PayrollManagementSystem/backend/app/api/router.py

"""API 路由汇总。

各业务模块的路由在此挂载。业务接口统一放在 `/api/v1/` 之下，
健康检查作为运维探针不带版本号，直接位于 `/api/health`。
"""

from fastapi import APIRouter

from app.api import health
from app.api.v1 import auth
from app.api.v1.base import customers as base_customers
from app.api.v1.base import personnel as base_personnel
from app.api.v1.base import products as base_products
from app.api.v1.system import business_roles as system_business_roles
from app.api.v1.system import logs as system_logs
from app.api.v1.system import params as system_params
from app.api.v1.system import roles as system_roles
from app.api.v1.system import users as system_users

api_router = APIRouter()

# 运维探针：/api/health
api_router.include_router(health.router)

# 业务接口：/api/v1/*
v1_router = APIRouter(prefix="/v1")
v1_router.include_router(auth.router)

# 系统管理（需求 2.5.1）：/api/v1/system/*
system_router = APIRouter(prefix="/system")
system_router.include_router(system_users.router)
system_router.include_router(system_roles.router)
system_router.include_router(system_business_roles.router)
system_router.include_router(system_params.router)
system_router.include_router(system_logs.operation_router)
system_router.include_router(system_logs.login_router)
v1_router.include_router(system_router)

# 基础数据（需求 2.1）：/api/v1/base/*，业务操作登录即可访问
base_router = APIRouter(prefix="/base")
base_router.include_router(base_personnel.router)
base_router.include_router(base_products.router)
base_router.include_router(base_customers.router)
v1_router.include_router(base_router)

api_router.include_router(v1_router)