scaffold-archipy-servicelisted

# Scaffold ArchiPy Service ## Before writing files 1. Inspect existing transports, domain DTOs/logics, app bootstrap, DI wiring, and service tests. 2. Infer domain, API version, framework, and sync/async style when established by the repository. 3. Ask only for unresolved choices. Default to `v1` and FastAPI only when no project convention exists. 4. Preserve existing routes, servicers, and bootstrap code; integrate without overwriting. ## Prefer ArchiPy ```bash uv add "archipy[fastapi]" # HTTP uv add "archipy[grpc]" # gRPC ``` ## Generate ```text services/<domain>/v{n}/ └── <domain>_service.py ``` ### FastAPI - Thin router: request → domain `*InputDTO` → logic → `*OutputDTO`. - Export `create_router(container)` (or equivalent) for `manage.py` / app factory. - Map domain errors to HTTP status; no business rules / atomic UoW decorators here. ### gRPC - Thin servicer calling logic; sync servicers with `AppUtils.create_grpc_app`, async with `create_async_grpc_app`. - Do not mix sync/async servicer styles on one server. ## Bootstrap (entrypoint) Prefer AppUtils — do not hand-roll bare `FastAPI()` / `grpc.server()`: ```python from archipy.helpers.utils.app_utils import AppUtils from archipy.configs.base_config import BaseConfig app = AppUtils.create_fastapi_app() app.include_router(create_user_v1_router(container)) ``` uvicorn in `manage.py` from `config.FASTAPI` (`SERVE_HOST`, `SERVE_PORT`, `RELOAD`, `PROXY_HEADERS`, `FORWARDED_ALLOW_IPS`). ## Constraints