# devoc-admin/devoc architecture

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

- Interactive diagram: https://gitdiagram.com/devoc-admin/devoc
- Repository: https://github.com/devoc-admin/devoc

## Overview

##### Project Type & Purpose
- This is a JavaScript/TypeScript monorepo (managed by pnpm & Turborepo) containing multiple related web applications and shared configuration.
- Apps:
- Main public website (apps/web) built with Next.js
- Customer-specific frontend (apps/customers/lasbordes/front) built with Next.js + embedded Payload CMS
- Customer preview app (apps/customers/lasbordes/preview) built with Vite
- Email templating service (apps/email) producing server‐side React email templates
- Shared tooling under tooling/typescript-config and root‐level scripts (biome, lefthook, turbo).

##### Key Architectural Components
- Monorepo Root
- pnpm-workspace (monorepo package manager)
- turbo.json (task orchestrator)
- tooling/ (shared TS configs, lint/format)
- App: web (Next.js)
- Static & dynamic pages under app/
- API routes for contact forms (send-email action)
- Integrates with Email service via internal HTTP call
- App: customers/lasbordes/front (Next.js + Payload)
- Public “front” pages under src/app/(frontend)
- Embedded headless CMS admin & API under src/app/(payload)
- GraphQL & REST endpoints for content storage
- Persists content to external database (e.g., MongoDB)
- App: customers/lasbordes/preview (Vite)
- Standalone preview of front components (static assets + React UI)
- App: email (Node + React Email)
- Email templates under emails/
- Export functions compile JSX → HTML
- Can be invoked by web or front apps or CI for notifications
- External Services
- Database (Payload CMS stores to DB)
- Email provider (e.g., SendGrid)
- CDN / Static hosting (for built frontends)

##### Interactions & Data Flows
- Developer tools (pnpm, turbo, biome, lefthook) orchestrate builds & code quality across all apps.
- Running `turbo dev` spawns each selected app’s dev server:
- Next.js dev server on port 3000 for web & front
- Vite dev server on port 5173 for preview
- web ↔ email: Next.js API route calls email service functions (HTTP or internal import).
- front ↔ payload API: Next.js Pages call local API routes (GraphQL/REST) to read/write CMS content → DB.
- CI/CD pipelines (not shown in files but typically present) build & deploy each app to its environment.

##### Architectural Patterns & Principles
- Monorepo Pattern: single repository for multiple apps & libs
- Shared Configuration: tooling/typescript-config, root scripts, and shared lib/utils.ts
- Modular Micro-Frontends: each customer frontend is isolated in its own folder
- Serverless/API-First: Next.js API routes & Vite serve dynamic API layers
- Headless CMS embedding: Payload CMS runs alongside front code
- Component-Based UI: React components and design-system patterns in each app

##### Diagramming Recommendations
- Use clear labels: e.g., “Next.js Web App”, “Payload CMS API”, “Email Template Service”
- From web API route → Email service → Email provider
- From front pages → Payload API → Database
- From devtools → apps (for build/run)
- Blue for public websites
- Green for customer-specific apps
- Orange for backend/email service
- Gray for tooling/config
- Rectangles for code modules/apps
- Clouds for external services (CDN, email provider)

##### Essential Details to Capture
- Monorepo orchestration (pnpm/turbo) at the top
- Isolation & independence of each app
- Embedded headless CMS pattern in the lasbordes front
- Serverless/API-first pattern of Next.js API routes
- Shared configuration in tooling and libs

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Monorepo Root and Tooling
    subgraph "Monorepo Root"
        direction TB
        PNPM["pnpm-workspace.yaml"]:::tooling
        TURBO["turbo.json"]:::tooling
        LHOOK["lefthook.yml"]:::tooling
        BIOME["biome.jsonc"]:::tooling
        TS_CFG["tooling/typescript-config"]:::tooling
        PNPM --> TURBO
        TURBO --> LHOOK
        LHOOK --> BIOME
        BIOME --> TS_CFG
    end

    %% Web App
    subgraph "Public Web App (Next.js)" 
        direction TB
        WEB_ROOT["apps/web/"]:::apps-web
        WEB_NXCFG["next.config.ts"]:::apps-web
        WEB_PAGES["app/ (static & dynamic pages)"]:::apps-web
        WEB_CMP["app/_components/"]:::apps-web
        WEB_ACTION["actions/send-email.ts"]:::apps-web
        WEB_ROOT --> WEB_NXCFG
        WEB_ROOT --> WEB_PAGES
        WEB_PAGES --> WEB_CMP
        WEB_ACTION --> WEB_ROOT
    end

    %% Customer Frontend
    subgraph "Customer Frontend (Next.js + Payload)" 
        direction TB
        FRONT_ROOT["apps/customers/lasbordes/front/"]:::apps-front
        FRONT_NXCFG["next.config.ts"]:::apps-front
        FRONT_FE["src/app/(frontend)/"]:::apps-front
        FRONT_PAY["src/app/(payload)/"]:::apps-front
        FRONT_API["src/app/api/contact/route.ts"]:::apps-front
        FRONT_COLL["src/collections/"]:::apps-front
        FRONT_PCFG["src/payload.config.ts"]:::apps-front
        FRONT_ROOT --> FRONT_NXCFG
        FRONT_ROOT --> FRONT_FE
        FRONT_ROOT --> FRONT_PAY
        FRONT_PAY --> FRONT_API
        FRONT_ROOT --> FRONT_COLL
        FRONT_ROOT --> FRONT_PCFG
    end

    %% Preview App
    subgraph "Customer Preview (Vite)" 
        direction TB
        PREV_ROOT["apps/customers/lasbordes/preview/"]:::apps-preview
        PREV_HTML["index.html"]:::apps-preview
        PREV_VITE["vite.config.ts"]:::apps-preview
        PREV_SRC["src/"]:::apps-preview
        PREV_ROOT --> PREV_HTML
        PREV_ROOT --> PREV_VITE
        PREV_ROOT --> PREV_SRC
    end

    %% Email Service
    subgraph "Email Template Service (Node + React Email)" 
        direction TB
        EMAIL_ROOT["apps/email/"]:::apps-email
        EMAIL_TS["tsconfig.json"]:::apps-email
        EMAIL_BIOME["biome.json"]:::apps-email
        EMAIL_EM["emails/"]:::apps-email
        EMAIL_STAT["emails/static"]:::apps-email
        EMAIL_ROOT --> EMAIL_TS
        EMAIL_ROOT --> EMAIL_BIOME
        EMAIL_ROOT --> EMAIL_EM
        EMAIL_EM --> EMAIL_STAT
    end

    %% External Services
    subgraph "External Services"
        direction TB
        DB[(Database)]:::external
        EMAIL_PROV[(Email Provider)]:::external
        CDN[(CDN / Hosting)]:::external
    end

    %% Interactions
    WEB_ACTION -->|"calls"| EMAIL_ROOT
    FRONT_FE -->|"reads/writes content"| FRONT_API
    FRONT_API -->|"persists"| DB
    EMAIL_ROOT -->|"sends via"| EMAIL_PROV
    WEB_PAGES -->|"deploy static"| CDN
    PREV_SRC -->|"deploy static"| CDN

    %% Dev Tools Interaction
    PNPM -->|runs| WEB_ROOT
    PNPM -->|runs| FRONT_ROOT
    PNPM -->|runs| PREV_ROOT
    PNPM -->|runs| EMAIL_ROOT

    %% Click Events
    click PNPM "https://github.com/devoc-admin/devoc/blob/main/pnpm-workspace.yaml"
    click TURBO "https://github.com/devoc-admin/devoc/blob/main/turbo.json"
    click LHOOK "https://github.com/devoc-admin/devoc/blob/main/lefthook.yml"
    click BIOME "https://github.com/devoc-admin/devoc/blob/main/biome.jsonc"
    click TS_CFG "https://github.com/devoc-admin/devoc/tree/main/tooling/typescript-config"
    click WEB_ROOT "https://github.com/devoc-admin/devoc/tree/main/apps/web/"
    click WEB_NXCFG "https://github.com/devoc-admin/devoc/blob/main/apps/web/next.config.ts"
    click WEB_PAGES "https://github.com/devoc-admin/devoc/tree/main/apps/web/app/"
    click WEB_CMP "https://github.com/devoc-admin/devoc/tree/main/apps/web/app/_components/"
    click WEB_ACTION "https://github.com/devoc-admin/devoc/blob/main/apps/web/actions/send-email.ts"
    click FRONT_ROOT "https://github.com/devoc-admin/devoc/tree/main/apps/customers/lasbordes/front/"
    click FRONT_NXCFG "https://github.com/devoc-admin/devoc/blob/main/apps/customers/lasbordes/front/next.config.ts"
    click FRONT_FE "https://github.com/devoc-admin/devoc/tree/main/apps/customers/lasbordes/front/src/app/(frontend)/"
    click FRONT_PAY "https://github.com/devoc-admin/devoc/tree/main/apps/customers/lasbordes/front/src/app/(payload)/"
    click FRONT_API "https://github.com/devoc-admin/devoc/blob/main/apps/customers/lasbordes/front/src/app/api/contact/route.ts"
    click FRONT_COLL "https://github.com/devoc-admin/devoc/tree/main/apps/customers/lasbordes/front/src/collections/"
    click FRONT_PCFG "https://github.com/devoc-admin/devoc/blob/main/apps/customers/lasbordes/front/src/payload.config.ts"
    click PREV_ROOT "https://github.com/devoc-admin/devoc/tree/main/apps/customers/lasbordes/preview/"
    click PREV_HTML "https://github.com/devoc-admin/devoc/blob/main/apps/customers/lasbordes/preview/index.html"
    click PREV_VITE "https://github.com/devoc-admin/devoc/blob/main/apps/customers/lasbordes/preview/vite.config.ts"
    click PREV_SRC "https://github.com/devoc-admin/devoc/tree/main/apps/customers/lasbordes/preview/src/"
    click EMAIL_ROOT "https://github.com/devoc-admin/devoc/tree/main/apps/email/"
    click EMAIL_EM "https://github.com/devoc-admin/devoc/tree/main/apps/email/emails/"
    click EMAIL_STAT "https://github.com/devoc-admin/devoc/tree/main/apps/email/emails/static"
    click EMAIL_TS "https://github.com/devoc-admin/devoc/blob/main/apps/email/tsconfig.json"
    click EMAIL_BIOME "https://github.com/devoc-admin/devoc/blob/main/apps/email/biome.json"

    %% Styles
    classDef tooling fill:#dddddd,stroke:#aaa,stroke-width:1px
    classDef apps-web fill:#bbdefb,stroke:#1976d2,stroke-width:2px
    classDef apps-front fill:#c8e6c9,stroke:#388e3c,stroke-width:2px
    classDef apps-preview fill:#c8e6c9,stroke:#388e3c,stroke-width:2px
    classDef apps-email fill:#ffe0b2,stroke:#f57c00,stroke-width:2px
    classDef external fill:#f5f5f5,stroke:#999,stroke-width:1px,stroke-dasharray: 2 2
    classDef default stroke:#333,stroke-width:1px;base:false
```
