277 lines
11 KiB
Markdown
277 lines
11 KiB
Markdown
# ERP Suite - Sistema ERP Multi-Vertical
|
|
|
|
## Descripción
|
|
|
|
Suite ERP/CRM/POS con soporte para múltiples verticales de negocio, diseñado para SaaS simple autocontratado y proyectos integrales personalizados.
|
|
|
|
**Estado General:** En desarrollo activo
|
|
**Migrado desde:** workspace-erp-inmobiliaria (Diciembre 2025)
|
|
|
|
## Verticales Soportados
|
|
|
|
| Vertical | Estado | Descripción |
|
|
|----------|--------|-------------|
|
|
| **ERP Core** | 60% | Base genérica reutilizable (autenticación, usuarios, catálogos) |
|
|
| **Construcción** | 35% | Gestión de proyectos de construcción, INFONAVIT, presupuestos |
|
|
| **Vidrio Templado** | 0% | Producción, calidad, trazabilidad de lotes |
|
|
| **Mecánicas Diesel** | 0% | Talleres, diagnósticos, reparaciones, refacciones |
|
|
| **Retail** | 0% | Punto de venta, inventario |
|
|
| **Clínicas** | 0% | Gestión de pacientes, citas |
|
|
|
|
## Stack Tecnológico
|
|
|
|
| Capa | Tecnología |
|
|
|------|------------|
|
|
| **Backend** | Node.js 20+, Express.js, TypeScript 5.3+, TypeORM |
|
|
| **Frontend Web** | React 18, Vite, TypeScript, Tailwind CSS |
|
|
| **Frontend Mobile** | React Native |
|
|
| **Base de Datos** | PostgreSQL 15+ con RLS (Row-Level Security) |
|
|
| **Autenticación** | JWT, bcryptjs |
|
|
| **Validación** | Zod, class-validator |
|
|
|
|
## Estructura del Proyecto (Autocontenida por Proyecto)
|
|
|
|
**Cada proyecto (erp-core y cada vertical) es autocontenido** con su propia documentación y sistema de orquestación para trazabilidad completa.
|
|
|
|
```
|
|
erp-suite/
|
|
├── apps/
|
|
│ ├── erp-core/ # ERP Base (60-70% compartido)
|
|
│ │ ├── backend/ # Node.js + Express + TypeScript
|
|
│ │ ├── frontend/ # React + Vite + Tailwind
|
|
│ │ ├── database/ # PostgreSQL DDL, migrations, seeds
|
|
│ │ ├── docs/ # Documentación PROPIA del core
|
|
│ │ └── orchestration/ # Sistema de agentes PROPIO
|
|
│ │ ├── 00-guidelines/CONTEXTO-PROYECTO.md
|
|
│ │ ├── trazas/ # Historial de tareas por agente
|
|
│ │ ├── estados/ # Estado de agentes
|
|
│ │ └── PROXIMA-ACCION.md
|
|
│ │
|
|
│ ├── verticales/
|
|
│ │ ├── construccion/ # Vertical INFONAVIT (35%)
|
|
│ │ │ ├── backend/
|
|
│ │ │ ├── frontend/
|
|
│ │ │ ├── database/
|
|
│ │ │ ├── docs/ # 403+ docs migrados (5.9 MB)
|
|
│ │ │ │ ├── 01-fase-alcance-inicial/ # 15 módulos MAI-*
|
|
│ │ │ │ ├── 02-fase-enterprise/ # 3 épicas MAE-*
|
|
│ │ │ │ └── 02-modelado/ # Schemas SQL
|
|
│ │ │ └── orchestration/ # Sistema de agentes PROPIO
|
|
│ │ │ ├── 00-guidelines/CONTEXTO-PROYECTO.md
|
|
│ │ │ ├── trazas/
|
|
│ │ │ ├── estados/
|
|
│ │ │ └── PROXIMA-ACCION.md
|
|
│ │ │
|
|
│ │ ├── vidrio-templado/ # Vertical (0%)
|
|
│ │ │ ├── docs/
|
|
│ │ │ └── orchestration/
|
|
│ │ │
|
|
│ │ ├── mecanicas-diesel/ # Vertical (0%)
|
|
│ │ │ ├── docs/
|
|
│ │ │ └── orchestration/
|
|
│ │ │
|
|
│ │ ├── retail/ # Vertical Punto de Venta
|
|
│ │ └── clinicas/ # Vertical Clínicas
|
|
│ │
|
|
│ ├── saas/ # Capa SaaS (billing)
|
|
│ └── shared-libs/ # Librerías compartidas
|
|
│
|
|
├── docs/ # Documentación GENERAL del suite
|
|
│ ├── 00-overview/ # Visión general, arquitectura
|
|
│ ├── 01-requerimientos/ # Requerimientos transversales
|
|
│ └── ...
|
|
│
|
|
└── orchestration/ # Orquestación GENERAL del suite
|
|
├── 00-guidelines/
|
|
└── legacy-reference/ # Sistema migrado (referencia)
|
|
```
|
|
|
|
### Estructura de Cada Proyecto (Patrón Autocontenido)
|
|
|
|
Cada proyecto sigue esta estructura estándar:
|
|
|
|
```
|
|
{proyecto}/
|
|
├── backend/ # Código backend
|
|
├── frontend/ # Código frontend
|
|
├── database/ # DDL, migrations, seeds
|
|
├── docs/ # Documentación PROPIA
|
|
│ ├── 00-vision-general/
|
|
│ ├── 01-fase-mvp/
|
|
│ ├── 02-modelado/
|
|
│ └── 90-transversal/
|
|
└── orchestration/ # Sistema de agentes PROPIO
|
|
├── 00-guidelines/
|
|
│ └── CONTEXTO-PROYECTO.md # Contexto específico
|
|
├── trazas/ # Historial por agente
|
|
│ ├── TRAZA-TAREAS-BACKEND.md
|
|
│ ├── TRAZA-TAREAS-FRONTEND.md
|
|
│ └── TRAZA-TAREAS-DATABASE.md
|
|
├── estados/
|
|
│ └── ESTADO-AGENTES.json
|
|
└── PROXIMA-ACCION.md # Siguiente tarea
|
|
```
|
|
|
|
## Módulos ERP Construcción (Migrados)
|
|
|
|
### Fase 1: Alcance Inicial (15 módulos)
|
|
| Código | Módulo | Descripción |
|
|
|--------|--------|-------------|
|
|
| MAI-001 | Fundamentos | Autenticación, usuarios, roles, permisos |
|
|
| MAI-002 | Proyectos | Gestión de proyectos y estructura |
|
|
| MAI-003 | Presupuestos | Presupuestos y control de costos |
|
|
| MAI-004 | Compras | Compras e inventarios |
|
|
| MAI-005 | Control de Obra | Avances y recursos |
|
|
| MAI-006 | Reportes | Analytics y reportería |
|
|
| MAI-007 | RRHH | Recursos humanos y asistencias |
|
|
| MAI-008 | Estimaciones | Estimaciones y facturación |
|
|
| MAI-009 | Calidad | Calidad y postventa |
|
|
| MAI-010 | CRM | CRM Derechohabientes |
|
|
| MAI-011 | INFONAVIT | Integración INFONAVIT |
|
|
| MAI-012 | Contratos | Contratos y subcontratos |
|
|
| MAI-013 | Administración | Seguridad y administración |
|
|
| MAI-018 | Preconstrucción | Licitaciones |
|
|
|
|
### Fase 2: Enterprise (3 épicas - 210 SP)
|
|
| Código | Épica | Story Points |
|
|
|--------|-------|--------------|
|
|
| MAE-014 | Finanzas y Controlling de Obra | 80 SP |
|
|
| MAE-015 | Activos, Maquinaria y Mantenimiento | 70 SP |
|
|
| MAE-016 | Gestión Documental (DMS) | 60 SP |
|
|
|
|
### Fase 3: Avanzada
|
|
| Código | Épica |
|
|
|--------|-------|
|
|
| MAA-017 | Seguridad HSE (Health, Safety & Environment) |
|
|
|
|
## Arquitectura
|
|
|
|
### Modelo de Reutilización
|
|
- **erp-core:** 60-70% del código base compartido
|
|
- **verticales:** Extensiones específicas por giro de negocio
|
|
- **saas:** Capa de autocontratación y billing multi-tenant
|
|
|
|
### Schemas de Base de Datos (PostgreSQL)
|
|
| Schema | Descripción |
|
|
|--------|-------------|
|
|
| `auth_management` | Autenticación, usuarios, roles, permisos |
|
|
| `project_management` | Proyectos, desarrollos, fases, viviendas |
|
|
| `financial_management` | Presupuestos, estimaciones, costos |
|
|
| `purchasing_management` | Compras, proveedores, inventarios |
|
|
| `construction_management` | Avances, recursos, materiales |
|
|
| `quality_management` | Inspecciones, pruebas, no conformidades |
|
|
| `infonavit_management` | Integración INFONAVIT |
|
|
|
|
### Orden de Desarrollo Recomendado
|
|
1. **Fase 1:** ERP Genérico (erp-core) - Base compartida
|
|
2. **Fase 2:** ERP Construcción (vertical) - Más avanzado
|
|
3. **Fase 3:** ERP Vidrio Templado (vertical)
|
|
4. **Fase 4:** Demás verticales según demanda
|
|
|
|
## Patrones de Referencia
|
|
|
|
Los patrones de diseno estan basados en Odoo:
|
|
- `knowledge-base/patterns/PATRON-CORE-ODOO.md`
|
|
- `knowledge-base/patterns/PATRON-INVENTARIO-ODOO.md`
|
|
- `knowledge-base/patterns/PATRON-CONTABILIDAD-ODOO.md`
|
|
|
|
## Directivas y Documentacion
|
|
|
|
### Principio Fundamental
|
|
> **"Primero documentar, despues desarrollar"**
|
|
|
|
Toda la documentacion debe existir ANTES de iniciar cualquier desarrollo.
|
|
|
|
### Directivas ERP Core
|
|
|
|
| Directiva | Proposito |
|
|
|-----------|-----------|
|
|
| `DIRECTIVA-DOCUMENTACION-PRE-DESARROLLO.md` | Documentar antes de desarrollar |
|
|
| `DIRECTIVA-PATRONES-ODOO.md` | Patrones de diseno basados en Odoo |
|
|
| `DIRECTIVA-HERENCIA-MODULOS.md` | Como las verticales extienden el core |
|
|
| `DIRECTIVA-MULTI-TENANT.md` | Aislamiento por tenant_id |
|
|
| `DIRECTIVA-EXTENSION-VERTICALES.md` | Arquitectura de extensiones |
|
|
| `ESTANDARES-API-REST-GENERICO.md` | APIs REST consistentes |
|
|
|
|
Ubicacion: `apps/erp-core/orchestration/directivas/`
|
|
|
|
### Herencia de Directivas
|
|
|
|
```
|
|
CORE (Global) → /home/isem/workspace/core/orchestration/directivas/
|
|
↓ hereda
|
|
ERP-CORE → apps/erp-core/orchestration/directivas/
|
|
↓ hereda
|
|
VERTICALES → apps/verticales/{vertical}/orchestration/directivas/
|
|
```
|
|
|
|
### Estructura de Documentacion
|
|
|
|
Ver: `docs/ESTRUCTURA-DOCUMENTACION-ERP.md`
|
|
|
|
```
|
|
docs/
|
|
├── 00-vision-general/ # Vision y arquitectura
|
|
├── 01-requerimientos/ # RF y RNF por modulo
|
|
├── 02-modelado/ # ERD, DDL, especificaciones
|
|
├── 03-user-stories/ # Historias por modulo
|
|
├── 04-test-plans/ # Planes de prueba
|
|
└── 90-transversal/ # Seguridad, multi-tenancy
|
|
```
|
|
|
|
## Inicio Rápido
|
|
|
|
```bash
|
|
# === ERP CORE ===
|
|
# Ver contexto del proyecto
|
|
cat apps/erp-core/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
|
|
|
|
# Ver siguiente tarea
|
|
cat apps/erp-core/orchestration/PROXIMA-ACCION.md
|
|
|
|
# Instalar dependencias
|
|
cd apps/erp-core/backend && npm install
|
|
cd apps/erp-core/frontend && npm install
|
|
|
|
# === VERTICAL CONSTRUCCIÓN ===
|
|
# Ver contexto del proyecto
|
|
cat apps/verticales/construccion/orchestration/00-guidelines/CONTEXTO-PROYECTO.md
|
|
|
|
# Ver siguiente tarea
|
|
cat apps/verticales/construccion/orchestration/PROXIMA-ACCION.md
|
|
|
|
# Ver documentación (403+ archivos)
|
|
ls apps/verticales/construccion/docs/
|
|
|
|
# Ver módulos de Fase 1
|
|
ls apps/verticales/construccion/docs/01-fase-alcance-inicial/
|
|
|
|
# === TRAZAS DE AGENTES ===
|
|
# Ver historial de tareas por agente
|
|
cat apps/erp-core/orchestration/trazas/TRAZA-TAREAS-BACKEND.md
|
|
cat apps/verticales/construccion/orchestration/trazas/TRAZA-TAREAS-BACKEND.md
|
|
|
|
# Ver estado de agentes
|
|
cat apps/erp-core/orchestration/estados/ESTADO-AGENTES.json
|
|
```
|
|
|
|
## Migración Completada
|
|
|
|
Este proyecto incluye código y documentación migrada desde:
|
|
- `[RUTA-LEGACY-ELIMINADA]/`
|
|
|
|
### Contenido Migrado
|
|
- **403 archivos Markdown** de documentación técnica
|
|
- **11 archivos SQL** (DDL, RLS policies)
|
|
- **Código fuente** de backend, frontend y database
|
|
- **Sistema de orquestación** legacy (referencia)
|
|
|
|
### Verticales Migradas
|
|
- `erp-construccion` → `apps/verticales/construccion/`
|
|
- `erp-generic` → `apps/erp-core/`
|
|
- `erp-vidrio-templado` → `apps/verticales/vidrio-templado/`
|
|
- `erp-mecanicas-diesel` → `apps/verticales/mecanicas-diesel/`
|
|
|
|
---
|
|
*Proyecto parte del workspace de Fábrica de Software con Agentes IA - Sistema NEXUS*
|