|
1 | | -# 🗺️ Global Master Index (UMS Entry Point) |
| 1 | +# Master Index -- UMS Navigation Hub |
2 | 2 |
|
3 | | -> 🌍 **Bilingual Navigation:** [🇪🇸 Versión en Español (Índice Maestro)](./MASTER_INDEX.es.md) | [🇺🇸 English](./MASTER_INDEX.md) |
| 3 | +> **Language:** [English](./MASTER_INDEX.md) | [Espanol](./MASTER_INDEX.es.md) |
4 | 4 |
|
5 | | -Welcome to the **User Management System (UMS)** central nervous system. This master index serves as the canonical routing gate for all actors interacting with this repository. Locate your designated profile below to access your tailored, accelerated reading path ensuring technical and procedural compliance. |
| 5 | +Phase-based navigation for the User Management System (UMS) documentation. |
6 | 6 |
|
7 | 7 | --- |
8 | 8 |
|
9 | | -## 🚀 1. Accelerated Paths by Role (Role-Based Navigation) |
| 9 | +### Phase 00 -- Product Vision |
10 | 10 |
|
11 | | -Identify your current relationship with the project to unlock the tailored compulsory reading hierarchy: |
| 11 | +- [Product Vision](./src/ums-workspace/docs/en/00-product/product-vision.md) |
| 12 | +- [Business Context](./src/ums-workspace/docs/en/00-product/business-context.md) |
| 13 | +- [Scope and Boundaries](./src/ums-workspace/docs/en/00-product/scope.md) |
| 14 | +- [Objectives (OKRs)](./src/ums-workspace/docs/en/00-product/objectives.md) |
| 15 | +- [Stakeholders](./src/ums-workspace/docs/en/00-product/stakeholders.md) |
12 | 16 |
|
13 | | -| Enterprise Role | Recommended Reading Path | Compliance Expected | |
14 | | -| :--- | :--- | :--- | |
15 | | -| **External Software Vendor** | 1. [bMAD Master Documentation](./src/ums-workspace/docs/en/index.md)<br>2. [Global Engineering Standards](./src/ums-workspace/docs/en/04-artifacts/engineering-standards.md)<br>3. [C4 Master Specification](./src/ums-workspace/docs/en/02-architecture/architecture-spec.md) | Validate tech baseline, environment isolation, and boundary checks before initiating work. | |
16 | | -| **Backend Developer / QA** | 1. [Plan for .NET Migration & Hexagonal Boundaries](./src/ums-workspace/docs/en/02-architecture/dotnet-migration-and-tech-stack-plan.md)<br>2. [Contract Testing Plan](./src/ums-workspace/docs/en/04-artifacts/contract-testing-plan.md)<br>3. [Testing Pyramid Quality Gates (ADR-0018)](./src/ums-workspace/docs/en/03-adrs/0018-testing-pyramid-quality-gates.md) | Enforce Test thresholds, DDD patterns, lint validations, and avoid leakages into the core domain. | |
17 | | -| **Solutions Architect** | 1. [Bounded Context Map](./src/ums-workspace/docs/en/02-architecture/bounded-context-map.md)<br>2. [ADR Registry](./src/ums-workspace/docs/en/03-adrs/)<br>3. [Distributed Observability Strategy](./src/ums-workspace/docs/en/04-artifacts/observability-strategy.md) | Assess overall pattern integrity, evaluate risk indices, and approve microservice readiness gates. | |
18 | | -| **Product Owner / PM** | 1. [Product Vision](./src/ums-workspace/docs/en/00-product/product-vision.md)<br>2. [Functional Stories Directory](./src/ums-workspace/docs/en/01-requirements/functional-stories/index.md)<br>3. [Gap Analysis & Debt Strategy](./src/ums-workspace/docs/en/04-artifacts/gap-analysis-and-optimization-plan.md) | Align release milestones with ADR maturity and govern functional stories coverage. | |
| 17 | +### Phase 01 -- Domain Requirements |
19 | 18 |
|
20 | | ---- |
21 | | - |
22 | | -## 🛡️ 2. Mandatory Compliance Path (Global Baseline) |
23 | | - |
24 | | -All contributors—regardless of seniority—MUST adhere to and enforce the foundational anchors below: |
25 | | - |
26 | | -* 📄 **[Global Engineering Standards](./src/ums-workspace/docs/en/04-artifacts/engineering-standards.md)**: Non-negotiable coding standards, SOLID, Clean Code, and OWASP. |
27 | | -* 📄 **[Architecture Maturity Model (AMM)](./src/ums-workspace/docs/en/04-artifacts/architecture-maturity-model.md)**: Comprehensive criteria for corporate enterprise readiness. |
28 | | -* 📄 **[.NET 8 Core Migration Plan](./src/ums-workspace/docs/en/02-architecture/dotnet-migration-and-tech-stack-plan.md)**: Mandatory decoupling criteria for domain models under C#. |
29 | | -* 📄 **[Contract Testing Strategy](./src/ums-workspace/docs/en/04-artifacts/contract-testing-plan.md)**: Quality gates for decoupled integration validations. |
30 | | - |
31 | | ---- |
32 | | - |
33 | | -## 🏛️ 3. bMAD Structure and Taxonomy (Phase-Based Navigation) |
34 | | - |
35 | | -This repository's documentation follows the **spec-driven AI strategy BMAD-METHOD** (numerical sequential phases). Click the references to navigate through the knowledge base: |
| 19 | +- [Glossary (Ubiquitous Language)](./src/ums-workspace/docs/en/01-requirements/glossary.md) |
| 20 | +- [Conceptual Data Model](./src/ums-workspace/docs/en/01-requirements/conceptual-data-model.md) |
| 21 | +- [Permission Matrix](./src/ums-workspace/docs/en/01-requirements/permission-matrix-example.md) |
| 22 | +- [Functional Stories](./src/ums-workspace/docs/en/01-requirements/functional-stories/index.md) |
36 | 23 |
|
37 | | -### 🎯 **[Phase 00 - Product Vision](./src/ums-workspace/docs/en/00-product/)** |
38 | | -* [Product Vision](./src/ums-workspace/docs/en/00-product/product-vision.md) | [Business Context](./src/ums-workspace/docs/en/00-product/business-context.md) | [Scope and Boundaries](./src/ums-workspace/docs/en/00-product/scope.md) | [Objectives (OKRs)](./src/ums-workspace/docs/en/00-product/objectives.md) | [Stakeholders](./src/ums-workspace/docs/en/00-product/stakeholders.md) |
| 24 | +### Phase 02 -- Architecture |
39 | 25 |
|
40 | | -### 📋 **[Phase 01 - Domain Requirements](./src/ums-workspace/docs/en/01-requirements/)** |
41 | | -* [Atomic Use Cases Catalog](./src/ums-workspace/docs/en/01-requirements/usecases/) | [Conceptual Data Model](./src/ums-workspace/docs/en/01-requirements/conceptual-data-model.md) | [Permission Matrix](./src/ums-workspace/docs/en/01-requirements/permission-matrix-example.md) | [DDD Glossary](./src/ums-workspace/docs/en/01-requirements/glossary.md) |
| 26 | +- [.NET Migration & Tech Stack Plan](./src/ums-workspace/docs/en/02-architecture/dotnet-migration-and-tech-stack-plan.md) |
| 27 | +- [Bounded Context Map](./src/ums-workspace/docs/en/02-architecture/bounded-context-map.md) |
| 28 | +- [C4 Architecture Spec](./src/ums-workspace/docs/en/02-architecture/architecture-spec.md) |
| 29 | +- [Technology Stack](./src/ums-workspace/docs/en/02-architecture/stack.md) |
| 30 | +- [Technical Enablers](./src/ums-workspace/docs/en/02-architecture/technical-enablers/index.md) |
42 | 31 |
|
43 | | -### 🏗️ **[Phase 02 - Architectural Design](./src/ums-workspace/docs/en/02-architecture/)** |
44 | | -* **[.NET 8 Migration Plan](./src/ums-workspace/docs/en/02-architecture/dotnet-migration-and-tech-stack-plan.md)** | [C4 Master Specification](./src/ums-workspace/docs/en/02-architecture/architecture-spec.md) | [Bounded Context Map](./src/ums-workspace/docs/en/02-architecture/bounded-context-map.md) | [Vendor Lock-In Risk Assessment](./src/ums-workspace/docs/en/02-architecture/vendor-risk-assessment.md) |
| 32 | +### Phase 03 -- Architectural Decision Records (ADRs) |
45 | 33 |
|
46 | | -### 📜 **[Phase 03 - Architectural Decision Records (ADRs)](./src/ums-workspace/docs/en/03-adrs/)** |
47 | | -* [Nx Monorepo Strategy](./src/ums-workspace/docs/en/03-adrs/0001-monorepo-orchestration-nx.md) | [Clean Arch Boundaries](./src/ums-workspace/docs/en/03-adrs/0002-clean-architecture-nestjs.md) | [Offline Resiliency](./src/ums-workspace/docs/en/03-adrs/0004-frontend-offline-resilience.md) | [Zero-Cost CodeQL](./src/ums-workspace/docs/en/03-adrs/0005-ci-cd-quality-codeql.md) | [BFF Gateway](./src/ums-workspace/docs/en/03-adrs/0008-progressive-multimodule-evolution-gateway-bff.md) | [View All 29 ADRs History](./src/ums-workspace/docs/en/03-adrs/) |
| 34 | +- [Full ADR Registry](./src/ums-workspace/docs/en/03-adrs/) (29 active decisions) |
48 | 35 |
|
49 | | -### 🛠️ **[Phase 04 - Engineering Standards and Artifacts](./src/ums-workspace/docs/en/04-artifacts/)** |
50 | | -* [Architecture Maturity](./src/ums-workspace/docs/en/04-artifacts/architecture-maturity-model.md) | [Observability Strategy](./src/ums-workspace/docs/en/04-artifacts/observability-strategy.md) | [Enterprise IAM Spec](./src/ums-workspace/docs/en/04-artifacts/enterprise-iam-ums-specification.md) | [High-Concurrency Auth Spec](./src/ums-workspace/docs/en/04-artifacts/high-concurrency-auth-specification.md) | [MFA Spec](./src/ums-workspace/docs/en/04-artifacts/mfa-passwordless-security-spec.md) |
| 36 | +### Phase 04 -- Engineering Standards & Artifacts |
51 | 37 |
|
52 | | -### 📈 **[Phase 05 - Release Roadmap](./src/ums-workspace/docs/en/05-roadmap/)** |
53 | | -* [Versioning & Audit Strategy](./src/ums-workspace/docs/en/05-roadmap/versioning-and-audit-strategy.md) | [Monorepo CHANGELOG](./src/ums-workspace/CHANGELOG.md) |
54 | | - |
55 | | ---- |
| 38 | +- [Engineering Standards](./src/ums-workspace/docs/en/04-artifacts/engineering-standards.md) |
| 39 | +- [Architecture Maturity Model](./src/ums-workspace/docs/en/04-artifacts/architecture-maturity-model.md) |
| 40 | +- [Contract Testing Plan](./src/ums-workspace/docs/en/04-artifacts/contract-testing-plan.md) |
| 41 | +- [Observability Strategy](./src/ums-workspace/docs/en/04-artifacts/observability-strategy.md) |
| 42 | +- [Enterprise IAM Spec](./src/ums-workspace/docs/en/04-artifacts/enterprise-iam-ums-specification.md) |
| 43 | +- [Multi-Tenant Governance Report](./src/ums-workspace/docs/en/04-artifacts/enterprise-multitenant-governance-report.md) |
56 | 44 |
|
57 | | -👉 **[Back to Main README](./README.md)** |
| 45 | +### Phase 05 -- Release Roadmap |
58 | 46 |
|
| 47 | +- [Versioning & Audit Strategy](./src/ums-workspace/docs/en/05-roadmap/versioning-and-audit-strategy.md) |
| 48 | +- [CHANGELOG](./src/ums-workspace/CHANGELOG.md) |
0 commit comments