README.es.md

UMS: Sistema Empresarial de Gestión de Usuarios

Navegación Bilingüe: English

_{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 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 - estrategia, objetivos del producto y posicionamiento de negocio.
• Portal de Arquitectura - vista arquitectónica, ADRs, blueprints y referencia aplicada.
• Modelo de Dominio - contextos acotados, agregados, entidades y reglas de dominio.
• Historias Funcionales - backlog de producto legible para negocio.
• Índice Maestro - navegación completa de documentación.
• Evolith Upstream - base de referencia corporativa heredada por UMS.

Inicio por rol

• Arquitectos: comenzar con Portal de Arquitectura, luego revisar Registro ADR y Matriz de Trazabilidad.
• Desarrolladores backend: comenzar con Referencia API .NET, luego revisar Agregados de Dominio y SDK .NET.
• Desarrolladores frontend: comenzar con ADR de Arquitectura Limpia Frontend, luego revisar SDK TypeScript y ADR de Gestión de Estado.
• Producto y PM: comenzar con Visión del Producto, luego revisar Alcance, Objetivos y Gap Tracker.
• DevOps y SRE: comenzar con Plan de Infraestructura, luego revisar Portal de Operaciones, Runbooks y Métricas.
• Contribuidores IA: comenzar con AGENTS.md, luego revisar Agentes de Control Documental y Plantilla ADR.

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

Documento	Tipo
Visión del Producto	Guía
Contexto de Negocio	Guía
Alcance y Límites	Guía
Objetivos	Guía
Hub de Gobernanza	Índice
Stakeholders	Registro

Fase 01 - Requisitos

Documento	Tipo
Estándar de Historia Funcional	Estándar
Hub de Requisitos	Índice
Historias Funcionales	Índice
Ejemplo de Matriz de Permisos	Matriz
Modelo de Datos Conceptual	Referencia
Glosario	Referencia

Fase 02 - Diseño y Arquitectura

Documento	Tipo
Patrones Canónicos	Guía
Portal de Arquitectura	Índice
Registro ADR	Índice
Hub de Diseño DDD	Índice
Matriz de Trazabilidad	Matriz
Matriz ADR de Evolith	Matriz
Vista General de Arquitectura	Referencia
Blueprints	Referencia

Fase 03 - Construcción

Documento	Tipo
Hub de Construcción	Índice
Portal SDK	Índice
Mapa de Contextos Acotados	Referencia
Flujos Cross-Context	Referencia
Primitivos DDD	Referencia
Referencia Aplicada API .NET	Referencia
Backlog del Proyecto	Registro

Fase 04 - Validación y QA

Documento	Tipo
Plan de Pruebas de Rendimiento	Guía
Reporte QA	Registro
Resultados de Pruebas Unitarias	Registro
Resultados de Pruebas de Integración	Registro
Resultados de Pruebas de Rendimiento	Registro
Evidencias QA	Registro

Fase 05 - Entrega y Operaciones

Documento	Tipo
Runbooks	Guía
Plan de Despliegue Kubernetes	Guía
Plan de Infraestructura	Guía
Plan de Implementación	Guía
Proceso de Release Documental	Guía
Portal de Operaciones	Índice
Métricas	Referencia

Referencias Transversales

Referencia de arquitectura, dominio y producto

• Dominio Identidad
• Dominio Autorización
• Dominio Configuración
• Dominio Aprobaciones
• Dominio IGA
• Dominio Auditoría
• Reglas de Consistencia
• Contratos SDK
• Estándares de Documentación
• Control Documental Bilingüe

Herencia entre UMS y Evolith

• UMS hereda de Evolith 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.

# 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

# 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}