# jhonson-lc/blog-fisei architecture

> Architecture diagram of the GitHub repository jhonson-lc/blog-fisei, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jhonson-lc/blog-fisei
- Repository: https://github.com/jhonson-lc/blog-fisei

## Overview

##### Project Type and Purpose
- This is a monorepo‑based full‑stack web application:
- Frontend: Next.js (TypeScript, App Router, SSR/SSG)
- Backend/CMS: Strapi (Node.js, REST API, content‑type driven)
- Shared Packages: UI components, ESLint/TSConfig presets
- Tooling: pnpm workspace, Turbo (build orchestration)

##### Main Components
- Client Application (apps/client)
- Server Application / CMS (apps/server)
- Database (PostgreSQL/MySQL/SQLite via Strapi config)
- File Storage (local “public/uploads” or external object storage)
- Shared Package Libraries (packages/ui, packages/eslint‑config‑custom, packages/tsconfig)
- Developer Tooling (pnpm, Turbo, CI/CD)

##### Relationships & Data Flow
A. Client ↔ Server
- Next.js pages/components invoke Strapi REST API endpoints (e.g., /api/article, /api/author) to fetch content.
- Data flows client ← server as JSON; server may authenticate requests or enforce middleware.
B. Server ↔ Database
- Strapi controllers/services perform CRUD on the database based on defined schemas.
C. Server ↔ Storage
- File uploads saved under apps/server/public/uploads (or proxied to S3).
D. Monorepo Packages ↔ Apps
- apps/client imports UI components from packages/ui.
- Both apps adhere to shared linting and TS config in packages/eslint‑config‑custom and packages/tsconfig.
E. Developer Workflow
- Turbo orchestrates builds, tests, and lint tasks across all packages.

##### Architectural Patterns & Design Principles
- Separation of Concerns: UI vs. API vs. Data Storage.
- Modular Monorepo: shared packages for UI, lint, TS settings.
- Layered MVC‑style structure inside Strapi: content-types → controllers → services → routes.
- Next.js App Router with server/client components.
- Infrastructure‑agnostic: environment variables drive database & storage configuration.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Monorepo: blog-fisei"
        %% Frontend
        subgraph "Frontend Layer"
            ClientApp["apps/client\n(Next.js 13, TypeScript, Tailwind)"]:::frontend
        end

        %% Backend
        subgraph "Backend Layer"
            ServerApp["apps/server\n(Strapi v4, Node.js)"]:::backend
            DBConfig["Database Config\n(config/database.js)"]:::backend
            Database["Database\n(PostgreSQL/MySQL/SQLite)"]:::data
            Storage["Uploads Storage\n(public/uploads)"]:::data
        end

        %% Shared Packages
        subgraph "Shared Packages"
            UIpkg["packages/ui\n(UI Components)"]:::packages
            ESLintPkg["packages/eslint-config-custom\n(ESLint rules)"]:::packages
            TSConfigPkg["packages/tsconfig\n(TS compiler options)"]:::packages
        end

        %% Developer Tooling
        subgraph "Developer Tooling"
            Pnpm["pnpm-workspace.yaml\n(pnpm workspace)"]:::tooling
            Turbo["turbo.json\n(build orchestrator)"]:::tooling
        end
    end

    %% Connections
    ClientApp -->|"REST API"| ServerApp
    ServerApp -->|"reads config"| DBConfig
    ServerApp -->|"SQL Query"| Database
    ServerApp -->|"File Upload"| Storage

    ClientApp -->|"import UI"| UIpkg
    ServerApp -->|"import UI"| UIpkg

    ClientApp -->|"config"| ESLintPkg
    ServerApp -->|"config"| ESLintPkg

    ClientApp -->|"config"| TSConfigPkg
    ServerApp -->|"config"| TSConfigPkg

    Pnpm -->|"runs"| ClientApp
    Pnpm -->|"runs"| ServerApp
    Pnpm -->|"runs"| UIpkg
    Pnpm -->|"runs"| ESLintPkg
    Pnpm -->|"runs"| TSConfigPkg
    Turbo -->|"orchestrates"| ClientApp
    Turbo -->|"orchestrates"| ServerApp
    Turbo -->|"orchestrates"| UIpkg
    Turbo -->|"orchestrates"| ESLintPkg
    Turbo -->|"orchestrates"| TSConfigPkg

    %% Click Events
    click ClientApp "https://github.com/jhonson-lc/blog-fisei/tree/main/apps/client"
    click ServerApp "https://github.com/jhonson-lc/blog-fisei/tree/main/apps/server"
    click DBConfig "https://github.com/jhonson-lc/blog-fisei/blob/main/apps/server/config/database.js"
    click Storage "https://github.com/jhonson-lc/blog-fisei/tree/main/apps/server/public/uploads"
    click UIpkg "https://github.com/jhonson-lc/blog-fisei/tree/main/packages/ui"
    click ESLintPkg "https://github.com/jhonson-lc/blog-fisei/tree/main/packages/eslint-config-custom"
    click TSConfigPkg "https://github.com/jhonson-lc/blog-fisei/tree/main/packages/tsconfig"
    click Pnpm "https://github.com/jhonson-lc/blog-fisei/blob/main/pnpm-workspace.yaml"
    click Turbo "https://github.com/jhonson-lc/blog-fisei/blob/main/turbo.json"

    %% Styles
    classDef frontend fill:#a3cef1,stroke:#0366d6,color:#0366d6;
    classDef backend fill:#b7e4c7,stroke:#2d6a4f,color:#2d6a4f;
    classDef data fill:#ffd8a8,stroke:#f76707,color:#d9480f;
    classDef packages fill:#e0bbE4,stroke:#7e22ce,color:#4c1d95;
    classDef tooling fill:#d3d3d3,stroke:#6e6e6e,color:#2e2e2e;
```
