workspace-v1/orchestration/templates/TEMPLATE-EPICA.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

184 lines
5.4 KiB
Markdown

# TEMPLATE: ÉPICA
**Versión:** 1.1.0
**Fecha:** 2025-12-08
**Uso:** Definición de épicas del proyecto
---
## VERIFICACIÓN DE CATÁLOGO (ANTES DE CREAR)
```
┌─────────────────────────────────────────────────────────────────────────────┐
│ OBLIGATORIO: Verificar si funcionalidades de esta épica existen en catálogo│
│ │
│ 1. Revisar historias de usuario vs keywords de @CATALOG_INDEX │
│ 2. Si match → referenciar en "Notas Técnicas" de cada US y usar código │
│ 3. Si NO match → proceder con implementación nueva │
└─────────────────────────────────────────────────────────────────────────────┘
```
**Funcionalidades del Catálogo a Considerar:**
- [ ] auth / login / registro → `@CATALOG_AUTH`
- [ ] sesiones / logout → `@CATALOG_SESSION`
- [ ] rate-limit / throttle → `@CATALOG_RATELIMIT`
- [ ] notificaciones / email / push → `@CATALOG_NOTIFY`
- [ ] multi-tenant / organización → `@CATALOG_TENANT`
- [ ] feature-flag / toggle → `@CATALOG_FLAGS`
- [ ] websocket / realtime → `@CATALOG_WS`
- [ ] pagos / stripe / suscripción → `@CATALOG_PAYMENTS`
**Resultado verificación:** {✅ No aplica catálogo | ✅ Usar @CATALOG_XXX para US-{NNN} | ⚠️ Pendiente verificar}
---
## ÉPICA: {EPIC-ID} - {Nombre de la Épica}
### Metadata
| Campo | Valor |
|-------|-------|
| **ID** | {EPIC-ID} (ej: EAI-001, EXT-005) |
| **Nombre** | {nombre descriptivo} |
| **Módulo** | {módulo principal} |
| **Fase** | {Fase 1 - Alcance Inicial / Fase 2 - Robustecimiento / Fase 3 - Extensiones} |
| **Prioridad** | {P0 / P1 / P2 / P3} |
| **Estado** | {Backlog / Ready / In Progress / Done} |
| **Story Points** | {estimación total} |
| **Sprint(s)** | {sprint(s) asignados} |
### Descripción
{Descripción de alto nivel de la épica. Qué problema resuelve, por qué es importante para el negocio.}
### Objetivo de Negocio
{Qué valor aporta esta épica al producto/negocio}
### Stakeholders
| Rol | Nombre/Equipo | Responsabilidad |
|-----|---------------|-----------------|
| Product Owner | {nombre} | Aprobación de criterios |
| Tech Lead | {nombre} | Validación técnica |
| Usuarios | {tipo} | Feedback |
---
### Historias de Usuario
| ID | Historia | Prioridad | SP | Estado |
|----|----------|-----------|-----|--------|
| US-{MOD}-001 | Como {rol}, quiero {acción} para {beneficio} | P0 | 5 | Backlog |
| US-{MOD}-002 | Como {rol}, quiero {acción} para {beneficio} | P0 | 3 | Backlog |
| US-{MOD}-003 | Como {rol}, quiero {acción} para {beneficio} | P1 | 8 | Backlog |
**Total Story Points:** {suma}
---
### Criterios de Aceptación de la Épica
**Funcionales:**
- [ ] {Criterio funcional 1}
- [ ] {Criterio funcional 2}
- [ ] {Criterio funcional 3}
**No Funcionales:**
- [ ] Performance: {criterio de rendimiento}
- [ ] Seguridad: {criterio de seguridad}
- [ ] Usabilidad: {criterio de UX}
**Técnicos:**
- [ ] Cobertura de tests > 80%
- [ ] Documentación completa
- [ ] Integración DB-Backend-Frontend verificada
---
### Dependencias
**Esta épica depende de:**
| Épica/Módulo | Estado | Bloqueante |
|--------------|--------|------------|
| {EPIC-XXX} | Done | Sí |
| {Módulo Y} | In Progress | No |
**Esta épica bloquea:**
| Épica/Módulo | Razón |
|--------------|-------|
| {EPIC-YYY} | Requiere API de esta épica |
---
### Desglose Técnico
**Database:**
- [ ] Schema: {schema_name}
- [ ] Tablas: {cantidad} ({lista})
- [ ] Funciones: {cantidad}
- [ ] RLS Policies: Sí/No
**Backend:**
- [ ] Módulo: {module_name}
- [ ] Entities: {cantidad}
- [ ] Endpoints: {cantidad}
- [ ] Tests: {cantidad esperada}
**Frontend:**
- [ ] Páginas: {cantidad} ({lista})
- [ ] Componentes: {cantidad}
- [ ] Stores: {cantidad}
---
### Riesgos
| Riesgo | Probabilidad | Impacto | Mitigación |
|--------|--------------|---------|------------|
| {Riesgo 1} | Alta/Media/Baja | Alto/Medio/Bajo | {Estrategia} |
---
### Definition of Ready (DoR)
- [ ] Historias de usuario definidas
- [ ] Criterios de aceptación claros
- [ ] Dependencias identificadas
- [ ] Estimación completada
- [ ] Diseño técnico aprobado
- [ ] Sin bloqueadores activos
### Definition of Done (DoD)
- [ ] Código implementado y revisado
- [ ] Tests pasando (unit, integration, e2e)
- [ ] Documentación actualizada
- [ ] Inventarios actualizados
- [ ] Trazas registradas
- [ ] Demo realizada
- [ ] Product Owner aprobó
---
### Documentación Relacionada
- Requerimientos: `docs/03-requerimientos/RF-{modulo}/`
- Especificaciones: `docs/04-modelado/especificaciones-tecnicas/`
- User Stories: `docs/05-user-stories/US-{modulo}/`
- ADR: `docs/97-adr/ADR-{NNN}-{nombre}.md`
---
### Historial
| Fecha | Cambio | Autor |
|-------|--------|-------|
| {YYYY-MM-DD} | Creación de épica | {nombre} |
---
**Creada por:** {nombre-agente}
**Fecha:** {YYYY-MM-DD}
**Última actualización:** {YYYY-MM-DD}