# miroslth/flat_cms architecture

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

- Interactive diagram: https://gitdiagram.com/miroslth/flat_cms
- Repository: https://github.com/miroslth/flat_cms

## Overview

##### Tipo y propósito del proyecto (según file tree + README)
**Proyecto:** Flat CMS (sin base de datos) para gestionar **noticias** y **secciones** con imágenes.
**Arquitectura:** Aplicación **full‑stack** con:
- **Frontend React** (`client/`)
- **Backend Node.js + Express** (`server/`)
- **Persistencia en filesystem** mediante **JSON** (`server/content/**`) + **uploads** para imágenes (`server/uploads/`)

El README confirma explícitamente: “JSON en filesystem (Flat CMS)” y separación `client/` (frontend) / `server/` (API) / `content/` (datos).

##### Frontend (`client/`)
Pistas claras de CRA/React:
- `client/public/index.html` y `client/src/index.js` → punto de entrada UI
- `client/src/App.js` → composición principal
- `client/src/components/`
- `SeccionNoticias.js` → UI/flujo para noticias
- `SeccionesManager.js` → UI/flujo para CRUD/gestión de secciones
- `client/src/api/content.js` → **capa de acceso a API** (muy importante para el diagrama; aquí se centralizan llamadas HTTP al backend)

##### Backend (`server/`)
- `server/index.js` → **Express app** (bootstrap, middlewares, mount de rutas)
- `server/routes/content.js` → endpoints de contenido (noticias/secciones)
- `server/routes/upload.js` → endpoints para subida de imágenes
- `server/utils/fileSystem.js` → lógica de lectura/escritura JSON en disco (la “base de datos”)
- `server/content/…` → “almacenamiento” en JSON (fuente de verdad)
- `server/uploads/` → almacenamiento de archivos subidos (imágenes)

##### Datos / persistencia (filesystem)
- `server/content/noticias/*.json`
- `server/content/secciones/*.json`
Esto equivale al rol de una DB, solo que en “flat files”.

##### Diagrama de Contexto / Contenedores (C4 – Container level)
Qué “sistemas” existen y cómo se comunican (Browser ↔ React ↔ Express ↔ FS/JSON, etc.).

##### Diagrama de Componentes (C4 – Component level) dentro del Backend y del Frontend
- Frontend: Components + API client
- Backend: Express app + rutas + utils + FS paths (content/uploads)

Esto encaja perfecto con el tree: se ve claramente el “container boundary” de `client/` y `server/`, y adentro aparecen componentes.

##### Usuario / Cliente
- **Admin/User (Browser)**: interactúa con la UI (login simple por “Admin26” según README; aunque no se ve un módulo auth claro en tree, puedes anotarlo como “credenciales/validación simple” si aplica en código).

##### Frontend (React SPA)
- **React App** (`client/src/App.js`)
- **UI Components**
- `SeccionesManager` (gestión secciones)
- `SeccionNoticias` (gestión noticias)
- **API Client Layer**
- `client/src/api/content.js` (requests a Express)
- (Opcional pero útil) **Hosting estático** si lo despliegas (Vercel/Static hosting), ya que README menciona demo en Vercel.

##### Backend (Express API)
- **Express Server** (`server/index.js`)
- **Routes**
- `routes/content.js` (CRUD de noticias/secciones)
- `routes/upload.js` (subida/serving de imágenes)
- **Utils**
- `utils/fileSystem.js` (read/write JSON; validaciones; paths; etc.)
- **Storage (Filesystem)**
- `server/content/secciones/*.json`
- `server/content/noticias/*.json`
- `server/uploads/*` (imágenes)

##### Infra / runtime (importante para exactitud)
- **Node.js runtime** (ejecuta Express)
- **NPM scripts** (build/run) — no hace falta dibujar scripts, pero sí indicar que son dos procesos: React dev server y Express server en local.
- **CORS / HTTP** (si aplica; normalmente React llama a API en otro puerto)

##### Relaciones e interacciones (flechas que no pueden faltar)
Dibuja flujos separados para **Noticias**, **Secciones** e **Imágenes**:

##### fileSystem utils → Filesystem
- lee/escribe `server/content/secciones/*.json` y `server/content/noticias/*.json`

##### Guarda en `server/uploads/`
4. Devuelve URL/path de imagen a frontend (y potencialmente se referencia desde el JSON de noticia/sección)

**Nota clave para el diagrama:** aquí hay dos “stores” distintos:
- **Content Store (JSON)** = `server/content/**`
- **Binary Store (uploads)** = `server/uploads/**`

##### Patrones/decisiones arquitectónicas que debes reflejar explícitamente
- **SPA + API**: React desacoplado del backend vía HTTP.
- **Flat-file persistence**: en vez de DB, el backend implementa “DAL” en `utils/fileSystem.js`.
- **Routing layer separada**: `routes/` agrupa endpoints por dominio (content vs upload).
- **Dominio explícito**: “noticias” y “secciones” como bounded contexts simples (dos carpetas y dos tipos de endpoints).

##### Etiquetas obligatorias en cajas
- “React SPA (client/)”
- “API Client (client/src/api/content.js)”
- “Express API (server/index.js)”
- “Content Routes (server/routes/content.js)”
- “Upload Routes (server/routes/upload.js)”
- “Filesystem Utils (server/utils/fileSystem.js)”
- “JSON Content Store (server/content/noticias, server/content/secciones)”
- “Uploads Store (server/uploads/)”

##### Flechas (direccionales) con protocolo/forma de datos
- React → Express: **HTTP REST (JSON)**
- React → Upload: **HTTP multipart/form-data**
- Express → FS: **read/write JSON files**, **write image binaries**

##### Qué NO omitir (errores comunes en este proyecto)
- No dibujar “DB” genérica: aquí la DB es el **filesystem** (content JSON).
- No mezclar “content” con “uploads”: son dos persistencias distintas con rutas distintas.
- Incluir la **capa API client** del frontend (`client/src/api/content.js`), porque explica dónde se centraliza la comunicación y facilita rastrear cambios.
- Mostrar que el backend está **modularizado por routes + utils**, no todo en `index.js`.

Puedes literalmente dibujar estas cajas:

**[Browser (Admin/User)]**
→ **[React SPA (client/src/App.js)]**
→ **[UI Components: SeccionesManager, SeccionNoticias]**
→ **[API Client: client/src/api/content.js]**
→ (HTTP JSON / multipart) **[Express Server: server/index.js]**
→ **[Routes: content.js | upload.js]**
→ **[Utils: fileSystem.js]**
→ **[Filesystem: server/content/{noticias,secciones}/*.json]**
→ **[Filesystem: server/uploads/*]**

Con eso capturas “lo esencial” y además separas el proyecto en el máximo de componentes útiles sin inventar partes que no existen.

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% =======================
  %% Actors / External
  %% =======================
  Admin["Admin/User<br/>(Browser)"]:::actor

  %% =======================
  %% Frontend (React SPA)
  %% =======================
  subgraph "Frontend Container: React SPA (client/)"
    direction TB
    FE_Index["Entry Point<br/>index.js"]:::frontend
    FE_App["App Composition<br/>App.js"]:::frontend

    subgraph "UI Components (client/src/components/)"
      direction TB
      FE_SeccionesManager["SeccionesManager<br/>(CRUD Secciones UI)"]:::frontend
      FE_SeccionNoticias["SeccionNoticias<br/>(CRUD Noticias UI)"]:::frontend
    end

    FE_ApiClient["API Client Layer<br/>api/content.js"]:::api
  end

  %% =======================
  %% Backend (Express API)
  %% =======================
  subgraph "Backend Container: Node.js + Express (server/)"
    direction TB
    BE_Express["Express Server Bootstrap<br/>index.js"]:::backend

    subgraph "Routing Layer (server/routes/)"
      direction TB
      BE_ContentRoutes["Content Routes<br/>content.js<br/>(Noticias/Secciones)"]:::backend
      BE_UploadRoutes["Upload Routes<br/>upload.js<br/>(Imágenes)"]:::backend
    end

    BE_FSUtils["Filesystem Persistence Utils<br/>utils/fileSystem.js"]:::backend
  end

  %% =======================
  %% Storage (Filesystem)
  %% =======================
  subgraph "Filesystem Persistence (No DB)"
    direction TB
    Store_Content["JSON Content Store<br/>server/content/**"]:::store

    subgraph "Content Domains"
      direction TB
      Store_Noticias["Noticias JSON Files<br/>(server/content/noticias/*.json)"]:::store
      Store_Secciones["Secciones JSON Files<br/>(server/content/secciones/*.json)"]:::store
    end

    Store_Uploads["Uploads/Binary Store<br/>(server/uploads/*)"]:::store
  end

  %% =======================
  %% Flows
  %% =======================
  Admin -->|"UI_interaction"| FE_Index
  FE_Index -->|"bootstraps"| FE_App

  FE_App -->|"renders"| FE_SeccionesManager
  FE_App -->|"renders"| FE_SeccionNoticias

  FE_SeccionesManager -->|"calls_API"| FE_ApiClient
  FE_SeccionNoticias -->|"calls_API"| FE_ApiClient

  FE_ApiClient -->|"HTTP_REST_JSON_/content"| BE_Express
  FE_ApiClient -->|"HTTP_multipart_/upload"| BE_Express

  BE_Express -->|"mounts"| BE_ContentRoutes
  BE_Express -->|"mounts"| BE_UploadRoutes

  BE_ContentRoutes -->|"read_write_JSON"| BE_FSUtils
  BE_UploadRoutes -->|"write_binary_file"| Store_Uploads
  BE_UploadRoutes -->|"returns_image_URL_path"| FE_ApiClient

  BE_FSUtils -->|"file_IO"| Store_Content
  Store_Content -->|"contains"| Store_Noticias
  Store_Content -->|"contains"| Store_Secciones

  Store_Noticias -->|"JSON_data"| BE_FSUtils
  Store_Secciones -->|"JSON_data"| BE_FSUtils

  %% =======================
  %% Click Events (from mapping)
  %% =======================
  click FE_Index "https://github.com/miroslth/flat_cms/blob/main/client/src/index.js"
  click FE_App "https://github.com/miroslth/flat_cms/blob/main/client/src/App.js"
  click FE_SeccionNoticias "https://github.com/miroslth/flat_cms/blob/main/client/src/components/SeccionNoticias.js"
  click FE_SeccionesManager "https://github.com/miroslth/flat_cms/blob/main/client/src/components/SeccionesManager.js"
  click FE_ApiClient "https://github.com/miroslth/flat_cms/blob/main/client/src/api/content.js"
  click BE_Express "https://github.com/miroslth/flat_cms/blob/main/server/index.js"
  click BE_ContentRoutes "https://github.com/miroslth/flat_cms/blob/main/server/routes/content.js"
  click BE_UploadRoutes "https://github.com/miroslth/flat_cms/blob/main/server/routes/upload.js"
  click BE_FSUtils "https://github.com/miroslth/flat_cms/blob/main/server/utils/fileSystem.js"
  click Store_Noticias "https://github.com/miroslth/flat_cms/tree/main/server/content/noticias/"
  click Store_Secciones "https://github.com/miroslth/flat_cms/tree/main/server/content/secciones/"
  click Store_Uploads "https://github.com/miroslth/flat_cms/tree/main/server/uploads/"

  %% =======================
  %% Styles
  %% =======================
  classDef actor fill:#E5E7EB,stroke:#6B7280,color:#111827,stroke-width:1px
  classDef frontend fill:#DBEAFE,stroke:#1D4ED8,color:#0F172A,stroke-width:1px
  classDef api fill:#BFDBFE,stroke:#1E40AF,color:#0F172A,stroke-width:1px
  classDef backend fill:#DCFCE7,stroke:#16A34A,color:#052e16,stroke-width:1px
  classDef store fill:#FFEDD5,stroke:#F97316,color:#431407,stroke-width:1px
```
