dingdanquanliucheng/backend/app/api/router.py

"""
API 基础路由模块

职责：
    提供系统级别的基础接口（如健康检查），URL 无公共前缀。
    当前仅包含 /health 接口。
"""
from fastapi import APIRouter

from backend.app.core.responses import success_response

router = APIRouter()


@router.get("/health")
def health() -> dict:
    """健康检查接口

    用途：供运维或负载均衡探活，验证服务是否正常运行。
    请求参数：无。
    返回值：{"status": "ok", "service": "backend"}
    权限要求：无需认证。
    """
    return success_response(
        {
            "status": "ok",
            "service": "backend",
        }
    )