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

231 lines
6.4 KiB
Markdown

# ANALISIS DE IMPACTO: {TAREA-ID}
**Tarea:** {Descripcion breve de la tarea}
**Fecha:** {YYYY-MM-DD}
**Analista:** {Agente que realiza el analisis}
**Fase CAPVED:** A (Analisis)
---
## 1. RESUMEN DE CAMBIO PROPUESTO
```yaml
tipo_cambio: "{CREAR | MODIFICAR | ELIMINAR}"
capa_origen: "{DATABASE | BACKEND | FRONTEND | MULTIPLE}"
descripcion: "{Descripcion del cambio a realizar}"
```
---
## 2. OBJETOS DIRECTAMENTE AFECTADOS
### 2.1 Database (DDL)
| Objeto | Tipo | Accion | Archivo |
|--------|------|--------|---------|
| {schema.tabla} | TABLE | {CREATE/ALTER/DROP} | `ddl/schemas/{schema}/tables/{archivo}.sql` |
| {schema.indice} | INDEX | {CREATE/DROP} | `ddl/schemas/{schema}/indexes/{archivo}.sql` |
| {schema.funcion} | FUNCTION | {CREATE/ALTER} | `ddl/schemas/{schema}/functions/{archivo}.sql` |
**Cambios en columnas (si aplica):**
| Columna | Cambio | Tipo Anterior | Tipo Nuevo | Nullable |
|---------|--------|---------------|------------|----------|
| {columna} | {ADD/MODIFY/DROP} | {tipo} | {tipo} | {YES/NO} |
---
### 2.2 Backend
| Objeto | Tipo | Accion | Archivo |
|--------|------|--------|---------|
| {NombreEntity} | Entity | {CREATE/MODIFY} | `src/modules/{mod}/entities/{archivo}.ts` |
| {NombreDto} | DTO | {CREATE/MODIFY} | `src/modules/{mod}/dto/{archivo}.ts` |
| {NombreService} | Service | {CREATE/MODIFY} | `src/modules/{mod}/services/{archivo}.ts` |
| {NombreController} | Controller | {CREATE/MODIFY} | `src/modules/{mod}/controllers/{archivo}.ts` |
**Endpoints afectados:**
| Metodo | Path | Accion | Cambio |
|--------|------|--------|--------|
| {GET/POST/PUT/DELETE} | `/api/{path}` | {CREATE/MODIFY} | {descripcion} |
---
### 2.3 Frontend
| Objeto | Tipo | Accion | Archivo |
|--------|------|--------|---------|
| {NombreType} | Type/Interface | {CREATE/MODIFY} | `src/types/{archivo}.ts` |
| {NombreSchema} | Zod Schema | {CREATE/MODIFY} | `src/schemas/{archivo}.ts` |
| {NombreHook} | Hook | {CREATE/MODIFY} | `src/hooks/{archivo}.ts` |
| {NombreComponent} | Component | {CREATE/MODIFY} | `src/components/{archivo}.tsx` |
---
## 3. CASCADA DE IMPACTO
### 3.1 Diagrama de Propagacion
```
{OBJETO_ORIGEN}
|
+---> {OBJETO_DEPENDIENTE_1}
| |
| +---> {SUB_DEPENDIENTE_1}
| +---> {SUB_DEPENDIENTE_2}
|
+---> {OBJETO_DEPENDIENTE_2}
|
+---> {OBJETO_DEPENDIENTE_3}
```
### 3.2 Matriz de Dependencias
| Objeto Modificado | Depende de | Es Dependencia de | Requiere Actualizacion |
|-------------------|------------|-------------------|------------------------|
| {objeto_1} | {dependencias} | {dependientes} | SI/NO |
| {objeto_2} | {dependencias} | {dependientes} | SI/NO |
---
## 4. ANALISIS POR CAPA (Consultar IMPACTO-CAMBIOS-*.md)
### 4.1 Si es cambio en DDL
Referencia: `core/orchestration/impactos/IMPACTO-CAMBIOS-DDL.md`
| Capa Dependiente | Requiere Actualizacion | Prioridad |
|------------------|------------------------|-----------|
| Entity | {SI/NO} | 1 |
| CreateDto | {SI/NO} | 2 |
| UpdateDto | {AUTO} | 2 |
| ResponseDto | {SI/NO} | 2 |
| Service | {POSIBLE} | 3 |
| Frontend Types | {SI/NO} | 4 |
| Frontend Schema | {SI/NO} | 4 |
| Tests | {POSIBLE} | 5 |
| DATABASE_INVENTORY | {SI} | 6 |
### 4.2 Si es cambio en Entity
Referencia: `core/orchestration/impactos/IMPACTO-CAMBIOS-ENTITY.md`
| Capa Dependiente | Requiere Actualizacion | Prioridad |
|------------------|------------------------|-----------|
| DTOs | {SI/NO} | 1 |
| Service | {POSIBLE} | 2 |
| Controller | {POSIBLE} | 3 |
| Frontend Types | {SI/NO} | 4 |
| Tests | {POSIBLE} | 5 |
| BACKEND_INVENTORY | {SI} | 6 |
### 4.3 Si es cambio en API
Referencia: `core/orchestration/impactos/IMPACTO-CAMBIOS-API.md`
| Capa Dependiente | Requiere Actualizacion | Prioridad |
|------------------|------------------------|-----------|
| Swagger/OpenAPI | {AUTO} | - |
| Frontend Types | {SI/NO} | 1 |
| Frontend API Service | {SI/NO} | 2 |
| Frontend Components | {POSIBLE} | 3 |
| Tests E2E | {POSIBLE} | 4 |
---
## 5. RIESGOS IDENTIFICADOS
| ID | Riesgo | Probabilidad | Impacto | Mitigacion |
|----|--------|--------------|---------|------------|
| R1 | {descripcion} | {ALTA/MEDIA/BAJA} | {ALTO/MEDIO/BAJO} | {accion} |
| R2 | {descripcion} | {ALTA/MEDIA/BAJA} | {ALTO/MEDIO/BAJO} | {accion} |
---
## 6. DEPENDENCIAS CON OTRAS TAREAS/HUs
### 6.1 Esta tarea BLOQUEA:
| Tarea | Descripcion | Razon |
|-------|-------------|-------|
| {TAREA-XXX} | {descripcion} | {por que bloquea} |
### 6.2 Esta tarea ES BLOQUEADA POR:
| Tarea | Descripcion | Estado |
|-------|-------------|--------|
| {TAREA-YYY} | {descripcion} | {COMPLETADA/EN_PROGRESO/PENDIENTE} |
---
## 7. VERIFICACION DE CATALOGO
Referencia: `core/catalog/CATALOG-INDEX.yml`
| Funcionalidad Requerida | Existe en Catalogo | Accion |
|-------------------------|-------------------|--------|
| {auth/session/etc} | {SI/NO} | {REUTILIZAR / IMPLEMENTAR} |
---
## 8. SCOPE CREEP DETECTADO
| Item | En Alcance Original | Accion |
|------|---------------------|--------|
| {item_1} | {SI/NO} | {INCLUIR / HU_DERIVADA} |
| {item_2} | {SI/NO} | {INCLUIR / HU_DERIVADA} |
**HUs Derivadas a Crear:**
```yaml
- id: "DERIVED-{TAREA-ID}-001"
descripcion: "{descripcion}"
prioridad: "{P0/P1/P2/P3}"
razon: "{por que se genera}"
```
---
## 9. ORDEN DE EJECUCION RECOMENDADO
```
1. [ ] {CAPA} - {accion} - {objeto}
2. [ ] {CAPA} - {accion} - {objeto}
3. [ ] {CAPA} - {accion} - {objeto}
...
N. [ ] Actualizar inventarios y trazas
```
---
## 10. CHECKLIST DE VALIDACION (Fase V)
```yaml
Analisis_completo:
- [ ] Todos los objetos afectados identificados
- [ ] Cascada de impacto documentada
- [ ] Riesgos identificados y mitigados
- [ ] Dependencias con otras tareas verificadas
- [ ] Catalogo consultado
- [ ] Scope creep detectado y registrado
- [ ] Orden de ejecucion definido
Listo_para_Fase_P:
- [ ] Este analisis esta completo
- [ ] Puede procederse a planificacion
```
---
## 11. APROBACION
| Rol | Nombre/Agente | Fecha | Estado |
|-----|---------------|-------|--------|
| Analista | {agente} | {fecha} | COMPLETADO |
| Revisor (si aplica) | {Architecture-Analyst} | {fecha} | {APROBADO/OBSERVACIONES} |
---
**Template Version:** 1.0.0 | **Sistema:** SIMCO + CAPVED