ums

# UMS: Sistema Empresarial de Gestión de Usuarios > **Navegación Bilingüe:** [English](../README.md) [![Estado](https://img.shields.io/badge/Estado-Activo-brightgreen?style=for-the-badge)]() [![Plataforma](https://img.shields.io/badge/.NET_10_%7C_PostgreSQL_%7C_React_18-informational?style=for-the-badge)]() [![Arquitectura](https://img.shields.io/badge/Evolith-Producto_Satelite-blueviolet?style=for-the-badge)](https://github.com/beyondnetcode/evolith_arch32) [![ADRs](https://img.shields.io/badge/ADRs-66_decisiones-orange?style=for-the-badge)](./architecture/adrs/) [![Licencia](https://img.shields.io/badge/Licencia-Propietaria-red?style=for-the-badge)]()

_{Framework de Arquitectura E2E de Evolith - UMS producto satélite oficial - clic para ampliar}
**UMS es un monolito modular para identidad, autorización, configuración, aprobaciones, cumplimiento, IGA y auditoría.**
Construido sobre **.NET 10, PostgreSQL, EF Core mediante Npgsql, React 18, TypeScript y Nx**.
Especializa la referencia de arquitectura corporativa [Evolith](https://github.com/beyondnetcode/evolith_arch32) para un sistema de gestión de usuarios de nivel producto. > *Heredar el estándar, especializar el producto.*

Comienza Aquí

Puntos de entrada principales

- [Visión del Producto](/ums/governance/product/product-vision.html) - estrategia, objetivos del producto y posicionamiento de negocio. - [Portal de Arquitectura](/ums/architecture/) - vista arquitectónica, ADRs, blueprints y referencia aplicada. - [Modelo de Dominio](/ums/domain/) - contextos acotados, agregados, entidades y reglas de dominio. - [Historias Funcionales](/ums/governance/requirements/functional-stories/) - backlog de producto legible para negocio. - [Índice Maestro](/ums/MASTER_INDEX.html) - navegación completa de documentación. - [Evolith Upstream](https://github.com/beyondnetcode/evolith_arch32) - base de referencia corporativa heredada por UMS.

Inicio por rol

- **Arquitectos:** comenzar con [Portal de Arquitectura](/ums/architecture/), luego revisar [Registro ADR](./architecture/adrs/) y [Matriz de Trazabilidad](/ums/architecture/traceability-matrix.html). - **Desarrolladores backend:** comenzar con [Referencia API .NET](/ums/architecture/api-dotnet/), luego revisar [Agregados de Dominio](/ums/domain/) y [SDK .NET](/ums/sdk/dotnet/). - **Desarrolladores frontend:** comenzar con [ADR de Arquitectura Limpia Frontend](/ums/architecture/adrs/0056-clean-architecture-frontend.html), luego revisar [SDK TypeScript](/ums/sdk/typescript/) y [ADR de Gestión de Estado](/ums/architecture/adrs/0057-zustand-tanstack-query-state.html). - **Producto y PM:** comenzar con [Visión del Producto](/ums/governance/product/product-vision.html), luego revisar [Alcance](/ums/governance/product/scope.html), [Objetivos](/ums/governance/product/objectives.html) y [Gap Tracker](/ums/governance/project/functional-story-gap-tracker.html). - **DevOps y SRE:** comenzar con [Plan de Infraestructura](../infra/infrastructure_plan.md), luego revisar [Portal de Operaciones](/ums/operations/), [Runbooks](/ums/operations/runbooks/) y [Métricas](/ums/operations/metrics/). - **Contribuidores IA:** comenzar con [AGENTS.md](../AGENTS.md), luego revisar [Agentes de Control Documental](/ums/governance/documentation-control-agents.html) y [Plantilla ADR](/ums/governance/sdlc/adr-template.html).

Navegación SDLC

Abre el área del ciclo de vida en la que estás trabajando. Cada sección agrupa documentos y puntos de entrada del repositorio que soportan su gate.

Fase 00 - Producto y Gobernanza

Fase 01 - Requisitos

Fase 02 - Diseño y Arquitectura

Fase 03 - Construcción

Fase 04 - Validación y QA

Fase 05 - Entrega y Operaciones

Referencias Transversales

Referencia de arquitectura, dominio y producto

- [Dominio Identidad](/ums/domain/identity/) - [Dominio Autorización](/ums/domain/authorization/) - [Dominio Configuración](/ums/domain/configuration/) - [Dominio Aprobaciones](/ums/domain/approvals/) - [Dominio IGA](/ums/domain/iga/) - [Dominio Auditoría](/ums/domain/audit/) - [Reglas de Consistencia](/ums/domain/consistency-rules/) - [Contratos SDK](/ums/sdk/contracts/schema-overview.html) - [Estándares de Documentación](/ums/STANDARDS.html) - [Control Documental Bilingüe](/ums/governance/documentation-control-agents.html)

Herencia entre UMS y Evolith

- UMS hereda de [Evolith](https://github.com/beyondnetcode/evolith_arch32) estándares arquitectónicos reutilizables, reglas de gobernanza, patrones ADR y prácticas documentales. - UMS conserva en este repositorio la implementación específica del producto, contextos acotados, esquemas, estrategia de seed y comportamiento runtime. - Los ADRs de producto pueden promoverse upstream cuando UMS aporta evidencia ejecutable de que la decisión es reutilizable por otros productos. - La multi-tenancy se aplica principalmente en la capa de aplicación. Las políticas de PostgreSQL, constraints, propiedad de schemas y row-level security son failsafes secundarios de infraestructura.

Herramientas y Automatización

Comandos de desarrollo local

Ejecuta los comandos técnicos desde `src/`, salvo cuando el comando apunte explícitamente a la solución backend. ```bash # Instalar dependencias frontend cd src npm install # Frontend: React 18 y Vite npx nx run app-web:dev # Backend: .NET 10 cd apps/ums.api dotnet build dotnet run # Pruebas backend dotnet test ```

Validación documental

```bash # Desde la raíz del repositorio python3 .bmad-core/scripts/cleanup_markdown_encoding.py # Desde src/, cuando se requiere setup de Context7 cd src npx ctx7 setup ``` Los cambios de documentación deben mantener sincronizados los artefactos en inglés y español, preservar integridad UTF-8 y evitar iconos decorativos o caracteres Markdown no estándar.

Contribución

Antes de contribuir, lee:

AGENTS.md - reglas y convenciones del repositorio para agentes.
Estándares - estándares de ingeniería y documentación.
Plantilla ADR - cómo proponer una decisión.
Guía de Herencia de Repositorios Hijo - cómo UMS hereda de Evolith.

Licencia

Este repositorio es propietario salvo que un archivo de licencia separado indique lo contrario.

_{UMS - Sistema Empresarial de Gestión de Usuarios | Producto Satélite de Evolith | .NET 10, React 18, PostgreSQL}

This site is open source. Improve this page.