# leortiz41/semilla-gestion-comunitaria architecture

> Architecture diagram of the GitHub repository leortiz41/semilla-gestion-comunitaria, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/leortiz41/semilla-gestion-comunitaria
- Repository: https://github.com/leortiz41/semilla-gestion-comunitaria

## Overview

Semilla is a multi-tenant community-development management platform. Staff authenticate, work across community and family records, plan and track projects, and manage resources; donors have a restricted project-progress view. The React frontend calls a modular Express REST API, backed by PostgreSQL and private R2 evidence storage. The graph emphasizes documented capabilities and sampled routes; unsampled subsystems are represented by their existing route directories, and their internal call paths are not inferred.

Main entry points: [`backend/src/server.ts`](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/server.ts) (Express API entry), [`frontend/src/App.tsx`](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/App.tsx) (Session and navigation), [`backend/src/config/database.ts`](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/config/database.ts) (PostgreSQL), [`frontend/src/lib/api.ts`](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/lib/api.ts) (REST client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Session and navigation<br/>[App.tsx]"]
  node_api["REST client<br/>[api.ts]"]
  node_communities_ui["Community records UI"]
  node_families_ui["Family records UI"]
  node_projects_ui["Project tracking UI"]
  node_donor_ui["Donor progress UI"]
  node_dashboard_ui["Dashboard UI"]
  node_payments_ui["Payments and contracts UI"]
  node_users_ui["Organization administration UI"]
end

subgraph group_access["Identity and access"]
  node_auth_routes["Authentication routes<br/>[auth.routes.ts]"]
  node_auth_service["Session authentication<br/>[auth.service.ts]"]
  node_authz["Token and permission checks<br/>[auth.middleware.ts]"]
  node_platform_routes["Platform administration"]
end

subgraph group_community["Community records"]
  node_community_routes["Community and zone routes"]
  node_community_service["Community records service"]
  node_family_routes["Family and household routes"]
end

subgraph group_programs["Programs and resources"]
  node_project_routes["Project and activity routes"]
  node_donor_routes["Donor access and map routes<br/>[donantes.routes.ts]"]
  node_payments_routes["Payments and contracts routes"]
  node_dashboard_routes["Dashboard routes"]
end

subgraph group_platform["API and persistence"]
  node_server["Express API entry<br/>[server.ts]"]
  node_database[("PostgreSQL<br/>[database.ts]")]
  node_r2[("Private evidence storage")]
end

node_staff(("Staff user"))
node_donor(("Donor"))

node_staff -->|"uses"| node_app
node_donor -->|"uses"| node_app
node_app -->|"requests"| node_api
node_app -->|"renders"| node_communities_ui
node_app -->|"renders"| node_families_ui
node_app -->|"renders"| node_projects_ui
node_app -->|"renders"| node_donor_ui
node_app -->|"renders"| node_dashboard_ui
node_api -->|"REST over HTTPS"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_community_routes
node_server -->|"mounts"| node_family_routes
node_server -->|"mounts"| node_project_routes
node_server -->|"mounts"| node_donor_routes
node_server -->|"mounts"| node_dashboard_routes
node_auth_routes -->|"delegates"| node_auth_service
node_auth_service -->|"queries"| node_database
node_authz -->|"checks session"| node_database
node_server -->|"mounts"| node_platform_routes
node_platform_routes -->|"queries"| node_database
node_community_routes -->|"delegates"| node_community_service
node_community_service -->|"persists"| node_database
node_project_routes -->|"queries"| node_database
node_project_routes -->|"reads and signs evidence"| node_r2
node_donor_routes -->|"queries"| node_database
node_donor_routes -->|"signs evidence"| node_r2
node_payments_ui -.->|"uses REST client"| node_api
node_users_ui -->|"uses REST client"| node_api
node_payments_routes -.->|"persists"| node_database

click node_app "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/App.tsx"
click node_api "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/lib/api.ts"
click node_communities_ui "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/comunidades"
click node_families_ui "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/familias"
click node_projects_ui "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/proyectos"
click node_donor_ui "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/modulos/proyectos/SeguimientoDonante.tsx"
click node_dashboard_ui "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/dashboard"
click node_payments_ui "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/pagos"
click node_users_ui "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/usuarios"
click node_auth_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/auth.routes.ts"
click node_auth_service "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/services/auth.service.ts"
click node_authz "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/middleware/auth.middleware.ts"
click node_platform_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/plataforma.routes.ts"
click node_community_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/comunidades.routes.ts"
click node_community_service "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/services/comunidades.service.ts"
click node_family_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/backend/src/routes"
click node_project_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/proyectos.routes.ts"
click node_donor_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/donantes.routes.ts"
click node_payments_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/backend/src/routes"
click node_dashboard_routes "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/dashboard.routes.ts"
click node_server "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/server.ts"
click node_database "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/config/database.ts"
click node_r2 "https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/services/r2-evidencias.service.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_app,node_api,node_communities_ui,node_families_ui,node_projects_ui,node_donor_ui,node_dashboard_ui,node_payments_ui,node_users_ui,node_staff toneBlue
class node_auth_routes,node_auth_service,node_authz,node_platform_routes toneAmber
class node_community_routes,node_community_service,node_family_routes toneMint
class node_project_routes,node_donor_routes,node_payments_routes,node_dashboard_routes toneRose
class node_server,node_database,node_r2,node_donor toneIndigo
```

## Components

### Web client

- [Session and navigation](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [REST client](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Community records UI](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/comunidades): `frontend/src/modulos/comunidades`
- [Family records UI](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/familias): `frontend/src/modulos/familias`
- [Project tracking UI](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/proyectos): `frontend/src/modulos/proyectos`
- [Donor progress UI](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/frontend/src/modulos/proyectos/SeguimientoDonante.tsx): `frontend/src/modulos/proyectos/SeguimientoDonante.tsx`
- [Dashboard UI](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/dashboard): `frontend/src/modulos/dashboard`
- [Payments and contracts UI](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/pagos): `frontend/src/modulos/pagos`
- [Organization administration UI](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/frontend/src/modulos/usuarios): `frontend/src/modulos/usuarios`

### Identity and access

- [Authentication routes](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Session authentication](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`
- [Token and permission checks](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/middleware/auth.middleware.ts): `backend/src/middleware/auth.middleware.ts`
- [Platform administration](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/plataforma.routes.ts): `backend/src/routes/plataforma.routes.ts`

### Community records

- [Community and zone routes](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/comunidades.routes.ts): `backend/src/routes/comunidades.routes.ts`
- [Community records service](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/services/comunidades.service.ts): `backend/src/services/comunidades.service.ts`
- [Family and household routes](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/backend/src/routes): `backend/src/routes`

### Programs and resources

- [Project and activity routes](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/proyectos.routes.ts): `backend/src/routes/proyectos.routes.ts`
- [Donor access and map routes](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/donantes.routes.ts): `backend/src/routes/donantes.routes.ts`
- [Payments and contracts routes](https://github.com/leortiz41/semilla-gestion-comunitaria/tree/main/backend/src/routes): `backend/src/routes`
- [Dashboard routes](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/routes/dashboard.routes.ts): `backend/src/routes/dashboard.routes.ts`

### API and persistence

- [Express API entry](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [PostgreSQL](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/config/database.ts): `backend/src/config/database.ts`
- [Private evidence storage](https://github.com/leortiz41/semilla-gestion-comunitaria/blob/main/backend/src/services/r2-evidencias.service.ts): `backend/src/services/r2-evidencias.service.ts`

### Other components

- **Staff user**
- **Donor**

## Connections

- Staff user → Session and navigation: uses (evidence: `README.md`)
- Donor → Session and navigation: uses (evidence: `README.md`)
- Session and navigation → REST client: requests (evidence: `frontend/src/App.tsx`)
- Session and navigation → Community records UI: renders (evidence: `frontend/src/App.tsx`)
- Session and navigation → Family records UI: renders (evidence: `frontend/src/App.tsx`)
- Session and navigation → Project tracking UI: renders (evidence: `frontend/src/App.tsx`)
- Session and navigation → Donor progress UI: renders (evidence: `frontend/src/App.tsx`)
- Session and navigation → Dashboard UI: renders (evidence: `frontend/src/App.tsx`)
- REST client → Express API entry: REST over HTTPS (evidence: `README.md`)
- Express API entry → Authentication routes: mounts (evidence: `backend/src/server.ts`)
- Express API entry → Community and zone routes: mounts (evidence: `backend/src/server.ts`)
- Express API entry → Family and household routes: mounts (evidence: `backend/src/server.ts`)
- Express API entry → Project and activity routes: mounts (evidence: `backend/src/server.ts`)
- Express API entry → Donor access and map routes: mounts (evidence: `backend/src/server.ts`)
- Express API entry → Dashboard routes: mounts (evidence: `backend/src/server.ts`)
- Authentication routes → Session authentication: delegates (evidence: `backend/src/services/auth.service.ts`)
- Session authentication → PostgreSQL: queries (evidence: `backend/src/services/auth.service.ts`)
- Token and permission checks → PostgreSQL: checks session (evidence: `backend/src/middleware/auth.middleware.ts`)
- Express API entry → Platform administration: mounts (evidence: `backend/src/server.ts`)
- Platform administration → PostgreSQL: queries (evidence: `backend/src/routes/plataforma.routes.ts`)
- Community and zone routes → Community records service: delegates (evidence: `backend/src/routes/comunidades.routes.ts`)
- Community records service → PostgreSQL: persists (evidence: `backend/src/services/comunidades.service.ts`)
- Project and activity routes → PostgreSQL: queries (evidence: `backend/src/routes/proyectos.routes.ts`)
- Project and activity routes → Private evidence storage: reads and signs evidence (evidence: `backend/src/routes/proyectos.routes.ts`)
- Donor access and map routes → PostgreSQL: queries (evidence: `backend/src/routes/donantes.routes.ts`)
- Donor access and map routes → Private evidence storage: signs evidence (evidence: `backend/src/routes/donantes.routes.ts`)
- Payments and contracts UI → REST client: uses REST client
- Organization administration UI → REST client: uses REST client (evidence: `frontend/src/modulos/usuarios/PaginaPlataforma.tsx`)
- Payments and contracts routes → PostgreSQL: persists (evidence: `backend/src/routes/proyectos.routes.ts`)
