ecom-erp
Sistema open source de comercio y contabilidad para retail pequeño. Arquitectura monolítica con frontend/admin separados en Next.js/React/Node. Contabilidad basada en libros diarios inmutables, dinero entero (cents) e inventario por movimientos.
Ficha actualizada 22 sept 2026, 15:23 · upstream 22 sept 2026, 5:08 · release sin release detectada
Qué es ecom-erp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
ecom-erp es un sistema open source diseñado para pequeños comercios de retail que combina una tienda online y un sistema contable en un único código base. La arquitectura utiliza Next.js, React y Node.js, con despliegue simplificado mediante Docker y Docker Compose. El sistema prioriza la integridad financiera sobre la complejidad empresarial, evitando ediciones directas a registros contables y utilizando reversales para correcciones.
El sistema se distingue por su enfoque en la transparencia: los estados financieros (Balance Sheet, P&L) se derivan directamente de los libros diarios, el inventario es un libro de movimientos inmutable y no una cifra estática. La instalación inicial es intencionalmente vacía, sin datos falsos, guiando al usuario a configurar la identidad de la empresa desde cero.
La contabilidad sigue reglas estrictas: el dinero se maneja en enteros (cents), los periodos cerrados fallan por defecto y las transacciones de inventario solo afectan al libro mayor a través de un punto único de publicación. Aunque el sistema es funcional, su CI es nuevo y no incluye builds de frontend, y las aplicaciones móviles son versiones de desarrollo sin APK publicado.
- Gestión integral de tienda online con catálogo, carrito y checkout (incluyendo pago contra entrega).
- Contabilidad automatizada basada en libros diarios inmutables para generar balances y P&L.
- Control de inventario mediante libro de movimientos (entradas/salidas) sin ediciones directas.
- Gestión de proveedores, órdenes de compra y conciliación de cuentas por pagar.
- Libros diarios inmutables: correcciones se hacen vía reversales, nunca editando registros originales.
- Dinero entero (cents): rechazo automático de decimales sub-cent para evitar errores de redondeo.
- Inventario derivado: el stock en mano se calcula desde movimientos históricos, no se escribe directamente.
- Periodos cerrados fallan por defecto: ninguna transacción o reversal puede afectar periodos cerrados.
- Instalación limpia sin datos falsos: la primera ejecución es un estado vacío para configuración real.
- CI nuevo y no probado: los builds de frontend aún no están incluidos en el pipeline de CI.
- Apps móviles solo dev: disponibles vía Expo Go, sin APK publicado ni repositorios separados.
- Gaps conocidos: stock-check móvil intermitente entre columnas legacy y movimientos derivados.
- Funcionalidades pendientes: Paymob planeado pero no implementado; contabilidad de valoración diferida pendiente.
- Tests mutan DB: la suite de pruebas modifica la base de datos en desarrollo (requiere modo aislado para CI).
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere 4 núcleos CPU, 4GB RAM y 10GB disco. Desplegar con Docker Compose. Ejecutar `npm test` en servidor para validar suite unitaria (371 tests) e integración (107 tests). Usar `test:isolated` para CI seguro. Verificar builds de frontend manualmente (`client-admin/npm run build`, `client/npm run build`). Configurar variables de entorno antes del primer despliegue.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.