# vikram-353/meetiq architecture

> Architecture diagram of the GitHub repository vikram-353/meetiq, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vikram-353/meetiq
- Repository: https://github.com/vikram-353/meetiq

## Overview

##### Project Type and Purpose
- This is a full-stack Next.js application (Next.js App Router) that provides user authentication, a dashboard for managing “agents” and “meetings,” and real-time video calling via Stream.Video.
- The README confirms it was bootstrapped with create-next-app and runs on Node.js with built-in Next.js routing, SSR/SSG, and optimized fonts.

##### File Structure Analysis
- Top-level config files: next.config.ts, drizzle.config.ts (Drizzle ORM for database), tsconfig.json.
- src/app: Next.js “app” directory including layouts and pages for /auth, /dashboard, /call, plus API route handlers under src/app/api/auth and src/app/api/trpc.
- src/components & src/components/ui: Shared React UI components (buttons, dialogs, tables, etc.).
- src/lib: Utility libraries (auth client, Stream.Video wrapper, common utils).
- src/hooks: Custom React hooks.
- src/db: Database configuration and schema definitions (Drizzle).
- src/modules: Domain-driven directories for agents, meetings, call, auth, dashboard, home—each containing server procedures (tRPC), schemas/types, UI views/components.
- src/trpc: tRPC client/server initialization and router definitions.

##### README and Architectural Insights
- Uses Next.js’s hybrid SSR/CSR model, Drizzle for ORM, tRPC for type-safe API, NextAuth for authentication ([…all] route), and Stream.Video for real-time calls.

##### Key Components
a. Frontend (Browser/Client)
- Next.js React pages & components under src/app & src/modules/*/ui
- tRPC & React Query client (src/trpc/client.tsx & src/trpc/query-client.ts)
- Stream.Video SDK wrapper (src/lib/stream.video.ts)
- NextAuth client for sign-in/up (via src/lib/auth-client.ts)
b. API Layer (Next.js Route Handlers + tRPC)
- NextAuth route: src/app/api/auth/[...all]/route.ts
- tRPC route: src/app/api/trpc/[trpc]/route.ts → src/trpc/server.tsx → src/trpc/routers/_app.ts
c. Business Logic & Data Access
- Domain procedures: src/modules/{agents,meetings}/server/procedures.ts (tRPC resolver functions)
- Drizzle ORM: src/db/index.ts & schema.ts
d. Data Store
- Relational database (e.g., PostgreSQL) configured via drizzle.config.ts
e. External Services
- NextAuth (OAuth providers, sessions)
- Stream.Video (real-time call service)

##### Relationships and Data Flow
- Browser → Next.js frontend (SSR/CSR)
→ On data needs: tRPC client → Next.js API (route.ts) → tRPC server → domain procedures → Drizzle → DB → back up chain → React Query → UI.
- Auth flow: Browser → NextAuth client → /api/auth route → NextAuth server → OAuth provider → session.
- Call flow: Browser → Stream.Video SDK client → Stream.Video service (signalling/media) → peers.

##### Architectural Patterns & Design Principles
- Feature-module decomposition (agents, meetings, call, auth).
- Type-safe end-to-end contract: tRPC + React Query.
- Monolithic Next.js app (frontend & API in one codebase) with serverless functions.
- ORM abstraction via Drizzle.
- Separation of concerns: UI components, hooks, lib utilities, server procedures.

## Diagram (Mermaid)

```mermaid
graph TD
  subgraph Client
    BROWSER["Browser"]:::frontend
    FRONTEND_APP["Next.js App Router\n(src/app)"]:::frontend
    SHARED_UI["Shared UI Components\n(src/components & src/components/ui)"]:::frontend
    FEATURE_UI["Feature Modules UI\n(src/modules/*/ui)"]:::frontend
    TRPC_CLIENT["tRPC Client\n(src/trpc/client.tsx)"]:::frontend
    QUERY_CLIENT["React Query Client\n(src/trpc/query-client.ts)"]:::frontend
    AUTH_CLIENT["NextAuth Client\n(src/lib/auth-client.ts)"]:::frontend
    STREAM_SDK["Stream.Video SDK Wrapper\n(src/lib/stream.video.ts)"]:::frontend
  end

  subgraph Server
    NEXTAUTH_API["NextAuth API Route\n(src/app/api/auth/[...all]/route.ts)"]:::api
    TRPC_API["tRPC API Route\n(src/app/api/trpc/[trpc]/route.ts)"]:::api
    TRPC_SERVER["tRPC Server Init\n(src/trpc/server.tsx)"]:::api
    ROOT_ROUTER["tRPC Root Router\n(src/trpc/routers/_app.ts)"]:::api
    AGENTS_PROC["Agents Procedures\n(src/modules/agents/server/procedures.ts)"]:::biz
    MEETINGS_PROC["Meetings Procedures\n(src/modules/meetings/server/procedures.ts)"]:::biz
    DRIZZLE["Drizzle ORM\n(src/db/index.ts & src/db/schema.ts)"]:::biz
  end

  subgraph PersistenceAndExternal
    DB["PostgreSQL Database"]:::db
    DRIZZLE_CFG["Drizzle Config\n(drizzle.config.ts)"]:::db
    NEXT_CONFIG["Next.js Config\n(next.config.ts)"]:::db
    OAUTH["OAuth Providers\n(NextAuth)"]:::external
    STREAM_SERVICE["Stream.Video Service"]:::external
  end

  BROWSER -->|"renders UI"| FRONTEND_APP
  FRONTEND_APP --> SHARED_UI
  FRONTEND_APP --> FEATURE_UI
  FRONTEND_APP --> TRPC_CLIENT
  FRONTEND_APP --> AUTH_CLIENT
  FRONTEND_APP --> STREAM_SDK
  TRPC_CLIENT --> QUERY_CLIENT
  TRPC_CLIENT -->|"tRPC call"| TRPC_API
  AUTH_CLIENT -->|"HTTP POST"| NEXTAUTH_API
  STREAM_SDK -->|"WebRTC/REST"| STREAM_SERVICE
  TRPC_API --> TRPC_SERVER
  TRPC_SERVER --> ROOT_ROUTER
  ROOT_ROUTER --> AGENTS_PROC
  ROOT_ROUTER --> MEETINGS_PROC
  AGENTS_PROC -->|"ORM query"| DRIZZLE
  MEETINGS_PROC -->|"ORM query"| DRIZZLE
  DRIZZLE --> DB
  NEXTAUTH_API -->|"OAuth callback"| OAUTH

  click FRONTEND_APP "https://github.com/vikram-353/meetiq/tree/main/src/app"
  click SHARED_UI "https://github.com/vikram-353/meetiq/tree/main/src/components"
  click FEATURE_UI "https://github.com/vikram-353/meetiq/tree/main/src/modules"
  click TRPC_CLIENT "https://github.com/vikram-353/meetiq/blob/main/src/trpc/client.tsx"
  click QUERY_CLIENT "https://github.com/vikram-353/meetiq/blob/main/src/trpc/query-client.ts"
  click AUTH_CLIENT "https://github.com/vikram-353/meetiq/blob/main/src/lib/auth-client.ts"
  click STREAM_SDK "https://github.com/vikram-353/meetiq/blob/main/src/lib/stream.video.ts"
  click NEXTAUTH_API "https://github.com/vikram-353/meetiq/blob/main/src/app/api/auth/[...all]/route.ts"
  click TRPC_API "https://github.com/vikram-353/meetiq/blob/main/src/app/api/trpc/[trpc]/route.ts"
  click TRPC_SERVER "https://github.com/vikram-353/meetiq/blob/main/src/trpc/server.tsx"
  click ROOT_ROUTER "https://github.com/vikram-353/meetiq/blob/main/src/trpc/routers/_app.ts"
  click DRIZZLE "https://github.com/vikram-353/meetiq/blob/main/src/db/index.ts"
  click DRIZZLE_CFG "https://github.com/vikram-353/meetiq/blob/main/drizzle.config.ts"
  click NEXT_CONFIG "https://github.com/vikram-353/meetiq/blob/main/next.config.ts"

  classDef frontend fill:#ADD8E6,stroke:#333,stroke-width:1px
  classDef api fill:#90EE90,stroke:#333,stroke-width:1px
  classDef biz fill:#FFA500,stroke:#333,stroke-width:1px
  classDef db fill:#D3D3D3,stroke:#333,stroke-width:1px
  classDef external fill:#FFFFE0,stroke:#333,stroke-width:1px
```
