workspace-v1/orchestration/templates/HERENCIA-ERP-CORE-TEMPLATE.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
Sistema NEXUS v3.4 migrado con:

Estructura principal:
- core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles)
- core/catalog: Catalogo de funcionalidades reutilizables
- shared/knowledge-base: Base de conocimiento compartida
- devtools/scripts: Herramientas de desarrollo
- control-plane/registries: Control de servicios y CI/CD
- orchestration/: Configuracion de orquestacion de agentes

Proyectos incluidos (11):
- gamilit (submodule -> GitHub)
- trading-platform (OrbiquanTIA)
- erp-suite con 5 verticales:
  - erp-core, construccion, vidrio-templado
  - mecanicas-diesel, retail, clinicas
- betting-analytics
- inmobiliaria-analytics
- platform_marketing_content
- pos-micro, erp-basico

Configuracion:
- .gitignore completo para Node.js/Python/Docker
- gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git)
- Sistema de puertos estandarizado (3005-3199)

Generated with NEXUS v3.4 Migration System
EPIC-010: Configuracion Git y Repositorios
2026-01-04 03:37:42 -06:00

119 lines
3.2 KiB
Markdown

# Herencia de ERP-Core
**Proyecto:** {NOMBRE_PROYECTO}
**Nivel:** {STANDALONE | VERTICAL}
**Fecha:** {FECHA}
**Version ERP-Core:** 1.2.0
---
## Cadena de Herencia
```
workspace-v1/orchestration/ <- BASE PRINCIPAL
|
projects/erp-core/ <- ERP-CORE (base de datos y modulos)
|
projects/{NOMBRE_PROYECTO}/ <- ESTE PROYECTO
```
---
## Que Heredamos de ERP-Core
### Schemas de Base de Datos (12 schemas, 144 tablas)
| Schema | Tablas | Uso | Heredado |
|--------|--------|-----|----------|
| `auth_management` | 26 | Autenticacion, MFA, OAuth, roles, permisos | SI |
| `core_management` | 12 | Partners, catalogos, UoM, monedas, secuencias | SI |
| `financial_management` | 15 | Contabilidad, facturas, pagos, asientos | SI |
| `inventory_management` | 20 | Productos, stock, valoracion FIFO/AVCO, lotes | SI |
| `purchasing_management` | 8 | Ordenes de compra, proveedores | SI |
| `sales_management` | 10 | Ventas, cotizaciones, equipos | SI |
| `projects_management` | 10 | Proyectos, tareas, dependencias | SI |
| `analytics_management` | 7 | Contabilidad analitica, centros de costo | SI |
| `system_management` | 13 | Mensajes, notificaciones, logs, auditoria | SI |
| `billing_management` | 11 | SaaS/Suscripciones | OPCIONAL |
| `crm_management` | 6 | Leads, oportunidades | OPCIONAL |
| `hr_management` | 6 | Empleados, contratos, ausencias | SI |
### Variable RLS (OBLIGATORIA)
```sql
current_setting('app.current_tenant_id', true)::UUID
```
**IMPORTANTE:** Toda query debe filtrar por esta variable.
### Modulos Backend Heredados
```typescript
// Imports desde erp-core
import { AuthModule } from '@erp-core/auth';
import { UsersModule } from '@erp-core/users';
import { RolesModule } from '@erp-core/roles';
import { TenantsModule } from '@erp-core/tenants';
import { PartnersModule } from '@erp-core/partners';
// ... otros modulos
```
### Componentes Frontend Heredados
```typescript
// Imports desde erp-core
import { AuthProvider } from '@erp-core/components/auth';
import { LayoutBase } from '@erp-core/components/layout';
import { PermissionGuard } from '@erp-core/guards';
```
---
## Que Extendemos en Este Proyecto
### Schemas Propios
| Schema | Tablas | Descripcion |
|--------|--------|-------------|
| `{schema_1}` | N | {descripcion} |
| `{schema_2}` | N | {descripcion} |
### Modulos Backend Propios
- `{modulo_1}/` - {descripcion}
- `{modulo_2}/` - {descripcion}
### Componentes Frontend Propios
- `{componente_1}/` - {descripcion}
- `{componente_2}/` - {descripcion}
---
## Reglas de Extension
1. **NO modificar** tablas heredadas de erp-core
2. **Extender** mediante:
- Nuevas tablas con FK a tablas de core
- Nuevos schemas propios del vertical
3. **Mantener** la variable RLS `app.current_tenant_id`
4. **Seguir** convencion de nomenclatura de core
---
## Referencias
- DDL de erp-core: `projects/erp-core/apps/database/ddl/`
- Documentacion: `projects/erp-core/docs/`
- Guia de alineacion: `GUIA-ALINEACION-ERP-CORE.md`
---
## Validaciones Requeridas
- [ ] Variable RLS correcta en DDL
- [ ] FKs a auth.tenants (no core.*)
- [ ] Schemas propios documentados
- [ ] Imports de erp-core funcionando
- [ ] Tests pasando