How cybxs82/g19x-ith-jldp-966-academic works
Plataforma CFO: usuarios cargan documentos ERP, bancarios y presupuestos; el sistema conserva y normaliza datos para derivar indicadores, forecast, alertas y recomendaciones que se consultan en el dashboard. Los usuarios también gestionan alertas y exportan reportes guardados con PDF. El README documenta las capacidades del producto; las relaciones entre componentes se limitan a las visibles en los extractos o documentadas allí, pues varias rutas y módulos de negocio no fueron muestreados.
Main entry points: financial_controller.py FastAPI controller · financial_repository.py Financial repository · dashboard-controller.ts Dashboard client · reports-controller.ts Reports client
Components 21
Experiencia web
- Dashboard
views/dashboard-view.tsx - Dashboard page
app/page.tsx - Dashboard client
controllers/dashboard-controller.ts - Financial model
models/financial-model.ts - Auth client
controllers/auth-controller.ts - ERP upload
views/erp-upload-view.tsx - Reports client
controllers/reports-controller.ts - Report model
models/report-model.ts
API y contratos
- Next API routes
app/api - FastAPI controller
backend/controllers/financial_controller.py - API schemas
backend/models/schemas.py
Servicios financieros
- File ingestion
backend/services/ingestion_service.py - Forecasting
backend/services/forecast_service.py - Recommendations
backend/services/recommendation_service.py - Authentication
backend/services/auth_service.py - Report PDF
backend/services/report_pdf_service.py
Persistencia
- Financial repository
backend/repositories/financial_repository.py - DB connection
backend/infrastructure/database.py - Settings
backend/infrastructure/config.py
Other components
- CFO / analista
- PostgreSQL
Connections 26
- CFO / analista → Dashboard: consulta
- Dashboard page → Dashboard client: solicita datos
app/page.tsx - Dashboard page → Dashboard: renderiza
app/page.tsx - Dashboard client → Next API routes: consulta dashboard
controllers/dashboard-controller.ts - Dashboard client → Financial model: mapea datos
controllers/dashboard-controller.ts - Dashboard → Reports client: guarda reporte
views/dashboard-view.tsx - Reports client → Next API routes: solicita reportes
controllers/reports-controller.ts - Reports client → Report model: usa contrato
controllers/reports-controller.ts - CFO / analista → ERP upload: carga archivos
- ERP upload → Auth client: invoca carga
views/erp-upload-view.tsx - Auth client → FastAPI controller: envía carga
controllers/auth-controller.ts - FastAPI controller → Authentication: autentica
backend/controllers/financial_controller.py - FastAPI controller → File ingestion: procesa cargas
backend/controllers/financial_controller.py - FastAPI controller → Recommendations: genera reglas
backend/controllers/financial_controller.py - FastAPI controller → Financial repository: consulta datos
backend/controllers/financial_controller.py - FastAPI controller → API schemas: valida contratos
backend/controllers/financial_controller.py - Financial repository → DB connection: abre conexión
backend/repositories/financial_repository.py - DB connection → Settings: lee ajustes
backend/infrastructure/database.py - DB connection → PostgreSQL: consulta y persiste
backend/infrastructure/database.py - CFO / analista → FastAPI controller: solicita forecast
- Financial repository → Forecasting: obtiene proyección
backend/repositories/financial_repository.py - Financial repository → File ingestion: recalcula derivados
backend/repositories/financial_repository.py - Financial repository → Report PDF: genera PDF
backend/repositories/financial_repository.py - CFO / analista → FastAPI controller: gestiona alertas
- CFO / analista → FastAPI controller: consulta recomendaciones
- CFO / analista → FastAPI controller: exporta instantánea