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

# === 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