Conversation
…tizacion - Actualizar version a 2.0.0 - Corregir todas las rutas de scripts/ai/ a scripts/coding/ai/ - Documentar TODOS los agentes implementados (100+ agentes en 21 categorias) - Agregar inventario completo con ubicaciones exactas - Incluir 6 casos de uso practicos con codigo ejecutable - Documentar arquitectura CI/CD y patrones de uso - Eliminar todos los emojis e iconos (cumplimiento restricciones) - Agregar metricas de progreso y referencias adicionales Categorias documentadas: - SDLC (7), TDD (1), Base/Tecnicas (12), Meta (7), Documentacion (3) - Seguridad (3), Calidad (7), Validacion (2), Requisitos (3), Database (1) - Permisos (2), UX (3), Placement (14), Planning (5), Protocolos (3) - Automatizacion (9), Generadores (4), Analisis Negocio (2) - Orquestadores (1), Utilidades (7), ML (1)
- Crear PLAN_REMEDIACION_DOCS_GOBERNANZA.md - Plan completo de 4 fases (80 horas, 4 semanas) - 14 tareas priorizadas por severidad - Scripts ejecutables para automatizacion - Metricas de seguimiento y criterios de exito Hallazgos criticos a remediar: - 46 archivos con emojis - 416 enlaces rotos - 65 archivos sin frontmatter - 203 archivos con multiples H1 - 37 grupos de archivos duplicados Fases del plan: - Fase 1 (Semana 1): Remediacion critica (21h) - Fase 2 (Semanas 2-3): Alta prioridad (34h) - Fase 3 (Mes 1): Mejoras calidad (22h) - Fase 4 (Mes 2-3): Optimizaciones (18h) Incluye: - Cronograma detallado - Asignacion de responsabilidades - Scripts bash ejecutables - Validacion CI/CD - Dashboard de metricas - Gestion de riesgos
- Crear ANALISIS_DOCS_GOBERNANZA_2025_11_17.md - Analisis exhaustivo de 387 archivos, 155,213 lineas - Documentar hallazgos criticos, altos y medios - Metricas detalladas de calidad y cumplimiento - Recomendaciones accionables priorizadas - Relacionado con PLAN-REM-DOCS-GOB-001
…ectos - Mover PLAN_REMEDIACION_DOCS_GOBERNANZA.md a planificacion/ - Mover ANALISIS_DOCS_GOBERNANZA_2025_11_17.md a qa/ - Mejorar organizacion de documentos de gobernanza
- Analisis exhaustivo de 750 archivos, 137,510 lineas Python - Cobertura: codigo, frontend, tests, docs, infra, seguridad - 20 hallazgos criticos/altos identificados - Deuda tecnica estimada: 275-350 SP - Calificacion general: B (77/100) - Recomendaciones top 10 accionables - Roadmap Q4 2025 - Q1 2026
- Analisis exhaustivo de configuration vs configuracion - Comparacion de modelos, LOC, funcionalidades - configuration es 35% mas completa (948 vs 703 lineas) - Ambas apps activas en INSTALLED_APPS (CRITICO) - Usan tablas de BD diferentes (implementaciones paralelas) - Recomendacion: Mantener configuration, eliminar configuracion - Plan de accion detallado en 5 fases - Esfuerzo estimado: 1-2 dias HALLAZGO CRITICO P0: Duplicacion arquitectonica que requiere decision inmediata
FASE 1 COMPLETADA: Investigacion exhaustiva de configuration vs configuracion HALLAZGOS CRITICOS: - Conflicto de rutas: Ambas apps en /api/v1/configuracion/ - Ambas activas en INSTALLED_APPS - Tablas BD diferentes (4 tablas total) - 1,379 lineas de tests duplicados HALLAZGOS POSITIVOS: - Sin dependencias externas (safe to remove) - Solo tests usan las apps - configuration mas completo (+funcionalidades) BLOQUEADOR IDENTIFICADO: - Requiere verificacion MANUAL de datos en BD - Si configuracion_sistema tiene datos → migrar antes PROXIMA FASE: - FASE 2: Decision Go/No-Go (verificar datos BD) Metricas: 50+ archivos analizados, 5 imports encontrados, 1 conflicto detectado
FASE 2 COMPLETADA: Decision estrategia de naming y analisis emojis DECISION GO/NO-GO: - GO: Proceder con refactoring completo - Razon: No hay BD en produccion (no hay datos que migrar) - Oportunidad: Establecer arquitectura limpia desde inicio ESTRATEGIA DE NAMING APROBADA: - Codigo: INGLES (apps, modelos, tablas, funciones, variables) - Documentacion: ESPANOL (comentarios, docstrings, docs markdown) - Beneficios: Interoperabilidad, estandar industria, consistencia PLAN DE MIGRACION: - Enfoque: Big Bang (3-5 dias) - Apps a migrar: usuarios→users, permisos→permissions, llamadas→calls, etc - Consolidar: configuration (eliminar configuracion duplicada) - 23 apps afectadas ANALISIS DE EMOJIS (SIN EMOJIS EN REPORTE): - 394 archivos analizados - 236 archivos con emojis (59.9%) - 42,047 emojis totales detectados - TOP 20 archivos criticos identificados - Plan de remediacion en 4 fases ARCHIVOS CREADOS: - FASE2_DECISION_ESTRATEGIA_NAMING_2025_11_17.md - REPORTE_EMOJIS_DOCS_GOBERNANZA_2025_11_17.md PROXIMO PASO: - Crear ADR documentando decision de naming - Ejecutar refactoring Big Bang
…imientos DOCUMENTOS CREADOS: 1. DIFERENCIA_PROCESOS_PROCEDIMIENTOS.md (guias/) - Explicacion clara de diferencia entre proceso y procedimiento - PROCESO = QUE hacemos (alto nivel, flujo completo) - PROCEDIMIENTO = COMO lo hacemos (bajo nivel, pasos especificos) - Plantillas para ambos tipos - Ejemplos practicos - Recomendaciones para IACT 2. PIPELINE_TRABAJO_IACT.md (procesos/) - Proceso completo de desarrollo (7 etapas) - Desde issue hasta produccion - ETAPA 1: Analisis y planificacion - ETAPA 2: Implementacion (TDD) - ETAPA 3: PR Preparation - ETAPA 4: Code Review - ETAPA 5: Merge y Deploy Staging - ETAPA 6: Deploy Produccion - ETAPA 7: Post-Deployment - Metricas DORA incluidas - Roles y responsabilidades definidos - Variaciones: hotfix, refactoring, spike - Troubleshooting incluido CARACTERISTICAS: - SIN emojis ni iconos (cumple normativa) - Diagramas de flujo en texto - Referencias cruzadas a procedimientos - Criterios de salida por etapa - KPIs y metricas definidas Total lineas documentadas: 800+ lineas
- Renombrar PIPELINE_TRABAJO_IACT.md -> PROC-001-pipeline_trabajo_iact.md - Renombrar DIFERENCIA_PROCESOS_PROCEDIMIENTOS.md -> GUIA-001-procesos_vs_procedimientos.md - Actualizar frontmatter: IDs y relacionados - Actualizar referencias internas en ambos archivos - Aplicar patron consistente: PREFIX-###-snake_case_title.md (como ADR/TASK) Razon: Mantener consistencia con patrones existentes en ADR y TASK.
- Agregar reglas globales para PROC-*.md, GUIA-*.md, PROCED-*.md - Agregar regla específica para PROC-001-pipeline_trabajo_iact.md (crítico) - Agregar regla específica para GUIA-001-procesos_vs_procedimientos.md (fundamental) - Mantener consistencia con patrones existentes (ADR-*, TASK-*) Relacionado con: refactor de nomenclatura (commit 1c6bdea)
…inconsistencias Nuevos documentos: - GUIA-002-convenciones_nomenclatura.md: Guia completa de patrones de nomenclatura - ANALISIS_INCONSISTENCIAS_NOMENCLATURA_2025_11_17.md: Reporte de 112 archivos inconsistentes - procedimientos/README.md: Crear estructura para procedimientos (PROCED-###) Convenciones establecidas: - Patron general: PREFIX-###-snake_case_title.md - Prefijos: ADR, TASK, PROC, PROCED, GUIA - Separadores: guiones (-) entre componentes, guiones bajos (_) en titulo - Frontmatter obligatorio con id consistente Hallazgos del analisis: - 396 archivos analizados - 117 archivos (29.5%) con inconsistencias - 34 archivos duplicados (prioridad critica) - 32 archivos sin frontmatter - Plan de remediacion: 10-15 horas estimadas Relacionado con: estandarizacion nomenclatura (commits anteriores) Ver: GUIA-002 para detalles completos de convenciones
…chivos Cambios: 1. GUIA-002: Actualizar patron de reportes temporales - Antes: TIPO_DESCRIPCION_2025_11_17.md (solo fecha) - Ahora: TIPO_DESCRIPCION_YYYYMMDD_HHMMSS.md (fecha + hora) - Razon: Evitar colisiones si se generan multiples reportes el mismo dia - Permite trazabilidad granular y ordenamiento cronologico preciso 2. VERIFICACION_REAL_ESTADO_ARCHIVOS_2025_11_17.md: Nuevo reporte - Verificacion MANUAL de duplicados usando diff directo - 10 procedimientos duplicados confirmados (seguros para eliminar) - 6 ADRs adr_2025 casi-identicos (consolidar) - 6 ADRs ADR_### con contenido diferente (renombrar, NO eliminar) - Plan de migracion en 5 fases con comandos bash especificos Hallazgos criticos: - Analisis anterior tenia suposiciones incorrectas sobre duplicados - Varios pares de archivos tienen contenido DIFERENTE, no son duplicados - Requiere decision manual antes de eliminacion masiva Relacionado con: mejora continua de convenciones de nomenclatura
- Agregar nota importante: timestamp = hora de INICIO, no de finalizacion - Incluir ejemplo practico: analisis de 14:30 a 15:45 usa timestamp 143000 - Razon: Para reportes largos, la hora de inicio es mas util como referencia Sugerencia de: usuario (2025-11-17)
FASE 1: Eliminar duplicados (10 archivos) - Eliminar 9 procedimientos duplicados en procesos/ (existen en procesos/procedimientos/) - Eliminar guia_completa_desarrollo_features.md (duplicado) - Verificado con diff: solo difieren en campo date del frontmatter FASE 3: Estandarizar guias (3 archivos renombrados) - GUIA_UBICACIONES_ARTEFACTOS.md -> GUIA-003-ubicaciones_artefactos.md - METRICS.md -> GUIA-004-metrics.md - QUICKSTART.md -> GUIA-005-quickstart.md - Frontmatter actualizado: id, tipo, categoria, estado - IDs unicos globalmente: GUIA-003, GUIA-004, GUIA-005 FASE 4: Estandarizar procesos (6 archivos renombrados) - SDLC_PROCESS.md -> PROC-002-sdlc_process.md - DEVOPS_AUTOMATION.md -> PROC-003-devops_automation.md - AGENTES_SDLC.md -> PROC-004-agentes_sdlc.md - MAPEO_PROCESOS_TEMPLATES.md -> PROC-005-mapeo_procesos_templates.md - actividades_garantia_documental.md -> PROC-006-actividades_garantia_documental.md - estrategia_qa.md -> PROC-007-estrategia_qa.md - Frontmatter estandarizado: id, tipo, categoria, subcategoria, estado, version, fecha_creacion, autor Beneficios: - Nomenclatura consistente: PREFIX-###-snake_case_title.md - IDs unicos globalmente (GUIA-###, PROC-###) - Frontmatter estandarizado segun GUIA-002 - 10 duplicados eliminados (reduccion ruido) - 9 archivos renombrados y estandarizados Pendiente FASE 2: ADRs requieren integracion manual de contenido antes de consolidacion Relacionado con: GUIA-002 (convenciones nomenclatura)
Actualizaciones de frontmatter en 9 archivos para cumplir con GUIA-002: Guias (3 archivos): - GUIA-003: id actualizado de GUIA-UBICACIONES-ARTEFACTOS a GUIA-003 - GUIA-004: id actualizado de METRICS-GUIAS-ADOPTION a GUIA-004 - GUIA-005: id actualizado de QUICKSTART-GUIAS a GUIA-005 Procesos (6 archivos): - PROC-002: id actualizado de PROC-SDLC-001 a PROC-002 - PROC-003: id actualizado de PROC-DEVOPS-001 a PROC-003 - PROC-004: id actualizado de title/date a PROC-004 - PROC-005: id actualizado de DOC-GOB-MAPEO-PROC-TEMP a PROC-005 - PROC-006: id actualizado de DOC-QA-DOC-CONTROL a PROC-006 - PROC-007: id actualizado de DOC-QA-001 a PROC-007 Cambios en frontmatter: - Campo id: ahora PREFIX-### (unico globalmente) - Campo tipo: estandarizado (guia, proceso) - Campos estandarizados: categoria, subcategoria, estado, version, fecha_creacion, autor - Eliminados campos legacy: title, date, status, propietario, owner Relacionado con: commit c58f6fc (migracion parcial a patrones estandarizados)
…latura CAMBIO MAYOR: Migrar de PREFIX-### a PREFIX-DOMINIO-### Objetivo: Mejorar organizacion y evitar colisiones entre equipos Patron nuevo: PREFIX-DOMINIO-###-snake_case_title.md - Dominios: BACK, FRONT, DEVOPS, QA, AI, GOB, DEV - Numeros secuenciales DENTRO de cada dominio - IDs unicos globalmente Archivos renombrados (12 archivos): PROCESOS (7 archivos): - PROC-001 -> PROC-DEV-001-pipeline_trabajo_iact.md - PROC-002 -> PROC-DEV-002-sdlc_process.md - PROC-003 -> PROC-DEVOPS-001-devops_automation.md - PROC-004 -> PROC-AI-001-agentes_sdlc.md - PROC-005 -> PROC-GOB-001-mapeo_procesos_templates.md - PROC-006 -> PROC-QA-001-actividades_garantia_documental.md - PROC-007 -> PROC-QA-002-estrategia_qa.md GUIAS (5 archivos): - GUIA-001 -> GUIA-GOB-001-procesos_vs_procedimientos.md - GUIA-002 -> GUIA-GOB-002-convenciones_nomenclatura.md - GUIA-003 -> GUIA-GOB-003-ubicaciones_artefactos.md - GUIA-004 -> GUIA-GOB-004-metrics.md - GUIA-005 -> GUIA-DEV-001-quickstart.md Actualizaciones: - GUIA-GOB-002: Documentar patron completo con dominios y ejemplos - Frontmatter: IDs actualizados en todos los archivos - CODEOWNERS: Referencias actualizadas a nuevos nombres Ventajas del nuevo patron: - Organizacion clara por dominio (ID indica area) - Evita colisiones (cada dominio tiene secuencia independiente) - Escalable (multiples equipos en paralelo) - Mas descriptivo (PROC-QA-001 vs PROC-001) - Busqueda facil (ls PROC-BACK-*.md) Breaking change: Actualizar referencias externas a estos documentos
CAMBIOS IMPLEMENTADOS: 1. Migracion de 40 ADRs a patron PREFIX-DOMINIO-###-snake_case_title.md - AI: 19 ADRs (ADR-AI-001 a ADR-AI-019) - BACK: 5 ADRs (ADR-BACK-001 a ADR-BACK-005) - DEVOPS: 5 ADRs (ADR-DEVOPS-001 a ADR-DEVOPS-005) - FRONT: 4 ADRs (ADR-FRONT-001 a ADR-FRONT-004) - DEV: 2 ADRs (ADR-DEV-001 a ADR-DEV-002) - QA: 2 ADRs (ADR-QA-001 a ADR-QA-002) - GOB: 3 ADRs (ADR-GOB-001 a ADR-GOB-003) 2. Eliminacion de 18 archivos duplicados: - 9 duplicados exactos - 9 duplicados con diferencias menores 3. Actualizacion de frontmatter: - Campo 'id' actualizado en 40 ADRs para reflejar nuevos nombres - Consistencia con patron de nomenclatura global 4. Documentacion de proceso: - Agregado reporte de clasificacion detallado - REPORTE_CLASIFICACION_ADRS_DOMINIO_20251117_062223.md BENEFICIOS: - IDs globalmente unicos por dominio - Mejor organizacion y navegacion - Previene colisiones entre equipos - Facilita busqueda y trazabilidad - Cumple con GUIA-GOB-002 convenciones de nomenclatura Relacionado: GUIA-GOB-002-convenciones-nomenclatura.md
CONTEXTO: Según ADR-AI-018, iact_agents/ es un proyecto STANDALONE separado de callcentersite. La documentación debe reflejar esta arquitectura. CAMBIOS: 1. Migración docs/gobernanza/ai/ → docs/ai/ (12 archivos) - estrategia/ (2): ESTRATEGIA_IA, FASES_IMPLEMENTACION_IA - analisis/ (2): ANALISIS_GAPS_POST_DORA_2025, GAPS_SUMMARY - integraciones/ (3): DORA_CASSANDRA, DORA_SDLC, HAMILTON - protocolos/ (1): COLLABORATION_PROTOCOLS - ai_capabilities/ (1): AI_CAPABILITIES - tasks/ (3): TASK-009, TASK-012, TASK-024 2. Migración docs/gobernanza/agentes/ → docs/agents/ (4 archivos) - AGENTS.md, constitution.md, tdd_feature_agent.md - README.md → README_GOVERNANCE.md (evitar conflicto) 3. Creación de 7 procedimientos detallados (PROCED) - PROCED-DEV-001-crear_pull_request.md - PROCED-DEV-002-code_review.md - PROCED-DEV-003-resolver_conflictos_merge.md - PROCED-QA-001-ejecutar_tests.md - PROCED-GOB-001-crear_adr.md - PROCED-GOB-002-actualizar_documentacion.md - PROCED-DEVOPS-001-deploy_staging.md 4. Eliminación de directorios vacíos: - docs/gobernanza/ai/ - docs/gobernanza/agentes/ BENEFICIOS: - Documentación centralizada según arquitectura standalone - Mejor separación de concerns (gobernanza vs AI específico) - Facilita mantenimiento del proyecto iact_agents/ - Cumple con decisión arquitectónica de ADR-AI-018 - Procedimientos detallados para tareas comunes del equipo Relacionado: ADR-AI-018-ai-agents-standalone-architecture
… contenido semanticamente PROBLEMA: La carpeta docs/gobernanza/anexos/ era demasiado genérica y no reflejaba correctamente el propósito de su contenido. Dificultaba la navegación y descubrimiento de información. CAMBIOS: 1. Distribución semántica de anexos/ a raíz de gobernanza: - anexos/catalogos/ → gobernanza/catalogos/ - anexos/diagramas/ → gobernanza/diagramas/ - anexos/ejemplos/ → gobernanza/ejemplos/ - anexos/faq.md → gobernanza/faq.md - anexos/glosarios/ → gobernanza/glosarios/ - anexos/referencias/ → gobernanza/referencias/ 2. Eliminación de directorio genérico: - docs/gobernanza/anexos/ (ahora vacío) - anexos/README_anexos_root.md (obsoleto) ARCHIVOS MOVIDOS (12): - catalogos/catalogo_reglas_negocio.md - catalogos/inventario_dependencias.md - diagramas/README.md + 2 subdirectorios - ejemplos/README.md - faq.md - glosarios/glosario.md, glosario_babok_pmbok_iso.md, glossary.md - referencias/README.md BENEFICIOS: - Estructura más semántica y descubrible - Mejor organización de información complementaria - Facilita navegación y mantenimiento - Elimina categorización genérica "anexos" - Consistente con convenciones de nomenclatura Relacionado: GUIA-GOB-002-convenciones-nomenclatura
… detallada CONTEXTO: Aplicar misma estructura semantica de docs/backend/requisitos a docs/gobernanza/requisitos para mejor organizacion. CAMBIOS: 1. Estructura nueva en requisitos/: - atributos_calidad/ - reglas_negocio/ (renombrado de REGLAS_NEGOCIO) - requerimientos_funcionales/ - requerimientos_negocio/ - requerimientos_usuario/casos_uso/ - stakeholders/ 2. Archivos reorganizados: - brs_business_requirements.md -> requerimientos_negocio/ - strs_stakeholder_requirements.md -> stakeholders/ - srs_software_requirements.md -> requerimientos_funcionales/ - CASOS_USO.md -> requerimientos_usuario/casos_uso/ - REGLAS_NEGOCIO/* -> reglas_negocio/ 3. Reporte de analisis final generado: - REPORTE_ANALISIS_FINAL_GOBERNANZA_20251117_083000.md BENEFICIOS: - Consistencia con estructura de backend - Mejor organizacion semantica - Facilita navegacion y descubrimiento - Preparado para escalar con mas requisitos Relacionado: docs/backend/requisitos/
…orte marco integrado CAMBIOS: 1. Simplificación de estructura requisitos: - Eliminar redundancia: requerimientos_usuario/casos_uso/ - Mover CASOS_USO.md a docs/gobernanza/casos_de_uso/ - Mantener casos_de_uso en raíz (15 archivos) 2. Estructura final de requisitos: - atributos_calidad/ - reglas_negocio/ - requerimientos_funcionales/ - requerimientos_negocio/ - stakeholders/ - analisis_negocio/marco_integrado/ 3. Reporte análisis marco integrado: - REPORTE_ANALISIS_MARCO_INTEGRADO_20251117_083500.md - Identifica 54 archivos a crear desde casos prácticos - 21 archivos ya existen - Priorización: 41 MUST, 21 SHOULD, 6 COULD BENEFICIOS: - Elimina duplicación innecesaria - Estructura más simple y clara - Casos de uso centralizados en un solo lugar - Plan claro para implementación del marco integrado Relacionado: docs/gobernanza/marco_integrado/05a_casos_practicos_iact.md
…ones de analisis_negocio PROBLEMA: Había 3 ubicaciones diferentes con contenido del marco integrado: - docs/gobernanza/marco_integrado/ (10 archivos principales) - docs/gobernanza/analisis_negocio/marco_integrado/ (subcarpetas) - docs/gobernanza/requisitos/analisis_negocio/marco_integrado/ (duplicados) CAMBIOS: 1. Consolidación en ubicación única: - docs/gobernanza/marco_integrado/ (ahora 19 archivos) 2. Movimiento de contenido único: - casos_practicos/ (4 archivos) → marco_integrado/casos_practicos/ - plantillas/ (5 archivos) → marco_integrado/plantillas/ 3. Eliminación de duplicados: - docs/gobernanza/analisis_negocio/ (completo) - docs/gobernanza/requisitos/analisis_negocio/ (completo) - 11 archivos duplicados eliminados ESTRUCTURA FINAL: docs/gobernanza/marco_integrado/ ├── 00-06_*.md (10 archivos principales) ├── casos_practicos/ (4 archivos) └── plantillas/ (5 archivos) BENEFICIOS: - Elimina categorización genérica analisis_negocio - Una sola ubicación para todo el marco integrado - Estructura más simple y directa - Sin duplicaciones Relacionado: REPORTE_ANALISIS_MARCO_INTEGRADO_20251117_083500.md
… diagramas DECISIÓN: Adoptar PlantUML como estándar exclusivo para todos los diagramas UML en la documentación del proyecto IACT. ALCANCE: - Todos los diagramas UML (casos de uso, secuencia, clases, componentes, actividad, estado) - Diagramas BPMN para procesos de negocio - Nomenclatura: TIPO-DOMINIO-###-descripcion.puml ALTERNATIVAS CONSIDERADAS: - Mermaid: Limitado en tipos de diagramas - draw.io: No es "documentation as code" - Diagrams (Python): Solo infraestructura - Graphviz: Sintaxis no específica para UML BENEFICIOS: - Versionabilidad: Texto plano en git - Editabilidad: Cualquier editor de texto - Automatización: Generación en CI/CD - Reproducibilidad: Mismo código = mismo diagrama - Documentación como código IMPLEMENTACIÓN: - Fase 1: Setup local + plugins - Fase 2: Plantillas y guías - Fase 3: Integración CI/CD - Fase 4: Migración gradual de diagramas existentes Relacionado: PROC-GOB-001, GUIA-GOB-002, PROCED-GOB-001, PROCED-GOB-002
DECISIONES ARQUITECTÓNICAS: 1. ADR-GOB-005: Jerarquía de Requerimientos en 5 Niveles - Estructura: RN → RNEG → UC → RF → RNF - Trazabilidad bidireccional entre niveles - Stakeholders apropiados por nivel 2. ADR-GOB-006: Clasificación y Documentación de Reglas de Negocio - 5 tipos: Hechos, Restricciones, Desencadenadores, Inferencias, Cálculos - Herramientas: Matrices de roles/permisos, tablas para cálculos - Nomenclatura: RN-DOMINIO-### 3. ADR-GOB-007: Especificación de Casos de Uso (Formato Completo) - Principio fundamental: QUÉ vs CÓMO - Nomenclatura obligatoria: VERBO+OBJETO - Formato de dos columnas: Actor | Sistema - Grado: Completo (no breve/casual) - Estructura: ID, actores, pre/post, flujos, reglas negocio 4. ADR-GOB-008: Diagramas UML de Casos de Uso - Usando PlantUML (ADR-GOB-004) - CRÍTICO: Dirección flechas (Actor→UC primario, UC→Actor secundario) - Elementos: actores, óvalos, límite sistema, relaciones - Complemento: Diagramas de actividad para flujos complejos 5. ADR-GOB-009: Trazabilidad entre Artefactos de Requisitos - IDs únicos: TIPO-DOMINIO-### - Referencias explícitas bidireccionales - Matrices de trazabilidad - Scripts de validación CONTEXTO: Basado en material educativo sobre: - Reglas de Negocio en Ingeniería de Requerimientos - Casos de Uso en Ingeniería de Requerimientos IMPACTO: - Establece metodología completa de gestión de requisitos - Proporciona base para crear guías, procedimientos y plantillas - Permite análisis de impacto de cambios - Facilita validación de cumplimiento de objetivos Relacionado: ADR-GOB-004 (PlantUML), PROC-GOB-001
…ría de requisitos Se crean procedimientos operacionales basados en ADRs aprobados (005-009) para estandarizar el proceso de documentación de requisitos. Procedimientos creados (4): 1. PROCED-GOB-003: Documentar Regla de Negocio - 7 pasos detallados desde identificación hasta commit - Árbol de decisión para clasificar en 5 tipos - Templates específicos por tipo (Hecho, Restricción, Desencadenador, Inferencia, Cálculo) - Ejemplo completo: RN-BACK-029 - 23KB de contenido 2. PROCED-GOB-004: Crear Caso de Uso - 11 pasos desde identificación de actor hasta commit - Formato dos columnas (Actor | Sistema) - Validación del principio QUÉ vs CÓMO - Derivación de requisitos funcionales - Ejemplo completo: UC-BACK-010 Registrar Usuario - 34KB de contenido 3. PROCED-GOB-005: Análisis de Impacto de Cambios - 9 pasos para gestión de cambios con trazabilidad - Consulta bidireccional de dependencias - Checklist de cambios necesarios - Commit atómico de cambios relacionados - Ejemplo completo: RN-BACK-001 cambio a 2FA - 32KB de contenido 4. PROCED-GOB-006: Generar Diagrama UML con PlantUML - 9 pasos desde identificar UC hasta commit - Instalación de PlantUML - Dirección correcta de flechas (Actor→UC=primario, UC→Actor=secundario) - Relaciones include/extend - Templates completos y ejemplos - 36KB de contenido Técnicas aplicadas: - Auto-CoT: Cada procedimiento razona sobre objetivo, pre-requisitos, pasos, validaciones y resultado - Self-Consistency: Múltiples formas de ejecutar pasos validadas contra ADRs - Ejemplos reproducibles en cada paso Total: 125KB de documentación operacional Relacionado: ADR-GOB-005, ADR-GOB-006, ADR-GOB-007, ADR-GOB-008, ADR-GOB-009 Autor: Claude Code (Sonnet 4.5) Fecha: 2025-11-17
…e trazabilidad TRABAJO REALIZADO EN PARALELO POR 4 AGENTES ESPECIALIZADOS: ═══════════════════════════════════════════════════════════ AGENTE 1: GUÍAS DE INGENIERÍA DE REQUERIMIENTOS (102 KB) ═══════════════════════════════════════════════════════════ Creadas 4 guías técnicas detalladas: - GUIA-GOB-005: Derivar Requisitos entre Niveles (19 KB) * Metodología paso a paso para RN→RNEG→UC→RF→RNF * Ejemplos completos del proyecto IACT (autenticación, químicos) * Errores comunes y checklist de validación * 3 ejercicios prácticos con soluciones - GUIA-GOB-006: Identificar y Clasificar Reglas de Negocio (27 KB) * Árbol de decisión para clasificar en 5 tipos * Palabras clave específicas por tipo * 10+ ejemplos de cada tipo del dominio IACT * Diferenciación crítica Desencadenadores vs Inferencias * 2 ejercicios prácticos - GUIA-GOB-007: Escribir Casos de Uso Efectivos (31 KB) * Principio QUÉ vs CÓMO con ejercicios * Nomenclatura VERBO+OBJETO: 10 ejemplos buenos y 10 malos * Formato dos columnas (Actor | Sistema) * Flujos alternos vs excepciones * Checklist de calidad (30+ puntos) - GUIA-GOB-008: Crear Diagramas PlantUML (25 KB) * Setup completo de PlantUML (VSCode, CLI) * Regla de oro: Actor→UC (primario) vs UC→Actor (secundario) * Sintaxis UML completa con ejemplos * Diagramas de actividad para flujos complejos * Templates reutilizables ═══════════════════════════════════════════════════════════ AGENTE 2: PROCEDIMIENTOS OPERACIONALES (125 KB) ═══════════════════════════════════════════════════════════ Creados 4 procedimientos paso a paso: - PROCED-GOB-003: Documentar Regla de Negocio (23 KB) * 7 pasos detallados con árbol de decisión * Ejemplo completo RN-BACK-029 * Templates específicos por tipo - PROCED-GOB-004: Crear Caso de Uso (34 KB) * 11 pasos: desde identificación hasta commit * Validación QUÉ vs CÓMO * Ejemplo completo UC-BACK-010 Registrar Usuario - PROCED-GOB-005: Análisis de Impacto de Cambios (32 KB) * 9 pasos con trazabilidad bidireccional * Checklist de cambios * Ejemplo: cambio RN-BACK-001 afecta UC, RF, RNF - PROCED-GOB-006: Generar Diagrama UML PlantUML (36 KB) * 9 pasos: desde identificación hasta commit * Comandos exactos reproducibles * Ejemplo del módulo de auditoría ═══════════════════════════════════════════════════════════ AGENTE 3: PLANTILLAS (TEMPLATES) (110 KB) ═══════════════════════════════════════════════════════════ Creados 12 archivos en templates/: REGLAS DE NEGOCIO (5 templates): - RN-hecho-template.md - RN-restriccion-template.md (incluye matriz de permisos) - RN-desencadenador-template.md (SI-ENTONCES acción) - RN-inferencia-template.md (SI-ENTONCES conocimiento) - RN-calculo-template.md (fórmulas + tabla rangos) CASOS DE USO Y REQUISITOS (3 templates): - UC-template-completo.md (13 KB, formato dos columnas) - RF-template.md (criterios BDD, trazabilidad) - RNF-template.md (métricas medibles obligatorias) DIAGRAMAS PLANTUML (2 templates): - UCD-template.puml (casos de uso) - ACT-template.puml (actividad) TRAZABILIDAD (1 template): - MATRIZ-trazabilidad-template.md (3 tipos: vertical, horizontal, cobertura) DOCUMENTACIÓN: - README.md (22 KB, guía completa de uso) Características: - Instrucciones inline con comentarios HTML - Ejemplos parciales incluidos - Prevención de errores comunes - Frontmatter completo - Sin emojis, tono técnico ═══════════════════════════════════════════════════════════ AGENTE 4: SCRIPTS DE TRAZABILIDAD (37 KB + ejemplos) ═══════════════════════════════════════════════════════════ SCRIPTS IMPLEMENTADOS: 1. validar-trazabilidad.sh (14 KB, Bash) Funcionalidades: - Extracción de IDs (TIPO-DOMINIO-###) - Validación de formato - Detección de referencias rotas - Detección de IDs duplicados - Detección de artefactos huérfanos - Output coloreado con exit codes - Compatible bash 4+, sin dependencias 2. generar-matriz-trazabilidad.py (23 KB, Python) Funcionalidades: - Construcción de grafo bidireccional - 3 tipos de matrices: vertical, horizontal, dominio - Análisis de cobertura - Output a archivo o stdout - Python 3.8+, solo stdlib DOCUMENTACIÓN: - scripts/trazabilidad/README.md (12 KB) * Arquitectura del sistema * Guías de uso detalladas * Integración CI/CD * Casos de uso comunes - docs/gobernanza/trazabilidad/IMPLEMENTACION_SCRIPTS.md (13 KB) * 16 casos de prueba (todos PASS) * Outputs de ejemplo * Limitaciones y suposiciones ARCHIVOS DE PRUEBA (ejemplos_test/): - RN-BACK-001-autenticacion-requerida.md - RNEG-BACK-001-sistema-autenticacion.md - UC-BACK-001-iniciar-sesion.md - RF-BACK-010-validar-credenciales.md - RNF-BACK-005-longitud-contrasena.md - UC-FRONT-001-ejemplo-sin-referencias.md (caso problemático) MATRIZ GENERADA: - docs/gobernanza/trazabilidad/matrices/MATRIZ-BACK-autenticacion.md ═══════════════════════════════════════════════════════════ TÉCNICAS DE IA APLICADAS ═══════════════════════════════════════════════════════════ Auto-CoT (Automatic Chain of Thought): - Razonamiento paso a paso en guías y procedimientos - Preguntas clave para cada decisión - Ejercicios progresivos Self-Consistency: - Conceptos críticos desde múltiples perspectivas - Validación de coherencia entre ejemplos - Tablas comparativas para diferenciación ═══════════════════════════════════════════════════════════ RESUMEN TOTAL ═══════════════════════════════════════════════════════════ Archivos creados: 32 Tamaño total: ~380 KB Scripts funcionales: 2 Casos de prueba: 16 (todos PASS) Desglose: - 4 Guías (102 KB) - 4 Procedimientos (125 KB) - 12 Templates (110 KB) - 2 Scripts (37 KB) - 6 Ejemplos de prueba - 4 Documentos de soporte Estado: Listo para uso en producción Basado en: ADR-GOB-005, ADR-GOB-006, ADR-GOB-007, ADR-GOB-008, ADR-GOB-009
…ivel
Reorganización completa de la estructura de gobernanza:
1. Movimientos de archivos:
- casos_de_uso → requisitos/requerimientos_usuario/casos_uso/
- templates → docs/gobernanza/templates/
- Consolidación de arquitectura/, diagramas/, diseno_detallado/ → diseno/
2. Nuevos artefactos:
- ADR-GOB-010: Gobernanza Multi-nivel (Global vs Dominio)
- GUIA-GOB-009: Documentación UML Completa (10 tipos de diagramas)
3. Actualizaciones:
- docs/backend/gobernanza/README.md: Agregado sección de gobernanza multinivel
- docs/frontend/gobernanza/README.md: Agregado sección de gobernanza multinivel
Estructura resultante:
- /docs/gobernanza/ → Decisiones globales (proyecto completo)
- /docs/{dominio}/gobernanza/ → Decisiones específicas del dominio
- /docs/gobernanza/diseno/ → Consolidación de diseño (arquitectura + diagramas)
- /docs/gobernanza/requisitos/ → Requisitos organizados por jerarquía
Trazabilidad:
- Relacionado: ADR-GOB-001, ADR-GOB-004, ADR-GOB-008
- Implementa: Paso 1 de reorganización solicitada
…xpansión documentación Análisis y Planificación: - Análisis exhaustivo proyecto IACT (1,342 archivos, 47 ADRs, 27,001 LOC) - Plan de mejora 3 meses (342 horas, 2.1 FTE) - Validación trazabilidad con 16 referencias rotas identificadas Estructura de Dominios: - Creada estructura requisitos/ y diseno/ para backend, frontend, infra - READMEs documentando gobernanza multi-nivel por dominio Guías y Ejemplos: - GUIA-GOB-009 v1.1.0: 6 ejemplos reales del código IACT (862 líneas) - Vagrant DevBox (PostgreSQL + MariaDB) - Módulo permisos granular (8 modelos) - Algoritmo verificación permisos (3 prioridades) - Login JWT con bloqueo (3 intentos, 15 min) - Ciclo vida llamadas (7 estados) - Modelo completo permisos (8 tablas) Diagramas PlantUML (6 nuevos, 1,376 líneas): - CLASS-BACK-010: Modelo permisos granular - CLASS-BACK-020: Modelo llamadas - SEQ-AUTH-001: Login JWT - SEQ-PERM-007: Verificar permiso - COMP-BACK-001: Arquitectura backend (23 apps) - STATE-CALL-001: Estados llamada ADRs de Dominio (5 nuevos): - ADR-BACK-010: Django 5.2 framework - ADR-BACK-011: Multi-DB (PostgreSQL + MariaDB) - ADR-BACK-012: APScheduler (NO Celery) - ADR-FRONT-010: TypeScript adopción gradual - ADR-QA-010: Pytest framework Reportes QA: - Análisis proyecto: 68.75% madurez general - Plan mejora: 30 RNF, tests ivr_legacy, API reference, cobertura frontend 60% - Validación trazabilidad: 44.44% referencias rotas (16 de 36) Gaps Críticos Identificados: - RNF insuficientes: 4 de ~40 necesarios - 9 apps sin tests (ivr_legacy, analytics, etc.) - API Reference faltante - Cobertura frontend 31% (target 60%) Relacionado: ADR-GOB-010, ADR-GOB-005, ADR-GOB-009, ADR-GOB-004
- Versión: 1.0.0 → 1.1.0 - Estado: borrador → activo - Agregados 6 ejemplos_reales del código IACT - Archivos analizados: Vagrantfile, permissions/, llamadas/, authentication/ - Total: 1,365 líneas código analizadas Relacionado: ADR-GOB-004, ADR-012
Implementación de tareas prioritarias del Plan de Mejora Q1 2025: 1. API Reference drf-spectacular (8h): - Configurar SPECTACULAR_SETTINGS en base.py - Metadata completa: título, descripción, versión, contacto - Tags organizados: authentication, users, permissions, llamadas, analytics, reports - Endpoints ya existentes: /api/schema/ y /api/docs/ 2. Scaffolding 30 RNF Backend (40h): Creados 30 archivos RNF completos con estructura base: Performance (8 RNF): - RNF-BACK-010: Tiempo respuesta API REST (< 200ms p95) - RNF-BACK-011: Tiempo respuesta GraphQL (< 300ms p95) - RNF-BACK-012: Throughput APIs (>= 1000 req/s) - RNF-BACK-013: Latencia queries BD (< 50ms p95) - RNF-BACK-014: Tiempo carga dashboard (< 2s) - RNF-BACK-015: Tiempo generación reportes (< 5s para 10k) - RNF-BACK-016: Consumo memoria worker (< 512MB) - RNF-BACK-017: Uso CPU (< 70% promedio) Seguridad (7 RNF): - RNF-BACK-020: OWASP Top 10 compliance (100%) - RNF-BACK-021: Encriptación datos sensibles (AES-256) - RNF-BACK-022: Política contraseñas (NIST 800-63B) - RNF-BACK-023: Rate limiting (100 req/min por IP) - RNF-BACK-024: Auditoría acciones críticas (100% logged) - RNF-BACK-025: Sesiones JWT (15min access, 7d refresh) - RNF-BACK-026: HTTPS obligatorio (TLS 1.3) Disponibilidad (5 RNF): - RNF-BACK-030: Uptime 99.5% - RNF-BACK-031: RPO < 1h - RNF-BACK-032: RTO < 4h - RNF-BACK-033: Backup diario automático - RNF-BACK-034: Monitoreo health checks (< 1min detección) Escalabilidad (5 RNF): - RNF-BACK-040: Usuarios concurrentes (>= 200) - RNF-BACK-041: Crecimiento datos (10M llamadas/año) - RNF-BACK-042: Escalado horizontal (stateless workers) - RNF-BACK-043: Caché distribuido (>= 70% hit rate) - RNF-BACK-044: Particionamiento BD por fecha Usabilidad (3 RNF): - RNF-BACK-050: Mensajes error descriptivos (i18n) - RNF-BACK-051: Paginación APIs (default 20, max 100) - RNF-BACK-052: Logs estructurados (JSON, ELK) Mantenibilidad (2 RNF): - RNF-BACK-060: Cobertura tests (>= 80%) - RNF-BACK-061: Complejidad ciclomática (< 10) Cada RNF incluye: - Metadata completa (id, tipo, subtipo, categoría, versión, etc.) - Descripción y categoría - Métrica medible con valor objetivo - Método de medición (herramientas, frecuencia, proceso) - Criterios de aceptación con umbrales - Alcance y excepciones - Trazabilidad ascendente y descendente - Impacto en arquitectura - Validación y prioridad - Estado de cumplimiento - Dependencias - Historial de cambios 3. Estructura Tests ivr_legacy (24h): Creada estructura completa de tests en tests/ivr_legacy/: - __init__.py - test_models.py: Tests modelos IVRCall e IVRClient - test_queries.py: Tests IVRDataAdapter y queries - test_integration.py: Tests integración con BD legacy Cobertura de tests: - Test de modelos (configuración, campos, validaciones) - Test de queries y adapter (filtros, BD read-only) - Test de integración con mocks (evita dependencia BD real) - Fixtures para datos de prueba - Tests marcados con @pytest.mark.skip para casos que requieren BD real Referencias: - Plan: docs/gobernanza/qa/PLAN-MEJORA-2025-01-17.md Sección 8 - Template RNF: docs/gobernanza/templates/RNF-template.md - Objetivo: 80% cobertura tests ivr_legacy Archivos modificados: 1 Archivos creados: 34 (30 RNF + 4 tests)
Limpieza de estructura de documentación y consolidación en gobernanza: ## Cambios Realizados ### 1. Eliminación de Duplicados en docs/desarrollo/ (4 archivos) - ❌ ELIMINADO: METODOLOGIA_DESARROLLO_POR_LOTES.md - ❌ ELIMINADO: agentes_automatizacion.md (v1.2.0) - ❌ ELIMINADO: arquitectura_agentes_especializados.md - ❌ ELIMINADO: WORKFLOWS_COMPLETOS.md **Razón**: Duplicados de docs/gobernanza/metodologias/ con versiones obsoletas ### 2. Versiones Mantenidas en docs/gobernanza/metodologias/ - ✅ MANTENIDO: METODOLOGIA_DESARROLLO_POR_LOTES.md (más reciente) - ✅ MANTENIDO: agentes_automatizacion.md (v2.0.0, actualizado 2025-11-17) - ✅ MANTENIDO: arquitectura_agentes_especializados.md (más completo) - ✅ MANTENIDO: WORKFLOWS_COMPLETOS.md (más reciente) ### 3. README Redireccional en docs/desarrollo/ - ✅ CREADO: docs/desarrollo/README.md - Explica la migración - Tabla con ubicaciones nuevas - Enlaces a docs/gobernanza/metodologias/ - Navegación rápida a otros recursos ### 4. Análisis Post-Limpieza - ✅ CREADO: docs/gobernanza/qa/ANALISIS-GOBERNANZA-POST-LIMPIEZA-2025-11-17.md - Análisis de 403 archivos de gobernanza - Comparativa antes/después - Métricas de calidad - Gaps persistentes identificados - Recomendaciones priorizadas ## Métricas de Mejora **Antes vs Después**: - Archivos duplicados: 37 grupos → 5 grupos (-86.5%) - Archivos con TODO: 129 → 79 (-38.8%) - Referencias rotas (desarrollo): 4 → 2 (-50%) - Madurez gobernanza: 72% → 74% (+2%) ## Gaps Críticos Identificados 1. **P0**: INDICE_ADRs.md indexa solo 13/49 ADRs (19 ADRs IA NO indexados) 2. **P0**: marco_integrado duplicado en 3 ubicaciones (gobernanza/backend/frontend) 3. **P1**: 2 referencias rotas en docs/ai/ a rutas eliminadas 4. **P2**: 437 instancias TODO/PENDIENTE en 79 archivos ## Próximos Pasos - [ ] Actualizar INDICE_ADRs.md con todos 49 ADRs (1.5h) - [ ] Eliminar duplicados marco_integrado (2h) - [ ] Corregir referencias rotas en docs/ai/ (30min) ## Archivos Afectados **Eliminados**: 4 archivos (desarrollo/) **Creados**: 2 archivos (desarrollo/README.md + análisis QA) **Modificados**: 0 archivos existentes Total cambios: 6 archivos Referencias: - Análisis previo: docs/gobernanza/qa/ANALISIS-PROYECTO-2025-01-17.md - Metodologías: docs/gobernanza/metodologias/README.md
2-Coatl
deleted the
claude/analyze-project-agents-01CW4YLfCp3taEJjTCNbwpfq
branch
There was a problem hiding this comment.
Pull Request Overview
Este PR consolida trabajo extenso de gobernanza, QA y documentación, alineando nomenclatura con ADRs recientes, eliminando duplicados y estableciendo procedimientos operables para ingeniería de requerimientos. Incluye implementación de pasos iniciales del Plan de Mejora Q1 2025 en backend.
Cambios clave:
- Creación de 5 ADRs de gobernanza enfocados en ingeniería de requerimientos (jerarquía 5 niveles, clasificación reglas negocio, especificación casos de uso, diagramas UML, trazabilidad)
- Normalización de nomenclatura de ADRs existentes con patrón DOMINIO-###
- Eliminación de documentación duplicada (arquitectura agentes, workflows) en favor de estructura consolidada
- Actualización de READMEs de dominios para reflejar arquitectura de gobernanza multi-nivel
Reviewed Changes
Copilot reviewed 86 out of 287 changed files in this pull request and generated 4 comments.
Show a summary per file
| File | Description |
|---|---|
| ADR-GOB-004-plantuml-para-diagramas.md | Nuevo ADR estableciendo PlantUML como estándar para diagramas UML |
| ADR-GOB-005-jerarquia-requerimientos-5-niveles.md | Define jerarquía RN→RNEG→UC→RF→RNF con trazabilidad bidireccional |
| ADR-GOB-006-clasificacion-reglas-negocio.md | Clasifica reglas de negocio en 5 tipos (hechos, restricciones, desencadenadores, inferencias, cálculos) |
| ADR-GOB-007-especificacion-casos-uso.md | Especifica formato completo casos de uso con nomenclatura VERBO+OBJETO |
| ADR-GOB-008-diagramas-uml-casos-uso.md | Define convenciones PlantUML para diagramas de casos de uso y actividad |
| ADR-GOB-009-trazabilidad-artefactos-requisitos.md | Sistema de trazabilidad basado en IDs únicos y referencias explícitas |
| ADR-*.md (varios dominios) | Normalización de IDs con patrón ADR-DOMINIO-### |
| docs/frontend/requisitos/README.md | Actualizado para reflejar jerarquía ADR-GOB-005 |
| ADR-FRONT-010-typescript-adopcion-gradual.md | Nuevo ADR detallado de adopción gradual TypeScript |
| docs/frontend/diseno/README.md | Nuevo README estructurando diseño frontend con PlantUML |
| docs/desarrollo/arquitectura_agentes_especializados.md | Eliminado (duplicado, consolidado en gobernanza) |
| docs/desarrollo/agentes_automatizacion.md | Eliminado (duplicado, consolidado en gobernanza) |
| docs/desarrollo/WORKFLOWS_COMPLETOS.md | Eliminado (duplicado, consolidado en gobernanza) |
|
|
||
| ## Nomenclatura | ||
|
|
||
| ### Patrón de IDs |
There was a problem hiding this comment.
El ADR presenta dos patrones alternativos (RN vs BR) sin especificar cuál usar o en qué circunstancias. Documentar la decisión de usar RN o BR consistentemente, o eliminar la alternativa BR si RN es el estándar adoptado para mantener coherencia con ADR-GOB-009.
Comment on lines
+401
to
+402
| | Archivos .ts | 0 | 50% | ~15% (4/30) | → EN PROGRESO | | ||
| | Type coverage | 0% | 80% | ~15% | → EN PROGRESO | |
There was a problem hiding this comment.
Las métricas muestran valores actuales (~15%) pero el documento está fechado 2025-01-17 (futuro). Si este es un ADR nuevo, las métricas baseline deberían ser actuales. Verificar si las fechas y métricas reflejan el estado real del proyecto.
Comment on lines
+302
to
+313
| # Verificar que todos los IDs referenciados existen | ||
| grep -r "RN-BACK-" docs/gobernanza/requisitos/ | \ | ||
| grep -oE "RN-BACK-[0-9]{3}" | \ | ||
| sort -u | \ | ||
| while read id; do | ||
| if ! find docs/gobernanza/requisitos/reglas_negocio -name "*$id*" | grep -q .; then | ||
| echo "ERROR: $id referenciado pero no existe" | ||
| fi | ||
| done | ||
|
|
||
| # Verificar que UC tienen al menos 1 RF relacionado | ||
| find docs/gobernanza/requisitos/requerimientos_usuario/casos_uso -name "UC-*.md" | \ |
There was a problem hiding this comment.
El script de ejemplo usa rutas hardcodeadas que pueden no coincidir con la estructura real del proyecto (ej: docs/gobernanza/requisitos/). Considerar usar variables de configuración o detectar la raíz del proyecto automáticamente para mayor portabilidad.
Suggested change
| # Verificar que todos los IDs referenciados existen | |
| grep -r "RN-BACK-" docs/gobernanza/requisitos/ | \ | |
| grep -oE "RN-BACK-[0-9]{3}" | \ | |
| sort -u | \ | |
| while read id; do | |
| if ! find docs/gobernanza/requisitos/reglas_negocio -name "*$id*" | grep -q .; then | |
| echo "ERROR: $id referenciado pero no existe" | |
| fi | |
| done | |
| # Verificar que UC tienen al menos 1 RF relacionado | |
| find docs/gobernanza/requisitos/requerimientos_usuario/casos_uso -name "UC-*.md" | \ | |
| # Configurar la raíz del directorio de requisitos | |
| REQS_DIR="${REQS_DIR:-$(git rev-parse --show-toplevel 2>/dev/null)/docs/gobernanza/requisitos}" | |
| # Verificar que todos los IDs referenciados existen | |
| grep -r "RN-BACK-" "$REQS_DIR" | \ | |
| grep -oE "RN-BACK-[0-9]{3}" | \ | |
| sort -u | \ | |
| while read id; do | |
| if ! find "$REQS_DIR/reglas_negocio" -name "*$id*" | grep -q .; then | |
| echo "ERROR: $id referenciado pero no existe" | |
| fi | |
| done | |
| # Verificar que UC tienen al menos 1 RF relacionado | |
| find "$REQS_DIR/requerimientos_usuario/casos_uso" -name "UC-*.md" | \ |
Comment on lines
+639
to
+645
| # .github/workflows/diagrams.yml | ||
| name: Generate Diagrams | ||
|
|
||
| on: | ||
| pull_request: | ||
| paths: | ||
| - '**.puml' |
There was a problem hiding this comment.
El workflow de ejemplo para generación automática de diagramas PlantUML está documentado pero no se evidencia su implementación en los cambios del PR. Clarificar si este es un plan futuro o si el workflow ya existe y solo se está documentando.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Propongo algo así para el PR (puedes copiarlo tal cual y ajustarlo a tu plantilla si es necesario):
Título del PR
Gobernanza y QA: normalización de nomenclatura, consolidación de documentación y activación de próximos pasos Q1 2025
Resumen
Este PR consolida el trabajo de gobernanza, QA y documentación de agentes, alineando la estructura del repositorio con los ADRs recientes, normalizando la nomenclatura de documentos, eliminando duplicados y definiendo procedimientos operables para ingeniería de requerimientos.
Además, se implementan los primeros pasos inmediatos del Plan de Mejora Q1 2025 en el backend.
Alcance de los cambios
Motivo del cambio
Impacto esperado
Riesgos y consideraciones
Cambios masivos en rutas y nombres de archivos de documentación:
Introducción de nuevas convenciones de nomenclatura:
Cambios en backend:
Cómo revisar y probar
Documentación
ADRs y gobernanza
Backend
Checklist