How leortiz41/semilla-gestion-comunitaria works
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: server.ts Express API entry · App.tsx Session and navigation · database.ts PostgreSQL · api.ts REST client
Components 25
Web client
- Session and navigation
frontend/src/App.tsx - REST client
frontend/src/lib/api.ts - Community records UI
frontend/src/modulos/comunidades - Family records UI
frontend/src/modulos/familias - Project tracking UI
frontend/src/modulos/proyectos - Donor progress UI
frontend/src/modulos/proyectos/SeguimientoDonante.tsx - Dashboard UI
frontend/src/modulos/dashboard - Payments and contracts UI
frontend/src/modulos/pagos - Organization administration UI
frontend/src/modulos/usuarios
Identity and access
- Authentication routes
backend/src/routes/auth.routes.ts - Session authentication
backend/src/services/auth.service.ts - Token and permission checks
backend/src/middleware/auth.middleware.ts - Platform administration
backend/src/routes/plataforma.routes.ts
Community records
- Community and zone routes
backend/src/routes/comunidades.routes.ts - Community records service
backend/src/services/comunidades.service.ts - Family and household routes
backend/src/routes
Programs and resources
- Project and activity routes
backend/src/routes/proyectos.routes.ts - Donor access and map routes
backend/src/routes/donantes.routes.ts - Payments and contracts routes
backend/src/routes - Dashboard routes
backend/src/routes/dashboard.routes.ts
API and persistence
- Express API entry
backend/src/server.ts - PostgreSQL
backend/src/config/database.ts - Private evidence storage
backend/src/services/r2-evidencias.service.ts
Other components
- Staff user
- Donor
Connections 29
- Staff user → Session and navigation: uses
README.md - Donor → Session and navigation: uses
README.md - Session and navigation → REST client: requests
frontend/src/App.tsx - Session and navigation → Community records UI: renders
frontend/src/App.tsx - Session and navigation → Family records UI: renders
frontend/src/App.tsx - Session and navigation → Project tracking UI: renders
frontend/src/App.tsx - Session and navigation → Donor progress UI: renders
frontend/src/App.tsx - Session and navigation → Dashboard UI: renders
frontend/src/App.tsx - REST client → Express API entry: REST over HTTPS
README.md - Express API entry → Authentication routes: mounts
backend/src/server.ts - Express API entry → Community and zone routes: mounts
backend/src/server.ts - Express API entry → Family and household routes: mounts
backend/src/server.ts - Express API entry → Project and activity routes: mounts
backend/src/server.ts - Express API entry → Donor access and map routes: mounts
backend/src/server.ts - Express API entry → Dashboard routes: mounts
backend/src/server.ts - Authentication routes → Session authentication: delegates
backend/src/services/auth.service.ts - Session authentication → PostgreSQL: queries
backend/src/services/auth.service.ts - Token and permission checks → PostgreSQL: checks session
backend/src/middleware/auth.middleware.ts - Express API entry → Platform administration: mounts
backend/src/server.ts - Platform administration → PostgreSQL: queries
backend/src/routes/plataforma.routes.ts - Community and zone routes → Community records service: delegates
backend/src/routes/comunidades.routes.ts - Community records service → PostgreSQL: persists
backend/src/services/comunidades.service.ts - Project and activity routes → PostgreSQL: queries
backend/src/routes/proyectos.routes.ts - Project and activity routes → Private evidence storage: reads and signs evidence
backend/src/routes/proyectos.routes.ts - Donor access and map routes → PostgreSQL: queries
backend/src/routes/donantes.routes.ts - Donor access and map routes → Private evidence storage: signs evidence
backend/src/routes/donantes.routes.ts - Payments and contracts UI → REST client: uses REST client
- Organization administration UI → REST client: uses REST client
frontend/src/modulos/usuarios/PaginaPlataforma.tsx - Payments and contracts routes → PostgreSQL: persists
backend/src/routes/proyectos.routes.ts