Forge Web - Architecture Overview

src/
├── app/                # Next.js App Router
│   ├── (auth)/         # Authentication pages
│   ├── api/            # API routes
│   └── dashboard/      # Main application
├── components/         # React components
│   ├── ui/             # shadcn/ui primitives
│   ├── dashboard/      # Dashboard components
│   ├── calling/        # LiveKit voice/video
│   ├── ideas/          # Ideas module
│   ├── goals/          # Goals module
│   ├── tasks/          # Tasks/Kanban module
│   ├── mindmap/        # React Flow mind maps
│   └── shared/         # Shared components
├── hooks/              # Custom React hooks
├── stores/             # Zustand state stores
├── lib/                # Utilities and configs
└── types/              # TypeScript definitions

src/app/api/
├── auth/[...nextauth]/  # NextAuth.js handlers
├── ideas/               # Ideas CRUD
├── goals/               # Goals CRUD
├── tasks/               # Tasks CRUD
├── comments/            # Comments CRUD
├── activity/            # Activity feed
├── users/               # User management
├── livekit/             # Voice/video calling
│   ├── call/            # Call management
│   └── token/           # Token generation
├── mindmaps/            # Mind map data
├── search/              # Global search
└── warmup/              # Database warmup

model User {
  id        String   @id @default(cuid())
  email     String   @unique
  name      String?
  image     String?
  tenantId  String?
  ideas     Idea[]
  goals     Goal[]
  tasks     Task[]
  comments  Comment[]
}
 
model Idea {
  id          String   @id @default(cuid())
  title       String
  description String?
  status      String   @default("draft")
  priority    String   @default("medium")
  authorId    String
  author      User     @relation(fields: [authorId])
  goals       GoalIdea[]
  tasks       Task[]
  comments    Comment[]
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt
}
 
model Goal {
  id          String   @id @default(cuid())
  title       String
  description String?
  status      String   @default("not_started")
  priority    String   @default("medium")
  progress    Int      @default(0)
  dueDate     DateTime?
  authorId    String
  author      User     @relation(fields: [authorId])
  ideas       GoalIdea[]
  tasks       Task[]
  comments    Comment[]
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt
}
 
model Task {
  id          String   @id @default(cuid())
  title       String
  description String?
  status      String   @default("backlog")
  priority    String   @default("medium")
  dueDate     DateTime?
  orderIndex  Int      @default(0)
  goalId      String?
  ideaId      String?
  authorId    String
  author      User     @relation(fields: [authorId])
  goal        Goal?    @relation(fields: [goalId])
  idea        Idea?    @relation(fields: [ideaId])
  comments    Comment[]
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt
}

// lib/db.ts
export async function getIdeasForTenant(tenantId: string) {
  return prisma.idea.findMany({
    where: {
      author: {
        tenantId: tenantId
      }
    }
  });
}

// middleware.ts
export { auth as middleware } from "@/lib/auth";
 
export const config = {
  matcher: [
    "/((?!api/auth|_next/static|_next/image|favicon.ico).*)",
  ],
};

// app/api/ideas/route.ts
import { auth } from "@/lib/auth";
 
export async function GET() {
  const session = await auth();
  if (!session?.user) {
    return Response.json({ error: "Unauthorized" }, { status: 401 });
  }
  // Fetch ideas for user's tenant
}

// next.config.ts
const nextConfig = {
  experimental: {
    reactCompiler: true,
  },
};

// hooks/use-ideas.ts
export function useIdeas() {
  return useQuery({
    queryKey: ["ideas"],
    queryFn: fetchIdeas,
    staleTime: 5 * 60 * 1000, // 5 minutes
    gcTime: 30 * 60 * 1000,   // 30 minutes
  });
}

export function useCreateIdea() {
  const queryClient = useQueryClient();
 
  return useMutation({
    mutationFn: createIdea,
    onMutate: async (newIdea) => {
      await queryClient.cancelQueries({ queryKey: ["ideas"] });
      const previous = queryClient.getQueryData(["ideas"]);
      queryClient.setQueryData(["ideas"], (old) => [...old, newIdea]);
      return { previous };
    },
    onError: (err, newIdea, context) => {
      queryClient.setQueryData(["ideas"], context.previous);
    },
    onSettled: () => {
      queryClient.invalidateQueries({ queryKey: ["ideas"] });
    },
  });
}

# Authentication
AUTH_SECRET="your-auth-secret"
AUTH_MICROSOFT_ENTRA_ID_ID="azure-client-id"
AUTH_MICROSOFT_ENTRA_ID_SECRET="azure-client-secret"
AUTH_MICROSOFT_ENTRA_ID_ISSUER="https://login.microsoftonline.com/tenant-id/v2.0"
 
# Database
TURSO_DATABASE_URL="libsql://your-db.turso.io"
TURSO_AUTH_TOKEN="your-turso-token"
 
# LiveKit (optional)
LIVEKIT_URL="wss://your-app.livekit.cloud"
LIVEKIT_API_KEY="your-api-key"
LIVEKIT_API_SECRET="your-api-secret"
 
# Application
NEXT_PUBLIC_APP_URL="https://your-domain.com"