workspace-v1/04-fase-proyectos/erp-suite/README.md
Adrian Flores Cortes 967ab360bb Initial commit: Workspace v1 with 3-layer architecture
Structure:
- control-plane/: Registries, SIMCO directives, CI/CD templates
- projects/: Gamilit, ERP-Suite, Trading-Platform, Betting-Analytics
- shared/: Libs catalog, knowledge-base

Key features:
- Centralized port, domain, database, and service registries
- 23 SIMCO directives + 6 fundamental principles
- NEXUS agent profiles with delegation rules
- Validation scripts for workspace integrity
- Dockerfiles for all services
- Path aliases for quick reference

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-23 00:35:19 -06:00

214 lines
4.5 KiB
Markdown

# 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
```yaml
# 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