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.business import businesses as business_businesses
from app.api.v1.business import ratings as business_ratings
from app.api.v1.business import receipts as business_receipts
from app.api.v1.business import shipments as business_shipments
from app.api.v1.calc import router as calc_router
from app.api.v1.reports import router as reports_router
from app.api.v1.settlements import router as settlements_router
from app.api.v1.system import approvals as system_approvals
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 settings as system_settings
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_settings.router)
system_router.include_router(system_approvals.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)

# 业务数据（需求 2.2）：/api/v1/business/*，业务操作登录即可访问
business_router = APIRouter(prefix="/business")
business_router.include_router(business_businesses.router)
business_router.include_router(business_shipments.router)
business_router.include_router(business_receipts.router)
business_router.include_router(business_ratings.router)
v1_router.include_router(business_router)

# 绩效核算（M3 ④）：/api/v1/calc/*，读登录即可、写限管理员与营销后勤
v1_router.include_router(calc_router)
# 月度结算（M3 ④）：/api/v1/settlements/*，读登录即可、写限管理员与营销后勤
v1_router.include_router(settlements_router)
# 报表统计（M4 ⑤）：/api/v1/reports/*，只读，限管理员/财务/领导
v1_router.include_router(reports_router)

api_router.include_router(v1_router)