1461a8d113
按 2026-11-02 需求补齐计划交付后端能力： - 角色授权：权限目录化，接口统一准入校验，未登记默认拒绝； 管理员判断改为按数据库角色重新判定，防止权限码持有者绕过 - 系统监控：单进程采集资源、请求与异常指标，分钟级聚合， 阈值配置化；敏感配置增加 repr 保护，Redis 密码 URL 转义 - 试用期计提：按回款日判定并写入快照，年度结清与调整单联动； 人员模型补试用期、离职日期与工资版本历史字段 - 计提模板：公式骨架受控，页面维护名称与参数绑定 - T+ 采集：自动化配置表与进度查询 内置角色禁停用保护对齐模块注释；核算规则版本提为常量并 补充批量核算失败堆栈日志。 影响范围：后端全部模块、数据库迁移 V22-V28 验证：uv run ruff check 通过；922 个单元测试全部通过； 集成测试因本机 MySQL 数据卷被其他容器锁定暂未运行
78 lines
2.3 KiB
Python
78 lines
2.3 KiB
Python
"""应用入口。
|
|
|
|
启动：``uv run uvicorn app.main:app --reload --port 8000``
|
|
"""
|
|
|
|
import logging
|
|
from collections.abc import AsyncGenerator
|
|
from contextlib import asynccontextmanager
|
|
|
|
from fastapi import FastAPI
|
|
|
|
from app.api.router import api_router
|
|
from app.core.config import get_settings
|
|
from app.core.db import dispose_engine
|
|
from app.core.exception_handlers import register_exception_handlers
|
|
from app.core.logging import setup_logging
|
|
from app.core.monitoring import MonitorMiddleware, Recorder
|
|
from app.core.redis_client import close_redis
|
|
from app.core.tplus_db import dispose_tplus_engine
|
|
from app.services.monitor_collector import MonitorCollector
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
|
|
@asynccontextmanager
|
|
async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
|
|
"""应用生命周期管理。
|
|
|
|
启动阶段不建立数据库/Redis 连接（延迟到首次使用），
|
|
但退出时必须显式释放连接池，否则 uvicorn 热重载会残留连接。
|
|
"""
|
|
settings = get_settings()
|
|
logger.info(
|
|
"应用启动 | 环境=%s | 数据库=%s/%s",
|
|
settings.app_env,
|
|
settings.mysql_host,
|
|
settings.mysql_database,
|
|
)
|
|
app.state.monitor.start()
|
|
try:
|
|
yield
|
|
finally:
|
|
app.state.monitor.stop()
|
|
dispose_engine()
|
|
dispose_tplus_engine()
|
|
close_redis()
|
|
logger.info("应用已停止，连接池已释放")
|
|
|
|
|
|
def create_app() -> FastAPI:
|
|
"""构造并配置 FastAPI 应用实例。
|
|
|
|
独立成函数便于测试中构造互不干扰的实例。
|
|
"""
|
|
settings = get_settings()
|
|
setup_logging(level="DEBUG" if settings.app_env == "dev" else "INFO")
|
|
|
|
app = FastAPI(
|
|
title="衍水集团营销人员工资管理系统",
|
|
description="营销人员绩效工资核算系统 —— 后端服务",
|
|
version="0.1.0",
|
|
# 接口文档挂在 /api 下，开发期可通过 Vite 代理从同一个端口访问
|
|
docs_url="/api/docs",
|
|
redoc_url=None,
|
|
openapi_url="/api/openapi.json",
|
|
lifespan=lifespan,
|
|
)
|
|
|
|
register_exception_handlers(app)
|
|
app.include_router(api_router, prefix="/api")
|
|
recorder = Recorder()
|
|
app.state.monitor = MonitorCollector(settings, recorder)
|
|
app.add_middleware(MonitorMiddleware, recorder=recorder)
|
|
return app
|
|
|
|
|
|
app = create_app()
|