🚀 Consulting Super App

All-in-One Enterprise Platform for Consulting Business

A comprehensive, production-grade super app that combines knowledge management, client management, project tracking, AI assistance, and team collaboration into one unified platform.

---

🌟 Features Overview

📚 Knowledge Management (ConsultKB)

• 100+ Consulting Frameworks from McKinsey, BCG, Bain, Deloitte
• 6-Layer Framework Taxonomy (Strategy → Domain → Tools → Engagement → Playbooks → Knowledge)
• AI-Powered Application - Apply frameworks with Claude AI assistance
• Smart Search - Full-text search with filters
• Export - PDF & PPTX generation
• Personal Notes & Bookmarks

👥 Client Management (CRM)

• Client Profiles - Complete client information & history
• Contact Management - Track all stakeholder contacts
• Engagement History - Full track record of interactions
• Document Repository - Centralized client documents
• Pipeline Management - Track potential deals

📊 Project Management

• Project Dashboard - Real-time project overview
• Timeline & Milestones - Gantt-style planning
• Task Management - Assign, track, complete
• Resource Allocation - Team & budget management
• Time Tracking - Log hours & billable time
• Budget Tracking - Monitor expenses vs budget

🤖 AI Consulting Assistant

• Framework Recommender - AI suggests best frameworks
• Content Generator - Generate reports, proposals, presentations
• Analysis Helper - Data analysis & insights
• Meeting Assistant - Notes, summaries, action items
• Proposal Writer - Auto-generate consulting proposals

📈 Analytics & Reporting

• Business Dashboard - KPIs, metrics, trends
• Project Analytics - Performance, profitability
• Client Analytics - Revenue, satisfaction, retention
• Team Performance - Utilization, productivity
• Custom Reports - Build & export custom reports

👨‍👩‍👧‍👦 Team Collaboration

• Real-time Chat - Team & client communication
• Video Calls - Integrated video conferencing
• Document Collaboration - Co-edit in real-time
• Comments & Reviews - Feedback system
• Notifications - Stay updated

📱 Mobile & PWA

• Responsive Design - Works on all devices
• PWA Support - Install as native app
• Offline Mode - Work without internet
• Push Notifications - Never miss updates

---

🏗️ Architecture

consulting-super-app/
├── apps/
│   ├── web/                    # Main Next.js web application
│   ├── mobile/                 # React Native mobile app
│   └── api/                    # API Gateway (optional)
├── packages/
│   ├── ui/                     # Shared UI components
│   ├── database/               # Prisma schema & client
│   ├── auth/                   # Authentication package
│   ├── ai/                     # AI integration package
│   ├── utils/                  # Shared utilities
│   └── config/                 # Shared configurations
└── virtus-futura/              # Unified website workspace
    └── src/
        ├── app/                # Main routes + /consultkb routes + APIs
        └── consultkb/          # ConsultKB modules (components/lib/data)

Tech Stack

Layer	Technology
Frontend	Next.js 16, React 19, TypeScript
Styling	Tailwind CSS v4, shadcn/ui
State	Zustand, TanStack Query
Animation	Framer Motion
Database	PostgreSQL (production), SQLite (dev)
ORM	Prisma 6
Auth	NextAuth.js / Auth.js
AI	Anthropic Claude API
Real-time	Pusher / Socket.io
Storage	AWS S3 / Vercel Blob
Email	Resend / SendGrid
Payments	Stripe
Deployment	Vercel / Docker

---

🚀 Getting Started

Prerequisites

• Node.js 18+
• npm or pnpm
• Git

Installation

# Clone the repository
git clone <repository-url>
cd consulting-super-app

# Install dependencies
npm install

# Set up environment variables
cp .env.example .env.local

# Set up database
npm run db:migrate
npm run db:seed

# Start development server
npm run dev

Open http://localhost:3000

Environment Variables

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/consulting"

# Authentication
NEXTAUTH_SECRET="your-secret-key"
NEXTAUTH_URL="http://localhost:3000"

# AI
ANTHROPIC_API_KEY="your-claude-api-key"

# Storage
AWS_ACCESS_KEY_ID="your-aws-key"
AWS_SECRET_ACCESS_KEY="your-aws-secret"
AWS_REGION="us-east-1"

# Email
RESEND_API_KEY="your-resend-key"

# Payments
STRIPE_SECRET_KEY="your-stripe-key"
STRIPE_WEBHOOK_SECRET="your-webhook-secret"

---

📦 Available Scripts

npm run dev          # Start all apps in development
npm run build        # Build all apps
npm run start        # Start production server
npm run lint         # Run linter
npm run test         # Run tests
npm run typecheck    # TypeScript type checking
npm run db:migrate   # Run database migrations
npm run db:seed      # Seed database
npm run db:studio    # Open Prisma Studio
npm run clean        # Clean all build artifacts

---

🗄️ Database Schema

The application uses 12 core models:

• User - Authentication & profiles
• Client - Client companies
• Contact - Client contacts
• Project - Consulting engagements
• Task - Project tasks
• Framework - Consulting frameworks
• Note - Personal notes
• Bookmark - Saved items
• Application - Framework applications
• Document - Files & documents
• Conversation - AI conversations
• Analytics - Metrics & events

---

🤝 Monorepo Structure

This is a Turborepo monorepo with the following packages:

Package	Description
@consulting/ui	Shared React components
@consulting/database	Prisma schema & client
@consulting/auth	Authentication utilities
@consulting/ai	AI integration (Claude)
@consulting/utils	Shared utilities
@consulting/config	ESLint, TypeScript configs

---

📱 Apps

Web App (apps/web)

Main Next.js application with all features.

Mobile App (apps/mobile)

React Native app for iOS & Android.

---

🔐 Authentication

Supports multiple authentication methods:

• Email/Password - Traditional login
• Google OAuth - One-click Google login
• Microsoft OAuth - Enterprise SSO
• Magic Link - Passwordless login
• 2FA - Two-factor authentication

---

🎨 UI Components

Built with shadcn/ui + custom components:

• 100+ reusable components
• Dark/Light theme
• Fully accessible (WCAG 2.1)
• Responsive by default
• TypeScript typed

---

📊 Analytics

Integrated analytics dashboard:

• Business Metrics - Revenue, growth, pipeline
• Project Metrics - On-time, budget, satisfaction
• Team Metrics - Utilization, performance
• Client Metrics - Retention, NPS, lifetime value

---

🚢 Deployment

Vercel (Recommended)

vercel deploy --prod

Docker

docker build -t consulting-super-app .
docker-compose up -d

Self-Hosted

See Deployment Guide for detailed instructions.

---

📖 Documentation

• Getting Started
• Architecture
• API Reference
• Database Schema
• AI Integration
• Deployment
• Contributing

---

🧪 Testing

# Unit tests
npm run test:unit

# Integration tests
npm run test:integration

# E2E tests
npm run test:e2e

# Coverage
npm run test:coverage

---

📄 License

MIT License - see LICENSE for details.

---

👥 Contributors

Built with ❤️ by the Consulting Super App Team

---

🙏 Acknowledgments

• Frameworks from McKinsey, BCG, Bain, Deloitte
• UI components from shadcn/ui
• Icons from Lucide
• Analytics from Vercel Analytics

---

Version: 1.0.0
Last Updated: February 2026

Last updated: Sat Feb 28 15:38:17 WIB 2026