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

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

@@ -0,0 +1,19 @@
+"""# Summary
+
+Item domain model — the neutral resource used throughout the template.
+"""
+from pydantic import BaseModel, Field
+
+
+class Item(BaseModel):
+    """A single countable resource.
+
+    Attributes:
+        name (str): Item name.
+        quantity (int): Item quantity. Defaults to 1.
+    """
+
+    name: str
+    quantity: int = Field(default=1)
+
+    model_config = {"extra": "ignore"}

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

@@ -0,0 +1,20 @@
+"""# Summary
+
+Mongo persistence for items: document schema and repository factory.
+"""
+from domain.item.models import Item
+from infra.db.repos.mongo import _repo_factory as mongo_repo_factory
+from mongo_ops import BaseDocument, BaseRepository
+
+
+class ItemDocument(Item, BaseDocument):
+    """Mongo document form of :class:`Item`."""
+
+
+def create_item_repo() -> BaseRepository:
+    """Create the Mongo-backed item repository.
+
+    Returns:
+        BaseRepository: Repository wired to the ``items`` collection.
+    """
+    return mongo_repo_factory("items", ItemDocument)

standards/templates/app/domain/item/ports/service.py

@@ -0,0 +1,33 @@
+"""# Summary
+
+CRUD service wiring for the item aggregate via the hexa container.
+"""
+from hexa import build
+
+from domain.item.models import Item
+from domain.item.ports.db import ItemDocument
+from infra.adapters.service import CrudsServiceAdaptor
+
+
+class ItemCrudsService(CrudsServiceAdaptor[Item, ItemDocument]):
+    """Item CRUD service resolving :class:`ItemDocument` from a repo.
+
+    Notes:
+        Instances are created by :func:`get_item_service`. The ``model`` and
+        ``schema`` class attributes bind the domain model and its document type.
+    """
+
+    model = Item
+    schema = ItemDocument
+
+
+def get_item_service(repo) -> ItemCrudsService:
+    """Build an item CRUD service wired to ``repo``.
+
+    Args:
+        repo (Any): Mongo-backed item repository from :func:`create_item_repo`.
+
+    Returns:
+        ItemCrudsService: Ready-to-use item CRUD service.
+    """
+    return build(ItemCrudsService, instances={"repo": repo})