{
  "module": "wiki_reference_app_overview",
  "content": {
    "path": "wiki_reference_app_overview",
    "docstring": "# Reference App — Overview\n\nThe standards ship a **runnable sample** of the whole blueprint: the **vet**\nveterinary-clinic application. It exists to be copied — it is the reference\nfor how a real domain sits on the architecture, and the code an agent pulls\nthrough the MCP tools (`get_app_template`, `get_app_component`).\n\n!!! note \"One sample, two templates\"\n    The **server** sample lives at `standards/src/templates/app/`\n    (FastAPI + openapi-first + mongo-ops + hexa). The **client** sample lives\n    at `standards/src/templates/client/` (Vite + MUI + `@aetoskia/react-openapi`\n    + `@aetoskia/react-auth`). Together they are the full-stack reference.\n\n---\n\n## The domain at a glance\n\n| Aggregate     | What it demonstrates                                          |\n|---------------|---------------------------------------------------------------|\n| **parents**   | The simplest CRUD slice (no foreign keys) — copy this first   |\n| **pets**      | Embedded list-of-refs (`parents[]`), file upload, enum fields |\n| **treatments**| Plain resource with pricing fields                            |\n| **vets**      | Plain resource; target of prefetch FKs                        |\n| **appointments** | Single FKs (`pet`, `vet`, `treatment`) expanded on read, filtered list |\n| **jobs**      | The worker's queue — durable status machine                   |\n\nThe pipeline axis ships one worked family, **`appointment_reminder`**, plus the\nreusable `pipelines/shared/` scaffold and a `worker.py` that dispatches jobs by\n`job.kind`.\n\n## Run it\n\n```bash\ncp -r <docs>/standards/src/templates/app apps/vet-sample\ncd apps/vet-sample\npip install -e \".[dev]\"\n\nuvicorn main:app --reload     # API on :8020 (memory backend, zero services)\npython worker.py              # background worker (polls jobs)\npython -m scripts.seed        # optional: seed demo data (mongo backend)\n```\n\nThe default `REPO_BACKEND=memory` means the API boots with **no external\nservices** — repositories are process-local dictionaries. Switch to\n`REPO_BACKEND=mongo` for persistence (see `.env.example`).\n\nThe client pairs with it:\n\n```bash\ncp -r <docs>/standards/src/templates/client apps/vet-sample-client\ncd apps/vet-sample-client\necho \"VITE_API_BASE_URL=http://localhost:8020\" > .env.local\necho \"VITE_AUTH_BASE_URL=http://localhost:8020\" >> .env.local\nnpm install\nnpm run dev                   # Vite dev server\n```\n\n!!! warning \"Auth\"\n    The server ships with the `bearerAuth` security scheme declared\n    (`{AUTH_SERVER}` introspection). Without a reachable auth-server the API\n    answers `401` on resource routes; `/health` stays public. For a local\n    no-auth demo, remove the `security` block from `openapi.yaml` and the\n    global security entry — see\n    [Auth Integration](../lib/22_auth_integration/).\n\n## Next\n\n- [Domain & API](02_domain_and_api.md) — walking the resource axis\n- [Pipelines & Worker](03_pipelines_and_worker.md) — the pipeline axis\n- [Client Admin](04_client_admin.md) — the spec-driven frontend\n",
    "objects": {}
  }
}