lzf_0626
15866d4564
docs/05 §5.1 把"业务写接口"列为必须携带 Idempotency-Key 的接口，风控 6 个 POST （手工扫描、确认接收、进入调查、关闭误报、完成结案、升级处理）此前一个都没带， 重复提交会二次驱动状态机。 复用平台的 api_request_receipt 与 ApiTransactionService，但新增 execute_in：原来的 execute 自己开 SessionFactory() 和 session.begin()，而 RiskActionService._finish 会在内部 commit，套进去就成了"内层提交外层事务"。execute_in 改为在调用方传入的 session 上读写幂等记录，幂等记录因此与业务写入同处一个事务（§5.2）。 scope 用实际路径（含 alert_no）而不是路由模板：§5.1 的幂等范围是 user_id + method + normalized_path + idempotency_key，把路径参数折成模板会让同一个键 在不同预警之间互相回放 —— 那是把两次不同资源的操作当成一次。 测试：单测加幂等透传替身与"缺键即 422"用例；新增 tests/integration/test_risk_idempotency_mysql.py，覆盖同键回放不重复执行、同键不同 正文 409、缺键/非 ASCII 拒绝，以及端到端"重复 POST 只调用一次处置逻辑"。