Repository navigation
IMPLEMENTATION
This page records current delivery status. It does not define architecture; GTS-Technical-Architecture, REFERENCE-ARCHITECTURE and the repository ADRs do that.
The status is based on current source, migrations, Compose configuration, dependency contracts and open GitHub issues. A present class or route counts as implemented code, but it does not prove that the user journey has shipped.
| Capability | State | Evidence and boundary |
|---|---|---|
| Canonical gear catalogue | Implemented | Core tables, repositories and T3K mapping code exist. |
| T3K source synchronisation | Implemented | Source client, staging tables, checkpoints, scheduler and consumer exist. |
| Passwordless T3K authentication | Implemented | OAuth routes, token encryption and auth dependencies exist. |
| User gear library | Implemented backend, transitional UI | APIs and persistence exist; settled /app/* workflow is not complete. |
| Signal-chain model | Implemented | Aggregate, validation service, repositories and JSON APIs exist. |
| Signal-chain groups | Implemented backend | Domain model, permutation service and APIs exist. |
| DI track upload and owner streaming | Implemented legacy context | API and persistence exist. ADR-0008 defines the future DI Library split. |
| Shootout authoring | Implemented backend, transitional UI | CRUD and process API exist; settled app workflow is not complete. |
| Per-chain audio processing | Implemented code, delivery validation open | Audio worker executes NAM and impulse-response chains. Issue #157 owns validation of the complete flow. |
| Manifest finalisation | Implemented code, delivery validation open | Orchestrator writes versioned manifests and projects completion. |
| Public media serving | Partly implemented | Manifest media routes exist. Issue #159 owns the settled product contract and playback validation. |
| Comparison player | Not complete | Issue #160 owns the shared public and app component. |
| User job progress | Not complete | Issue #158 owns app polling, history and retry UX. |
| Video composition | Parked | No worker or queue is deployed. ADR-0007 governs reopening. |
The repository currently enforces:
- Ten
import-lintercontracts for package and framework boundaries. - Strict mypy checking for
model/gts. - TypeScript checking for the video package.
- Astro checks and app type checking through
justrecipes. - OpenAPI schema drift checks for the React app client.
- Real PostgreSQL and pgmq integration tests.
- A ban on
unittest.mockin tests. - Documentation checks for broken and stale claims covered by repository tests.
The quality gate runs through the external worktree engine in a feature worktree. The main checkout uses the individual just check-* recipes against its running stack.
The Compose runtime contains:
- PostgreSQL with pgmq.
- FastAPI web application.
- nginx.
- Vite and React app service.
- T3K synchronisation service.
- Audio worker.
- Shootout orchestrator.
Astro is a build service. CloudBeaver is optional. There is no Redis, Taskiq or video worker.
The public Astro surface and authenticated React app boundary are accepted and scaffolded. The repository still contains server-rendered Jinja2 routes and a legacy React island while product workflows move to their intended surfaces.
Current facts:
-
/app/*uses Vite, React and TanStack Router. -
/app/build,/app/shootoutsand/app/libraryare scaffolds. - Public pages use Astro output and normal document navigation.
- Generated Astro output is ignored.
- The app client is generated from OpenAPI.
The coexistence is a migration state. New authenticated workflows belong in the app rather than extending the old Jinja2 or island implementation.
The main remaining product sequence is:
- Validate user-triggered rendering, per-chain segments and finalisation under issue #157.
- Deliver progress, history and bounded retry under issue #158.
- Settle gated media serving and playback under issue #159.
- Deliver the shared comparison player under issue #160.
This sequence is the product critical path. Video is outside it.
ADR-0008 defines a future DI Library bounded context with provenance, shared metadata and private raw-audio access. sources/di_library does not exist yet. The current core_di_tracks implementation remains the live model until that work lands.
The architecture reserves an optional video enrichment, but ADR-0007 parks all execution.
The following claims appeared in older implementation plans and are no longer valid:
- Work is not organised by the old Phase 1 to Phase 7 plan.
- Astro output is not committed.
- The authenticated application is not a React island.
- Redis and Taskiq are not part of the job architecture.
- A video worker is not a running bounded-context container.
- Serena, typeguard and a five-week typing experiment are not project architecture.
- External workflow tools are not vendored into the repository.
GitHub issues are the delivery source of truth. This page should summarise them without restating transient task detail.