律所收接案开发任务清单
律所收接案系统开发任务清单（技术执行版）
1. 文档目的
本清单用于将“跨部门流程方案”拆解为可执行开发任务，按迭代推进，避免大而全改造导致风险失控。
2. 当前基线（已完成）
- 市场部 FTJ 线索录入、列表、详情、跟进记录；
- 分配与阶段管理字段（第一阶段）；
- 分配池看板、律师接收/拒绝快捷操作（第二阶段）；
- 到期线索 cron 站内提醒（轻量版）。
3. 迭代拆分
Iteration A（1周）：稳定现有 FTJ
目标：把已上线能力做稳定和可运维。
任务：
- 增加“提醒任务手动执行按钮”（后台页面）。
- 增加“提醒发送日志”查询（按线索、接收人、日期筛选）。
- 为 FTJ 关键写操作加操作日志（分配、接收、拒绝、阶段变更）。
- 对
next_follow_date与next_follow_time做统一口径（保留一个主字段，避免歧义）。
验收：
- 可手动触发提醒并看到成功/失败统计；
- 可追溯任何线索的关键状态变更记录。
Iteration B（1-2周）：行政/财务最小字段接入
目标：跨部门“可协同”，不做复杂财务系统。
数据字段（建议新增到 by_market_lead 或扩展表）：
- 行政：
contract_no、contract_file、archive_status、archive_time - 财务：
fee_received、fee_pending、fee_mode、invoice_status、payment_time
页面改造：
- FTJ 详情页新增“行政信息”区域（行政角色可编辑）。
- FTJ 详情页新增“财务信息”区域（财务角色可编辑）。
- 阶段流转增加前置校验（如进入
ENTRUSTED需合同/收费计划至少一项）。
权限：
- 市场/律师只读行政财务字段；
- 行政不可改财务金额；
- 财务不可改案件评估内容。
验收：
- 三部门在同一线索详情内完成协作；
- 权限隔离符合预期。
Iteration C（1周）：统计看板与考核口径
目标：管理层可一眼看到堵点与绩效。
报表指标：
- 线索总量、未分配、已分配、已退回、到期未跟进；
- 律师接收率、拒绝率、平均首次联系时长；
- 线索 -> 委托转化率；
- 平均阶段停留时长；
- 已收/待收金额、逾期应收。
技术实现建议：
- 先做 SQL 聚合 + 后台列表；
- 再做图表可视化（可后置）。
验收：
- 管理层可按时间区间与责任人筛选；
- 指标定义与业务口径一致。
4. 技术任务清单（按模块）
4.1 数据库
- [ ] 迁移脚本：行政/财务字段新增
- [ ] 索引优化：
shop_id + current_stage、shop_id + assign_status、shop_id + next_follow_time - [ ] 数据字典文档同步更新
4.2 后端（Action/Model）
- [ ] FTJ 详情保存接口分角色写入
- [ ] 阶段流转前置校验封装
- [ ] 提醒日志记录模型/表
- [ ] 操作日志统一写入
4.3 前端（模板）
- [ ] FTJ 列表增加高级筛选
- [ ] FTJ 详情页三部门分区展示
- [ ] 提醒执行与结果反馈页面
4.4 定时任务
- [ ] 市场线索提醒 cron 增加 dry-run 参数
- [ ] 支持按 shop 限定执行
- [ ] 超时与锁机制（避免并发重复发送）
5. 风险点与规避
- 字段膨胀导致
market_lead过重
建议：超过 20 个新增业务字段后拆扩展表（lead_admin、lead_finance）。
- 角色边界不清导致互相覆盖
建议：后端接口按角色白名单字段保存，禁止全字段提交。
- 提醒重复发送
建议：按“线索+接收人+日期”去重，并记录发送日志。
- 阶段乱跳
建议：引入状态机约束（例如 TO_ASSIGN -> INITIAL_CONTACT -> EVALUATING -> ENTRUSTED -> HANDLING -> CLOSED）。
6. 建议里程碑
- M1（本周）：稳定现有 FTJ + 手动提醒 + 操作日志
- M2（下周）：行政/财务字段 + 权限隔离 + 前置校验
- M3（第3周）：管理看板 + 指标口径 + 周报自动化
7. 交付物清单（每次迭代）
每次迭代必须交付：
- SQL 迁移文件
- 变更文件清单
- 权限影响说明
- 回归测试点列表
- 回滚方案
