Skip to content

Latest commit

 

History

History
101 lines (80 loc) · 8.65 KB

File metadata and controls

101 lines (80 loc) · 8.65 KB

Índice Maestro — Evolith Tracker

Navegación Bilingüe: English (este documento) · Versión en Español

Warning

Deprecation Notice: Este Índice Maestro se encuentra descontinuado. Por favor, utilice el "Storefront" en el README.md para la navegación orientada a roles, o diríjase a los Hubs localizados (ej. DECISIONS.md).

Bienvenido a la documentación del Evolith Tracker, repositorio satélite derivado de la arquitectura de referencia corporativa Evolith.

Rutas de Navegación por Rol

  • Desarrollador: Revisar el Upstream Base para ver los estándares de código y arquitectura.
  • Arquitecto / Líder Técnico: Revisar DECISIONS.md para conocer las decisiones arquitectónicas aplicadas en este repositorio y las heredadas del Upstream.
  • Producto / Dominio: Revisar el Dominio de Negocio para entender los objetivos del producto y los stakeholders.
  • PO / PM (BMAD): Revisar los Entregables BMAD para los documentos estándar de producto y diseño conceptual.

Entregables BMAD — Producto y Diseño Conceptual

Documento ES Descripción
Project Brief ES Brief estructurado: problema, personas, casos de uso, reglas de negocio
PRD ES Documento de Requisitos de Producto completo: épicas, CLI, MCP, orquestación BMAD
UX Concept ES Visión UX conceptual: navegación, flujos clave, interacción Web/CLI/MCP
User Stories Breakdown ES Desglose completo SM Agent: 114 historias · 372 pts · 11 módulos · criterios Gherkin · secuenciación en sprints

Arquitectura y Diseño Técnico

Documento Descripción
Tracker Target Architecture TAD maestro: bounded contexts, domain model, layer structure, integrations
NestJS Backend Design Arquitectura NestJS: módulos, CQRS, repositories, guards, middleware
React Frontend Design Arquitectura React: state management, routing, permission-driven UI
PostgreSQL Data Design Diseño de datos: 10 schemas, DDL, RLS, indexes, concurrency, migrations
UMS Authentication Integration Integración AuthN/AuthZ con UMS SaaS: JWT, JWKS, permission guards
UMS Authorization Graph Design ACL transformation: UMS graph → Tracker permissions, role hierarchy
Core Integration Design Integración con Evolith Core: rulesets, artifact schemas, taxonomy, caching
Phase Gate Design Motor de evaluación de gates: criteria, checklists, exception handling
Artifact & Evidence Design Sistema de artefactos: definitions, instances, evidence records
CLI Gap Analysis Análisis de gaps CLI: comandos requeridos vs existentes, propuestas
Core Feedback Analysis Feedback para Core: ADR candidates, SDK gaps, reusable patterns
Implementation Roadmap Roadmap de implementación: 8 fases, effort estimates, risk register
Re-Do Flow Design Motor de contingencias del Release: triggers, estados, algoritmo de recálculo, autorización humana
Agent Assignment API Contrato de asignación de agentes BMAD sobre REST/CLI/MCP, modos manual/automated, autorización

Pruebas y Calidad

Documento Descripción
Test Strategy Estrategia de pruebas: pirámide, testing por capa hexagonal, Pact, microfrontends, cobertura, Gate 4 (CFR < 2%), integración .harness

Seguridad

Documento Descripción
Security Specification Modelo STRIDE, AuthN/AuthZ fail-closed, aislamiento de tenants (RLS), protección de datos, OWASP Top 10, testing de seguridad

Infraestructura y Entrega

Documento Descripción
CI/CD Pipeline Spec Pipeline (stages, quality gates), promoción de entornos, despliegue Helm/K8s, integración .harness, GitOps
Observability Spec Logs/métricas/trazas, dashboards, alertas, SLOs, correlación, restricciones multi-tenant

Modelos DDD (Bounded Contexts)

Documento Descripción
Bounded Context Map (oficial) Mapa estratégico de los 9 contexts: relaciones, patrones DDD, flujo de domain events
Domain Model & E/R Overview Síntesis consolidada: modelo conceptual, agregados, value objects y E/R de los 10 schemas
Core — 5 Phase Gates
Discovery DDD Initiative, Backlog, Epic, UserStory aggregates
Design DDD TechnicalBlueprint, Contract, ADR, DataSchema aggregates
Construction DDD ImplementationCycle, TechnicalStory, PeerReview aggregates
QA DDD TestCycle, TestExecution, Defect aggregates
Release DDD ReleasePackage, DeploymentRecord, Environment aggregates
Soporte — 4 contextos transversales
Governance DDD SatelliteProduct, SDLCExecution, PhaseGateState, ExceptionRequest aggregates
Artifacts DDD ArtifactDefinition, ArtifactInstance, EvidenceRecord aggregates
Metrics DDD ScorecardDefinition, MetricSnapshot, DriftAlert aggregates
Integration DDD IntegrationEndpoint, SyncRecord, ACLAdapter aggregates

Decisiones Arquitectónicas y Riesgos

Documento Descripción
DECISIONS.md Registro de ADRs locales y decisiones heredadas del Upstream
Risk Register Registro formal de riesgos: probabilidad, impacto, severidad, mitigación, owner
T-002 Microfrontends Fase 1 Decisión de adoptar microfrontends en Fase 1
Upstream Proposals Candidatos a ADR propuestos a Evolith Core · incluye Propuesta 3: solicitud formal de URLs de esquemas de artefactos (GAP-020)

Auditoría y Gobernanza Documental

Documento Descripción
Inventario de Documentación Inventario completo de documentos con estado bilingüe
Auditoría Funcional Revisión PO: capacidades, historias, reglas, criterios
Auditoría Técnica Revisión Arquitecto: dominio, CQRS, infraestructura
Cumplimiento Evolith Core Matriz de conformidad con estándares de Evolith Core
Análisis de Brechas 24 brechas detectadas con severidad y estado
Plan de Remediación Plan de acción para resolver brechas
Auditoría de Trazabilidad Cadena completa: visión → capacidad → código → evidencia