# luisfer-king/correas-center-ddd architecture

> Architecture diagram of the GitHub repository luisfer-king/correas-center-ddd, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/luisfer-king/correas-center-ddd
- Repository: https://github.com/luisfer-king/correas-center-ddd

## Overview

Correas Center is a web portal with a Fastify backend and React frontend. Its evidenced public workflow assembles public content through frontend API clients, sends requests through a shared HTTP client, and serves public catalog, CMS, and commercial routes from the backend. The backend also composes administrative catalog, CMS, CRM, and IAM capabilities. The excerpts show composition and some frontend calls, but not the complete route handlers or persistence implementations, so those links are kept at the subsystem level.

Main entry points: [`src/backend/app.ts`](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/app.ts) (Fastify API), [`src/backend/composition/componer-publicacion.ts`](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/composition/componer-publicacion.ts) (Public composition), [`src/frontend/shared/api/cliente-http.ts`](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/shared/api/cliente-http.ts) (HTTP client), [`src/backend/contexts/catalog-management/infrastructure/componer-catalogo.ts`](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/catalog-management/infrastructure/componer-catalogo.ts) (Catalog composition)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Backend runtime"]
  node_api["Fastify API<br/>[app.ts]"]
  node_public_composition["Public composition"]
end

subgraph group_domains["Domain capabilities"]
  node_catalog_composition["Catalog composition"]
  node_cms_composition["CMS composition<br/>[componer-cms.ts]"]
  node_crm_composition["CRM composition<br/>[componer-crm.ts]"]
  node_iam["Identity access"]
  node_catalog_public["Public catalog reads"]
  node_commercial_public["Public commercial"]
  node_cms_public["Public CMS content"]
end

subgraph group_frontend["Frontend portal"]
  node_app_ui["React portal<br/>[App.tsx]"]
  node_public_content["Public content queries"]
  node_public_frame["Public site frame"]
  node_catalog_clients["Catalog API clients"]
  node_cms_clients["CMS API clients"]
  node_http_client["HTTP client<br/>[cliente-http.ts]"]
end

subgraph group_shared["Shared contracts"]
  node_public_contracts["Public data contracts<br/>[catalogo.ts]"]
  node_public_common["Paging contracts<br/>[comun.ts]"]
end

node_visitor(("Portal visitor"))
node_staff(("Portal staff"))
node_database[("PostgreSQL")]

node_api -->|"registers public"| node_public_composition
node_api -->|"composes catalog"| node_catalog_composition
node_api -->|"composes CMS"| node_cms_composition
node_api -->|"composes CRM"| node_crm_composition
node_public_composition -->|"constructs reads"| node_catalog_public
node_public_composition -->|"constructs handlers"| node_commercial_public
node_cms_composition -->|"uses authorization"| node_iam
node_catalog_composition -->|"uses authorization"| node_iam
node_crm_composition -->|"uses authorization"| node_iam
node_public_composition -->|"builds data access"| node_database
node_catalog_composition -->|"builds repositories"| node_database
node_cms_composition -->|"builds repositories"| node_database
node_crm_composition -->|"builds repositories"| node_database
node_visitor -.->|"uses portal"| node_app_ui
node_staff -.->|"uses portal"| node_app_ui
node_public_content -->|"calls queries"| node_catalog_clients
node_public_content -->|"calls queries"| node_cms_clients
node_public_frame -.->|"loads public data"| node_http_client
node_catalog_clients -->|"sends requests"| node_http_client
node_cms_clients -->|"sends requests"| node_http_client
node_http_client -->|"fetches API"| node_api
node_catalog_clients -->|"uses types"| node_public_contracts
node_cms_clients -->|"uses types"| node_public_common

click node_api "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/app.ts"
click node_public_composition "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/composition/componer-publicacion.ts"
click node_catalog_composition "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/catalog-management/infrastructure/componer-catalogo.ts"
click node_cms_composition "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/content-management-system/infrastructure/componer-cms.ts"
click node_crm_composition "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/commercial/infrastructure/componer-crm.ts"
click node_iam "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/identity-access-management/infrastructure/prisma-iam-client.ts"
click node_catalog_public "https://github.com/luisfer-king/correas-center-ddd/tree/master/src/backend/contexts/catalog-management/application/use-cases/publico"
click node_commercial_public "https://github.com/luisfer-king/correas-center-ddd/tree/master/src/backend/contexts/commercial/application/use-cases/publico"
click node_cms_public "https://github.com/luisfer-king/correas-center-ddd/tree/master/src/backend/contexts/content-management-system"
click node_app_ui "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/App.tsx"
click node_public_content "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/publico/api/cliente-contenido-publico.ts"
click node_public_frame "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/publico/api/cliente-marco-publico.ts"
click node_catalog_clients "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/catalog/api/publico/cliente-categorias.ts"
click node_cms_clients "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/cms/api/publico/cliente-registros.ts"
click node_http_client "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/shared/api/cliente-http.ts"
click node_public_contracts "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/shared/publico/catalogo.ts"
click node_public_common "https://github.com/luisfer-king/correas-center-ddd/blob/master/src/shared/publico/comun.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_public_composition toneBlue
class node_catalog_composition,node_cms_composition,node_crm_composition,node_iam,node_catalog_public,node_commercial_public,node_cms_public,node_database toneAmber
class node_app_ui,node_public_content,node_public_frame,node_catalog_clients,node_cms_clients,node_http_client toneMint
class node_public_contracts,node_public_common toneRose
class node_visitor,node_staff toneIndigo
```

## Components

### Backend runtime

- [Fastify API](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/app.ts): `src/backend/app.ts`
- [Public composition](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/composition/componer-publicacion.ts): `src/backend/composition/componer-publicacion.ts`

### Domain capabilities

- [Catalog composition](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/catalog-management/infrastructure/componer-catalogo.ts): `src/backend/contexts/catalog-management/infrastructure/componer-catalogo.ts`
- [CMS composition](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/content-management-system/infrastructure/componer-cms.ts): `src/backend/contexts/content-management-system/infrastructure/componer-cms.ts`
- [CRM composition](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/commercial/infrastructure/componer-crm.ts): `src/backend/contexts/commercial/infrastructure/componer-crm.ts`
- [Identity access](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/backend/contexts/identity-access-management/infrastructure/prisma-iam-client.ts): `src/backend/contexts/identity-access-management/infrastructure/prisma-iam-client.ts`
- [Public catalog reads](https://github.com/luisfer-king/correas-center-ddd/tree/master/src/backend/contexts/catalog-management/application/use-cases/publico): `src/backend/contexts/catalog-management/application/use-cases/publico`
- [Public commercial](https://github.com/luisfer-king/correas-center-ddd/tree/master/src/backend/contexts/commercial/application/use-cases/publico): `src/backend/contexts/commercial/application/use-cases/publico`
- [Public CMS content](https://github.com/luisfer-king/correas-center-ddd/tree/master/src/backend/contexts/content-management-system): `src/backend/contexts/content-management-system`

### Frontend portal

- [React portal](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/App.tsx): `src/frontend/App.tsx`
- [Public content queries](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/publico/api/cliente-contenido-publico.ts): `src/frontend/features/publico/api/cliente-contenido-publico.ts`
- [Public site frame](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/publico/api/cliente-marco-publico.ts): `src/frontend/features/publico/api/cliente-marco-publico.ts`
- [Catalog API clients](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/catalog/api/publico/cliente-categorias.ts): `src/frontend/features/catalog/api/publico/cliente-categorias.ts`
- [CMS API clients](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/features/cms/api/publico/cliente-registros.ts): `src/frontend/features/cms/api/publico/cliente-registros.ts`
- [HTTP client](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/frontend/shared/api/cliente-http.ts): `src/frontend/shared/api/cliente-http.ts`

### Shared contracts

- [Public data contracts](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/shared/publico/catalogo.ts): `src/shared/publico/catalogo.ts`
- [Paging contracts](https://github.com/luisfer-king/correas-center-ddd/blob/master/src/shared/publico/comun.ts): `src/shared/publico/comun.ts`

### Other components

- **Portal visitor**
- **Portal staff**
- **PostgreSQL**

## Connections

- Fastify API → Public composition: registers public (evidence: `src/backend/app.ts`)
- Fastify API → Catalog composition: composes catalog (evidence: `src/backend/app.ts`)
- Fastify API → CMS composition: composes CMS (evidence: `src/backend/app.ts`)
- Fastify API → CRM composition: composes CRM (evidence: `src/backend/app.ts`)
- Public composition → Public catalog reads: constructs reads (evidence: `src/backend/composition/componer-publicacion.ts`)
- Public composition → Public commercial: constructs handlers (evidence: `src/backend/composition/componer-publicacion.ts`)
- CMS composition → Identity access: uses authorization (evidence: `src/backend/contexts/content-management-system/infrastructure/componer-cms.ts`)
- Catalog composition → Identity access: uses authorization (evidence: `src/backend/contexts/catalog-management/infrastructure/componer-catalogo.ts`)
- CRM composition → Identity access: uses authorization (evidence: `src/backend/contexts/commercial/infrastructure/componer-crm.ts`)
- Public composition → PostgreSQL: builds data access (evidence: `src/backend/composition/componer-publicacion.ts`)
- Catalog composition → PostgreSQL: builds repositories (evidence: `src/backend/contexts/catalog-management/infrastructure/componer-catalogo.ts`)
- CMS composition → PostgreSQL: builds repositories (evidence: `src/backend/contexts/content-management-system/infrastructure/componer-cms.ts`)
- CRM composition → PostgreSQL: builds repositories (evidence: `src/backend/contexts/commercial/infrastructure/componer-crm.ts`)
- Portal visitor → React portal: uses portal
- Portal staff → React portal: uses portal
- Public content queries → Catalog API clients: calls queries (evidence: `src/frontend/features/publico/api/cliente-contenido-publico.ts`)
- Public content queries → CMS API clients: calls queries (evidence: `src/frontend/features/publico/api/cliente-contenido-publico.ts`)
- Public site frame → HTTP client: loads public data
- Catalog API clients → HTTP client: sends requests (evidence: `src/frontend/features/catalog/api/publico/cliente-categorias.ts`)
- CMS API clients → HTTP client: sends requests (evidence: `src/frontend/features/cms/api/publico/cliente-registros.ts`)
- HTTP client → Fastify API: fetches API (evidence: `src/frontend/shared/api/cliente-http.ts`)
- Catalog API clients → Public data contracts: uses types (evidence: `src/frontend/features/catalog/api/publico/cliente-categorias.ts`)
- CMS API clients → Paging contracts: uses types (evidence: `src/frontend/features/cms/api/publico/cliente-registros.ts`)
