# shine0078/cars-portfolio architecture

> Architecture diagram of the GitHub repository shine0078/cars-portfolio, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-03-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shine0078/cars-portfolio
- Repository: https://github.com/shine0078/cars-portfolio

## Overview

##### What this project is (type + purpose)
This repo is a **headless-CMS + frontend** system:

- **Frontend:** a **Next.js (Pages Router)** web app at the repo root (`next.config.mjs`, `src/pages/*`, `src/components/*`).
- **Backend/CMS:** a **Strapi** project under `my-project/` (Strapi-style `config/*`, `src/api/*`, `database/migrations/*`, `public/uploads/*`, `src/admin/*`).
- The intended architecture is: **Next.js renders UI** and **reads content/data from Strapi** (and potentially uses Next.js API routes for small server-side utilities).

##### Next.js app (repo root)
Key directories/files to model:

- `src/pages/*`
- `index.js`, `projects/index.js`, `experience/index.js` → primary routes/pages.
- `src/pages/api/hello.js` → Next.js API route (serverless/function or Node handler depending on deployment).
- `_app.js`, `_document.js` → app shell / document customization.
- `src/components/header/*`, `src/components/footer/*` → shared UI components.

- “Pages (Routes)”
- “UI Components”
- “Strapi Client / Data Access Layer”
- “Next API routes” (if used beyond the template)

##### Strapi backend (`my-project/`)
Key directories/files to model:

- `my-project/config/*`
- `server.ts`, `database.ts`, `middlewares.ts`, `plugins.ts`, `api.ts`, `admin.ts` → Strapi runtime configuration.
- `my-project/src/index.ts` → Strapi bootstrap/entry customization point.
- `my-project/src/api/email/*`
- `content-types/email/schema.json` → a Strapi content type (Email).
- `controllers/email.ts`, `routes/email.ts`, `services/email.ts` → classic Strapi layering (route → controller → service).
- `my-project/database/migrations/*` → DB schema migrations (indicates a real DB is used; exact engine depends on `config/database.ts`).
- `my-project/public/uploads/*` → Strapi local media storage (or placeholder for a provider; the folder indicates at least local dev storage).
- `my-project/src/admin/*` (`app.example.tsx`, `vite.config.example.ts`) → Strapi Admin UI customization/build configuration.

- “REST/Content API”
- “Email API (route/controller/service)”
- “Database access layer / ORM (Strapi’s internal)”
- “Admin UI”
- “Uploads/Media storage”

##### Shared / environment / deployment
- There are **two `package.json`** files (root and `my-project/package.json`) → two separately built/deployed apps.
- Likely runtime:
- Next.js: Vercel or Node server
- Strapi: Node server (container/VM/PaaS) + database

##### Browser → Next.js
- Users request pages: `GET /`, `/projects`, `/experience`.

##### Next.js → Strapi Content API
- Next pages call `src/lib/strapi.js` to fetch content from Strapi endpoints.
- “HTTPS (REST) /api/*”
- “Fetch content + media URLs”

##### Strapi → Database
- Strapi persists content types (including `email`) into the DB defined in `my-project/config/database.ts`.

##### Strapi → Uploads/Media storage
- For media/content assets: local `public/uploads` or external provider (if configured).

##### Admin user (content editor) → Strapi Admin UI
- Admin accesses Strapi admin panel to manage content.

##### (Optional) Browser/Next.js → Next.js API routes
- If used, show: Browser → Next API route → (maybe Strapi/other services).

##### Architectural patterns to highlight (from structure)
- **Headless CMS pattern:** Strapi is the system of record; Next.js is presentation.
- **Layered backend design in Strapi:** `routes → controllers → services → persistence`.
- **Separation of deployables:** two independent Node applications with separate dependency graphs and release lifecycles.
- **Content-type driven domain:** `schema.json` defines the “Email” model; code is organized per-content-type.

##### “Don’t overthink it”: split into as many components as possible (specific to this repo)
To be maximally detailed (and still accurate), break it down like this:

##### Next.js breakdown
- Router/Pages:
- `/` (`src/pages/index.js`)
- `/projects` (`src/pages/projects/index.js`)
- `/experience` (`src/pages/experience/index.js`)
- UI:
- Header (`src/components/header/header.js`)
- Footer (`src/components/footer/footer.js`)
- Data access:
- Strapi client wrapper (`src/lib/strapi.js`, `src/lib/dist/strapi.dev.js`)
- API:
- Next API routes (`src/pages/api/*`) — currently `hello.js`

##### Strapi breakdown
- Admin UI customization:
- API Modules:
- Email module: schema + routes + controller + service
- Core runtime config:
- `my-project/config/server.ts` (server settings)
- `my-project/config/database.ts` (DB connection)
- `my-project/config/middlewares.ts`
- `my-project/config/plugins.ts`
- Persistence:
- DB + migrations
- Assets:
- uploads folder

## Diagram (Mermaid)

```mermaid
flowchart TD

%% =========================
%% Actors
%% =========================
subgraph "Actors"
direction TB
User["End User (Browser)"]:::actor
Editor["Content Editor (Admin)"]:::actor
end

%% =========================
%% System Context (High-level)
%% =========================
subgraph "System Context (Headless CMS + Frontend)"
direction TB

NextApp["Next.js Website (Pages Router)\nNode/Vercel"]:::frontend
StrapiApp["Strapi CMS Backend\nNode Server"]:::backend
DB[("SQL Database\n(configured in database.ts)")]:::db
Uploads[("Media Storage\n(public/uploads or provider)")]:::storage
end

User -->|"HTTPS GET /, /projects, /experience"| NextApp
Editor -->|"HTTPS /admin"| StrapiApp
NextApp -->|"HTTPS REST /api/*\n(fetch content + media URLs)"| StrapiApp
StrapiApp -->|"SQL (Strapi ORM/query engine)"| DB
StrapiApp -->|"File I/O / storage provider API"| Uploads
User -.->|"GET media assets (optional direct)"| StrapiApp
User -.->|"GET media assets (optional direct)"| Uploads

%% =========================
%% Next.js Container (Repo Root)
%% =========================
subgraph "Next.js Frontend App (repo root)"
direction TB

NextConfig["Next.js Config\n(next.config.mjs)"]:::frontend

subgraph "Routing + App Shell"
direction TB
Pages["Pages / Routes\n(src/pages/*)"]:::frontend
PageHome["Route: / (index.js)"]:::frontend
PageProjects["Route: /projects (projects/index.js)"]:::frontend
PageExperience["Route: /experience (experience/index.js)"]:::frontend

AppShell["App Shell\n(_app.js)"]:::frontend
Document["Document\n(_document.js)"]:::frontend
end

subgraph "UI Components"
direction TB
Header["Header Component\n(src/components/header/*)"]:::frontend
Footer["Footer Component\n(src/components/footer/*)"]:::frontend
end

subgraph "Data Access Layer"
direction TB
StrapiClient["Strapi API Client\n(fetch wrapper)"]:::frontend
StrapiClientSrc["src/lib/strapi.js"]:::frontend
StrapiClientDist["src/lib/dist/strapi.dev.js"]:::frontend
end

subgraph "Next.js API Routes (Optional)"
direction TB
NextApi["API Routes\n(src/pages/api/*)"]:::optional
HelloApi["Example: /api/hello\n(hello.js)"]:::optional
end

Pages --> PageHome
Pages --> PageProjects
Pages --> PageExperience
Pages --> AppShell
Pages --> Document

PageHome -->|"calls fetch() via client"| StrapiClient
PageProjects -->|"calls fetch() via client"| StrapiClient
PageExperience -->|"calls fetch() via client"| StrapiClient

StrapiClient --> StrapiClientSrc
StrapiClient --> StrapiClientDist

Header -->|"shared layout"| Pages
Footer -->|"shared layout"| Pages

User -->|"HTTPS"| Pages
User -.->|"HTTPS (optional)"| NextApi
NextApi --> HelloApi
end

%% Next.js deployable linkages
NextConfig --> Pages
StrapiClient -->|"HTTPS REST"| StrapiApp

%% =========================
%% Strapi Container (my-project/)
%% =========================
subgraph "Strapi Backend / CMS App (my-project/)"
direction TB

subgraph "Core Runtime"
direction TB
StrapiBootstrap["Bootstrap / Entry\n(src/index.ts)"]:::backend
StrapiConfig["Runtime Configuration\n(config/*)"]:::backend
ServerCfg["server.ts"]:::backend
DbCfg["database.ts"]:::backend
MwCfg["middlewares.ts"]:::backend
PluginsCfg["plugins.ts"]:::backend
ApiCfg["api.ts"]:::backend
AdminCfg["admin.ts"]:::backend
end

subgraph "Content + APIs"
direction TB
ContentAPI["REST/Content API\n(Strapi endpoints)"]:::backend

subgraph "Email API Module (src/api/email/*)"
direction TB
EmailSchema["Content Type Schema\n(schema.json)"]:::backend
EmailRoutes["Routes Layer\n(routes/email.ts)"]:::backend
EmailController["Controller Layer\n(controllers/email.ts)"]:::backend
EmailService["Service Layer\n(services/email.ts)"]:::backend
end
end

subgraph "Admin"
direction TB
AdminUI["Strapi Admin UI\n(/admin)"]:::backend
AdminCustom["Admin UI Customization (optional/examples)\n(src/admin/*)"]:::optional
AdminAppExample["app.example.tsx"]:::optional
AdminViteExample["vite.config.example.ts"]:::optional
end

subgraph "Persistence + Assets"
direction TB
Migrations["Database Migrations\n(database/migrations/*)"]:::db
GeneratedTypes["Generated Types\n(types/generated/*)"]:::backend
ContentTypesDTS["contentTypes.d.ts"]:::backend
ComponentsDTS["components.d.ts"]:::backend
UploadsFolder["Uploads Folder\n(public/uploads/*)"]:::storage
end

StrapiConfig --> ServerCfg
StrapiConfig --> DbCfg
StrapiConfig --> MwCfg
StrapiConfig --> PluginsCfg
StrapiConfig --> ApiCfg
StrapiConfig --> AdminCfg

StrapiBootstrap --> StrapiConfig
StrapiBootstrap --> ContentAPI
ContentAPI --> EmailRoutes

EmailRoutes -->|"routes -> controller"| EmailController
EmailController -->|"controller -> service"| EmailService
EmailService -->|"read/write content"| DB
EmailSchema -->|"defines model"| EmailService

AdminUI -->|"manage content"| ContentAPI
AdminCustom --> AdminAppExample
AdminCustom --> AdminViteExample
AdminUI -.->|"optional customization"| AdminCustom

DbCfg -->|"connect"| DB
Migrations -->|"apply schema changes"| DB

ContentAPI -->|"returns media URLs"| UploadsFolder
StrapiApp --> AdminUI
StrapiApp --> ContentAPI
StrapiApp --> UploadsFolder

GeneratedTypes --> ContentTypesDTS
GeneratedTypes --> ComponentsDTS
end

%% =========================
%% Click Events (from component_mapping)
%% =========================
click NextConfig "https://github.com/shine0078/cars-portfolio/blob/main/next.config.mjs"
click Pages "https://github.com/shine0078/cars-portfolio/tree/main/src/pages/"
click PageHome "https://github.com/shine0078/cars-portfolio/blob/main/src/pages/index.js"
click PageProjects "https://github.com/shine0078/cars-portfolio/blob/main/src/pages/projects/index.js"
click PageExperience "https://github.com/shine0078/cars-portfolio/blob/main/src/pages/experience/index.js"
click AppShell "https://github.com/shine0078/cars-portfolio/blob/main/src/pages/_app.js"
click Document "https://github.com/shine0078/cars-portfolio/blob/main/src/pages/_document.js"
click HelloApi "https://github.com/shine0078/cars-portfolio/blob/main/src/pages/api/hello.js"
click Header "https://github.com/shine0078/cars-portfolio/blob/main/src/components/header/header.js"
click Footer "https://github.com/shine0078/cars-portfolio/blob/main/src/components/footer/footer.js"
click StrapiClientSrc "https://github.com/shine0078/cars-portfolio/blob/main/src/lib/strapi.js"
click StrapiClientDist "https://github.com/shine0078/cars-portfolio/blob/main/src/lib/dist/strapi.dev.js"

click StrapiApp "https://github.com/shine0078/cars-portfolio/tree/main/my-project/"
click StrapiConfig "https://github.com/shine0078/cars-portfolio/blob/main/my-project/config/server.ts"
click ServerCfg "https://github.com/shine0078/cars-portfolio/blob/main/my-project/config/server.ts"
click DbCfg "https://github.com/shine0078/cars-portfolio/blob/main/my-project/config/database.ts"
click MwCfg "https://github.com/shine0078/cars-portfolio/blob/main/my-project/config/middlewares.ts"
click PluginsCfg "https://github.com/shine0078/cars-portfolio/blob/main/my-project/config/plugins.ts"
click ApiCfg "https://github.com/shine0078/cars-portfolio/blob/main/my-project/config/api.ts"
click AdminCfg "https://github.com/shine0078/cars-portfolio/blob/main/my-project/config/admin.ts"
click StrapiBootstrap "https://github.com/shine0078/cars-portfolio/blob/main/my-project/src/index.ts"

click EmailSchema "https://github.com/shine0078/cars-portfolio/blob/main/my-project/src/api/email/content-types/email/schema.json"
click EmailRoutes "https://github.com/shine0078/cars-portfolio/blob/main/my-project/src/api/email/routes/email.ts"
click EmailController "https://github.com/shine0078/cars-portfolio/blob/main/my-project/src/api/email/controllers/email.ts"
click EmailService "https://github.com/shine0078/cars-portfolio/blob/main/my-project/src/api/email/services/email.ts"

click Migrations "https://github.com/shine0078/cars-portfolio/tree/main/my-project/database/migrations/"
click UploadsFolder "https://github.com/shine0078/cars-portfolio/tree/main/my-project/public/uploads/"

click AdminAppExample "https://github.com/shine0078/cars-portfolio/blob/main/my-project/src/admin/app.example.tsx"
click AdminViteExample "https://github.com/shine0078/cars-portfolio/blob/main/my-project/src/admin/vite.config.example.ts"

click ContentTypesDTS "https://github.com/shine0078/cars-portfolio/blob/main/my-project/types/generated/contentTypes.d.ts"
click ComponentsDTS "https://github.com/shine0078/cars-portfolio/blob/main/my-project/types/generated/components.d.ts"

%% =========================
%% Styles
%% =========================
classDef actor fill:#e5e7eb,stroke:#6b7280,color:#111827,stroke-width:1px
classDef frontend fill:#dbeafe,stroke:#1d4ed8,color:#0b1b3a,stroke-width:1px
classDef backend fill:#bfdbfe,stroke:#1e40af,color:#0b1b3a,stroke-width:1px
classDef db fill:#dcfce7,stroke:#166534,color:#052e16,stroke-width:1px
classDef storage fill:#ffedd5,stroke:#9a3412,color:#431407,stroke-width:1px
classDef optional fill:#f3f4f6,stroke:#6b7280,color:#111827,stroke-width:1px,stroke-dasharray: 5 5
```
