README.es.md

Evolith Tracker: Plano de Control de Gobernanza SDLC

Navegación Bilingüe: English

_{Arquitectura E2E de Evolith — Producto satélite Tracker — haz clic para ampliar}

Evolith Tracker es un plano de control de gobernanza para el ciclo de vida completo del SDLC.
Construido sobre .NET 10, PostgreSQL, EF Core, React 19, TypeScript y Nx.
Especializa la referencia corporativa de Evolith para seguimiento SDLC, decisiones de gate y gestión de evidencia.

Hereda el estándar, especializa el producto.

---

Empezar aquí

Puntos de entrada principales

• Visión del Producto — estrategia, objetivos del producto y posicionamiento empresarial.
• Portal de Arquitectura — panorama arquitectónico, bounded contexts, modelo de dominio.
• Modelo de Dominio — lenguaje ubicado, bounded contexts, agregados.
• Índice Maestro — navegación completa de documentación.
• Evolith Upstream — base de referencia corporativa heredada por Tracker.

Primeros pasos por rol

• Arquitectos: empezar con Arquitectura Objetivo, luego revisar DECISIONS.md y Diseño de Integración Core.
• Desarrolladores backend: empezar con Diseño Backend .NET, luego revisar Diseño de Datos PostgreSQL y Implementación de Plataforma.
• Desarrolladores frontend: empezar con Diseño Frontend React, luego revisar Integración Web.
• Producto y PM: empezar con Visión del Producto, luego revisar el Registro de GAPs.
• DevOps y SRE: empezar con Plan de Infraestructura, luego revisar Especificación de Observabilidad.
• Contribuyentes IA: empezar con AGENTS.md, luego revisar Agentes BMAD.

Navegación SDLC

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

Fase 00 — intake estratégico

Documento	Tipo
Hub de Intake	Hub
Formatos de Intake	Referencia
Visión del Producto	Guía

Fase 01 — Discovery

Documento	Tipo
Hub de Discovery	Hub
DDD de Discovery	Referencia
Glosario	Referencia

Fase 02 — Design

Documento	Tipo
Hub de Design	Hub
Arquitectura Objetivo	Referencia
Diseño Backend NestJS	Referencia
Diseño de Datos PostgreSQL	Referencia
Diseño de Integración Core	Referencia
Implementación de Plataforma	Referencia

Fase 03 — Construction

Documento	Tipo
DDD de Construction	Referencia
BFF Application Gateway	Tarea
Seguimiento Arquitectónico	Referencia
Intercepción de PRs	Referencia

Fase 04 — QA

Documento	Tipo
DDD de QA	Referencia
QA Contextual	Referencia
Estrategia de Pruebas	Guía

Fase 05 — Release

Documento	Tipo
DDD de Release	Referencia
Gobernanza de Release	Referencia
Diseño de Flujo Re-Do	Referencia

Transversal — Gobernanza, Artefactos, Métricas

Documento	Tipo
DDD de Gobernanza	Referencia
DDD de Artefactos	Referencia
DDD de Métricas	Referencia
DDD de Integración	Referencia
Diseño de Phase Gate	Referencia
Diseño de Artefactos y Evidencia	Referencia

Referencias Transversales

Arquitectura, dominio y producto

• Dominio Discovery
• Dominio Design
• Dominio Construction
• Dominio QA
• Dominio Release
• Dominio Gobernanza
• Dominio Artefactos
• Dominio Métricas
• Dominio Integración
• Especificación de Seguridad
• Integración Autenticación UMS

Heredancia de Tracker y Evolith

• Tracker hereda estándares de arquitectura reutilizables, reglas de gobernanza, patrones ADR y prácticas de documentación de Evolith.
• Tracker mantiene la implementación específica del producto, bounded contexts, esquemas y comportamiento runtime en este repositorio.
• Los ADRs del producto pueden ser promovidos upstream cuando Tracker proporciona evidencia ejecutable de que la decisión es reutilizable entre productos.
• El multi-tenancy se aplica principalmente en la capa de aplicación. Las políticas PostgreSQL, restricciones, propiedad de esquemas y seguridad a nivel de fila son respaldos de infraestructura secundarios.

Herramientas y Automatización

Comandos de desarrollo local

Ejecuta comandos técnicos desde src/ a menos que el comando apunte explícitamente a la solución backend.

# Instalar dependencias del frontend
cd src
npm install

# Frontend: React 19 y Vite
npx vite build --config apps/tracker-web/vite.config.mts

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

# Pruebas del backend
dotnet test

Validación de documentación

# Desde la raíz del repositorio
python3 .bmad-core/scripts/cleanup_markdown_encoding.py

Los cambios de documentación deben mantener sincronizados los artefactos en inglés y español, preservar la integridad UTF-8 y evitar iconos decorativos o caracteres Markdown no estándar.

---

Contribuir

Antes de contribuir, lee:

• AGENTS.md — reglas de agentes y convenciones del repositorio.
• DECISIONS.md — decisiones arquitectónicas — locales e heredadas.
• evolith.satellite.json — límites e invariantes del satélite.
• Guía de Herencia de Repositorio Hijo — cómo Tracker hereda de Evolith.

---

Licencia

Dual licensed. Ver LICENSE y NOTICE.

---

_{Evolith Tracker — Plano de Control de Gobernanza SDLC | Producto Satélite de Evolith | .NET 10, React 19, PostgreSQL}