rckrdmrd/erp-suite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
erp-suite/README.md

11 KiB
Raw Permalink Blame History

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