Skip to content

Commit 88dcc47

Browse files
committed
docs: agregar documentacion de logging DORA y estructura backend completa
- logs_data/: Esquemas JSON para metricas DORA (temporal hasta Cassandra) - deployment_logs.json: Logs de deployments - dora_metrics.json: Metricas DORA calculadas - incident_logs.json: Logs de incidentes - SCHEMA.md: Documentacion completa de esquemas y uso - README.md: Proposito y plan de migracion a Cassandra - docs/backend/: Estructura completa de documentacion backend - deployment/: Procedimientos de deployment - devops/: Scripts CLI y agentes SDLC - diseno/: Patrones de diseno - testing/: Estrategia de testing - .github/CODEOWNERS: Ownership claro de componentes Todas las validaciones de emojis pasaron exitosamente. Documentacion lista para migracion a Cassandra cuando este disponible.
1 parent c21353d commit 88dcc47

13 files changed

Lines changed: 1094 additions & 380 deletions

File tree

.github/CODEOWNERS

Lines changed: 82 additions & 265 deletions
Original file line numberDiff line numberDiff line change
@@ -1,265 +1,82 @@
1-
# CODEOWNERS - Ownership y Revisión de Documentación
2-
#
3-
# Este archivo define los owners por área de documentación.
4-
# Los owners son automáticamente solicitados para review en PRs que modifican sus áreas.
5-
#
6-
# Formato: <path pattern> <@github-username> <@github-team>
7-
# Documentación: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
8-
9-
# ============================================================================
10-
# DOCUMENTACIÓN TÉCNICA
11-
# ============================================================================
12-
13-
# Documentación Backend
14-
# Owner: Equipo Backend Lead + Arquitecto Senior
15-
docs/backend/** @equipo-backend-lead @arquitecto-senior
16-
docs/backend/requisitos/** @product-owner @equipo-backend-lead
17-
docs/backend/arquitectura/** @arquitecto-senior
18-
docs/backend/diseno/** @arquitecto-senior @equipo-backend-lead
19-
docs/backend/devops/** @devops-lead
20-
docs/backend/qa/** @qa-lead
21-
22-
# Documentación Frontend
23-
# Owner: Equipo Frontend Lead
24-
docs/frontend/** @equipo-frontend-lead @arquitecto-senior
25-
docs/frontend/requisitos/** @product-owner @equipo-frontend-lead
26-
docs/frontend/arquitectura/** @arquitecto-senior @equipo-frontend-lead
27-
docs/frontend/devops/** @devops-lead
28-
docs/frontend/qa/** @qa-lead
29-
30-
# Documentación Infrastructure
31-
# Owner: DevOps Lead
32-
docs/infrastructure/** @devops-lead @arquitecto-senior
33-
docs/infrastructure/requisitos/** @product-owner @devops-lead
34-
docs/infrastructure/devops/** @devops-lead
35-
docs/infrastructure/cpython_precompilado/** @devops-lead
36-
37-
# ============================================================================
38-
# DOCUMENTACIÓN TRANSVERSAL
39-
# ============================================================================
40-
41-
# Arquitectura Transversal
42-
# Owner: Arquitecto Senior
43-
docs/arquitectura/** @arquitecto-senior
44-
docs/arquitectura/STORAGE_ARCHITECTURE.md @arquitecto-senior @devops-lead
45-
docs/adr/** @arquitecto-senior
46-
47-
# Requisitos de Negocio
48-
# Owner: Product Owner + Arquitecto Senior
49-
docs/requisitos/** @product-owner @arquitecto-senior
50-
docs/vision_y_alcance/** @product-owner @arquitecto-senior
51-
52-
# Guias Operativas
53-
# Owner: Doc Lead + Arquitecto Senior
54-
docs/guias/** @doc-lead @arquitecto-senior
55-
docs/guias/onboarding/** @doc-lead @tech-lead
56-
docs/guias/workflows/** @tech-lead @devops-lead
57-
docs/guias/testing/** @qa-lead @tech-lead
58-
docs/guias/deployment/** @devops-lead @tech-lead
59-
docs/guias/troubleshooting/** @tech-lead @devops-lead
60-
docs/plantillas/guia-template.md @doc-lead @arquitecto-senior
61-
62-
# Gobernanza y Procesos
63-
# Owner: Arquitecto Senior + Tech Lead
64-
docs/gobernanza/** @arquitecto-senior @tech-lead
65-
docs/gobernanza/metodologias/** @arquitecto-senior @tech-lead
66-
docs/gobernanza/marco_integrado/** @arquitecto-senior @tech-lead
67-
docs/gobernanza/agentes/** @arquitecto-senior @tech-lead
68-
docs/gobernanza/ai/** @arquitecto-senior @tech-lead
69-
70-
# SDLC Outputs (issues, plans, reports auto-generados)
71-
# Owner: Arquitecto Senior
72-
docs/sdlc_outputs/** @arquitecto-senior
73-
74-
# Plantillas y Estándares
75-
# Owner: Arquitecto Senior
76-
docs/plantillas/** @arquitecto-senior
77-
78-
# Testing y QA
79-
# Owner: QA Lead
80-
docs/testing/** @qa-lead @arquitecto-senior
81-
docs/qa/** @qa-lead @arquitecto-senior
82-
83-
# Proyecto y Vision
84-
# Owner: Product Owner + Arquitecto Senior
85-
docs/proyecto/** @product-owner @arquitecto-senior
86-
87-
# DORA Metrics y Operaciones
88-
# Owner: DevOps Lead + SRE Lead
89-
docs/dora/** @devops-lead @sre-lead
90-
docs/operaciones/** @devops-lead @sre-lead
91-
92-
# Features y Funcionalidades
93-
# Owner: Tech Lead + Backend Lead
94-
docs/features/** @tech-lead @equipo-backend-lead
95-
96-
# AI Telemetry System (TASK-024)
97-
# Owner: Arquitecto Senior + Tech Lead
98-
api/callcentersite/dora_metrics/ai_telemetry.py @arquitecto-senior @tech-lead
99-
api/callcentersite/dora_metrics/tests_ai_telemetry.py @arquitecto-senior @qa-lead
100-
api/callcentersite/dora_metrics/migrations/0003_aitelemetry.py @arquitecto-senior @devops-lead
101-
docs/gobernanza/ai/TASK-024-ai-telemetry-system.md @arquitecto-senior @tech-lead
102-
103-
# Predictive Analytics (TASK-033)
104-
# Owner: Arquitecto Senior + Tech Lead
105-
api/callcentersite/dora_metrics/ml_features.py @arquitecto-senior @tech-lead
106-
api/callcentersite/dora_metrics/ml_models.py @arquitecto-senior @tech-lead
107-
api/callcentersite/dora_metrics/tests_predictive_analytics.py @arquitecto-senior @qa-lead
108-
scripts/ml/retrain_deployment_risk_model.py @arquitecto-senior @devops-lead
109-
docs/features/ai/TASK-033-predictive-analytics.md @arquitecto-senior @tech-lead
110-
111-
# Auto-remediation System (TASK-034)
112-
# Owner: Arquitecto Senior + SRE Lead
113-
api/callcentersite/dora_metrics/auto_remediation.py @arquitecto-senior @sre-lead
114-
docs/features/ai/TASK-034-auto-remediation-system.md @arquitecto-senior @sre-lead
115-
116-
# Performance Benchmarking (TASK-035)
117-
# Owner: Arquitecto Senior + DevOps Lead
118-
scripts/benchmarking/run_benchmarks.sh @arquitecto-senior @devops-lead
119-
docs/arquitectura/TASK-035-performance-benchmarking.md @arquitecto-senior @devops-lead
120-
121-
# Disaster Recovery (TASK-036)
122-
# Owner: SRE Lead + DevOps Lead
123-
scripts/disaster_recovery/*.sh @sre-lead @devops-lead
124-
docs/operaciones/TASK-036-disaster-recovery.md @sre-lead @devops-lead
125-
126-
# Production Readiness (TASK-038)
127-
# Owner: Tech Lead + SRE Lead
128-
docs/operaciones/TASK-038-production-readiness.md @tech-lead @sre-lead
129-
130-
# ============================================================================
131-
# DOCUMENTACIÓN AUTO-GENERADA
132-
# ============================================================================
133-
134-
# Docs auto-generados requieren revisión especial
135-
# Verificar que info auto-generada es correcta y completa
136-
docs/**/arquitectura/*.md @arquitecto-senior
137-
138-
# ============================================================================
139-
# ANÁLISIS Y REPORTES
140-
# ============================================================================
141-
142-
# Análisis y reportes de documentación
143-
docs/anexos/** @arquitecto-senior
144-
docs/specs/** @arquitecto-senior @product-owner
145-
146-
# ============================================================================
147-
# SCRIPTS DE AUTOMATIZACIÓN
148-
# ============================================================================
149-
150-
# Scripts SDLC Core
151-
scripts/sdlc_agent.py @tech-lead @arquitecto-senior
152-
scripts/ai/agents/sdlc_orchestrator.py @tech-lead @arquitecto-senior
153-
scripts/ai/agents/sdlc_planner.py @tech-lead @arquitecto-senior
154-
scripts/ai/agents/sdlc_feasibility.py @arquitecto-senior @tech-lead
155-
scripts/ai/agents/sdlc_design.py @arquitecto-senior @tech-lead
156-
scripts/ai/agents/sdlc_testing.py @qa-lead @tech-lead
157-
scripts/ai/agents/sdlc_deployment.py @devops-lead @tech-lead
158-
scripts/ai/agents/sdlc_base.py @arquitecto-senior @tech-lead
159-
160-
# Scripts de agentes AI
161-
scripts/ai/agents/** @tech-lead @ai-lead
162-
163-
# Scripts de documentación y sincronización
164-
scripts/sync_documentation.py @arquitecto-senior @devops-lead
165-
scripts/reorganizar_docs_por_dominio.sh @arquitecto-senior @devops-lead
166-
scripts/validar_estructura_docs.sh @arquitecto-senior @devops-lead
167-
scripts/generate_guides.py @doc-lead @arquitecto-senior
168-
scripts/ai/agents/documentation_sync_agent.py @arquitecto-senior
169-
170-
# Scripts de metricas DORA
171-
scripts/dora_metrics.py @devops-lead @tech-lead
172-
scripts/generate_dora_report.sh @devops-lead @tech-lead
173-
scripts/ai/agents/dora_sdlc_integration.py @devops-lead @tech-lead
174-
175-
# Scripts de CI/CD
176-
scripts/ci/** @devops-lead @tech-lead
177-
scripts/deploy.sh @devops-lead @sre-lead
178-
scripts/health_check.sh @devops-lead @sre-lead
179-
scripts/run_all_tests.sh @qa-lead @tech-lead
180-
scripts/run_integration_tests.sh @qa-lead @tech-lead
181-
182-
# Scripts de requisitos
183-
scripts/requisitos/** @arquitecto-senior @product-owner
184-
185-
# Scripts de disaster recovery
186-
scripts/disaster_recovery/** @devops-lead @dba-lead
187-
188-
# Scripts de base de datos
189-
scripts/cassandra/** @dba-lead @devops-lead
190-
scripts/validate_database_router.sh @dba-lead @arquitecto-senior
191-
192-
# Scripts de validacion
193-
scripts/validate_critical_restrictions.sh @arquitecto-senior @tech-lead
194-
scripts/validate_security_config.sh @devops-lead @arquitecto-senior
195-
scripts/check_no_emojis.py @tech-lead
196-
197-
# Scripts de logging (Cassandra centralized logging)
198-
scripts/logging/** @devops-lead @arquitecto-senior
199-
200-
# Scripts de testing
201-
scripts/ai/agents/test_runner.py @qa-lead @tech-lead
202-
scripts/ai/run_test_generation.sh @qa-lead @tech-lead
203-
204-
# Scripts de utilities
205-
scripts/cleanup_sessions.sh @backend-lead
206-
scripts/cleanup_branches.sh @tech-lead
207-
scripts/install_hooks.sh @tech-lead
208-
scripts/complete_sync.sh @tech-lead
209-
210-
# Templates de scripts
211-
scripts/templates/** @tech-lead @arquitecto-senior
212-
213-
# Documentacion de scripts
214-
docs/scripts/** @doc-lead @tech-lead
215-
216-
# ============================================================================
217-
# CONFIGURACIÓN DE DOCUMENTACIÓN
218-
# ============================================================================
219-
220-
# MkDocs y configuración de documentación
221-
docs/mkdocs.yml @arquitecto-senior @tech-lead
222-
docs/requirements.txt @devops-lead
223-
docs/index.md @arquitecto-senior
224-
docs/README.md @arquitecto-senior
225-
226-
# Project Management
227-
# Owner: Arquitecto Senior + Tech Lead
228-
TODO.md @arquitecto-senior @tech-lead
229-
PLAN_EJECUCION_COMPLETO.md @arquitecto-senior @tech-lead
230-
231-
# Analysis and Verification Reports
232-
# Owner: Arquitecto Senior
233-
VERIFICATION_REPORT.md @arquitecto-senior
234-
DOCS_LEGACY_ANALYSIS_REPORT.md @arquitecto-senior
235-
MAPEO_MIGRACION_LEGACY.md @arquitecto-senior
236-
237-
# ============================================================================
238-
# CI/CD WORKFLOWS
239-
# ============================================================================
240-
241-
# Workflows de documentación
242-
.github/workflows/docs.yml @devops-lead @arquitecto-senior
243-
.github/workflows/sync-docs.yml @devops-lead @arquitecto-senior
244-
.github/workflows/docs-validation.yml @devops-lead @arquitecto-senior
245-
.github/workflows/requirements_*.yml @arquitecto-senior @product-owner
246-
247-
# ============================================================================
248-
# NOTAS
249-
# ============================================================================
250-
#
251-
# Roles definidos:
252-
# - @arquitecto-senior: Responsable de arquitectura y diseño técnico
253-
# - @equipo-backend-lead: Lead del equipo backend
254-
# - @equipo-frontend-lead: Lead del equipo frontend
255-
# - @devops-lead: Lead de DevOps e infrastructure
256-
# - @product-owner: Product Owner / Requirements Owner
257-
# - @qa-lead: Lead de QA y testing
258-
# - @tech-lead: Tech Lead general del proyecto
259-
#
260-
# Proceso de revisión:
261-
# 1. PR que modifica docs/ requiere aprobación de owner correspondiente
262-
# 2. Docs auto-generados requieren verificación de arquitecto
263-
# 3. Cambios en requisitos requieren aprobación de PO + Arquitecto
264-
# 4. Cambios en scripts requieren aprobación de Arquitecto + DevOps
265-
#
1+
# CODEOWNERS - Define ownership de codigo y documentacion
2+
# Ver: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
3+
4+
# Global owners (fallback para archivos sin owner especifico)
5+
* @tech-lead
6+
7+
# === BACKEND ===
8+
/api/ @backend-lead @tech-lead
9+
/api/apps/ @backend-lead
10+
/api/settings/ @backend-lead @arquitecto-senior
11+
/api/tests/ @qa-lead @backend-lead
12+
13+
# === FRONTEND ===
14+
/frontend/ @frontend-lead @tech-lead
15+
/frontend/src/components/ @frontend-lead
16+
/frontend/src/pages/ @frontend-lead
17+
/frontend/tests/ @qa-lead @frontend-lead
18+
19+
# === INFRASTRUCTURE ===
20+
/infrastructure/ @devops-lead @tech-lead
21+
/infrastructure/cpython/ @devops-lead
22+
/infrastructure/devcontainer/ @devops-lead
23+
/infrastructure/vagrant/ @devops-lead
24+
25+
# === SCRIPTS ===
26+
/scripts/ @devops-lead @tech-lead
27+
/scripts/ai/ @arquitecto-senior @tech-lead
28+
/scripts/ai/agents/ @arquitecto-senior
29+
/scripts/ci/ @devops-lead @qa-lead
30+
/scripts/requisitos/ @arquitecto-senior @product-owner
31+
32+
# === DOCUMENTATION ===
33+
/docs/ @doc-lead @tech-lead
34+
/docs/arquitectura/ @arquitecto-senior
35+
/docs/backend/ @backend-lead @arquitecto-senior
36+
/docs/backend/requisitos/ @arquitecto-senior @product-owner
37+
/docs/backend/devops/ @devops-lead
38+
/docs/backend/diseno/ @arquitecto-senior
39+
/docs/backend/testing/ @qa-lead
40+
/docs/backend/deployment/ @devops-lead
41+
/docs/backend/gobernanza/ @tech-lead @product-owner
42+
/docs/adr/ @arquitecto-senior @tech-lead
43+
/docs/guias/ @doc-lead
44+
/docs/specs/ @arquitecto-senior @product-owner
45+
/docs/plantillas/ @doc-lead @arquitecto-senior
46+
47+
# === CI/CD ===
48+
/.github/workflows/ @devops-lead @tech-lead
49+
/.github/workflows/backend-ci.yml @devops-lead @backend-lead
50+
/.github/workflows/frontend-ci.yml @devops-lead @frontend-lead
51+
/.github/workflows/security-scan.yml @devops-lead @security-lead
52+
/.github/workflows/deploy.yml @devops-lead @tech-lead
53+
54+
# === CONFIGURATION ===
55+
/.env.example @devops-lead
56+
/docker-compose.yml @devops-lead
57+
/Makefile @devops-lead @tech-lead
58+
59+
# === REQUISITOS ===
60+
/docs/requisitos/ @arquitecto-senior @product-owner
61+
/docs/requisitos/funcionales/ @product-owner
62+
/docs/requisitos/no_funcionales/ @arquitecto-senior @tech-lead
63+
64+
# === GOVERNANCE ===
65+
/docs/gobernanza/ @tech-lead @product-owner
66+
/docs/gobernanza/procesos/ @tech-lead
67+
/docs/gobernanza/ci_cd/ @devops-lead
68+
69+
# === TESTING ===
70+
/tests/ @qa-lead
71+
**/tests/ @qa-lead
72+
73+
# === SECURITY ===
74+
/.github/workflows/security-scan.yml @security-lead @devops-lead
75+
/scripts/validate_security_config.sh @security-lead
76+
/scripts/validate_critical_restrictions.sh @arquitecto-senior @security-lead
77+
78+
# === CRITICAL FILES (require multiple approvals) ===
79+
/README.md @tech-lead @product-owner
80+
/CONTRIBUTING.md @tech-lead @doc-lead
81+
/LICENSE @product-owner @tech-lead
82+
/.github/CODEOWNERS @tech-lead @devops-lead @arquitecto-senior

0 commit comments

Comments
 (0)