Skip to content

Commit 525ab9a

Browse files
beyondnetPerubeyondnetPeru
committed
docs: update documentation with new master navigation index, localized POC portals, and refined knowledge hub pathways
1 parent c36492e commit 525ab9a

10 files changed

Lines changed: 150 additions & 37 deletions

File tree

‎MASTER_INDEX.es.md‎

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,19 +21,25 @@ Navegacion por fases de la documentacion del Sistema de Gestion de Usuarios (UMS
2121
- [Matriz de Permisos](./governance/requirements-es/permission-matrix-example.md)
2222
- [Historias Funcionales](./governance/requirements-es/functional-stories/index.md)
2323

24-
### Fase 02 -- Arquitectura
24+
### Fase 02 -- Planeacion MVP y Backlog de Proyecto
25+
26+
- [Priorizacion de Historias Funcionales para MVP](./governance/roadmap/mvp-functional-prioritization.es.md)
27+
- [Backlog de Proyecto](./governance/project-es/index.md)
28+
- [Backlog de Producto MVP](./governance/project-es/mvp-product-backlog.md)
29+
30+
### Fase 03 -- Arquitectura
2531

2632
- [Plan de Migracion .NET](./architecture/blueprints-es/dotnet-migration-and-tech-stack-plan.md)
2733
- [Mapa de Contextos Delimitados](./architecture/blueprints-es/bounded-context-map.md)
2834
- [Especificacion C4](./architecture/blueprints-es/architecture-spec.md)
2935
- [Stack Tecnologico](./architecture/blueprints-es/stack.md)
3036
- [Habilitadores Tecnicos](./architecture/blueprints-es/technical-enablers/index.md)
3137

32-
### Fase 03 -- Registros de Decision Arquitectonica (ADRs)
38+
### Fase 04 -- Registros de Decision Arquitectonica (ADRs)
3339

3440
- [Registro Completo de ADRs](./architecture/adrs-es/) (40 decisiones activas)
3541

36-
### Fase 04 -- Estandares de Ingenieria y Artefactos
42+
### Fase 05 -- Estandares de Ingenieria y Artefactos
3743

3844
- [Estandares de Ingenieria](./architecture/artifacts-es/engineering-standards.md)
3945
- [Modelo de Madurez Arquitectonica](./architecture/artifacts-es/architecture-maturity-model.md)
@@ -42,7 +48,8 @@ Navegacion por fases de la documentacion del Sistema de Gestion de Usuarios (UMS
4248
- [Especificacion IAM Empresarial](./architecture/artifacts-es/enterprise-iam-ums-specification.md)
4349
- [Reporte de Gobernanza Multi-Tenant](./architecture/artifacts-es/enterprise-multitenant-governance-report.md)
4450

45-
### Fase 05 -- Hoja de Ruta
51+
### Fase 06 -- Hoja de Ruta
4652

53+
- [Indice de Roadmap](./governance/roadmap/index.md)
4754
- [Estrategia de Versionado](./governance/roadmap/versioning-and-audit-strategy.md)
4855
- [CHANGELOG](./CHANGELOG.md)

‎MASTER_INDEX.md‎

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -21,19 +21,25 @@ Product Lifecycle and Engineering Specifications for the User Management System
2121
- [Permission Matrix](./governance/requirements/permission-matrix-example.md)
2222
- [Functional Stories](./governance/requirements/functional-stories/index.md)
2323

24-
### Phase 02 -- Architecture
24+
### Phase 02 -- MVP Planning and Project Backlog
25+
26+
- [MVP Functional Story Prioritization](./governance/roadmap/mvp-functional-prioritization.md)
27+
- [Project Backlog](./governance/project/index.md)
28+
- [MVP Product Backlog](./governance/project/mvp-product-backlog.md)
29+
30+
### Phase 03 -- Architecture
2531

2632
- [.NET Migration & Tech Stack Plan](./architecture/blueprints/dotnet-migration-and-tech-stack-plan.md)
2733
- [Bounded Context Map](./architecture/blueprints/bounded-context-map.md)
2834
- [C4 Architecture Spec](./architecture/blueprints/architecture-spec.md)
2935
- [Technology Stack](./architecture/blueprints/stack.md)
3036
- [Technical Enablers](./architecture/blueprints/technical-enablers/index.md)
3137

32-
### Phase 03 -- Architectural Decision Records (ADRs)
38+
### Phase 04 -- Architectural Decision Records (ADRs)
3339

3440
- [Full ADR Registry](./architecture/adrs/) (40 active decisions)
3541

36-
### Phase 04 -- Engineering Standards & Artifacts
42+
### Phase 05 -- Engineering Standards & Artifacts
3743

3844
- [Engineering Standards](./architecture/artifacts/engineering-standards.md)
3945
- [Architecture Maturity Model](./architecture/artifacts/architecture-maturity-model.md)
@@ -42,7 +48,8 @@ Product Lifecycle and Engineering Specifications for the User Management System
4248
- [Enterprise IAM Spec](./architecture/artifacts/enterprise-iam-ums-specification.md)
4349
- [Multi-Tenant Governance Report](./architecture/artifacts/enterprise-multitenant-governance-report.md)
4450

45-
### Phase 05 -- Release Roadmap
51+
### Phase 06 -- Release Roadmap
4652

53+
- [Roadmap Index](./governance/roadmap/index.md)
4754
- [Versioning & Audit Strategy](./governance/roadmap/versioning-and-audit-strategy.md)
4855
- [CHANGELOG](./CHANGELOG.md)

‎README.es.md‎

Lines changed: 30 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,21 @@
1111

1212
---
1313

14+
## 🧭 Índice Maestro de Navegación
15+
Empieza aquí si eres nuevo en UMS. Este índice le da a cada lector una ruta rápida dentro del repositorio sin necesidad de conocer la estructura de carpetas.
16+
17+
| Quiero... | Empezar Aquí | Luego Leer |
18+
| :--- | :--- | :--- |
19+
| Entender el producto | [Visión de Producto](./governance/product-es/product-vision.md) | [Contexto de Negocio](./governance/product-es/business-context.md) → [Alcance](./governance/product-es/scope.md) |
20+
| Ver qué debe construirse primero | [Priorización MVP](./governance/roadmap/mvp-functional-prioritization.es.md) | [Backlog de Producto MVP](./governance/project-es/mvp-product-backlog.md) |
21+
| Revisar requisitos funcionales | [Índice de Requisitos](./governance/requirements-es/index.md) | [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) → [Glosario](./governance/requirements-es/glossary.md) |
22+
| Validar datos y modelo de dominio | [Modelo de Datos Conceptual](./governance/requirements-es/conceptual-data-model.md) | [Formatos de Exportación ER](./architecture/blueprints-es/er-export-formats.md) → [Diseño ER de Base de Datos](./architecture/blueprints-es/database-design-er.md) |
23+
| Entender la arquitectura | [Portal de Arquitectura](./architecture/index.es.md) | [Especificación C4](./architecture/blueprints-es/architecture-spec.md) → [Registro ADR](./architecture/adrs-es/index.md) |
24+
| Construir u operar el sistema | [Engine Room](./src/) | [Habilitadores Técnicos](./architecture/blueprints-es/technical-enablers/index.md) → [Portal de Operaciones](./operations/index.md) |
25+
| Navegar todo | [Índice Maestro](./MASTER_INDEX.es.md) | Árbol completo de documentación por fase de ciclo de vida. |
26+
27+
---
28+
1429
## 🚀 Inicio Rápido (Motor Técnico)
1530
```powershell
1631
cd src
@@ -22,25 +37,27 @@ npm install; npx nx run app-web:dev
2237
## 📍 Hub de Conocimiento
2338
| Dominio | Índice del Portal | Contenidos |
2439
| :--- | :--- | :--- |
25-
| ⚖️ **Gobernanza** | [Portal de Gobernanza](./governance/index.es.md) | Visión, Contexto, Roadmap y Auditorías. |
26-
| 🏗️ **Arquitectura** | [Portal de Arquitectura](./architecture/index.es.md) | Registro ADR, Espec. C4 y Mapas de Contexto. |
27-
| 📋 **Requisitos** | [Índice de Requisitos](./governance/requirements-es/index.md) | Historias de Usuario, Glosario y Modelos. |
28-
| 🛠️ **Infraestructura** | [Infraestructura](./infrastructure/index.md) | Docker, Kong y Kubernetes. |
29-
| 🚀 **Operaciones** | [Portal de Operaciones](./operations/index.md) | Observabilidad (OTel), SQL y SRE. |
30-
| 🎓 **Conocimiento** | [Base de Conocimiento](./knowledge/index.md) | POCs, Investigación y Onboarding. |
40+
| ⚖️ **Gobernanza** | [Portal de Gobernanza](./governance/index.es.md) | Dirección de producto, estándares, roadmap, backlog de proyecto y auditorías. |
41+
| 🗂️ **Entrega de Proyecto** | [Backlog de Proyecto](./governance/project-es/index.md) | Épicas MVP, historias de usuario, orden de prioridad, fases y línea de corte. |
42+
| 📋 **Requisitos** | [Índice de Requisitos](./governance/requirements-es/index.md) | Historias funcionales, glosario de negocio, modelo de permisos y modelo conceptual. |
43+
| 🏗️ **Arquitectura** | [Portal de Arquitectura](./architecture/index.es.md) | Stack, registro ADR, especificación C4, contextos delimitados y habilitadores técnicos. |
44+
| 🛠️ **Infraestructura** | [Infraestructura](./infrastructure/index.md) | Docker, Kong, Kubernetes y configuración de ambientes. |
45+
| 🚀 **Operaciones** | [Portal de Operaciones](./operations/index.md) | Runbooks, observabilidad, operación SQL y prácticas SRE. |
46+
| 🎓 **Conocimiento** | [Base de Conocimiento](./knowledge/index.es.md) | Rutas de lectura recomendadas, POCs, investigación y onboarding. |
3147

3248
---
3349

3450
## 👥 Lectura Recomendada por Rol
3551
| Perfil | Objetivo de Lectura | Ruta de Aprendizaje (Links Directos) |
3652
| :--- | :--- | :--- |
37-
| **Director / Ejecutivo** | Estrategia y Valor de Negocio | [Visión](./governance/product-es/product-vision.md) → [Contexto](./governance/product-es/business-context.md) → [Roadmap](./governance/roadmap/index.md) |
38-
| **Product Owner** | Requisitos y Alcance Funcional | [Requisitos](./governance/requirements-es/index.md) → [Historias](./governance/requirements-es/functional-stories/index.md) → [Glosario](./governance/requirements-es/glossary.md) |
39-
| **Arquitecto de SW** | Diseño Técnico y Trazabilidad | [Espec. C4](./architecture/blueprints-es/architecture-spec.md) → [Registro ADR](./architecture/adrs-es/index.md) → [Mapa de Contextos](./architecture/blueprints-es/bounded-context-map.md) |
40-
| **Developer (BE/FE)** | Patrones, Estándares y Código | [Estándares](./architecture/artifacts-es/engineering-standards.md) → [Historias](./governance/requirements-es/functional-stories/index.md) → [Engine Room](./src/) |
41-
| **DevOps / SRE** | Infra, Seguridad y Ops | [Infraestructura](./infrastructure/index.md) → [Portal de Ops](./operations/index.md) → [Espec. IAM](./architecture/artifacts-es/enterprise-iam-ums-specification.md) |
42-
| **QA / Seguridad** | Calidad y Especificaciones | [Plan de Pruebas](./architecture/artifacts-es/contract-testing-plan.md) → [Espec. IAM](./architecture/artifacts-es/enterprise-iam-ums-specification.md) → [Madurez](./architecture/artifacts-es/architecture-maturity-model.md) |
43-
| **IA / Agentes** | BMAD-METHOD y Automatización | [Reglas de Agentes](./AGENTS.md) → [Estándar BMAD](./architecture/artifacts-es/bmad-master-audit-alignment-report.md) → [Auditoría Taxonomía](./governance/audits/2026-05-13-taxonomy-normalization-audit.md) |
53+
| **Director / Ejecutivo** | Valor de negocio, alcance MVP y confianza de entrega | [Visión de Producto](./governance/product-es/product-vision.md) → [Contexto de Negocio](./governance/product-es/business-context.md) → [Priorización MVP](./governance/roadmap/mvp-functional-prioritization.es.md) → [Backlog de Producto MVP](./governance/project-es/mvp-product-backlog.md) |
54+
| **Product Owner** | Alcance funcional, secuencia y propiedad del backlog | [Requisitos](./governance/requirements-es/index.md) → [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) → [Priorización MVP](./governance/roadmap/mvp-functional-prioritization.es.md) → [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) |
55+
| **Analista de Negocio** | Narrativa de negocio, reglas, criterios de aceptación y trazabilidad | [Estándar de Historias Funcionales](./governance/requirements-es/functional-stories/functional-story-standard.md) → [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) → [Glosario](./governance/requirements-es/glossary.md) → [Modelo Conceptual](./governance/requirements-es/conceptual-data-model.md) |
56+
| **Arquitecto de SW** | Diseño técnico, decisiones y límites de dominio | [Portal de Arquitectura](./architecture/index.es.md) → [Especificación C4](./architecture/blueprints-es/architecture-spec.md) → [Registro ADR](./architecture/adrs-es/index.md) → [Mapa de Contextos](./architecture/blueprints-es/bounded-context-map.md) |
57+
| **Developer (BE/FE)** | Qué construir, por qué importa y cómo debe integrarse | [Backlog de Producto](./governance/project-es/mvp-product-backlog.md) → [Historias Funcionales](./governance/requirements-es/functional-stories/index.md) → [Habilitadores Técnicos](./architecture/blueprints-es/technical-enablers/index.md) → [Engine Room](./src/) |
58+
| **DevOps / SRE** | Ambientes, confiabilidad, observabilidad y soporte | [Infraestructura](./infrastructure/index.md) → [Portal de Operaciones](./operations/index.md) → [Runbooks](./operations/runbooks/index.md) → [Estrategia de Observabilidad](./architecture/artifacts-es/observability-strategy.md) |
59+
| **QA / Seguridad** | Quality gates, riesgos de acceso y estrategia de verificación | [Plan de Pruebas de Contrato](./architecture/artifacts-es/contract-testing-plan.md) → [Especificación IAM Empresarial](./architecture/artifacts-es/enterprise-iam-ums-specification.md) → [Modelo de Madurez Arquitectónica](./architecture/artifacts-es/architecture-maturity-model.md) |
60+
| **IA / Agentes** | BMAD-METHOD, reglas del repositorio y contexto de automatización | [Reglas de Agentes](./AGENTS.md) → [Base de Conocimiento](./knowledge/index.es.md) → [Auditoría BMAD](./architecture/artifacts-es/bmad-master-audit-alignment-report.md) → [Auditoría Taxonomía](./governance/audits/2026-05-13-taxonomy-normalization-audit.md) |
4461

4562
---
4663

0 commit comments

Comments
 (0)