Motivation
The existing quickstarts are CI-tested and good; what's missing is the next step — full reference applications showing Awa embedded in the frameworks people actually run, exercising the integration seams (bridges, callbacks, mixed fleets) that quickstarts can't.
Scope
CI-tested reference apps under examples/, one directory each:
Each app: docker-compose for Postgres, a README that doubles as a tutorial, and a smoke test in CI (same convention as the quickstarts).
Acceptance
- All apps green in CI; each README walks from clone to observed job completion.
- Linked from the docs-site Learn section and the relevant feature docs.
References
Roadmap: docs/0.7-roadmap.md (WS-6, NEW-16). Related: #118, #14, #293, ADR-029, awa-seaorm.
Motivation
The existing quickstarts are CI-tested and good; what's missing is the next step — full reference applications showing Awa embedded in the frameworks people actually run, exercising the integration seams (bridges, callbacks, mixed fleets) that quickstarts can't.
Scope
CI-tested reference apps under
examples/, one directory each:awa.bridge.insert_job, a user-owned callback endpoint (feat(callbacks): callback-only router + user-owned helpers (#279, #281) #293 pattern), progress polling.insert_job_syncinside a request transaction,Clientsync worker.awa-seaormtransactional enqueue alongside application writes.Each app: docker-compose for Postgres, a README that doubles as a tutorial, and a smoke test in CI (same convention as the quickstarts).
Acceptance
References
Roadmap:
docs/0.7-roadmap.md(WS-6, NEW-16). Related: #118, #14, #293, ADR-029,awa-seaorm.