# lexiesm/dccommit architecture

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

- Interactive diagram: https://gitdiagram.com/lexiesm/dccommit
- Repository: https://github.com/lexiesm/dccommit

## Overview

##### Project type and purpose
- This is a full-stack social/community web application.
- Frontend: Next.js 13 (app router) + React + Clerk for auth.
- Backend: Node.js/TypeScript Express REST API using Prisma ORM (PostgreSQL) and Supabase.
- Use cases: user registration & authentication, creating posts, comments, reporting content, admin/moderator dashboards.

##### File structure
- Top-level “front” directory: a Next.js project with:
- src/app – React pages & layouts.
- src/components – reusable UI components.
- src/services – client-side wrappers around backend HTTP calls.
- Clerk config (.clerk), middleware, and Next config.
- Top-level “back” directory: an Express/TypeScript REST API:
- src/api/controllers & src/api/routes – MVC-style controllers & route definitions.
- lib/prisma.ts – Prisma client setup.
- prisma/schema.prisma & prisma/migrations – database schema + migrations.
- supabase/ – Supabase config (storage, functions).
- generated/prisma – compiled Prisma client.
- Common configuration: tsconfig.json, eslint.config, package.json in each.

##### Main components
A. Client (Browser)
- Next.js SSR & CSR pages
- React components
- services/*.ts – HTTP clients to the API
B. API Gateway / Auth Layer
- Clerk authentication middleware (both front & back)
- Next.js middleware and back/src/api/auth-clerk
C. Backend REST API
- Express app.ts → routes → controllers
- Business logic layer (controllers → lib services if any)
- Prisma client for DB operations
- Supabase SDK for storage or real-time functions
D. Database
- PostgreSQL (managed via Prisma Migrations)
- Schema defined in prisma/schema.prisma
E. External Services
- Clerk (authentication, user management)
- Supabase (file storage, edge functions)
- Postman (for API testing – not shown in runtime)

##### Relationships & data flow
- Browser → Next.js server (SSR/ISR)
- Calls internal pages or fetches client services →
- services/*.ts invoke API endpoints (e.g., GET /posts, POST /comments)
- Next.js middleware uses Clerk to validate tokens/cookies
- Browser direct calls to Clerk for sign-in/out (if applicable)
- REST API receives requests → Clerk middleware → route handlers → Prisma & Supabase → responses
- REST API → Database via Prisma
- REST API → Supabase Storage (e.g., image uploads)

##### Architectural patterns & design principles
- Layered architecture: Presentation (front), API (controllers), Data (Prisma/DB).
- MVC-style controllers with explicit routing.
- Separation of concerns: Next.js for UI and SEO; Express for business logic.
- Infrastructure as code: Prisma schema & migrations.
- External auth offloading to Clerk; file handling via Supabase.

##### Technologies / frameworks
- Frontend: Next.js 13 App Router, React, TypeScript, Clerk SDK, CSS modules.
- Backend: Node.js, Express, TypeScript, Prisma ORM, Supabase JS.
- Database: PostgreSQL.
- Testing/Triage: Postman collection (API DCCommits.postman_collection.json).

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Layer
    subgraph "Client (Browser)"
        direction TB
        Pages["Next.js Pages\n(src/app)"]:::frontend
        UI["React UI Components\n(src/components)"]:::frontend
        Services["API Client Layer\n(src/services)"]:::frontend
        ClerkConfig["Clerk Config\n(.clerk)"]:::auth
        MiddlewareFront["Next.js Middleware\n(src/middleware.ts)"]:::auth
    end

    %% Auth Provider
    ClerkCloud["Clerk Auth Service"]:::external

    %% Backend Auth & API
    subgraph "API Gateway / Auth Layer"
        direction TB
        AuthMiddleware["Clerk Auth Middleware\n(back/src/api/auth-clerk/middleware.ts)"]:::auth
    end

    subgraph "Backend REST API"
        direction TB
        AppTS["Express App Entry\n(back/src/app.ts)"]:::backend
        IndexTS["Server Init\n(back/src/index.ts)"]:::backend
        Routes["API Routes\n(back/src/api/routes/*.ts)"]:::backend
        Controllers["Controllers\n(back/src/api/controllers/*.ts)"]:::backend
        PrismaSetup["Prisma Client Setup\n(back/src/lib/prisma.ts)"]:::backend
        SupabaseConfig["Supabase Config\n(back/src/supabase/config.toml)"]:::backend
        SupabaseCode["Supabase SDK\n(back/src/supabase)"]:::backend
    end

    %% Database
    DB["PostgreSQL\n(prisma/schema.prisma)"]:::database
    Migrations["Prisma Migrations\n(prisma/migrations/*)"]:::database
    GeneratedPrisma["Generated Prisma Client\n(back/generated/prisma)"]:::database

    %% External Services
    SupabaseCloud["Supabase Storage & Functions"]:::external

    %% Client Testing
    Postman["Postman Collection\n(back/API DCCommits.postman_collection.json)"]:::external

    %% Connections
    Pages -->|"uses"| UI
    UI -->|"calls"| Services
    Services -->|"HTTPS REST"| AppTS
    Pages -->|"SSR/ISR"| AppTS
    Pages -->|"auth calls"| ClerkCloud
    Services -->|"auth tokens"| ClerkCloud
    AppTS -->|"validates"| AuthMiddleware
    AuthMiddleware -->|"protects"| Routes
    AppTS -->|"loads routes"| Routes
    Routes -->|"invoke"| Controllers
    Controllers -->|"DB operations"| PrismaSetup
    PrismaSetup -->|"runs queries"| DB
    Controllers -->|"file ops"| SupabaseCode
    SupabaseCode -->|"storage API"| SupabaseCloud

    %% Legend: Migrations and Generated associate
    DB --- Migrations
    DB --- GeneratedPrisma

    %% Click Events
    click Pages "https://github.com/lexiesm/dccommit/tree/main/front/src/app"
    click UI "https://github.com/lexiesm/dccommit/tree/main/front/src/components"
    click Services "https://github.com/lexiesm/dccommit/tree/main/front/src/services"
    click ClerkConfig "https://github.com/lexiesm/dccommit/blob/main/front/.clerk"
    click MiddlewareFront "https://github.com/lexiesm/dccommit/blob/main/front/src/middleware.ts"
    click AuthMiddleware "https://github.com/lexiesm/dccommit/blob/main/back/src/api/auth-clerk/middleware.ts"
    click AppTS "https://github.com/lexiesm/dccommit/blob/main/back/src/app.ts"
    click IndexTS "https://github.com/lexiesm/dccommit/blob/main/back/src/index.ts"
    click Routes "https://github.com/lexiesm/dccommit/tree/main/back/src/api/routes"
    click Controllers "https://github.com/lexiesm/dccommit/tree/main/back/src/api/controllers"
    click PrismaSetup "https://github.com/lexiesm/dccommit/blob/main/back/src/lib/prisma.ts"
    click Schema "https://github.com/lexiesm/dccommit/blob/main/back/prisma/schema.prisma"
    click Migrations "https://github.com/lexiesm/dccommit/tree/main/back/prisma/migrations"
    click SupabaseConfig "https://github.com/lexiesm/dccommit/blob/main/back/src/supabase/config.toml"
    click SupabaseCode "https://github.com/lexiesm/dccommit/tree/main/back/src/supabase"
    click GeneratedPrisma "https://github.com/lexiesm/dccommit/tree/main/back/generated/prisma"
    click Postman "https://github.com/lexiesm/dccommit/blob/main/back/API DCCommits.postman_collection.json"

    %% Styles
    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef backend fill:#90EE90,stroke:#000,stroke-width:1px
    classDef database fill:#FFA500,stroke:#000,stroke-width:1px,shape:cylinder
    classDef external fill:#DDA0DD,stroke:#000,stroke-width:1px,shape:cloud
    classDef auth fill:#FFD700,stroke:#000,stroke-width:1px
```
