refactor: conform standards docs to doc-forge wiki/lib layout; generic build.py; static kind links

standards/templates/app/interfaces/item/routes.py

@@ -0,0 +1,42 @@
+"""# Summary
+
+Item route handlers — names must match openapi.yaml operationIds.
+"""
+from fastapi import Request
+from fastapi.responses import JSONResponse
+
+from domain.item.models import Item
+
+
+def svc(request: Request):
+    """Resolve the item CRUD service from app state."""
+    return request.app.state.db_resources["item_svc"]
+
+
+async def create_item(request: Request, body: dict):
+    """Create an item from the request body."""
+    data = body.model_dump() if hasattr(body, "model_dump") else dict(body)
+    doc = await svc(request).create(Item(**data))
+    return JSONResponse(status_code=201, content=doc.model_dump(mode="json", by_alias=True))
+
+
+async def get_item(request: Request, id: str):
+    """Fetch one item by id."""
+    doc = await svc(request).read(id)
+    if doc is None:
+        return JSONResponse(status_code=404, content={"detail": "item not found"})
+    return doc.model_dump(mode="json", by_alias=True)
+
+
+async def list_items(request: Request):
+    """List all items."""
+    docs = await svc(request).search({})
+    return [d.model_dump(mode="json", by_alias=True) for d in docs]
+
+
+async def delete_item(request: Request, id: str):
+    """Delete one item by id."""
+    ok = await svc(request).delete(id)
+    if not ok:
+        return JSONResponse(status_code=404, content={"detail": "item not found"})
+    return {"deleted": True}

standards/templates/app/interfaces/job/routes.py

@@ -0,0 +1,34 @@
+"""# Summary
+
+Job route handlers — names must match openapi.yaml operationIds.
+"""
+from fastapi import Request
+from fastapi.responses import JSONResponse
+
+from domain.job.models import Job
+
+
+def svc(request: Request):
+    """Resolve the job CRUD service from app state."""
+    return request.app.state.db_resources["job_svc"]
+
+
+async def create_job(request: Request, body: dict):
+    """Create a job from the request body."""
+    data = body.model_dump() if hasattr(body, "model_dump") else dict(body)
+    doc = await svc(request).create(Job(**data))
+    return JSONResponse(status_code=201, content=doc.model_dump(mode="json", by_alias=True))
+
+
+async def get_job(request: Request, id: str):
+    """Fetch one job by id."""
+    doc = await svc(request).read(id)
+    if doc is None:
+        return JSONResponse(status_code=404, content={"detail": "job not found"})
+    return doc.model_dump(mode="json", by_alias=True)
+
+
+async def list_jobs(request: Request):
+    """List all jobs."""
+    docs = await svc(request).search({})
+    return [d.model_dump(mode="json", by_alias=True) for d in docs]

standards/templates/app/interfaces/openapi.py

@@ -0,0 +1,8 @@
+"""# Summary
+
+All handler functions — names must match openapi.yaml operationId values. The
+OpenAPI-first router resolves each operation to a handler by name, so this module
+re-exports every route handler from the subpackages into one flat namespace.
+"""
+from interfaces.item.routes import *
+from interfaces.job.routes import *