create-dwy 0.8.0 → 0.9.0

package/templates/project/fullstack-monorepo/backend/CLAUDE.md.hbs

@@ -0,0 +1,68 @@
+# {{projectName}} backend
+
+FastAPI 后端,uv workspace monorepo。
+
+## 架构分层
+
+- **装配层** `src/app/` -- 只做装配:加载配置、初始化基础设施、注册业务包。**不写业务逻辑**
+- **业务包** `packages/<scope>-<domain>/` -- 业务实现,域分包,每个包独立 `pyproject.toml`
+
+## 域分包五件套
+
+每个业务包目录结构:
+
+```
+packages/{{scopePrefix}}-<domain>/
+  src/{{scopePrefix}}_<domain>/
+    __init__.py        # register(app, *, config, **providers) 入口
+    config.py          # 包级 DomainConfig(嵌入装配层 Settings)
+    router.py          # APIRouter,只做参数校验 + service 调用
+    service.py         # 业务逻辑,依赖通过 get_config() / get_provider() 注入
+    schemas.py         # Pydantic Request/Response
+    models.py          # SQLAlchemy ORM(可选)
+    protocols.py       # 外部服务 Protocol(SmsProvider / OssProvider 等)
+```
+
+## Provider 模式
+
+外部服务(数据库、Redis、SMS、OSS 等)抽象成 Protocol,具体实现由装配层 `src/app/factories.py` 按 `settings` 选择(dev=in-memory,prod=real),`main.py` 通过 `register(...)` 传给业务包。业务代码只依赖 Protocol 不依赖具体实现。
+
+## dwyeapi 优先
+
+数据库/Redis/JWT/响应封装/异常处理一律先用 `dwyeapi`,不重复造轮子。
+
+## 加新业务包
+
+1. 复制 `packages/{{scopePrefix}}-{{initialDomain}}/` 改名为 `{{scopePrefix}}-<newdomain>/`
+2. 改 `pyproject.toml` 的 `name`,改包内 `__init__.py` 的导出
+3. 根 `pyproject.toml` 的 `[tool.uv.sources]` 增加 workspace 引用
+4. `src/app/main.py` 增加 `register_<newdomain>(app, config=settings.<newdomain>, ...)`
+5. `src/app/config.py` 嵌入 `<newdomain>: <Newdomain>Config = ...`
+6. `alembic/env.py` 增加 `import {{scopePrefix}}_<newdomain>.models`
+
+## 常用命令
+
+```bash
+# 安装
+uv sync --extra dev
+
+# 启动 dev
+uv run uvicorn app.main:app --reload --port {{portPrefix}}8001
+
+# 测试
+uv run pytest tests/ -v
+
+# Lint
+uv run ruff check src/ packages/
+uv run ruff format src/ packages/
+
+# 迁移
+uv run alembic revision --autogenerate -m "msg"
+uv run alembic upgrade head
+```
+
+## 服务端口约定
+
+- Backend: `{{portPrefix}}8001`
+- PostgreSQL: `{{portPrefix}}5432`
+- Redis: `{{portPrefix}}6379`

package/templates/project/fullstack-monorepo/backend/Dockerfile.dev

@@ -0,0 +1,23 @@
+FROM python:3.11.15-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    PIP_DISABLE_PIP_VERSION_CHECK=1
+
+WORKDIR /app
+
+# 安装 uv
+RUN pip install --no-cache-dir uv
+
+# 复制 workspace 配置(利用 Docker 缓存)
+COPY pyproject.toml ./
+COPY packages ./packages
+COPY src ./src
+
+# 同步依赖(含 dev 组)
+RUN uv sync --extra dev
+
+# 容器内端口固定 8001,外部映射由 docker-compose 处理
+EXPOSE 8001
+
+CMD ["uv", "run", "uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8001", "--reload"]

package/templates/project/fullstack-monorepo/backend/alembic/env.py.hbs

@@ -0,0 +1,68 @@
+"""Alembic 环境配置 -- 从 app.config 读取数据库 URL。"""
+
+import asyncio
+from logging.config import fileConfig
+
+from sqlalchemy import pool
+from sqlalchemy.ext.asyncio import async_engine_from_config
+
+# 导入所有 packages 的 models,让 Alembic 能发现表定义。
+# dwy_shared 暂未提供 models,占位 import 用于将来扩展时只在此处追加。
+import dwy_shared  # noqa: F401
+import {{scopePrefix}}_{{initialDomain}}.models  # noqa: F401
+from alembic import context
+from app.config import settings
+from dwyeapi.database import Base
+
+# Alembic Config
+config = context.config
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+# 使用 app.config 中的数据库 URL
+config.set_main_option("sqlalchemy.url", settings.database_url)
+
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    """离线模式运行迁移。"""
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(
+        url=url,
+        target_metadata=target_metadata,
+        literal_binds=True,
+        dialect_opts={"paramstyle": "named"},
+    )
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def do_run_migrations(connection) -> None:
+    """在给定连接上运行迁移。"""
+    context.configure(connection=connection, target_metadata=target_metadata)
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+async def run_async_migrations() -> None:
+    """异步模式运行迁移。"""
+    connectable = async_engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    async with connectable.connect() as connection:
+        await connection.run_sync(do_run_migrations)
+    await connectable.dispose()
+
+
+def run_migrations_online() -> None:
+    """在线模式运行迁移。"""
+    asyncio.run(run_async_migrations())
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

package/templates/project/fullstack-monorepo/backend/alembic/script.py.mako

@@ -0,0 +1,26 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+# revision identifiers, used by Alembic.
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}

package/templates/project/fullstack-monorepo/backend/alembic.ini.hbs

@@ -0,0 +1,43 @@
+# Alembic 配置 -- sqlalchemy.url 由 env.py 从 app.config.settings 注入,这里留空。
+[alembic]
+script_location = alembic
+prepend_sys_path = . src
+path_separator = os
+version_path_separator = os
+sqlalchemy.url =
+
+[post_write_hooks]
+
+[loggers]
+keys = root,sqlalchemy,alembic
+
+[handlers]
+keys = console
+
+[formatters]
+keys = generic
+
+[logger_root]
+level = WARN
+handlers = console
+qualname =
+
+[logger_sqlalchemy]
+level = WARN
+handlers =
+qualname = sqlalchemy.engine
+
+[logger_alembic]
+level = INFO
+handlers =
+qualname = alembic
+
+[handler_console]
+class = StreamHandler
+args = (sys.stderr,)
+level = NOTSET
+formatter = generic
+
+[formatter_generic]
+format = %(levelname)-5.5s [%(name)s] %(message)s
+datefmt = %H:%M:%S

package/templates/project/fullstack-monorepo/backend/packages/dwy-shared/pyproject.toml

@@ -0,0 +1,16 @@
+[project]
+name = "dwy-shared"
+version = "0.1.0"
+description = "跨项目通用 kernel(业务无关基础设施)"
+requires-python = ">=3.11"
+# 依赖仅声明包名,版本号由根 pyproject.toml 统一管理
+dependencies = [
+    "dwyeapi",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/dwy_shared"]

package/templates/project/fullstack-monorepo/backend/packages/dwy-shared/src/dwy_shared/__init__.py

@@ -0,0 +1,12 @@
+"""dwy-shared -- 跨项目通用 kernel。
+
+可在此处添加项目无关的工具/基础设施代码,例如:
+- 通用数据库会话工具(若 dwyeapi 未覆盖)
+- 公共 ORM Mixin
+- 跨项目中间件
+- 公共异常基类
+
+业务相关代码请放到 packages/<scope>-<domain>/。
+"""
+
+__version__ = "0.1.0"

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/pyproject.toml.hbs

@@ -0,0 +1,20 @@
+[project]
+name = "{{scopePrefix}}-{{initialDomain}}"
+version = "0.1.0"
+description = "{{initialDomain}} 业务包"
+requires-python = ">=3.11"
+# 依赖仅声明包名,版本号由根 pyproject.toml 统一管理
+dependencies = [
+    "fastapi",
+    "sqlalchemy",
+    "pydantic",
+    "dwyeapi",
+    "dwy-shared",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/{{scopePrefix}}_{{initialDomain}}"]

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/src/{{scopePrefix}}_{{initialDomain}}/__init__.py.hbs

@@ -0,0 +1,40 @@
+"""{{initialDomain}} 业务包入口。
+
+外部调用约定:
+    from {{scopePrefix}}_{{initialDomain}} import register
+    register(app, config=settings.{{initialDomain}}, **providers)
+
+包内通过 get_config() / get_provider() 拿到装配层注入的依赖,
+不直接 import app.config(避免循环依赖)。
+"""
+
+from fastapi import FastAPI
+
+from .config import DomainConfig
+from .router import router
+from .schemas import HealthResponse
+
+__all__ = ["DomainConfig", "HealthResponse", "get_config", "register", "router"]
+
+# 模块级状态:装配层 register() 注入,业务代码通过 get_config() 读取
+_config: DomainConfig | None = None
+
+
+def register(app: FastAPI, *, config: DomainConfig, **providers: object) -> None:
+    """装载本业务包到 FastAPI 应用。
+
+    Args:
+        app: FastAPI 实例。
+        config: 业务包配置(由装配层从 Settings 传入)。
+        **providers: 外部 Provider(如 sms_provider/oss_provider 等)。
+    """
+    global _config
+    _config = config
+    app.include_router(router)
+
+
+def get_config() -> DomainConfig:
+    """业务代码调用:获取本包配置。"""
+    if _config is None:
+        raise RuntimeError("{{scopePrefix}}_{{initialDomain}} 未调用 register(),配置不可用")
+    return _config

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/src/{{scopePrefix}}_{{initialDomain}}/config.py

@@ -0,0 +1,9 @@
+"""业务包配置 -- 由装配层 Settings 嵌入。"""
+
+from pydantic import BaseModel
+
+
+class DomainConfig(BaseModel):
+    """业务包配置。在此追加包特有字段(如 max_records / cache_ttl 等)。"""
+
+    enabled: bool = True

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/src/{{scopePrefix}}_{{initialDomain}}/models.py.hbs

@@ -0,0 +1,17 @@
+"""{{initialDomain}} ORM 模型。
+
+在此定义 SQLAlchemy 模型,Alembic 通过 alembic/env.py 的 import 发现表。
+
+示例:
+    from sqlalchemy.orm import Mapped, mapped_column
+    from dwyeapi.database import Base, TimestampMixin
+
+    class Item(Base, TimestampMixin):
+        __tablename__ = "{{initialDomain}}_item"
+        id: Mapped[int] = mapped_column(primary_key=True)
+        name: Mapped[str] = mapped_column(index=True)
+
+模板初始不定义任何模型,避免 alembic autogenerate 生成业务无关表。
+"""
+
+__all__: list[str] = []

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/src/{{scopePrefix}}_{{initialDomain}}/protocols.py

@@ -0,0 +1,14 @@
+"""外部服务 Protocol 定义。
+
+业务代码只依赖此处定义的 Protocol,具体实现由装配层 src/app/factories.py
+按 settings.environment 选择(dev=in-memory,prod=real)。
+
+示例:
+    from typing import Protocol
+
+    class SmsProvider(Protocol):
+        async def send(self, phone: str, message: str) -> None: ...
+
+    class OssProvider(Protocol):
+        async def put(self, key: str, data: bytes) -> str: ...
+"""

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/src/{{scopePrefix}}_{{initialDomain}}/router.py.hbs

@@ -0,0 +1,22 @@
+"""{{initialDomain}} 路由 -- 只做参数校验 + service 调用,业务逻辑放 service.py。"""
+
+from fastapi import APIRouter
+
+from .schemas import HealthResponse
+
+router = APIRouter(prefix="/api/{{initialDomain}}", tags=["{{initialDomain}}"])
+
+
+@router.get("/health", response_model=HealthResponse)
+async def health() -> HealthResponse:
+    """业务包健康检查。"""
+    return HealthResponse(status="ok", domain="{{initialDomain}}")
+
+
+# 在此扩展业务 endpoint,调用 service 层完成实际逻辑:
+#
+# from .service import DomainService
+#
+# @router.post("/items")
+# async def create_item(payload: CreateItemRequest) -> ItemResponse:
+#     return await DomainService().create_item(payload)

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/src/{{scopePrefix}}_{{initialDomain}}/schemas.py

@@ -0,0 +1,21 @@
+"""Pydantic Request/Response models。"""
+
+from pydantic import BaseModel
+
+
+class HealthResponse(BaseModel):
+    """健康检查响应。"""
+
+    status: str
+    domain: str
+
+
+# 在此追加业务 schema:
+# class CreateItemRequest(BaseModel):
+#     name: str
+#     ...
+#
+# class ItemResponse(BaseModel):
+#     id: int
+#     name: str
+#     ...

package/templates/project/fullstack-monorepo/backend/packages/{{scopePrefix}}-{{initialDomain}}/src/{{scopePrefix}}_{{initialDomain}}/service.py

@@ -0,0 +1,11 @@
+"""业务逻辑层。
+
+依赖通过 `__init__.py` 的 get_config() 拿配置,通过 get_provider() 拿外部服务。
+不在 service 里 import app.* / FastAPI 相关,保持纯业务无 web 框架耦合。
+"""
+
+
+class DomainService:
+    """业务服务 stub -- 在此实现具体业务方法。"""
+
+    pass

package/templates/project/fullstack-monorepo/backend/pyproject.toml.hbs

@@ -0,0 +1,84 @@
+[project]
+name = "{{projectName}}-backend"
+version = "0.1.0"
+description = "{{projectDescription}}"
+requires-python = ">=3.11"
+dependencies = [
+    # workspace members(本地 editable,详见 [tool.uv.sources])
+    "dwy-shared",
+    "{{scopePrefix}}-{{initialDomain}}",
+    # 单一版本中心 -- 所有 workspace member 用到的外部依赖在这里集中管理版本号,
+    # member 自己的 pyproject.toml 只写包名,uv workspace 解析时从顶层取约束。
+    "dwyeapi>=0.9.0",
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.30.0",
+    "sqlalchemy[asyncio]>=2.0.0",
+    "asyncpg>=0.30.0",
+    "redis[hiredis]>=5.0.0",
+    "pydantic[email]>=2.12.5",
+    "python-jose[cryptography]>=3.3.0",
+    "bcrypt>=4.0.0",
+    "alembic>=1.13.0",
+    "python-multipart>=0.0.9",
+    "httpx>=0.27.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "aiosqlite>=0.20.0",
+    "fakeredis[json,lua]>=2.21.0",
+    "ruff>=0.6.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/app"]
+
+[tool.ruff]
+target-version = "py311"
+line-length = 120
+
+[tool.ruff.lint]
+select = ["E", "W", "F", "I", "N", "UP", "B", "SIM", "RUF"]
+ignore = [
+    "B008",     # Depends() in function defaults is standard FastAPI pattern
+    "RUF001",   # Fullwidth punctuation in Chinese strings is intentional
+    "RUF002",   # Fullwidth punctuation in Chinese docstrings is intentional
+    "RUF003",   # Fullwidth punctuation in Chinese comments is intentional
+]
+
+[tool.ruff.lint.isort]
+known-first-party = ["app", "dwy_shared", "{{scopePrefix}}_{{initialDomain}}"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[[tool.uv.index]]
+name = "aliyun"
+url = "https://mirrors.aliyun.com/pypi/simple/"
+default = true
+
+[[tool.uv.index]]
+name = "pypi-org"
+url = "https://pypi.org/simple/"
+explicit = true
+
+[tool.uv.workspace]
+# 后端 monorepo:每个 member 都有独立 pyproject.toml,具备独立发包能力
+# members:
+#   dwy-shared    -- 业务无关 kernel(数据库 / Redis / 中间件等),跨项目可复用
+#   {{scopePrefix}}-{{initialDomain}}   -- 初始业务包雏形,复制此目录改名即可新增业务包
+members = ["packages/*"]
+
+[tool.uv.sources]
+# dwyeapi 走 pypi-org(避免 aliyun 镜像延迟)
+dwyeapi = { index = "pypi-org" }
+# workspace member:本地引用,uv sync 自动 editable 安装
+dwy-shared = { workspace = true }
+{{scopePrefix}}-{{initialDomain}} = { workspace = true }

package/templates/project/fullstack-monorepo/backend/src/app/__init__.py

@@ -0,0 +1,3 @@
+"""装配层 -- 组装基础设施 + 业务包,不写业务逻辑。"""
+
+__version__ = "0.1.0"

package/templates/project/fullstack-monorepo/backend/src/app/config.py.hbs

@@ -0,0 +1,21 @@
+"""装配层配置 -- 嵌入各业务包 Config。
+
+继承 `dwyeapi.config.BaseSettings`,基类已统一提供 database_url / redis_url /
+secret_key / environment / allowed_origins / log_* 等字段,本文件只追加项目专属
+与插件嵌套配置。`.env` 使用双下划线分隔嵌套层级(例 `<DOMAIN_UPPER>__ENABLED=true`,
+其中 DOMAIN_UPPER 是 initialDomain 的全大写形式)。
+"""
+
+from dwyeapi.config import BaseSettings as DwyBaseSettings
+
+from {{scopePrefix}}_{{initialDomain}}.config import DomainConfig
+
+
+class Settings(DwyBaseSettings):
+    """装配层配置。"""
+
+    # ── 业务包嵌套 Config(各包字段在对应 Config 类定义)──
+    {{initialDomain}}: DomainConfig = DomainConfig()
+
+
+settings = Settings()

package/templates/project/fullstack-monorepo/backend/src/app/exceptions.py

@@ -0,0 +1,26 @@
+"""异常处理器注册 -- 统一响应信封 {code, message, data, timestamp}。"""
+
+from fastapi import FastAPI
+
+
+def register_exception_handlers(app: FastAPI) -> None:
+    """注册全局异常处理器。
+
+    优先复用 dwyeapi 的 handler;若需追加项目特有异常(如 426 UpgradeRequired),
+    在本函数内 `@app.exception_handler(MyError)` 追加。
+    """
+    try:
+        from dwyeapi.exceptions import register_handlers
+
+        register_handlers(app)
+    except ImportError:
+        # dwyeapi 未提供 register_handlers 时的最简兜底
+        from fastapi import Request
+        from fastapi.responses import JSONResponse
+
+        @app.exception_handler(Exception)
+        async def _fallback_handler(request: Request, exc: Exception) -> JSONResponse:
+            return JSONResponse(
+                status_code=500,
+                content={"code": "INTERNAL_ERROR", "message": str(exc), "data": None},
+            )

package/templates/project/fullstack-monorepo/backend/src/app/factories.py

@@ -0,0 +1,16 @@
+"""Provider 工厂 -- 按 settings 选择外部服务的具体实现。
+
+业务包只依赖 Protocol(在各包 protocols.py 定义),具体实现由本文件根据
+settings.environment / settings.<domain>.provider 等字段决定:
+  - dev: 内存实现(InMemorySmsProvider 等)
+  - prod: 真实实现(AliyunSmsProvider / TencentOssProvider 等)
+
+main.py 调用本文件的 make_* 函数,把 Provider 注入业务包的 register()。
+"""
+
+# 示例占位:实际新增业务时,在此添加 make_xxx_provider(settings) -> XxxProvider
+#
+# def make_sms_provider(settings: Settings) -> SmsProvider:
+#     if settings.environment == "dev":
+#         return InMemorySmsProvider()
+#     return AliyunSmsProvider(access_key=settings.sms.access_key, ...)

package/templates/project/fullstack-monorepo/backend/src/app/infra/__init__.py

@@ -0,0 +1 @@
+# 基础设施适配占位 -- HTTP client / 第三方 SDK 封装等放此目录。

package/templates/project/fullstack-monorepo/backend/src/app/main.py.hbs

@@ -0,0 +1,65 @@
+"""FastAPI 应用入口 -- 装配层。
+
+职责:加载配置 -> 初始化基础设施(日志/DB/Redis) -> 注册业务包路由。
+业务逻辑一律在 packages/ 下,本文件只做"装配"。
+"""
+
+from collections.abc import AsyncGenerator
+from contextlib import asynccontextmanager
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from app import __version__
+from app.config import settings
+from app.exceptions import register_exception_handlers
+from {{scopePrefix}}_{{initialDomain}} import register as register_{{initialDomain}}
+
+
+@asynccontextmanager
+async def lifespan(app: FastAPI) -> AsyncGenerator[None]:
+    """启动时初始化日志/DB/Redis,关闭时反向释放。"""
+    # TODO: 在此初始化日志、数据库连接池、Redis 连接
+    # 示例:
+    #   from dwyeapi import logger as dwy_logger
+    #   from dwyeapi import cache as dwy_cache
+    #   dwy_logger.configure(level=settings.log_level)
+    #   await dwy_cache.configure(settings.redis_url)
+    yield
+    # TODO: 反向释放
+    #   await dwy_cache.close_redis()
+
+
+# prod 环境关闭 Swagger,避免接口结构对外暴露
+_docs_disabled = settings.environment == "prod"
+
+app = FastAPI(
+    title="{{projectName}} API",
+    version=__version__,
+    description="{{projectDescription}}",
+    lifespan=lifespan,
+    docs_url=None if _docs_disabled else "/docs",
+    redoc_url=None if _docs_disabled else "/redoc",
+    openapi_url=None if _docs_disabled else "/openapi.json",
+)
+
+# CORS -- dev 全放开,prod 通过 settings.allowed_origins 收紧
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"] if settings.environment == "dev" else settings.allowed_origins,
+    allow_credentials=True,
+    allow_methods=["GET", "POST", "PUT", "PATCH", "DELETE"],
+    allow_headers=["*"],
+)
+
+# 异常处理
+register_exception_handlers(app)
+
+# 业务包装配(Provider/Hook 在此注入)
+register_{{initialDomain}}(app, config=settings.{{initialDomain}})
+
+
+@app.get("/api/health")
+async def health() -> dict:
+    """健康检查 -- 只探活,不探依赖。"""
+    return {"status": "ok", "service": "{{projectName}}", "version": __version__}

package/templates/project/fullstack-monorepo/backend/src/app/middleware/__init__.py

@@ -0,0 +1 @@
+# 自定义中间件占位 -- 鉴权/限流/请求日志等放此目录。