LedgerLab
Volver a 08 Proyectos · Portafolio
Estado: planificación.
API de finanzas personales con ingesta automática de transacciones, categorización por reglas y reportes programados.
Documentos
- Plan — objetivo, alcance, modelo de datos, hitos y criterios de aceptación.
- Pitch para clientes — cómo explicar el proyecto sin jerga técnica.
Stack
| Capa | Tecnología |
|---|---|
| API y reglas | Python + FastAPI |
| Worker de ingesta | Go |
| Base de datos | PostgreSQL |
| Cola | Redis + Celery |
| Frontend | React / Next.js |
| Infra | Docker + GitHub Actions |
Estructura
08_Proyectos/ledgerlab/
├── README.md
├── Plan-ledgerlab.md
├── api/ # FastAPI
│ ├── app/
│ └── tests/
├── worker/ # Go
│ ├── cmd/
│ └── internal/
├── web/ # React / Next.js
├── docker-compose.yml
└── .github/workflows/Cómo empezar
- Leer Plan.
- Crear el esquema de base de datos y las migraciones.
- Implementar auth y CRUD de cuentas, categorías y transacciones.
- Sumar la ingesta CSV con el worker en Go.
- Cerrar con reportes, tests, CI, deploy y demo.
Reglas del proyecto
- La API y las reglas viven en Python.
- La ingesta pesada de archivos vive en Go.
- Los montos se guardan como enteros en la unidad mínima (centavos).
- No se importan credenciales bancarias ni se accede a bancos.