3 Commits

Include renames

Author	SHA1	Message	Date
lzf_0626	d896a906cd	fix(risk): 规则扫描加跨进程锁——手工触发与定时扫描此前可以同时跑 ... docs/25 P2 最后一项。核实后分清了两层，报告没区分： - **定时扫描是安全的**：risk_scan_scheduler.py 已有 MySQL 连接级咨询锁 （GET_LOCK，锁名 jr_risk_scan_schedule），跨进程互斥。 - **HTTP 端点不安全**：POST /api/v1/risk/alerts/scan → RiskScanService.scan() 只用了 **进程内** asyncio.Lock。多 Web worker、或 Worker 与 API 同时运行时形同虚设。 而扫描的幂等只有应用层的 _exists 查重 —— fin_risk_alert 的 trigger_rule_codes 是 JSON 数组，**无法建唯一索引兜底**（同一交易可命中多条规则，唯一键本应是"交易+规则"，而规则 埋在 JSON 里）。所以两条路径并发时会同时查不到、同时插入，产生重复预警。 **改动**： 1. 把 mysql_scan_lock 与锁名移到 pp/infrastructure/db.py —— 端点与调度器**必须共用 同一把锁**，放在基础设施层两个入口才都能引用（service 不该反向依赖 worker）。 调度器改为从那里 import。 2. **端点层加锁**（controllers/risk.py 的 scan 端点）：取不到锁就抛 RiskScanBusyError （与 service 内部那把进程内锁用同一错误类型与文案）。 **为什么不加在 RiskScanService.scan() 内部**：GET_LOCK 是**连接级**的，而调度器已经在 它自己的 session 上持锁；被两个入口共用的服务方法若再取同一把锁，取锁的连接并不是持锁的 那一个、必然返回 0 —— 会**把定时扫描自己挡死**。所以锁加在入口层，每个入口只取一次。 **实测**： - 无人持锁时扫描 → **200**「规则扫描完成」 - 本进程先取得跨进程锁后再调端点 → **409**「规则扫描正在执行，请稍后重试」 （同一进程内不同 session 也互斥，说明它是连接级的，正是跨进程所需） - 释放后再调 → **200**，恢复正常 顺带第 4 次遇到 409 复用错误码 RUN_NOT_CANCELLABLE，语义不符；属 P3 待处理项。 ruff / mypy(136 文件) / 639 unit+contract 全绿。	2026-09-11 13:57:22 +08:00
lzf_0626	0d3447bde4	fix(risk): 日报邮件端点补上授权校验——它此前是风控里唯一没有校验的端点 ... **问题**：POST /api/v1/risk/daily-report/mail 原先只取 context 做 401 判定， **没有任何授权校验**；RiskDailyReportMailService.send 既拿不到 context、也不调用 AuthorizationService。收件人、标题、正文**全部由客户端决定** —— 一旦运维开启 SMTP （RISK_DAILY_REPORT_MAIL_ENABLED），它就是一个未授权的邮件发送器。 默认关闭（ENABLED 默认 false + DRY_RUN 默认 true）让它至今没出事，但那不是可依赖的保护。 **改动**： - send 改为 async 并接收 context，入口处 wait AuthorizationService.require( context, "risk:report:mail")。校验放在 **service 层**而不是 controller —— 本项目风控 端点的授权一律落在 service（risk_query / risk_action / risk_scan 等都是这样）， controller 只负责取 context；这个端点是唯一的例外，现在补齐。 - controller 相应改为 wait ...send(..., context=context)。 - 权限 isk:report:mail 已在上一轮随另外三个一起创建并授予 risk_operator 与 admin。 **实测**： - 9002(risk_operator) → **200** + {"status":"disabled","recipient_count":1}（默认关闭） - 9001(customer) → **403** AGENT_PERMISSION_DENIED「缺少操作权限」 **测试**：3 个既有用例改为 async 并传入带权限的 context；**新增** est_mail_service_requires_the_permission，断言无权限身份必须被拒 —— 钉住本次修复。 ruff / mypy(136 文件) / 623 unit+contract / 29 integration 全绿。	2026-09-11 13:39:50 +08:00
zhangshy	a94d5c754d	feat: 迁移奶龙风控业务模块与演示文档	2026-09-10 21:03:44 +08:00