How omarmariscal/silverback works
Silverback is a Contraloría POA planning and audit-execution platform: staff use role-specific web screens to manage annual plans and activities, while Jefatura reviews and authorizes plans and monitors performance. The README also documents auditor management, catalog-based planning, and cloud evidence storage. The sampled frontend service shows POA requests over HTTP; most backend wiring and the document-storage implementation were not sampled, so those relationships are shown only where documented or left unconnected.
Main entry points: poas.service.ts POA workflows · poa.service.ts POA service · actividades.service.ts Activity management · prisma.service.ts Prisma access
Components 21
Web application
- Role-based screens
frontend/src/app - Session and roles
frontend/src/services/auth.service.ts - API client
frontend/src/services/api.ts - POA service
frontend/src/services/poa.service.ts - POA contracts
frontend/src/types/poa-api.ts
POA and activities
- POA endpoints
backend/src/modules/poas/infrastructure/http/poas.controller.ts - POA workflows
backend/src/modules/poas/application/poas.service.ts - POA persistence
backend/src/modules/poas/infrastructure/repositories/prisma-poa.repository.ts - Activity endpoints
backend/src/modules/actividades/infrastructure/http/actividades.controller.ts - Activity management
backend/src/modules/actividades/application/actividades.service.ts - Activity queries
backend/src/modules/actividades/infrastructure/repositories/prisma-actividad-query.repository.ts - Subactivity queries
backend/src/modules/actividades/infrastructure/repositories/prisma-subactividad-query.repository.ts
Oversight and catalogs
- Activity catalog
backend/src/modules/catalogo - Auditor directory
backend/src/modules/auditores - Center POAs
backend/src/modules/centros - Role dashboards
backend/src/modules/dashboard - Evidence storage
API platform
- PostgreSQL
- Prisma access
backend/src/prisma/prisma.service.ts - JWT authentication
backend/src/core/auth
Other components
- Contraloría staff
Connections 22
- Contraloría staff → Role-based screens: uses
- Role-based screens → Session and roles: resolves session
frontend/src/services/auth.service.ts - Role-based screens → POA service: requests POA
- POA service → API client: sends requests
frontend/src/services/poa.service.ts - POA service → POA contracts: uses contracts
frontend/src/services/poa.service.ts - POA service → POA endpoints: calls endpoints
frontend/src/services/poa.service.ts - POA endpoints → POA workflows: delegates to
- POA workflows → POA persistence: persists plans
- Activity endpoints → Activity management: delegates to
- Activity management → Activity queries: queries activities
- Activity management → Subactivity queries: queries subactivities
- POA workflows → Activity management: manages plan activities
- POA persistence → Prisma access: uses ORM
- Activity queries → Prisma access: uses ORM
- Subactivity queries → Prisma access: uses ORM
- Prisma access → PostgreSQL: accesses data
- POA workflows → Activity catalog: selects catalog items
- POA workflows → Auditor directory: assigns auditors
- Contraloría staff → Evidence storage: stores evidence
- Contraloría staff → Role dashboards: reviews metrics
- Contraloría staff → Center POAs: reviews center plans
- Contraloría staff → JWT authentication: authenticates