group_xinghuo_jinrong

113 Commits 9 Branches 1 Tag

2 Commits

Include renames

Author	SHA1	Message	Date
GaoYiYuan_0626andWorkBuddy	4fd2ec05c8	基金转换 T-4+T-5（并行组 A）：convert_repository 代理侧 + locks.try_lock 非阻塞抢锁 T-4（convert_repository · agent 库 risk_convert_detail）： - 新增 7 方法：insert_placeholder(占位 pending) / complete_convert(回写 completed+折算详情) / mark_failed / get_by_group_id / get_by_client_request_id(None 直接返回 None) / list_expired_candidates(hours) / mark_expired(S2 标记不硬删) - 引擎走 agent 库 rw（D20）；status 5 值枚举；不与 risk_repository 混职责 - Decimal 折算字段经 _to_bind 转 float 绑定（sqlite 不支持直接绑 Decimal，同 T-3） T-5（locks.try_lock）： - 单次非阻塞抢锁：抢到返回 _Token(with 进入 True)，抢不到立即 _NoLock(进入 False，不等不降级) - Redis 不可用退回进程内 Lock.acquire(blocking=False)；_NoLock.__enter__ 返回 False 避免 with None 报错 - 不改 run_locked（D4：其等 2s 后降级 fn(False)，语义相反；3 处调用点零改动）测试：test_convert_repository.py 6 用例 + test_locks_redis.py +4 用例（既有 6 例零改动） pytest 全量 634 passed / 3 skipped（基线 624 + 10，零回归） Co-Authored-By: WorkBuddy <workbuddy@tencent.com>	2026-09-10 15:53:31 +08:00
GaoYiYuan_0626	037ce7edca	docs(架构改进): 补齐 PRD/开发计划/TODO/交接文档，落地无密钥告警与 Redis 分布式锁一、流程文档（按 AIcoding 六步落地，供新会话从交接文档开工） - 新增 docs/PRD/PRD-架构改进与稳定性加固.md：6 条 FR（文档勘误、非缺陷说明、无密钥启动告警、审计失败告警、Redis 分布式锁、中间件顺序测试） - 新增 docs/项目框架设计/改进方案评审-问题清单与对比.md：24 项问题分档 A~G，经两轮独立 AI 评审，无阻断级错误 - 新增 docs/项目框架设计/开发计划-架构改进.md：HOW 层设计，含合并前只做低风险 11 项的批次策略 - 新增 docs/项目框架设计/TODO-架构改进.md：T-101~T-109、T-201~T-202 可勾选项 - 新增 docs/交接文档-架构改进.md：自包含交接入口，hy3 新会话可直接开工 - 新增 docs/项目框架设计/架构设计说明书.md：按模块/分层逐一讲解的全量架构说明二、代码改动（T-107/108/109、T-201.1、T-201.2） - app/main.py：启动时 DEEPSEEK_API_KEY 缺失告警，明确告知将走降级回复 - app/utils/authz.py：越权审计失败日志补 trace_id，便于串联全链路 - app/api/audit_middleware.py：审计失败日志补 status/path/request_id - app/service/risk/redis_gateway.py：新增 acquire_lock（SET NX EX）与 release_lock（Lua 原子释放，只删自己的锁） - app/service/risk/locks.py：run_locked 改为双层锁，Redis 为主、进程内锁为备； Redis 超时沿用 fn(locked=False) 降级语义，Redis 不可用（含测试 Fake 缺方法的 AttributeError）安全退回进程内锁，绝不抛异常三、文档勘误（A1/A2/A3） - MEMORY.md：文件数 42→45、Tools 4→5 - 02-mysql-agent专用.sql：会话表 5→6 - 架构设计-风控模块.md：同步更正四、测试 - 新增 tests/test_locks_redis.py：覆盖抢锁成功、占用超时、Redis 故障降级、 Fake 缺方法降级、只删自己锁、三处调用点 key 前缀 - tests/test_audit_middleware.py：补充告警字段断言 - 全量 pytest 510 passed（原基线 503）	2026-09-09 18:10:03 +08:00

Author

SHA1

Message

Date

GaoYiYuan_0626andWorkBuddy

4fd2ec05c8

基金转换 T-4+T-5（并行组 A）：convert_repository 代理侧 + locks.try_lock 非阻塞抢锁

T-4（convert_repository · agent 库 risk_convert_detail）：
- 新增 7 方法：insert_placeholder(占位 pending) / complete_convert(回写 completed+折算详情)
  / mark_failed / get_by_group_id / get_by_client_request_id(None 直接返回 None)
  / list_expired_candidates(hours) / mark_expired(S2 标记不硬删)
- 引擎走 agent 库 rw（D20）；status 5 值枚举；不与 risk_repository 混职责
- Decimal 折算字段经 _to_bind 转 float 绑定（sqlite 不支持直接绑 Decimal，同 T-3）

T-5（locks.try_lock）：
- 单次非阻塞抢锁：抢到返回 _Token(with 进入 True)，抢不到立即 _NoLock(进入 False，不等不降级)
- Redis 不可用退回进程内 Lock.acquire(blocking=False)；_NoLock.__enter__ 返回 False 避免 with None 报错
- 不改 run_locked（D4：其等 2s 后降级 fn(False)，语义相反；3 处调用点零改动）

测试：test_convert_repository.py 6 用例 + test_locks_redis.py +4 用例（既有 6 例零改动）
pytest 全量 634 passed / 3 skipped（基线 624 + 10，零回归）

Co-Authored-By: WorkBuddy <workbuddy@tencent.com>

2026-09-10 15:53:31 +08:00

GaoYiYuan_0626

037ce7edca

docs(架构改进): 补齐 PRD/开发计划/TODO/交接文档，落地无密钥告警与 Redis 分布式锁

一、流程文档（按 AIcoding 六步落地，供新会话从交接文档开工）
- 新增 docs/PRD/PRD-架构改进与稳定性加固.md：6 条 FR（文档勘误、非缺陷说明、
  无密钥启动告警、审计失败告警、Redis 分布式锁、中间件顺序测试）
- 新增 docs/项目框架设计/改进方案评审-问题清单与对比.md：24 项问题分档 A~G，
  经两轮独立 AI 评审，无阻断级错误
- 新增 docs/项目框架设计/开发计划-架构改进.md：HOW 层设计，含合并前只做低风险
  11 项的批次策略
- 新增 docs/项目框架设计/TODO-架构改进.md：T-101~T-109、T-201~T-202 可勾选项
- 新增 docs/交接文档-架构改进.md：自包含交接入口，hy3 新会话可直接开工
- 新增 docs/项目框架设计/架构设计说明书.md：按模块/分层逐一讲解的全量架构说明

二、代码改动（T-107/108/109、T-201.1、T-201.2）
- app/main.py：启动时 DEEPSEEK_API_KEY 缺失告警，明确告知将走降级回复
- app/utils/authz.py：越权审计失败日志补 trace_id，便于串联全链路
- app/api/audit_middleware.py：审计失败日志补 status/path/request_id
- app/service/risk/redis_gateway.py：新增 acquire_lock（SET NX EX）与
  release_lock（Lua 原子释放，只删自己的锁）
- app/service/risk/locks.py：run_locked 改为双层锁，Redis 为主、进程内锁为备；
  Redis 超时沿用 fn(locked=False) 降级语义，Redis 不可用（含测试 Fake 缺方法的
  AttributeError）安全退回进程内锁，绝不抛异常

三、文档勘误（A1/A2/A3）
- MEMORY.md：文件数 42→45、Tools 4→5
- 02-mysql-agent专用.sql：会话表 5→6
- 架构设计-风控模块.md：同步更正

四、测试
- 新增 tests/test_locks_redis.py：覆盖抢锁成功、占用超时、Redis 故障降级、
  Fake 缺方法降级、只删自己锁、三处调用点 key 前缀
- tests/test_audit_middleware.py：补充告警字段断言
- 全量 pytest 510 passed（原基线 503）

2026-09-09 18:10:03 +08:00