Rumbo
PWA de planificacion de ahorro para personas y emprendedores de Republica Dominicana.
Requisitos
- Node.js 24 o posterior.
- npm 11 o posterior.
- Un proyecto Supabase configurado para autenticacion y PostgreSQL.
La API requiere SUPABASE_URL y DATABASE_URL. La PWA requiere VITE_SUPABASE_URL y VITE_SUPABASE_PUBLISHABLE_KEY. El asistente npm run setup:supabase crea los archivos locales ignorados por Git; consulta SUPABASE_SETUP.md para completar la configuracion y las migraciones.
Comandos
npm install
npm run setup:supabase
npm run db:migrate -w @ahorra/api
npm run db:security -w @ahorra/api
npm run dev
npm test
npm run typecheck
npm run build
Los tests de @ahorra/api necesitan un Postgres local (supabase start) y
TEST_DATABASE_URL. Para comprobar solo que las migraciones aplican y que las
restricciones hacen lo que dicen, sin Docker:
npm run db:verify -w @ahorra/api
Estructura
apps/web: PWA React y Vite.apps/api: API Fastify autenticada y persistencia PostgreSQL aislada por usuario.packages/domain: contratos, validaciones y calculos financieros compartidos.android: envoltorio nativo generado con Capacitor; ver MOVIL_ANDROID.md.- Documentos Markdown: especificacion funcional, UX/UI, reglas y datos.
App movil
El mismo build de apps/web se empaqueta como APK de Android con Capacitor,
contra el mismo backend de produccion. Instrucciones completas en
MOVIL_ANDROID.md.
npm run build:mobile # bundle web en modo native + cap sync
npm run mobile:open # abre el proyecto en Android Studio
Primera vertical
La version actual permite:
- Cambiar entre espacio Personal y Negocio.
- Registrar un sueldo u otro ingreso.
- Registrar gastos y movimientos programados.
- Editar ingresos y gastos para corregir o ajustar la planificacion.
- Calcular disponible antes y despues del ahorro.
- Mostrar proyeccion, categorias y actividad reciente.
- Navegar por paginas independientes de Inicio, Movimientos, Presupuesto, Metas, Reportes y Configuracion.
- Definir limites mensuales por categoria.
- Crear metas y registrar aportes que actualizan el disponible.
- Filtrar movimientos y exportar reportes CSV.
- Proteger los datos por cuenta con Supabase Auth, PostgreSQL y RLS.
- Instalar la interfaz como PWA.
