Vishesh 'ironeagle' Bangotra
0cb35d10a6
- build.py: _TEMPLATE_COMPONENTS rewritten around the vet sample (53 kinds —
per-resource slices, jobs, worked appointment_reminder family, tests);
seed tokens dropped from the manifest ('sample: vet' instead)
- registry.py: get_app_component(kind) no longer renames item/example seeds;
prompts and tool docs updated to 'copy a slice and adapt'
- templates/README.md, 01_build_recipe, 40_ui_admin, wiki/03 updated off the
old seed scheme; repo inventory/config now exclude vet (docs move under
standards; react/vet itself is deleted in a later phase)
- regenerated MCP bundle, vendored templates, and site output
325 lines
9.4 KiB
JSON
325 lines
9.4 KiB
JSON
{
|
|
"project": "standards",
|
|
"template": "templates/app",
|
|
"sample": "vet",
|
|
"components": [
|
|
{
|
|
"kind": "parent-model",
|
|
"path": "domain/parents/models.py",
|
|
"placeholder": "",
|
|
"description": "Example domain model (parents — the simplest slice)."
|
|
},
|
|
{
|
|
"kind": "parent-ports-db",
|
|
"path": "domain/parents/ports/db.py",
|
|
"placeholder": "",
|
|
"description": "Example document model + repository factory."
|
|
},
|
|
{
|
|
"kind": "parent-ports-service",
|
|
"path": "domain/parents/ports/service.py",
|
|
"placeholder": "",
|
|
"description": "Example CRUD service wired through the DI library."
|
|
},
|
|
{
|
|
"kind": "parent-routes",
|
|
"path": "interfaces/parents/routes.py",
|
|
"placeholder": "",
|
|
"description": "Example thin HTTP handlers bound to operationIds."
|
|
},
|
|
{
|
|
"kind": "pet-model",
|
|
"path": "domain/pets/models.py",
|
|
"placeholder": "",
|
|
"description": "Domain model with an embedded parents list."
|
|
},
|
|
{
|
|
"kind": "pet-ports-db",
|
|
"path": "domain/pets/ports/db.py",
|
|
"placeholder": "",
|
|
"description": "Populating document + repository factory (FK wiring)."
|
|
},
|
|
{
|
|
"kind": "pet-routes",
|
|
"path": "interfaces/pets/routes.py",
|
|
"placeholder": "",
|
|
"description": "Routes including the file-upload endpoint."
|
|
},
|
|
{
|
|
"kind": "appointment-model",
|
|
"path": "domain/appointments/models.py",
|
|
"placeholder": "",
|
|
"description": "Domain model with single-id FKs + nested value objects."
|
|
},
|
|
{
|
|
"kind": "appointment-routes",
|
|
"path": "interfaces/appointments/routes.py",
|
|
"placeholder": "",
|
|
"description": "Routes with expand_ref FK handling and list filters."
|
|
},
|
|
{
|
|
"kind": "job-model",
|
|
"path": "domain/jobs/models.py",
|
|
"placeholder": "",
|
|
"description": "Job queue model (the worker's unit of work)."
|
|
},
|
|
{
|
|
"kind": "job-ports-db",
|
|
"path": "domain/jobs/ports/db.py",
|
|
"placeholder": "",
|
|
"description": "Job repository factory."
|
|
},
|
|
{
|
|
"kind": "job-ports-service",
|
|
"path": "domain/jobs/ports/service.py",
|
|
"placeholder": "",
|
|
"description": "Job CRUD service."
|
|
},
|
|
{
|
|
"kind": "job-routes",
|
|
"path": "interfaces/jobs/routes.py",
|
|
"placeholder": "",
|
|
"description": "Job routes (enqueue/inspect via the API)."
|
|
},
|
|
{
|
|
"kind": "interface-common",
|
|
"path": "interfaces/_common.py",
|
|
"placeholder": "",
|
|
"description": "Shared helpers: svc resolution, dump, pagination, expand_ref."
|
|
},
|
|
{
|
|
"kind": "openapi-routes",
|
|
"path": "interfaces/openapi.py",
|
|
"placeholder": "",
|
|
"description": "Route registry: flat re-export of every handler namespace."
|
|
},
|
|
{
|
|
"kind": "auth",
|
|
"path": "interfaces/auth/security.yaml",
|
|
"placeholder": "",
|
|
"description": "Mergeable bearerAuth security scheme + global security for openapi.yaml."
|
|
},
|
|
{
|
|
"kind": "pipeline-abc",
|
|
"path": "pipelines/appointment_reminder/abc.py",
|
|
"placeholder": "",
|
|
"description": "Port contracts for a pipeline family."
|
|
},
|
|
{
|
|
"kind": "pipeline-impl",
|
|
"path": "pipelines/appointment_reminder/impl.py",
|
|
"placeholder": "",
|
|
"description": "Concrete stages, wired root, and family registration."
|
|
},
|
|
{
|
|
"kind": "pipeline-yaml",
|
|
"path": "pipelines/appointment_reminder/pipeline.yaml",
|
|
"placeholder": "",
|
|
"description": "Graph spec (nodes, edges, roots, schema)."
|
|
},
|
|
{
|
|
"kind": "pipeline-resources",
|
|
"path": "pipelines/appointment_reminder/resources/pipeline.yaml",
|
|
"placeholder": "",
|
|
"description": "Runtime spec consumed by the shared loader."
|
|
},
|
|
{
|
|
"kind": "pipeline-pattern",
|
|
"path": "pipelines/appointment_reminder/resources/patterns/reminder.yaml",
|
|
"placeholder": "",
|
|
"description": "Pattern/rule fragment merged by the loader."
|
|
},
|
|
{
|
|
"kind": "pipeline-ports",
|
|
"path": "pipelines/shared/ports.py",
|
|
"placeholder": "",
|
|
"description": "Shared pipeline ports (FinalizePort, RegistryPort)."
|
|
},
|
|
{
|
|
"kind": "pipeline-loader",
|
|
"path": "pipelines/shared/loader.py",
|
|
"placeholder": "",
|
|
"description": "Shared loader: DI wiring + pattern merge."
|
|
},
|
|
{
|
|
"kind": "pipeline-registry",
|
|
"path": "pipelines/shared/registry.py",
|
|
"placeholder": "",
|
|
"description": "Shared registry: (kind, variant, mode) -> root class."
|
|
},
|
|
{
|
|
"kind": "config",
|
|
"path": "config.py",
|
|
"placeholder": "",
|
|
"description": "Settings dataclass + singleton (incl. worker knobs)."
|
|
},
|
|
{
|
|
"kind": "init",
|
|
"path": "init.py",
|
|
"placeholder": "",
|
|
"description": "Composition root (init/shutdown, resources dict)."
|
|
},
|
|
{
|
|
"kind": "main",
|
|
"path": "main.py",
|
|
"placeholder": "",
|
|
"description": "Spec-first app bootstrap + lifespan."
|
|
},
|
|
{
|
|
"kind": "worker",
|
|
"path": "worker.py",
|
|
"placeholder": "",
|
|
"description": "Poll loop + job dispatch by kind + status machine."
|
|
},
|
|
{
|
|
"kind": "openapi",
|
|
"path": "openapi.yaml",
|
|
"placeholder": "",
|
|
"description": "OpenAPI contract (x- extensions drive the admin client)."
|
|
},
|
|
{
|
|
"kind": "pyproject",
|
|
"path": "pyproject.toml",
|
|
"placeholder": "",
|
|
"description": "Packaging + dependency pins."
|
|
},
|
|
{
|
|
"kind": "changelog",
|
|
"path": "CHANGELOG.md",
|
|
"placeholder": "",
|
|
"description": "Keep a Changelog file with an [Unreleased] section (versioning standard)."
|
|
},
|
|
{
|
|
"kind": "version-file",
|
|
"path": "VERSION",
|
|
"placeholder": "",
|
|
"description": "Single-line version file (service-docker CI checks tag == VERSION)."
|
|
},
|
|
{
|
|
"kind": "dockerfile",
|
|
"path": "Dockerfile",
|
|
"placeholder": "",
|
|
"description": "API + worker image with private-index wiring."
|
|
},
|
|
{
|
|
"kind": "dockerignore",
|
|
"path": ".dockerignore",
|
|
"placeholder": "",
|
|
"description": "Docker build-context exclusions."
|
|
},
|
|
{
|
|
"kind": "gitignore",
|
|
"path": ".gitignore",
|
|
"placeholder": "",
|
|
"description": "VCS exclusions (caches, venv, generated _gen/)."
|
|
},
|
|
{
|
|
"kind": "compose",
|
|
"path": "docker-compose.yaml",
|
|
"placeholder": "",
|
|
"description": "api + worker + mongo compose file."
|
|
},
|
|
{
|
|
"kind": "env-example",
|
|
"path": ".env.example",
|
|
"placeholder": "",
|
|
"description": "Environment variable template."
|
|
},
|
|
{
|
|
"kind": "db-setup",
|
|
"path": "infra/db/setup.py",
|
|
"placeholder": "",
|
|
"description": "Mongo connection lifecycle."
|
|
},
|
|
{
|
|
"kind": "repo",
|
|
"path": "infra/db/repos/mongo.py",
|
|
"placeholder": "",
|
|
"description": "Repository factory (base/populating/cached)."
|
|
},
|
|
{
|
|
"kind": "repo-int",
|
|
"path": "infra/db/repos/mongo_int.py",
|
|
"placeholder": "",
|
|
"description": "Integer-id repository variants (create_repo factory)."
|
|
},
|
|
{
|
|
"kind": "repo-memory",
|
|
"path": "infra/db/repos/memory.py",
|
|
"placeholder": "",
|
|
"description": "In-memory repository flavour (zero-dependency demo store)."
|
|
},
|
|
{
|
|
"kind": "service-adapter",
|
|
"path": "infra/adapters/service.py",
|
|
"placeholder": "",
|
|
"description": "Generic CRUD service adaptor."
|
|
},
|
|
{
|
|
"kind": "http-cache",
|
|
"path": "infra/http_cache.py",
|
|
"placeholder": "",
|
|
"description": "Response cache decorator + Redis store (generation invalidation)."
|
|
},
|
|
{
|
|
"kind": "progress-bus",
|
|
"path": "infra/adapters/sse.py",
|
|
"placeholder": "",
|
|
"description": "In-memory SSE progress bus (keyed by an event attribute)."
|
|
},
|
|
{
|
|
"kind": "actions-stream",
|
|
"path": "infra/adapters/actions_stream.py",
|
|
"placeholder": "",
|
|
"description": "Per-resource action stream (SSE) adaptor."
|
|
},
|
|
{
|
|
"kind": "kv-store",
|
|
"path": "infra/adapters/kv.py",
|
|
"placeholder": "",
|
|
"description": "KV port + in-memory fallback + optional Redis adaptor."
|
|
},
|
|
{
|
|
"kind": "package-init",
|
|
"path": "domain/__init__.py",
|
|
"placeholder": "",
|
|
"description": "Empty package marker; add an __init__.py to every package dir."
|
|
},
|
|
{
|
|
"kind": "script-seed",
|
|
"path": "scripts/seed.py",
|
|
"placeholder": "",
|
|
"description": "Operator seed script."
|
|
},
|
|
{
|
|
"kind": "script-drop",
|
|
"path": "scripts/drop.py",
|
|
"placeholder": "",
|
|
"description": "Operator drop script."
|
|
},
|
|
{
|
|
"kind": "test-openapi-build",
|
|
"path": "tests/integration/test_openapi_app_builds.py",
|
|
"placeholder": "",
|
|
"description": "Generic test: every spec operationId resolves and the app builds."
|
|
},
|
|
{
|
|
"kind": "test-jobs-routes",
|
|
"path": "tests/unit/test_jobs_routes.py",
|
|
"placeholder": "",
|
|
"description": "Unit test pattern for a resource's routes with service fakes."
|
|
},
|
|
{
|
|
"kind": "test-pipeline",
|
|
"path": "tests/unit/test_appointment_reminder_pipeline.py",
|
|
"placeholder": "",
|
|
"description": "Unit test pattern for a pipeline family."
|
|
},
|
|
{
|
|
"kind": "test-worker",
|
|
"path": "tests/unit/test_worker.py",
|
|
"placeholder": "",
|
|
"description": "Unit test pattern for worker dispatch and status transitions."
|
|
}
|
|
]
|
|
} |