|
|
7635802a42
|
feat(audit): 新增操作审计日志（表/中间件/查询接口）+ 角色常量收敛
背景：系统此前没有操作审计。task_logs 的 task_id 是 NOT NULL 外键，只能挂在
任务上，且全项目仅 4 处写入点 —— 登录、导出、产品增删改、收编完全不留痕。
需求方整理的问题清单里「无审计日志查看页」正源于此：不是没有页面，是没数据。
设计参考 MOM(KCGL) 的 audit_logs / audit_listener，但按 Track 栈做了取舍：
1) 写入时机：MOM 用 SQLAlchemy event listener + 同事务写入，优点是零侵入，
缺点是**业务回滚时审计一起消失**，而失败/被拒的操作（越权尝试、参数错误）
恰恰最需要留痕。Track 改为响应生成后用**独立 session** 写入：
- 业务回滚不影响审计（已验证 422/401 失败操作同样落库）
- 审计写入失败也不影响业务（全包裹 try/except）
- 代价：非原子提交，响应后进程立即被 kill 可能丢一条（已注释说明取舍）
2) 采集方式：中间件自动采集写操作 + 导出/下载/打印这类「读但敏感」的 GET。
路径段推导 module/action/target_id。不做手写埋点，因为手写必然漏 ——
task_logs 只有 4 处写入点就是前车之鉴。
3) 增量价值：新增 request_id 字段，与 core/logging.py 的结构化日志打通，
凭一个 ID 就能从审计记录直接跳到那一次接口日志。MOM 无此字段。
4) 敏感信息：details 经 sanitize_details 递归剔除 password/token/secret 等键；
中间件不读请求体，登录明文密码不会落库（已断言表内无密码痕迹）。
配套改动：
- core/roles.py：角色常量与 is_admin 收敛为单一事实来源。此前同一份
「管理员角色」规则散在 task_service、products.py 内联判断和前端
constants/task.ts 三处，已因此发生过「移动端漏判 SUPERVISOR 误挡主管」。
task_service 改为从 core.roles 导入同名常量，保持既有引用可用。
- core/deps.py：抽出 require_roles/require_admin 可复用依赖，替代内联判断。
- main.py：500 响应显式补 X-Request-ID 头 —— 该响应由 ServerErrorMiddleware
生成，位于 RequestContextMiddleware 外层，中间件没机会写头。
- auth.py：登录校验前把「尝试的账号」写入 request.state，使登录事件
（含失败登录）可归属到人，可用于追踪暴力破解。
验证：本地起 PostgreSQL 17 + 迁移后跑端到端测试，32/32 通过
（TestClient 每个请求新建事件循环，与模块级 asyncpg 连接池冲突会报
"got Future attached to a different loop"，故改用 httpx.AsyncClient +
ASGITransport 单循环；生产 uvicorn 单循环无此问题）。
|
2026-09-21 02:23:19 +00:00 |
|
|
|
4454047ce3
|
fix: 修复任务分页总数错误 + 补齐可观测性基建
分页总数（#5）：
- get_all_tasks 的 total 原为 len(flat_tasks)（当前页条数），移动端
「我的任务」用 tasks.length < total 判断 hasMore，首页满员时恒为
false，列表永远停在第一页 20 条。改为独立 COUNT 查询（与
notifications.py 已有写法保持一致）。
可观测性（#9）：
- 新增 core/logging.py：单行 JSON 结构化日志 + request_id/user 上下文
注入；零第三方依赖；接管 uvicorn 自带 handler 避免格式绕过。
- 新增 core/middleware.py：RequestContextMiddleware 生成/透传
X-Request-ID 并回写响应头，输出含耗时/用户的结构化访问日志。
- 新增 core/health.py：拆分存活/就绪探针。/health/live 不触依赖；
/health/ready 探主库，不可用返回 503；MOM 挂掉仅降级不摘流量。
- main.py：全局异常处理器只把堆栈写日志，响应体仅回 request_id；
接入可选 Sentry（未装 SDK 时静默跳过）。
- auth_service：解析 Token 后写入 user 上下文，日志自动带操作人。
注：异常处理器由 ServerErrorMiddleware 调用，此时 contextvar 已被重置，
故 request_id 同时写入 request.state（由 ASGI scope 承载）再读取。
已用 TestClient 验证：探针状态码/检查项、X-Request-ID 透传与生成、
500 响应携带可对账的 request_id 且不泄露堆栈。
|
2026-09-21 01:57:20 +00:00 |
|
|
|
17105dc9c2
|
初始提交：项目基础结构
- backend: FastAPI 后端服务 (Python)
- frontend: React + Tauri 前端应用
- docker-compose.yml: 容器编排配置
|
2026-08-04 10:05:59 +08:00 |
|
