Fullstack TemplateOpinionated FastAPI + Vue baseline

Contract-first, ADR-driven, observable, and strict by default.

Contract Parity

OpenAPI remains the source of truth and parity is checked across spec, backend runtime, and frontend bindings.

Strong Architecture

Backend bounded contexts, frontend layered structure, import boundaries, and ADR-driven governance are enforced in automation.

Observability Baseline

Backend and frontend both ship structured observability primitives instead of leaving telemetry as a future concern.

Real Developer Workflow

Make targets, local hooks, Docker compose, pytest-alembic, generated frontend API, and CI symmetry already exist in the baseline.

What This Site Covers

Template OverviewScope, baseline, source of truth, reference slice, and what derived projects must customize.Getting StartedFast-path onboarding for local setup, runtime modes, checks, and bounded-context growth.Template PhilosophyWhy this repository is intentionally strict and why validation is treated as architecture.Frontend UI LayerAdapter-oriented UI boundary, migration rules, and the intended primitive discipline.

Architecture And Governance

Reading map

Every architecture decision is already documented and linked.

The ADR catalog is split into architecture, product-reference, and engineering decisions. The public entrypoint is the ADR reading map, not a loose folder of markdown files.

ADR Reading MapMandatory entrypoint before touching architecture, runtime, contracts, CI, or governance.Architecture ADRsRepository layout, platform runtime, testing model, observability, and dependency direction.Engineering ADRsTemplate metadata, self-consistency checks, CI symmetry, and repository governance.Reference Product ADRsExample domain decisions for derived projects, not a claim that this repo is already a product.

Baseline, Not Product

Already implemented

FastAPI backend with bounded contexts, typed settings, explicit Unit of Work, Alembic, and observability.
Vue frontend with app/pages/features/entities/shared structure, shell routing, and generated OpenAPI bindings.
Contract parity checks, ADR validation, repository consistency checks, Docker builds, and local CI-grade hooks.
One canonical cross-stack reference slice for system health.

Intentionally not productized

No business-specific product surface beyond the reference slice.
No pretense that the homepage or ADRs describe a fully implemented commercial platform.
No relaxed validation path hidden behind convenience switches.
No generated-project magic that weakens source-of-truth ownership.

Primary Links

RepositoryBrowse the source, workflows, and release history on GitHub.Baseline ReleaseThe first tagged reusable baseline for derived projects.Canonical OpenAPIThe public HTTP source of truth used for parity checks and generated frontend API bindings.