[TASK-2026-01-24-ESTANDAR-ORCHESTRATION] feat: Add missing orchestration files
- Add _inheritance.yml (PROVIDER type definition) - Add _MAP.md (navigation map) - Add PROJECT-PROFILE.yml (project metadata) - Add DEPENDENCY-GRAPH.yml (dependencies) - Add TRACEABILITY.yml (version history) - Add MAPA-DOCUMENTACION.yml (documentation map) Complies with SIMCO-ESTANDAR-ORCHESTRATION.md v1.0.0 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
parent
75a489a5d8
commit
4597c27fc5
189
orchestration/DEPENDENCY-GRAPH.yml
Normal file
189
orchestration/DEPENDENCY-GRAPH.yml
Normal file
@ -0,0 +1,189 @@
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# DEPENDENCY-GRAPH.yml - Template SaaS
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
#
|
||||
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
|
||||
# Propósito: Grafo de dependencias del proyecto
|
||||
# Fecha: 2026-01-24
|
||||
#
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
version: "1.0.0"
|
||||
proyecto: "template-saas"
|
||||
tipo: "PROVIDER"
|
||||
fecha_actualizacion: "2026-01-24"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# DEPENDENCIAS ENTRANTES (De quién depende este proyecto)
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
depende_de:
|
||||
workspace:
|
||||
- ruta: "orchestration/directivas/simco/"
|
||||
tipo: "directivas"
|
||||
descripcion: "Directivas SIMCO del workspace"
|
||||
|
||||
- ruta: "shared/catalog/"
|
||||
tipo: "codigo"
|
||||
descripcion: "Catálogo de funcionalidades compartidas"
|
||||
|
||||
externos:
|
||||
- nombre: "PostgreSQL"
|
||||
version: "15+"
|
||||
tipo: "database"
|
||||
|
||||
- nombre: "Redis"
|
||||
version: "7+"
|
||||
tipo: "cache"
|
||||
|
||||
- nombre: "Node.js"
|
||||
version: "20+"
|
||||
tipo: "runtime"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# DEPENDENCIAS SALIENTES (Quién depende de este proyecto)
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
consumidores:
|
||||
intermediate:
|
||||
- proyecto: "erp-core"
|
||||
tipo: "INTERMEDIATE"
|
||||
hereda:
|
||||
- "arquitectura multi-tenant"
|
||||
- "patrones de API"
|
||||
- "estructura de frontend"
|
||||
- "esquema de auth"
|
||||
sla_propagacion: "72h"
|
||||
|
||||
standalone:
|
||||
- proyecto: "gamilit"
|
||||
tipo: "STANDALONE"
|
||||
hereda:
|
||||
- "arquitectura base"
|
||||
- "patrones de auth"
|
||||
sla_propagacion: "1 semana"
|
||||
|
||||
- proyecto: "michangarrito"
|
||||
tipo: "STANDALONE"
|
||||
hereda:
|
||||
- "arquitectura base"
|
||||
sla_propagacion: "1 semana"
|
||||
|
||||
- proyecto: "trading-platform"
|
||||
tipo: "STANDALONE"
|
||||
hereda:
|
||||
- "arquitectura base"
|
||||
- "patrones de API"
|
||||
sla_propagacion: "1 semana"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# DEPENDENCIAS INTERNAS (Entre módulos del proyecto)
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
dependencias_internas:
|
||||
backend:
|
||||
auth:
|
||||
depende_de:
|
||||
- "users"
|
||||
- "common"
|
||||
- "config"
|
||||
consumidores:
|
||||
- "todos los módulos"
|
||||
|
||||
users:
|
||||
depende_de:
|
||||
- "companies"
|
||||
- "common"
|
||||
consumidores:
|
||||
- "auth"
|
||||
|
||||
companies:
|
||||
depende_de:
|
||||
- "common"
|
||||
consumidores:
|
||||
- "users"
|
||||
- "todos los módulos con tenant"
|
||||
|
||||
frontend:
|
||||
auth:
|
||||
depende_de:
|
||||
- "common"
|
||||
- "hooks"
|
||||
consumidores:
|
||||
- "layout"
|
||||
- "routes"
|
||||
|
||||
dashboard:
|
||||
depende_de:
|
||||
- "auth"
|
||||
- "layout"
|
||||
- "common"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# GRAFO VISUAL
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
grafo_visual: |
|
||||
workspace-v2/orchestration/
|
||||
│
|
||||
▼
|
||||
┌─────────────────────────────────────────────────┐
|
||||
│ template-saas (PROVIDER) │
|
||||
│ │
|
||||
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
|
||||
│ │ auth │◄─┤ users │◄─┤companies │ │
|
||||
│ └────┬─────┘ └──────────┘ └──────────┘ │
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ [APIs exportadas] │
|
||||
└─────────────────────────────────────────────────┘
|
||||
│
|
||||
├───────────────────────────────────────┐
|
||||
│ │
|
||||
▼ ▼
|
||||
┌─────────────────────┐ ┌─────────────────┐
|
||||
│ erp-core │ │ gamilit │
|
||||
│ (INTERMEDIATE) │ │ (STANDALONE) │
|
||||
│ │ └─────────────────┘
|
||||
│ │ │
|
||||
│ ▼ │
|
||||
│ [5 verticales ERP] │
|
||||
└─────────────────────┘
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# IMPACTO DE CAMBIOS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
impacto_cambios:
|
||||
alto:
|
||||
- modulo: "auth"
|
||||
razon: "Todos los proyectos dependen del sistema de autenticación"
|
||||
accion: "Notificar a TODOS los consumidores antes de cambio"
|
||||
|
||||
- modulo: "database/core-schema"
|
||||
razon: "Esquema base heredado por todos"
|
||||
accion: "Migración coordinada requerida"
|
||||
|
||||
medio:
|
||||
- modulo: "users"
|
||||
razon: "Afecta gestión de usuarios en consumidores"
|
||||
accion: "Propagación según SLA"
|
||||
|
||||
- modulo: "companies"
|
||||
razon: "Afecta multi-tenancy"
|
||||
accion: "Propagación según SLA"
|
||||
|
||||
bajo:
|
||||
- modulo: "common"
|
||||
razon: "Utilidades genéricas"
|
||||
accion: "Propagación normal"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# NOTAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
notas:
|
||||
- "Como PROVIDER, cualquier cambio breaking requiere coordinación"
|
||||
- "Mantener retrocompatibilidad en APIs públicas"
|
||||
- "Documentar cambios en CHANGELOG antes de propagar"
|
||||
- "Security fixes se propagan inmediatamente (no esperar SLA)"
|
||||
186
orchestration/MAPA-DOCUMENTACION.yml
Normal file
186
orchestration/MAPA-DOCUMENTACION.yml
Normal file
@ -0,0 +1,186 @@
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# MAPA-DOCUMENTACION.yml - Template SaaS
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
#
|
||||
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
|
||||
# Propósito: Mapa de toda la documentación del proyecto
|
||||
# Fecha: 2026-01-24
|
||||
#
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
version: "1.0.0"
|
||||
proyecto: "template-saas"
|
||||
tipo: "PROVIDER"
|
||||
fecha_actualizacion: "2026-01-24"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# DOCUMENTACIÓN PRINCIPAL (orchestration/)
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
orchestration:
|
||||
navegacion:
|
||||
- archivo: "_MAP.md"
|
||||
proposito: "Mapa de navegación visual"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "_INDEX.md"
|
||||
proposito: "Índice legacy (deprecated)"
|
||||
estado: "deprecated"
|
||||
nota: "Usar _MAP.md en su lugar"
|
||||
|
||||
configuracion:
|
||||
- archivo: "_inheritance.yml"
|
||||
proposito: "Define herencia PROVIDER"
|
||||
estado: "completo"
|
||||
critico: true
|
||||
|
||||
- archivo: "BOOTLOADER.md"
|
||||
proposito: "Protocolo de arranque NEXUS"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "CONTEXT-MAP.yml"
|
||||
proposito: "Mapa de contexto para agentes"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "PROJECT-PROFILE.yml"
|
||||
proposito: "Perfil y metadata del proyecto"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "PROJECT-STATUS.md"
|
||||
proposito: "Estado actual del proyecto"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "PROXIMA-ACCION.md"
|
||||
proposito: "Checkpoint de sesión"
|
||||
estado: "activo"
|
||||
|
||||
trazabilidad:
|
||||
- archivo: "DEPENDENCY-GRAPH.yml"
|
||||
proposito: "Grafo de dependencias"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "TRACEABILITY.yml"
|
||||
proposito: "Historial de cambios y propagaciones"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "MAPA-DOCUMENTACION.yml"
|
||||
proposito: "Este archivo"
|
||||
estado: "completo"
|
||||
|
||||
subcarpetas:
|
||||
00-guidelines:
|
||||
- archivo: "CONTEXTO-PROYECTO.md"
|
||||
proposito: "Contexto general del proyecto"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "HERENCIA-SIMCO.md"
|
||||
proposito: "Cómo hereda directivas"
|
||||
estado: "completo"
|
||||
|
||||
inventarios:
|
||||
- archivo: "MASTER_INVENTORY.yml"
|
||||
proposito: "Inventario maestro consolidado"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "DATABASE_INVENTORY.yml"
|
||||
proposito: "Inventario de tablas DDL"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "BACKEND_INVENTORY.yml"
|
||||
proposito: "Inventario de entidades y servicios"
|
||||
estado: "completo"
|
||||
|
||||
- archivo: "FRONTEND_INVENTORY.yml"
|
||||
proposito: "Inventario de componentes"
|
||||
estado: "completo"
|
||||
|
||||
trazas:
|
||||
- archivo: "TRAZA-TAREAS-DATABASE.md"
|
||||
proposito: "Historial de tareas DDL"
|
||||
estado: "activo"
|
||||
|
||||
- archivo: "TRAZA-TAREAS-BACKEND.md"
|
||||
proposito: "Historial de tareas backend"
|
||||
estado: "activo"
|
||||
|
||||
- archivo: "TRAZA-TAREAS-FRONTEND.md"
|
||||
proposito: "Historial de tareas frontend"
|
||||
estado: "activo"
|
||||
|
||||
analisis:
|
||||
- archivo: "_INDEX.md"
|
||||
proposito: "Índice de análisis realizados"
|
||||
estado: "completo"
|
||||
nota: "Contiene 60+ archivos de análisis históricos"
|
||||
|
||||
planes:
|
||||
- archivo: "HISTORICO-SPRINTS.md"
|
||||
proposito: "Historial de sprints completados"
|
||||
estado: "activo"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# DOCUMENTACIÓN DE USUARIO (docs/)
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
docs:
|
||||
nota: "Documentación de usuario del proyecto"
|
||||
ubicacion: "projects/template-saas/docs/"
|
||||
estado: "parcial"
|
||||
|
||||
carpetas:
|
||||
- nombre: "00-vision-general/"
|
||||
estado: "pendiente"
|
||||
|
||||
- nombre: "10-arquitectura/"
|
||||
estado: "parcial"
|
||||
|
||||
- nombre: "70-onboarding/"
|
||||
estado: "pendiente"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# DOCUMENTACIÓN DE CÓDIGO
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
codigo:
|
||||
backend:
|
||||
ubicacion: "projects/template-saas/backend/"
|
||||
readme: "README.md"
|
||||
estado: "completo"
|
||||
|
||||
frontend:
|
||||
ubicacion: "projects/template-saas/frontend/"
|
||||
readme: "README.md"
|
||||
estado: "parcial"
|
||||
|
||||
database:
|
||||
ubicacion: "projects/template-saas/database/"
|
||||
readme: "README.md"
|
||||
ddl: "ddl/"
|
||||
estado: "completo"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# ESTADÍSTICAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
estadisticas:
|
||||
total_archivos_orchestration: 85
|
||||
archivos_obligatorios_completos: 10
|
||||
archivos_obligatorios_total: 10
|
||||
cobertura_obligatorios: "100%"
|
||||
|
||||
por_carpeta:
|
||||
root: 12
|
||||
00-guidelines: 2
|
||||
inventarios: 4
|
||||
trazas: 4
|
||||
analisis: 60+
|
||||
planes: 2
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# NOTAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
notas:
|
||||
- "Template-saas es PROVIDER - su documentación es referencia para consumidores"
|
||||
- "Mantener actualizado con cada nuevo archivo creado"
|
||||
- "La carpeta analisis/ contiene histórico extenso de fases de desarrollo"
|
||||
154
orchestration/PROJECT-PROFILE.yml
Normal file
154
orchestration/PROJECT-PROFILE.yml
Normal file
@ -0,0 +1,154 @@
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# PROJECT-PROFILE.yml - Template SaaS
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
#
|
||||
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
|
||||
# Propósito: Perfil y metadata del proyecto
|
||||
# Fecha: 2026-01-24
|
||||
#
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# IDENTIFICACIÓN
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
proyecto:
|
||||
nombre: "Template SaaS"
|
||||
codigo: "template-saas"
|
||||
tipo: "PROVIDER"
|
||||
nivel: "1A"
|
||||
version: "1.1.0"
|
||||
|
||||
descripcion: |
|
||||
Template base para aplicaciones SaaS multi-tenant.
|
||||
Proporciona arquitectura, patrones y componentes reutilizables
|
||||
que heredan otros proyectos del workspace.
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# STACK TECNOLÓGICO
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
stack:
|
||||
backend:
|
||||
framework: "NestJS"
|
||||
version: "^10.0.0"
|
||||
lenguaje: "TypeScript"
|
||||
orm: "TypeORM"
|
||||
auth: "JWT + Passport"
|
||||
|
||||
frontend:
|
||||
framework: "React"
|
||||
version: "^18.2.0"
|
||||
lenguaje: "TypeScript"
|
||||
ui: "Material-UI (MUI)"
|
||||
estado: "React Query + Context"
|
||||
|
||||
database:
|
||||
motor: "PostgreSQL"
|
||||
version: "15+"
|
||||
schema: "template_saas_dev"
|
||||
migraciones: "TypeORM"
|
||||
|
||||
infraestructura:
|
||||
contenedores: "Docker"
|
||||
orquestacion: "docker-compose"
|
||||
cache: "Redis"
|
||||
ci_cd: "GitHub Actions"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# RUTAS DEL PROYECTO
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
rutas:
|
||||
proyecto: "projects/template-saas"
|
||||
backend: "projects/template-saas/backend"
|
||||
frontend: "projects/template-saas/frontend"
|
||||
database: "projects/template-saas/database"
|
||||
docs: "projects/template-saas/docs"
|
||||
orchestration: "projects/template-saas/orchestration"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# MÓDULOS PRINCIPALES
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
modulos:
|
||||
backend:
|
||||
- nombre: "auth"
|
||||
estado: "completo"
|
||||
descripcion: "Autenticación JWT con refresh tokens"
|
||||
|
||||
- nombre: "users"
|
||||
estado: "completo"
|
||||
descripcion: "CRUD de usuarios con roles"
|
||||
|
||||
- nombre: "companies"
|
||||
estado: "completo"
|
||||
descripcion: "Multi-tenancy por empresa"
|
||||
|
||||
- nombre: "common"
|
||||
estado: "completo"
|
||||
descripcion: "Utilidades compartidas"
|
||||
|
||||
frontend:
|
||||
- nombre: "auth"
|
||||
estado: "completo"
|
||||
descripcion: "Páginas de login, registro, recuperación"
|
||||
|
||||
- nombre: "dashboard"
|
||||
estado: "completo"
|
||||
descripcion: "Dashboard principal"
|
||||
|
||||
- nombre: "admin"
|
||||
estado: "parcial"
|
||||
descripcion: "Panel de administración"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# ESTADO DEL PROYECTO
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
estado:
|
||||
general: "activo"
|
||||
madurez: "producción"
|
||||
cobertura_tests: "~60%"
|
||||
documentacion: "parcial"
|
||||
|
||||
metricas:
|
||||
entidades_ddl: 15
|
||||
endpoints_api: 45
|
||||
componentes_ui: 30
|
||||
tests_unitarios: 120
|
||||
tests_e2e: 15
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# EQUIPO Y RESPONSABLES
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
equipo:
|
||||
owner: "ISEM Development"
|
||||
agentes_principales:
|
||||
- "Claude Code"
|
||||
- "Trae"
|
||||
- "Windsurf"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# DEPENDENCIAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
dependencias:
|
||||
workspace:
|
||||
- "orchestration/directivas/simco/"
|
||||
- "shared/catalog/"
|
||||
|
||||
externas:
|
||||
- "PostgreSQL 15+"
|
||||
- "Redis 7+"
|
||||
- "Node.js 20+"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# NOTAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
notas:
|
||||
- "Este proyecto es PROVIDER - cualquier cambio afecta a los consumidores"
|
||||
- "Mantener retrocompatibilidad en APIs públicas"
|
||||
- "Documentar cambios breaking en CHANGELOG"
|
||||
115
orchestration/TRACEABILITY.yml
Normal file
115
orchestration/TRACEABILITY.yml
Normal file
@ -0,0 +1,115 @@
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# TRACEABILITY.yml - Template SaaS
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
#
|
||||
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
|
||||
# Propósito: Trazabilidad del proyecto
|
||||
# Fecha: 2026-01-24
|
||||
#
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
version: "1.0.0"
|
||||
proyecto: "template-saas"
|
||||
tipo: "PROVIDER"
|
||||
fecha_actualizacion: "2026-01-24"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# HISTORIAL DE VERSIONES
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
versiones:
|
||||
- version: "1.1.0"
|
||||
fecha: "2026-01-24"
|
||||
descripcion: "Estandarización orchestration/ según SIMCO v4.3.0"
|
||||
cambios:
|
||||
- "Agregado _inheritance.yml (PROVIDER)"
|
||||
- "Agregado _MAP.md"
|
||||
- "Agregado PROJECT-PROFILE.yml"
|
||||
- "Agregado DEPENDENCY-GRAPH.yml"
|
||||
- "Agregado TRACEABILITY.yml"
|
||||
- "Agregado MAPA-DOCUMENTACION.yml"
|
||||
propagado_a:
|
||||
- "Pendiente propagación a consumidores"
|
||||
|
||||
- version: "1.0.0"
|
||||
fecha: "2026-01-01"
|
||||
descripcion: "Versión inicial estable"
|
||||
cambios:
|
||||
- "Sistema de autenticación JWT completo"
|
||||
- "Multi-tenancy por empresa"
|
||||
- "CRUD de usuarios con roles"
|
||||
- "Dashboard básico"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# PROPAGACIONES REALIZADAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
propagaciones:
|
||||
- fecha: "2026-01-20"
|
||||
tipo: "feature"
|
||||
origen: "template-saas"
|
||||
destino: "erp-core"
|
||||
descripcion: "Estructura de orchestration/"
|
||||
commit_origen: "887b0b4e"
|
||||
commit_destino: "887b0b4e"
|
||||
estado: "completado"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# TAREAS DOCUMENTADAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
tareas:
|
||||
- id: "TASK-2026-01-24-ESTANDARIZACION"
|
||||
titulo: "Estandarización orchestration/ como PROVIDER"
|
||||
estado: "en_progreso"
|
||||
archivos_creados:
|
||||
- "_inheritance.yml"
|
||||
- "_MAP.md"
|
||||
- "PROJECT-PROFILE.yml"
|
||||
- "DEPENDENCY-GRAPH.yml"
|
||||
- "TRACEABILITY.yml"
|
||||
- "MAPA-DOCUMENTACION.yml"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# CADENA DE HERENCIA
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
cadena_herencia:
|
||||
upstream:
|
||||
- "workspace-v2/orchestration/"
|
||||
|
||||
downstream:
|
||||
intermediate:
|
||||
- "erp-core"
|
||||
standalone:
|
||||
- "gamilit"
|
||||
- "michangarrito"
|
||||
- "trading-platform"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# VALIDACIONES
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
validaciones:
|
||||
ultima_validacion: "2026-01-24"
|
||||
resultado: "pendiente"
|
||||
archivos_obligatorios:
|
||||
_MAP.md: true
|
||||
_inheritance.yml: true
|
||||
BOOTLOADER.md: true
|
||||
CONTEXT-MAP.yml: true
|
||||
PROJECT-PROFILE.yml: true
|
||||
PROJECT-STATUS.md: true
|
||||
PROXIMA-ACCION.md: true
|
||||
DEPENDENCY-GRAPH.yml: true
|
||||
TRACEABILITY.yml: true
|
||||
MAPA-DOCUMENTACION.yml: true
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# NOTAS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
notas:
|
||||
- "Mantener este archivo actualizado con cada cambio significativo"
|
||||
- "Registrar propagaciones a consumidores"
|
||||
- "Documentar versiones según semver"
|
||||
98
orchestration/_MAP.md
Normal file
98
orchestration/_MAP.md
Normal file
@ -0,0 +1,98 @@
|
||||
# Mapa de Navegación - Template SaaS orchestration/
|
||||
|
||||
**Versión:** 1.0.0
|
||||
**Sistema:** SIMCO v4.3.0 + NEXUS v4.0
|
||||
**Tipo:** PROVIDER
|
||||
**Actualizado:** 2026-01-24
|
||||
|
||||
---
|
||||
|
||||
## Estructura
|
||||
|
||||
```
|
||||
orchestration/
|
||||
├── _MAP.md ← ESTE ARCHIVO (navegación)
|
||||
├── _INDEX.md ← Índice legacy (deprecated)
|
||||
├── _inheritance.yml ← Define herencia y exportación
|
||||
├── BOOTLOADER.md ← Protocolo de arranque NEXUS
|
||||
├── CONTEXT-MAP.yml ← Mapa de contexto del proyecto
|
||||
├── PROJECT-PROFILE.yml ← Perfil y metadata del proyecto
|
||||
├── PROJECT-STATUS.md ← Estado actual del proyecto
|
||||
├── PROXIMA-ACCION.md ← Checkpoint de sesión
|
||||
├── DEPENDENCY-GRAPH.yml ← Grafo de dependencias
|
||||
├── TRACEABILITY.yml ← Trazabilidad del proyecto
|
||||
├── MAPA-DOCUMENTACION.yml ← Mapa de documentación
|
||||
├── README.md ← Documentación general
|
||||
│
|
||||
├── 00-guidelines/ ← Guías del proyecto
|
||||
│ ├── CONTEXTO-PROYECTO.md
|
||||
│ └── HERENCIA-SIMCO.md
|
||||
│
|
||||
├── analisis/ ← Análisis realizados
|
||||
│ └── _INDEX.md
|
||||
│
|
||||
├── inventarios/ ← Inventarios por capa
|
||||
│ ├── MASTER_INVENTORY.yml
|
||||
│ ├── DATABASE_INVENTORY.yml
|
||||
│ ├── BACKEND_INVENTORY.yml
|
||||
│ └── FRONTEND_INVENTORY.yml
|
||||
│
|
||||
├── planes/ ← Planes de sprint
|
||||
│ └── HISTORICO-SPRINTS.md
|
||||
│
|
||||
├── trazas/ ← Trazas de tareas
|
||||
│ ├── TRAZA-TAREAS-DATABASE.md
|
||||
│ ├── TRAZA-TAREAS-BACKEND.md
|
||||
│ └── TRAZA-TAREAS-FRONTEND.md
|
||||
│
|
||||
└── _archivo/ ← Archivos históricos
|
||||
├── analisis-previo/
|
||||
└── planes/
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Archivos Clave
|
||||
|
||||
| Archivo | Propósito | Alias |
|
||||
|---------|-----------|-------|
|
||||
| `_inheritance.yml` | Define que es PROVIDER y a quién exporta | @INHERIT |
|
||||
| `BOOTLOADER.md` | Secuencia de arranque de 5 pasos | @BOOT |
|
||||
| `CONTEXT-MAP.yml` | Contexto para agentes | @CONTEXT |
|
||||
| `PROJECT-STATUS.md` | Estado actual | @STATUS |
|
||||
| `PROXIMA-ACCION.md` | Siguiente acción pendiente | @NEXT |
|
||||
|
||||
---
|
||||
|
||||
## Rol: PROVIDER
|
||||
|
||||
Template SaaS es **PROVEEDOR** de patrones arquitectónicos:
|
||||
|
||||
```
|
||||
template-saas (PROVIDER)
|
||||
│
|
||||
├──► erp-core (INTERMEDIATE)
|
||||
│ ├──► erp-clinicas
|
||||
│ ├──► erp-construccion
|
||||
│ ├──► erp-mecanicas-diesel
|
||||
│ ├──► erp-retail
|
||||
│ └──► erp-vidrio-templado
|
||||
│
|
||||
├──► gamilit (STANDALONE)
|
||||
├──► michangarrito (STANDALONE)
|
||||
└──► trading-platform (STANDALONE)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Navegación Rápida
|
||||
|
||||
- **Iniciar sesión:** Leer `BOOTLOADER.md` → `CONTEXT-MAP.yml` → `PROXIMA-ACCION.md`
|
||||
- **Ver estado:** `PROJECT-STATUS.md`
|
||||
- **Ver inventarios:** `inventarios/MASTER_INVENTORY.yml`
|
||||
- **Ver trazas:** `trazas/TRAZA-TAREAS-*.md`
|
||||
- **Ver herencia:** `_inheritance.yml`
|
||||
|
||||
---
|
||||
|
||||
*Sistema SIMCO v4.3.0 + NEXUS v4.0*
|
||||
114
orchestration/_inheritance.yml
Normal file
114
orchestration/_inheritance.yml
Normal file
@ -0,0 +1,114 @@
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
# _inheritance.yml - Template SaaS
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
#
|
||||
# Sistema: SIMCO v4.3.0 + NEXUS v4.0
|
||||
# Propósito: Define herencia y exportación de patrones
|
||||
# Fecha: 2026-01-24
|
||||
#
|
||||
# ═══════════════════════════════════════════════════════════════════════════════
|
||||
|
||||
tipo: PROVIDER
|
||||
version: "1.0.0"
|
||||
fecha_creacion: "2026-01-24"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# HERENCIA
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
hereda_de:
|
||||
- workspace-v2/orchestration/ # Directivas globales SIMCO
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# EXPORTACIÓN
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
exporta_a:
|
||||
- erp-core # INTERMEDIATE - Suite ERP
|
||||
- gamilit # STANDALONE - Proyecto educativo
|
||||
- michangarrito # STANDALONE - Taller mecánico
|
||||
- trading-platform # STANDALONE - Plataforma trading
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# PATRONES EXPORTADOS
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
patrones_exportados:
|
||||
arquitectura:
|
||||
- multi-tenancy # Arquitectura multi-tenant
|
||||
- api-structure # Estructura de API NestJS
|
||||
- frontend-structure # Estructura de frontend React
|
||||
- database-schema # Patrones de esquema DDL
|
||||
|
||||
seguridad:
|
||||
- auth-jwt # Autenticación JWT
|
||||
- rbac # Control de acceso por roles
|
||||
- rate-limiting # Limitación de tasa
|
||||
|
||||
infraestructura:
|
||||
- docker-compose # Configuración Docker
|
||||
- migrations # Sistema de migraciones
|
||||
- seeding # Sistema de seeds
|
||||
|
||||
documentacion:
|
||||
- orchestration-structure # Estructura orchestration/
|
||||
- docs-structure # Estructura docs/
|
||||
- inventory-format # Formato de inventarios
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# REGLAS DE PROPAGACIÓN
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
reglas_propagacion:
|
||||
security_fixes:
|
||||
sla: "inmediato"
|
||||
prioridad: P0
|
||||
descripcion: "Fixes de seguridad se propagan inmediatamente"
|
||||
|
||||
bug_fixes:
|
||||
sla: "72h"
|
||||
prioridad: P1
|
||||
descripcion: "Bug fixes se propagan en 72 horas"
|
||||
|
||||
features:
|
||||
sla: "siguiente_sprint"
|
||||
prioridad: P2
|
||||
descripcion: "Features se propagan en siguiente sprint"
|
||||
|
||||
documentation:
|
||||
sla: "inmediato"
|
||||
prioridad: P1
|
||||
descripcion: "Cambios de documentación se propagan inmediatamente"
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# MÓDULOS CORE
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
|
||||
modulos_core:
|
||||
backend:
|
||||
- auth # Autenticación y autorización
|
||||
- users # Gestión de usuarios
|
||||
- companies # Gestión de empresas/tenants
|
||||
- common # Utilidades comunes
|
||||
- config # Configuración centralizada
|
||||
|
||||
frontend:
|
||||
- auth # Componentes de autenticación
|
||||
- layout # Layouts principales
|
||||
- common # Componentes comunes
|
||||
- hooks # Hooks personalizados
|
||||
|
||||
database:
|
||||
- core-schema # Esquema base (users, companies, roles)
|
||||
- audit-schema # Tablas de auditoría
|
||||
- config-schema # Configuración de sistema
|
||||
|
||||
# ─────────────────────────────────────────────────────────────────────────────
|
||||
# NOTAS
|
||||
# ─────────────────────────────────────────────════════════════════════════════
|
||||
|
||||
notas:
|
||||
- "Template SaaS es el PROVEEDOR principal de patrones arquitectónicos"
|
||||
- "Todos los proyectos que heredan deben sincronizar según SLA definido"
|
||||
- "Cambios breaking requieren coordinación con todos los consumidores"
|
||||
- "Este archivo es OBLIGATORIO según SIMCO-ESTANDAR-ORCHESTRATION.md"
|
||||
Loading…
Reference in New Issue
Block a user