AELA
AELA ERP — Comprobantes Fiscales para Ecuador.
El proyecto combina:
- facturacion electronica SRI
- notas de venta para escenarios Lite
- caja diaria
- POS
- inventario
- contabilidad
- configuracion tributaria y operativa por empresa
- soporte monoempresa y multiempresa
Stack
- Backend: Node.js, Express, Prisma, PostgreSQL
- Frontend: React, Vite, React Router, Axios
- Autenticacion: JWT
- Reportes: PDFKit y exportaciones CSV
Estructura
backend/: API, Prisma, reglas de negocio y utilidades SRIfrontend/: aplicacion web Reactdocs/: documentacion funcional y tecnica del sistema
Modos y ediciones
AELA maneja dos conceptos distintos:
Tipo de sistema
full: habilita contabilidad, ATS, retenciones y liquidacioneslite: orientado a operacion simplificada y deshabilita modulos avanzados
Modo de operacion
monoempresa: una sola empresa operativamultiempresa: permite administrar varias empresas dentro del sistema
Ambos se pueden configurar desde la pantalla Configuracion del Sistema.
Flujo inicial
- Configurar base de datos y variables de entorno.
- Ejecutar Prisma para crear tablas.
- Levantar backend y frontend.
- Entrar a
/login.
- Registrar la primera empresa y el primer administrador.
- El sistema crea automaticamente:
- configuracion base SRI
- configuracion base del sistema
- plan de cuentas base editable
Arranque rapido
Backend
cd backend
Copy-Item .env.example .env
npm install
npm run db:migrate:safe
npm run catastro:import
npm run dev
Frontend
cd frontend
Copy-Item .env.example .env
npm install
npm run dev
Variables de entorno
Backend
Archivo: backend/.env
Variables principales:
DATABASE_URLJWT_SECRETJWT_EXPIRES_INPORTNODE_ENVAELA_EDITIONMODO_EMPRESAFRONTEND_URLSMTP_*
Frontend
Archivo: frontend/.env
Variables principales:
VITE_API_URLVITE_EDITIONVITE_MODO_EMPRESA
Nota:
- hoy la edicion y el modo pueden arrancar desde
.env, pero la configuracion operativa persistida del sistema pasa a ser la referencia principal dentro de la aplicacion.
Documentacion disponible
Estado funcional actual
El sistema ya incluye:
- bootstrap inicial de empresa y administrador
- usuarios con roles
- configuracion SRI separada de configuracion operativa
- gestion de clientes, proveedores, productos y empresas
- caja diaria y cierre
- POS basico
- inventario
- compras con importacion desde XML o autorizacion SRI
- retenciones con vinculacion opcional a compras y precarga del documento sustento
- contabilidad con plan de cuentas, asientos y reportes base
Calidad y pruebas
Comandos base recomendados:
Backend
cd backend
npm test
npm run db:backup
npm run db:migrate:dev:safe -- --name nombre_del_cambio
npm run catastro:import
Notas de seguridad para Prisma:
- No usar
prisma db push --accept-data-loss sobre bases con datos.
db:migrate:safe crea backup con pg_dump, ejecuta migraciones y restaura automáticamente si la migración falla.catastro:import carga por defecto los CSV oficiales de docs/datosRuc en contribuyentes_sri.
Frontend
cd frontend
npm test
npm run lint
npm run build
Además, el repositorio ya incluye un workflow base de CI en .github/workflows/ci.yml para ejecutar estas validaciones automáticamente en push y pull_request.
La cobertura automatizada ya valida una base inicial de:
- utilidades críticas de backend
- permisos y restricciones por plan
- helpers de sesión y acceso en frontend
- reglas base del flujo compra -> retención
También quedó saneado el frontend operativo para dejar npm run lint sin warnings, incluyendo:
- separación del hook
useAuth del provider para evitar exports mixtos
- estabilización de
useEffect y callbacks en caja, declaraciones, facturación, retenciones, notas de venta e inventario
- limpieza de variables y capturas sin uso en componentes y utilidades offline
- carga diferida por rutas en
App.jsx para reducir el peso del arranque inicial
- eliminación del warning de Vite por import mixto de
offlineDB en la cola offline
Seguimiento
Para ver claramente:
- lo implementado
- lo validado
- lo pendiente
- los riesgos operativos
revisar Estado del Proyecto.
Observaciones
- La configuracion de produccion SRI debe validarse cuidadosamente antes de emitir comprobantes reales.
- El plan de cuentas base es un punto de partida y el contador puede editarlo segun la necesidad de la empresa.
