Evolith Tracker: SDLC Governance Control Plane

Bilingual Navigation: Versión en Español

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

Evolith Tracker is a governance control plane for the full SDLC lifecycle.
Built on .NET 10, PostgreSQL, EF Core, React 19, TypeScript, and Nx.
It specializes the Evolith corporate architecture reference for SDLC tracking, gate decisions, and evidence management.

Inherit the standard, specialize the product.

---

Start Here

Primary entry points

• Product Vision - strategy, product goals, and business positioning.
• Architecture Portal - architectural overview, bounded contexts, domain model.
• Domain Model - ubiquitous language, bounded contexts, aggregates.
• Master Index - complete documentation navigation.
• Evolith Upstream - corporate reference base inherited by Tracker.

Getting started by role

• Architects: start with Target Architecture, then review DECISIONS.md and Core Integration Design.
• Backend developers: start with .NET Backend Design, then review PostgreSQL Data Design and Platform Implementation.
• Frontend developers: start with React Frontend Design, then review Web Integration.
• Product and PM: start with Product Vision, then review User Stories and GAP Register.
• DevOps and SRE: start with Infrastructure Plan, then review Observability Spec.
• AI contributors: start with AGENTS.md, then review BMAD Agents.

SDLC Navigation

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

Phase 00 - Strategic Intake

Document	Type
Intake Hub	Hub
Intake Formats	Reference
Product Vision	Guide

Phase 01 - Discovery

Document	Type
Discovery Hub	Hub
Discovery DDD	Reference
User Stories	Reference
Glossary	Reference

Phase 02 - Design

Document	Type
Design Hub	Hub
Target Architecture	Reference
NestJS Backend Design	Reference
PostgreSQL Data Design	Reference
Core Integration Design	Reference
Platform Implementation	Reference

Phase 03 - Construction

Document	Type
Construction DDD	Reference
BFF Application Gateway	Task
Architecture-Aware Tracking	Reference
Pull Request Interception	Reference

Phase 04 - QA

Document	Type
QA DDD	Reference
Contextual QA	Reference
Test Strategy	Guide

Phase 05 - Release

Document	Type
Release DDD	Reference
Release Governance	Reference
Re-Do Flow Design	Reference

Cross-Cutting - Governance, Artifacts, Metrics

Document	Type
Governance DDD	Reference
Artifacts DDD	Reference
Metrics DDD	Reference
Integration DDD	Reference
Phase Gate Design	Reference
Artifact & Evidence Design	Reference

Cross-Cutting References

Architecture, domain, and product reference

• Discovery Domain
• Design Domain
• Construction Domain
• QA Domain
• Release Domain
• Governance Domain
• Artifacts Domain
• Metrics Domain
• Integration Domain
• Security Specification
• UMS Authentication Integration

Tracker and Evolith inheritance

• Tracker inherits reusable architecture standards, governance rules, ADR patterns, and documentation practices from Evolith.
• Tracker keeps product-specific implementation, bounded contexts, schemas, and runtime behavior in this repository.
• Product ADRs may be promoted upstream when Tracker 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 19 and Vite
npx vite build --config apps/tracker-web/vite.config.mts

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

# Backend tests
dotnet test

Documentation validation

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

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.
• DECISIONS.md - architectural decisions — local and inherited.
• evolith.satellite.json - satellite boundary and invariants.
• Child Repository Inheritance Guide - how Tracker inherits from Evolith.

---

License

Dual licensed. See LICENSE and NOTICE.

---

_{Evolith Tracker — SDLC Governance Control Plane | Evolith Satellite Product | .NET 10, React 19, PostgreSQL}