Architecture
Deployable units:
| Unit | Package | Responsibility |
|---|---|---|
| Web | apps/web |
Cookie sessions, UI, OAuth consent page |
| API | apps/api |
Public HTTP /v1, MCP, token/register, well-known |
| Worker | apps/worker |
Queue consumer and cron |
| Admin | apps/admin |
Internal admin UI against clanker_test_admin |
| Docs | apps/docs |
TanStack Start guides and API reference |
Shared libraries:
@clanker-test/services— Effect services, worker runtime, publicHttpApi+toWebHandler@clanker-test/db— product Postgres schema (clanker_test)@clanker-test/admin-db— admin Postgres schema (clanker_test_admin)@clanker-test/core— ids, settings helpers, validation kit
The web app must not HTTP-call the public API for product actions.