group_fqcd_jr/docs/风控业务演示文档/16-已知限制与待办.md

已知限制与待办

文档功能

本文档用于集中说明风控模块当前已知限制、暂缓事项、公共底座例外和外部依赖风险，避免演示时产生超出实际能力的预期。

暂缓事项

对话历史与长期留存

• 当前继续使用主项目 MySQL 会话和消息存储。
• 暂不改为 Redis-only。
• 暂不修改公共 Run、Worker、消息持久化和记忆抽取链路。
• 后续计划采用 MySQL 权威保存、Redis 缓存最近会话和分级留存。

公共底座例外

当前公共基座存在 3 项 MyPy 类型问题：

• 模型网关端点适配器类型不一致。
• Worker 请求元数据类型不一致。

经确认公共基座不修改，上述问题作为已知类型例外保留。它们不影响当前业务运行和真实 Agent 验收。

外部依赖

• Redis 不可用时，缓存和限流可能降级，不影响结构化业务主流程。
• Milvus 不可用时，语义记忆关闭，结构化查询继续运行。
• 模型服务不可用时，使用模板或规则化降级。
• SMTP 未开启时，邮件接口返回禁用或 dry-run。

前端范围

• 当前验证页面位于 private_frontend。
• 私有页面用于个人本地验证，不作为公共模块正式交付。
• 正式前端样式、路由和部署由主项目统一处理。

数据范围

• 本模块不提供演示数据初始化和重置。
• 演示前需要由主项目预先写入足量客户、产品、交易、预警和权限数据。
• 没有有效客户归属时，风控账号将无法访问客户数据。

Agent 边界

• Agent 只读，不执行正式处置。
• 误报、放行和疑似误判只是复核草案。
• 模型结果不能绕过权限、数据范围和合规校验。
• 对话历史缓存和长期归档策略尚未实施。

后续建议

• 主项目合并完成后对齐统一 RBAC 和客户数据范围。
• 修复公共 data_scope 最高权限跨资源扩散问题。
• 确认幂等回执与业务 Action 内部提交的事务边界。
• 私有前端最后再适配 data/meta 列表信封和写接口 Idempotency-Key。
• 根据合规要求确定会话保留期、脱敏和归档策略。
• 正式前端接入前完成接口字段最终冻结。
• 在网络可用时保留 Ruff、MyPy 和结构审计结果作为合并证据。