← Back to Approach

Approach · The Governance Laboratory

Budget Triage

Enterprise Architecture Exploration

Active Development

Overview

Personal finance management system built with enterprise-grade architecture patterns. Intentionally over-engineered to explore modern governance frameworks, observability patterns, and deterministic ML extraction pipelines.

Achieved F1=1.000 extraction quality on ground-truth datasets through agent-assisted annotation and deterministic synthetic document generation.

Technical Stack

Runtime & Core

  • Bun (modern TypeScript runtime)
  • Express + Hono (dual API framework exploration)
  • PostgreSQL with type-safe schema generation (Kanel)
  • ts-rest for end-to-end type contracts

Infrastructure & Security

  • Infisical (self-hosted secrets management)
  • Machine identity patterns for automated access
  • Docker containerization
  • OpenTelemetry instrumentation throughout

Governance Framework

  • ADR-020 (Architecture Decision Records)
  • Runtime/config/toolchain compliance verification
  • Script governance rules
  • Cross-surface validation
  • Evidence-based logging

Key Patterns Explored

Architecture Decision Records (ADR-020)

Formal governance framework ensuring runtime, configuration, and toolchain compliance. 18/19 CI Quality Gates passing.

Intelligent Document Processing

Architecting resilient VLM/OCR pipelines with strict quality baselines (F1=1.000), agent-assisted annotation, and synthetic ground truth.

High-Volume Test Engineering

Over 7,700+ tests (7,082 backend, 703 frontend, 664 integration) ensuring deterministic performance across complex extraction operations.

Why This Matters

Governance at Scale

ADR frameworks and policy-based development are crucial for large teams. Learning the patterns in a controlled environment.

Security Best Practices

Secrets management, machine identity, audit logging—production security patterns in practice.

Modern TypeScript Ecosystem

Bun, modern frameworks, type-safe patterns. Staying current with evolving JavaScript/TypeScript landscape.

Observability Mindset

Building systems that are observable from day one. OpenTelemetry, structured logging, traces.

Development Philosophy

This project is intentionally over-engineered for its scope. The goal isn't to ship the perfect budgeting app—it's to deeply understand enterprise patterns that become essential at scale.

Would you use ADR governance for a personal project in production? Probably not. But understanding ADR frameworks by implementing them teaches patterns applicable to large codebases, distributed teams, and regulated environments.

Projects as learning experiences—using practical applications to explore theoretical and architectural concepts.

Technical Depth

This project demonstrates understanding of:

  • Enterprise governance frameworks (ADR)
  • Secrets management and security patterns
  • Type-safe architecture across boundaries
  • Observability instrumentation (OpenTelemetry)
  • Modern TypeScript ecosystem and tooling
  • Policy-based development and compliance verification
  • Infrastructure as code and containerization