feat: upgrade app template server from vet reference

- integer-id persistence: memory (default, zero-dep) + mongo_int repos
  selected by REPO_BACKEND via create_repo factory
- interfaces/_common.py: shared svc/dump/paginate/expand_ref/read_or_404
  helpers; item/job routes rebuilt on them (paginated {total,items} lists,
  PUT replace, 204 deletes, int path ids)
- interfaces/system: /health liveness probe (public)
- openapi.yaml rewritten to 3.1.0 with x- extensions on Item/Job
  (x-resource, x-primary-key, x-display-format, x-list-columns, x-label,
  x-order, x-hidden, x-filterable, x-sortable, x-autocomplete), auth-server
  x-* securityScheme wiring, shared error responses
- config/init/main: REPO_BACKEND knob, load_dotenv before spec build
Verified: 7/7 tests pass; live smoke test (/health ok, 401 without token)

standards/src/templates/app/domain/item/models.py

@@ -9,11 +9,13 @@ class Item(BaseModel):
     """A single countable resource.
 
     Attributes:
+        id (int | None): Server-assigned identifier. Defaults to None.
         name (str): Item name.
         quantity (int): Item quantity. Defaults to 1.
     """
 
+    id: int | None = None
     name: str
     quantity: int = Field(default=1)
 
-    model_config = {"extra": "ignore"}
+    model_config = {"extra": "ignore"}

standards/src/templates/app/domain/item/ports/db.py

@@ -1,21 +1,25 @@
 """# Summary
 
-Mongo persistence for items: document schema and repository factory.
+Items persistence ports — integer-id document and repository factory.
 """
-from mongo_ops import BaseDocument, BaseRepository
+from mongo_ops import BaseDocument
+from pydantic import Field
 
 from domain.item.models import Item
-from infra.db.repos.mongo import _repo_factory as mongo_repo_factory
+from infra.db.repos import create_repo
 
 
 class ItemDocument(Item, BaseDocument):
-    """Mongo document form of :class:`Item`."""
+    """Persisted item document. The integer ``id`` shadows the ObjectId."""
+
+    id: int | None = Field(default=None, validation_alias="_id")
 
 
-def create_item_repo() -> BaseRepository:
-    """Create the Mongo-backed item repository.
+def create_item_repo():
+    """Create the item repository selected by ``settings.repo_backend``.
 
     Returns:
-        BaseRepository: Repository wired to the ``items`` collection.
+        IntIdMemoryRepository | IntIdMongoRepository: Repository wired to the
+        ``items`` collection/store.
     """
-    return mongo_repo_factory("items", ItemDocument)
+    return create_repo("items", ItemDocument)

standards/src/templates/app/domain/job/models.py

@@ -11,6 +11,7 @@ class Job(BaseModel):
     """A unit of background work.
 
     Attributes:
+        id (int | None): Server-assigned identifier. Defaults to None.
         name (str): Job name.
         status (str): Lifecycle status. Defaults to "pending".
         retry_count (int): Times the job failed. Defaults to 0.
@@ -18,10 +19,11 @@ class Job(BaseModel):
         payload (dict | None): Arbitrary job payload. Defaults to None.
     """
 
+    id: int | None = None
     name: str
     status: Literal["pending", "processing", "done", "failed"] = "pending"
     retry_count: int = Field(default=0)
     error_message: str | None = None
     payload: dict | None = None
 
-    model_config = {"extra": "ignore"}
+    model_config = {"extra": "ignore"}

standards/src/templates/app/domain/job/ports/db.py

@@ -1,21 +1,25 @@
 """# Summary
 
-Mongo persistence for jobs: document schema and repository factory.
+Jobs persistence ports — integer-id document and repository factory.
 """
-from mongo_ops import BaseDocument, BaseRepository
+from mongo_ops import BaseDocument
+from pydantic import Field
 
 from domain.job.models import Job
-from infra.db.repos.mongo import _repo_factory as mongo_repo_factory
+from infra.db.repos import create_repo
 
 
 class JobDocument(Job, BaseDocument):
-    """Mongo document form of :class:`Job`."""
+    """Persisted job document. The integer ``id`` shadows the ObjectId."""
+
+    id: int | None = Field(default=None, validation_alias="_id")
 
 
-def create_job_repo() -> BaseRepository:
-    """Create the Mongo-backed job repository.
+def create_job_repo():
+    """Create the job repository selected by ``settings.repo_backend``.
 
     Returns:
-        BaseRepository: Repository wired to the ``jobs`` collection.
+        IntIdMemoryRepository | IntIdMongoRepository: Repository wired to the
+        ``jobs`` collection/store.
     """
-    return mongo_repo_factory("jobs", JobDocument)
+    return create_repo("jobs", JobDocument)