MASTER_INDEX.md

Master Index -- UMS Navigation Hub

Language: English | Español

Product Lifecycle and Engineering Specifications for the User Management System (UMS).

---

Phase 00 -- Product Vision

• Product Vision
• Business Context
• Scope and Boundaries
• Objectives (OKRs)
• Stakeholders
• UX/UI Design Proposal

Phase 01 -- Domain Requirements

• Glossary (Ubiquitous Language)
• Conceptual Data Model
• Permission Matrix
• Functional Stories

Phase 02 -- MVP Planning and Project Backlog

• Project Backlog
• MVP Product Backlog
• Functional Story Gap Tracker
• Epic 06: Approvals
• Epic 07: Compliance
• Epic 08: IGA

Phase 03 -- Architecture & Database Design

• Database Design ER
• ER Export Formats
• Interactive ER Viewer
• Service Entity Map
• Shell Library Architecture
• Notification and Feedback Architecture
• Architecture Overview
• Architecture Portal
• Traceability Matrix (FS → ADR → TE)
• Technical Enablers Index
• Canonical Patterns Index

Phase 04 -- Construction & Domain Design

• Construction Portal
• DDD Design Portal
• Bounded Context Map
• Ubiquitous Language
• Identity Context
• Authorization Context
• Configuration Context
• Audit Context
• Approvals Context
• IGA Context
• Compliance Context
• Cross-Context Flows
• DDD Primitives
• ADR-0050: Naming & Taxonomy Standard
• ADR-0051: Event Bus Injectable Port
• ADR-0052: Immutable Audit Trail
• ADR-0053: OpenTelemetry Observability
• ADR-0054: Shell Library Isolation (amended 2026-05-24 — scope extended to AOP + Bootstrapper, dep graph corrected)
• ADR-0059: Single API Tier Decision
• ADR-0060: AOP Cross-Cutting Concern Strategy
• ADR-0061: Execution Context Accessor Pattern (Evolith candidate)
• ADR-0062: PII-Safe Serilog Configuration (Evolith candidate)
• ADR-0063: Idempotency Key Middleware (Evolith candidate)
• ADR-0066: Actionable User Error Contract (Evolith candidate)
• ADR-0071: Authorization Graph Engine
• ADR-0072: Dynamic Auth Method Resolution
• ADR-0073: UMS SDK Multi-Runtime
• ADR-0074: Auth Graph Schema Versioning Policy
• ADR Registry
• Shell Library Developer Guides — Overview · DDD · Factory · AOP · Bootstrapper · Combined Usage · API Aspects
• Design Decisions & Gaps
• Interactive DDD Viewer

Phase 04b -- Domain Aggregate Architecture

Phase 04b documents each Aggregate Root with 8 structured sections: Aggregate Overview · Object Model · Sequence Diagrams · ER Model · Bounded Context Model · API Contract · Persistence Notes · Security & Audit. Owned child entities (Branch, Branding, IdentityProvider, etc.) are documented within their parent Aggregate Root page — not as separate documents.

• Domain Aggregate Index
• Identity BC: Tenant · UserAccount · UserManagementDelegation · Authorization Graph · Auth Method Resolution
• Authorization BC: SystemSuite · PermissionTemplate · Profile
• Configuration BC: IdpConfiguration · AppConfiguration · FeatureFlag
• Approvals BC: ApprovalWorkflow · ApprovalRequest · DocumentType · UserDocument
• IGA BC: PromotionRequest · RoleMaturityStatus
• Audit BC: AuditRecord

Owned child entities (Branch, Branding, IdentityProvider, MfaEnrollment, PasswordCredential, ProfilePermission, NotificationRule, AccessEnforcementPolicy, etc.) are documented within their parent aggregate's page. Full entity inventory: Domain Aggregate Index.

Phase 06 -- UMS SDK

The UMS SDK is the official client integration surface, distributed across three runtimes (.NET, TypeScript, NestJS) sharing a single canonical contract — the AuthorizationGraph JSON Schema. Source lives under src/libs/sdk/. See ADR-0073 and ADR-0074.

• SDK Portal
• Contracts: Schema Overview · Error Codes · Versioning Policy · Fixtures · Compatibility Matrix
• .NET: README · Quickstart
• TypeScript: README · Quickstart
• NestJS: README · Quickstart

Phase 05 -- Operations

• Operations Portal
• RB-01: Incident Response
• RB-02: Rollback Procedure
• RB-03: Cache Failure Recovery
• RB-04: Database Failover

Engineering Metrics

• Solution Metrics Dashboard
  • API Metrics (ums.api)
  • Web Metrics (ums.web-app)
  • Library Metrics (shell/*)
  • Test Suite Metrics
  • Aggregate Metrics by Category