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
183 lines
4.3 KiB
Markdown
183 lines
4.3 KiB
Markdown
# Contexto del Proyecto - {NOMBRE_PROYECTO}
|
|
|
|
## Identificacion
|
|
|
|
| Campo | Valor |
|
|
|-------|-------|
|
|
| **Nombre** | {NOMBRE_PROYECTO} |
|
|
| **Tipo** | Vertical ERP - {INDUSTRIA} |
|
|
| **Estado** | {En desarrollo | MVP | Produccion} |
|
|
| **Version** | {VERSION} |
|
|
| **Fecha Creacion** | {FECHA} |
|
|
|
|
---
|
|
|
|
## Descripcion
|
|
|
|
{Descripcion detallada del proyecto y su proposito}
|
|
|
|
---
|
|
|
|
## VARIABLES PARA DIRECTIVAS GLOBALES
|
|
|
|
```yaml
|
|
# Identificacion del Proyecto
|
|
PROJECT: {nombre_lowercase}
|
|
PROJECT_NAME: {NOMBRE_PROYECTO}
|
|
PROJECT_LEVEL: STANDALONE
|
|
|
|
# Paths Principales (WORKSPACE-V1)
|
|
WORKSPACE_ROOT: ~/workspace-v1
|
|
PROJECT_ROOT: ~/workspace-v1/projects/{nombre_lowercase}
|
|
APPS_ROOT: ~/workspace-v1/projects/{nombre_lowercase}/apps
|
|
DOCS_ROOT: ~/workspace-v1/projects/{nombre_lowercase}/docs
|
|
ORCHESTRATION: ~/workspace-v1/projects/{nombre_lowercase}/orchestration
|
|
|
|
# Herencia de ERP-Core
|
|
ERP_CORE_ROOT: ~/workspace-v1/projects/erp-core
|
|
HERENCIA_DOC: orchestration/00-guidelines/HERENCIA-ERP-CORE.md
|
|
|
|
# Base Orchestration (Directivas y Perfiles)
|
|
DIRECTIVAS_PATH: ~/workspace-v1/orchestration/directivas
|
|
PERFILES_PATH: ~/workspace-v1/orchestration/agents/perfiles
|
|
CATALOG_PATH: ~/workspace-v1/core/catalog
|
|
|
|
# Base de Datos
|
|
DB_NAME: {nombre_db}
|
|
DB_DDL_PATH: ~/workspace-v1/projects/{nombre_lowercase}/apps/database/ddl
|
|
DB_SCRIPTS_PATH: ~/workspace-v1/projects/{nombre_lowercase}/apps/database
|
|
DB_SEEDS_PATH: ~/workspace-v1/projects/{nombre_lowercase}/apps/database/seeds
|
|
|
|
# Backend
|
|
BACKEND_ROOT: ~/workspace-v1/projects/{nombre_lowercase}/apps/backend
|
|
BACKEND_SRC: ~/workspace-v1/projects/{nombre_lowercase}/apps/backend/src
|
|
|
|
# Frontend
|
|
FRONTEND_ROOT: ~/workspace-v1/projects/{nombre_lowercase}/apps/frontend
|
|
FRONTEND_SRC: ~/workspace-v1/projects/{nombre_lowercase}/apps/frontend/src
|
|
```
|
|
|
|
---
|
|
|
|
## HERENCIA Y DEPENDENCIAS
|
|
|
|
### Tipo de Proyecto
|
|
|
|
```yaml
|
|
NIVEL: "STANDALONE"
|
|
TIPO: "Proyecto independiente"
|
|
HEREDA_DE: "erp-core"
|
|
```
|
|
|
|
### Herencia de ERP-Core
|
|
|
|
```yaml
|
|
herencia:
|
|
tipo: "EXTIENDE"
|
|
base: "projects/erp-core"
|
|
version: "1.2.0"
|
|
documento: "orchestration/00-guidelines/HERENCIA-ERP-CORE.md"
|
|
|
|
schemas_heredados:
|
|
- auth_management (26 tablas)
|
|
- core_management (12 tablas)
|
|
- financial_management (15 tablas)
|
|
- inventory_management (20 tablas)
|
|
- purchasing_management (8 tablas)
|
|
- sales_management (10 tablas)
|
|
- projects_management (10 tablas)
|
|
- analytics_management (7 tablas)
|
|
- system_management (13 tablas)
|
|
- hr_management (6 tablas)
|
|
```
|
|
|
|
### Dependencias Externas
|
|
|
|
```yaml
|
|
dependencias:
|
|
erp_core:
|
|
documento: "orchestration/referencias/DEPENDENCIAS-ERP-CORE.yml"
|
|
|
|
shared_modules:
|
|
documento: "orchestration/referencias/DEPENDENCIAS-SHARED.yml"
|
|
```
|
|
|
|
---
|
|
|
|
## STACK TECNOLOGICO
|
|
|
|
| Capa | Tecnologia |
|
|
|------|------------|
|
|
| Backend | Node.js 20+, Express.js, TypeScript 5.3+, TypeORM |
|
|
| Frontend | React 18, Vite, TypeScript, Tailwind CSS |
|
|
| Base de Datos | PostgreSQL 15+ con RLS |
|
|
| Autenticacion | JWT + bcrypt |
|
|
|
|
---
|
|
|
|
## SCHEMAS DE BASE DE DATOS
|
|
|
|
### Heredados de ERP-Core
|
|
|
|
(Ver HERENCIA-ERP-CORE.md)
|
|
|
|
### Propios de Este Proyecto
|
|
|
|
| Schema | Proposito |
|
|
|--------|-----------|
|
|
| `{schema_1}_management` | {descripcion} |
|
|
| `{schema_2}_management` | {descripcion} |
|
|
|
|
---
|
|
|
|
## MODULOS DEL PROYECTO
|
|
|
|
### Fase 1: Foundation (Heredados)
|
|
|
|
- Autenticacion (de erp-core)
|
|
- Usuarios y Roles (de erp-core)
|
|
- Multi-Tenancy (de erp-core)
|
|
|
|
### Fase 2: Negocio Especifico
|
|
|
|
| Modulo | Descripcion | Estado |
|
|
|--------|-------------|--------|
|
|
| {modulo_1} | {descripcion} | {%} |
|
|
| {modulo_2} | {descripcion} | {%} |
|
|
|
|
---
|
|
|
|
## CONVENCIONES
|
|
|
|
### Base de Datos
|
|
|
|
- Schemas: `{dominio}_management`
|
|
- Tablas: `snake_case`
|
|
- Indices: `idx_{tabla}_{columnas}`
|
|
- FKs: `fk_{origen}_to_{destino}`
|
|
- Variable RLS: `app.current_tenant_id`
|
|
|
|
### Backend
|
|
|
|
- Archivos: `kebab-case.tipo.ts`
|
|
- Clases: `PascalCase`
|
|
- Metodos: `camelCase`
|
|
|
|
### Frontend
|
|
|
|
- Componentes: `PascalCase.tsx`
|
|
- Hooks: `use{Nombre}.ts`
|
|
- Stores: `{nombre}.store.ts`
|
|
|
|
---
|
|
|
|
## DOCUMENTACION RELACIONADA
|
|
|
|
- HERENCIA-ERP-CORE.md - Que heredamos del core
|
|
- DEPENDENCIAS-ERP-CORE.yml - Detalle de dependencias
|
|
- DEPENDENCIAS-SHARED.yml - Modulos de catalogo usados
|
|
|
|
---
|
|
|
|
**Nivel:** STANDALONE | **Sistema:** SIMCO v3.4 + CAPVED
|