README.md

UMS: Enterprise User Management System

Bilingual Navigation: Versión en Español

_{Evolith E2E Architecture Framework - UMS official satellite product - click to enlarge}

UMS is a modular monolith for identity, authorization, configuration, approvals, compliance, IGA, and audit.
Built on .NET 10, PostgreSQL, EF Core through Npgsql, React 18, TypeScript, and Nx.
It specializes the Evolith corporate architecture reference for a product-grade user management system.

Inherit the standard, specialize the product.

---

Start Here

Primary entry points

• Product Vision - strategy, product goals, and business positioning.
• Architecture Portal - architectural overview, ADRs, blueprints, and applied reference material.
• Domain Model - bounded contexts, aggregates, entities, and domain rules.
• Functional Stories - business-readable product backlog.
• Master Index - complete documentation navigation.
• Evolith Upstream - corporate reference base inherited by UMS.

Getting started by role

• Architects: start with Architecture Portal, then review ADR Registry and Traceability Matrix.
• Backend developers: start with API .NET Reference, then review Domain Aggregates and .NET SDK.
• Frontend developers: start with Frontend Clean Architecture ADR, then review TypeScript SDK and State Management ADR.
• Product and PM: start with Product Vision, then review Scope, Objectives, and Gap Tracker.
• DevOps and SRE: start with Infrastructure Plan, then review Operations Portal, Runbooks, and Metrics.
• AI contributors: start with AGENTS.md, then review Documentation Control Agents and ADR Template.

SDLC Navigation

Open the lifecycle area you are working in. Each section groups the documents and repository anchors that support its gate.

Phase 00 - Product and Governance

• Governance Hub
• Product Vision
• Business Context
• Scope and Boundaries
• Stakeholders
• Objectives

Phase 01 - Requirements

• Requirements Hub
• Functional Stories
• Functional Story Standard
• Conceptual Data Model
• Permission Matrix Example
• Glossary

Phase 02 - Design and Architecture

• Architecture Portal
• Architecture Overview
• ADR Registry
• Traceability Matrix
• Blueprints
• Canonical Patterns
• DDD Design Hub
• Evolith ADR Matrix

Phase 03 - Construction

• Construction Hub
• Bounded Context Map
• Cross-Context Flows
• DDD Primitives
• API .NET Applied Reference
• SDK Portal
• Project Backlog

Phase 04 - Validation and QA

• QA Report
• Unit Testing Results
• Integration Testing Results
• Performance Testing Plan
• Performance Testing Results
• QA Evidences

Phase 05 - Delivery and Operations

• Operations Portal
• Runbooks
• Metrics
• Kubernetes Deployment Plan
• Infrastructure Plan
• Implementation Plan
• Documentation Release Process

Cross-Cutting References

Architecture, domain, and product reference

• Identity Domain
• Authorization Domain
• Configuration Domain
• Approvals Domain
• IGA Domain
• Audit Domain
• Consistency Rules
• SDK Contracts
• Documentation Standards
• Bilingual Documentation Control

UMS and Evolith inheritance

• UMS inherits reusable architecture standards, governance rules, ADR patterns, and documentation practices from Evolith.
• UMS keeps product-specific implementation, bounded contexts, schemas, seed strategy, and runtime behavior in this repository.
• Product ADRs may be promoted upstream when UMS provides executable evidence that the decision is reusable across products.
• Multi-tenancy is enforced primarily at the application layer. PostgreSQL policies, constraints, schema ownership, and row-level security are secondary infrastructure failsafes.

Tools and Automation

Local development commands

Run technical commands from src/ unless the command explicitly targets the backend solution.

# Install frontend dependencies
cd src
npm install

# Frontend: React 18 and Vite
npx nx run app-web:dev

# Backend: .NET 10
cd apps/ums.api
dotnet build
dotnet run

# Backend tests
dotnet test

Documentation validation

# From the repository root
python3 .bmad-core/scripts/cleanup_markdown_encoding.py

# From src/, when Context7 setup is needed
cd src
npx ctx7 setup

Documentation changes must keep English and Spanish artifacts synchronized, preserve UTF-8 integrity, and avoid decorative icons or non-standard Markdown characters.

---

Contribution

Before contributing, read:

• AGENTS.md - agent rules and repository conventions.
• Standards - engineering and documentation standards.
• ADR Template - how to propose a decision.
• Child Repository Inheritance Guide - how UMS inherits from Evolith.

---

License

This repository is proprietary unless a separate license file states otherwise.

---

_{UMS - Enterprise User Management System | Evolith Satellite Product | .NET 10, React 18, PostgreSQL}