2a1939d2e7
- 四表接口 /api/v1/reports/*：个人明细（全筛选 summary）、部门汇总（团队基数与月结聚合同源、12.5%/5% 分列、零行经理、冻结对照）、业务统计（排除聚合行）、回款统计（8 档区间恒在、回款金额按 receipt_id 去重防分摊拆行翻倍） - Excel 导出：公司页眉/财务复核栏/领导签字栏/日期/版本、Decimal 原值 + number_format、文本防公式注入、2 万行超限 400、导出行为入操作日志 - manager_share 共享模块：月结聚合与报表部门汇总同源取参与分桶（薄委托保留测试入口） - 区间元数据落 core/report_meta（repository 需要类型，避免反向依赖 service 层） - 准入 require_roles(admin/finance/leader)，支持自定义 403 文案 Co-Authored-By: Claude Code <noreply@anthropic.com>
73 lines
3.1 KiB
Python
73 lines
3.1 KiB
Python
"""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)
|