workspace-v1/04-fase-proyectos/erp-suite/README.md

FASE 4.2: MIGRACION ERP SUITE

Proyecto: ERP Suite (Multi-Vertical) Estado: Pendiente Prioridad: P1 Complejidad: Alta Dependencias: Fase 4.1 (Gamilit) completada

---

OBJETIVO

Migrar ERP Suite al nuevo modelo de repositorio, considerando:

1. Estructura multi-vertical (core + verticales especializadas)
2. Service descriptors para core y cada vertical
3. Docker compose por vertical con redes aisladas
4. Codigo compartido entre verticales (erp-core)

---

INFORMACION DEL PROYECTO

Datos Generales

Campo	Valor
Nombre	ERP Suite
Tipo	Suite ERP Multi-Vertical
Estado	En desarrollo
Stack Backend	Express + TypeScript
Stack Frontend	React + TypeScript
Base de Datos	PostgreSQL (una por vertical)

Verticales

Vertical	Estado	BD
erp-core	Base	erp_core_db
construccion	Activo	erp_construccion_db
mecanicas-diesel	Activo	erp_mecanicas_db
vidrio-templado	Planificado	-
retail	Planificado	-
clinicas	Planificado	-

Ubicacion Actual

/home/adrian/Documentos/workspace/projects/erp-suite/
|
+-- apps/
|     +-- erp-core/
|     |     +-- backend/
|     |     +-- frontend/
|     +-- verticales/
|           +-- construccion/
|           +-- mecanicas-diesel/
|           +-- ...
+-- docker/
+-- orchestration/

---

ESTRUCTURA OBJETIVO

erp-suite/
|
+-- apps/
|     +-- erp-core/
|     |     +-- backend/
|     |     |     +-- service.descriptor.yml
|     |     |     +-- src/
|     |     |     +-- package.json
|     |     |     +-- Dockerfile
|     |     +-- frontend/
|     |     |     +-- service.descriptor.yml
|     |     +-- database/
|     |           +-- ddl/
|     |           +-- seeds/
|     |
|     +-- verticales/
|           +-- construccion/
|           |     +-- backend/
|           |     |     +-- service.descriptor.yml
|           |     +-- frontend/
|           |     +-- database/
|           |
|           +-- mecanicas-diesel/
|           |     +-- backend/
|           |     |     +-- service.descriptor.yml
|           |     +-- frontend/
|           |     +-- database/
|           |
|           +-- vidrio-templado/
|           +-- retail/
|           +-- clinicas/
|
+-- docker/
|     +-- docker-compose.yml            # Core services
|     +-- docker-compose.construccion.yml
|     +-- docker-compose.mecanicas.yml
|     +-- docker-compose.override.yml   # Dev overrides
|     +-- .env.example
|
+-- orchestration/
|     +-- inventarios/
|     |     +-- SUITE_MASTER_INVENTORY.yml
|     +-- 00-guidelines/
|
+-- docs/
|
+-- package.json
+-- README.md

---

COMPLEJIDADES ESPECIALES

1. Codigo Compartido (erp-core)

El erp-core contiene:

• Autenticacion compartida
• Modelos base
• Utilidades comunes
• UI components compartidos

Las verticales extienden erp-core.

2. Bases de Datos Separadas

Cada vertical tiene su propia BD pero comparten:

• Schema de autenticacion
• Schema de configuracion

3. Docker Compose por Vertical

# docker-compose.construccion.yml
# Extiende docker-compose.yml (core)

services:
  construccion-api:
    extends:
      file: docker-compose.yml
      service: erp-api-template
    # ... overrides especificos

4. Puertos por Vertical

Segun ports.registry.yml:

• erp-core: 3010, 3011
• construccion: 3012, 3013
• mecanicas: 3014, 3015
• vidrio: 3016, 3017
• retail: 3018, 3019

---

TAREAS DE MIGRACION

Ver PLANEACION/00-TAREAS.md para detalle completo.

Resumen

Grupo	Descripcion	Esfuerzo
Estructura	Crear carpetas y root files	3 horas
Core	Migrar erp-core	4 horas
Verticales	Migrar verticales activas	6 horas
Docker	Crear compose files	4 horas
Validacion	Probar todo	3 horas
TOTAL		20 horas

---

DOCUMENTOS DE ESTA FASE

04-fase-proyectos/erp-suite/
|
+-- README.md                  # Este archivo
+-- ANALISIS/
|     +-- 00-PLAN-ANALISIS.md
|     +-- 01-INVENTARIO-ACTUAL.md
|     +-- 02-VERTICALES.md
|     +-- 03-DEPENDENCIAS.md
+-- PLANEACION/
|     +-- 00-TAREAS.md
|     +-- 01-ESTRUCTURA-MULTIVERTICAL.md
+-- IMPLEMENTACION/
|     +-- 00-EJECUCION.md
+-- PROMPTS/
|     +-- PROMPT-MIGRATION-AGENT.md
+-- VALIDACION/
      +-- CHECKLIST.md

---

SIGUIENTE PASO

1. Completar migracion de Gamilit (Fase 4.1)
2. Ejecutar analisis de ERP Suite
3. Migrar erp-core primero
4. Migrar verticales una por una

---

Agente Responsable: Tech-Leader + Backend-Agent