|
|
|
@@ -0,0 +1,169 @@
|
|
|
|
|
# AI合同起草与审查助手-法律文书能力吸收开发方案代码对齐复核-2026-05-22
|
|
|
|
|
|
|
|
|
|
## 一、复核口径
|
|
|
|
|
|
|
|
|
|
本次复核只对齐《AI合同起草与审查助手-法律文书能力吸收开发方案-2026-05-20.md》和当前代码，不把以下几类事情混为一谈：
|
|
|
|
|
|
|
|
|
|
1. 方案主线功能是否已经开发完成。
|
|
|
|
|
2. 是否按方案中的建议表名、建议接口名逐字实现。
|
|
|
|
|
3. 是否已经具备当天可访问的远程测试环境。
|
|
|
|
|
4. 是否还存在生产级增强项。
|
|
|
|
|
|
|
|
|
|
当前本地代码基线：
|
|
|
|
|
|
|
|
|
|
- 分支：`main`
|
|
|
|
|
- 最新提交：`d9ca79e0 docs: record contract delivery deploy`
|
|
|
|
|
- 上一功能提交：`f89d9d00 feat: add contract delivery export diff`
|
|
|
|
|
|
|
|
|
|
## 二、总体现状
|
|
|
|
|
|
|
|
|
|
按当前代码判断，Phase15-A 到 Phase15-H 的主线产品闭环已经完成。
|
|
|
|
|
|
|
|
|
|
也就是说，方案要求的文书类型入口、动态要素表单、草稿保存恢复、生成接口升级、审查建议采纳、条款推荐、措辞改写、行业惯例推荐、编辑器、AI 侧边栏、版本历史、DOCX 当前版本导出、版本对比、Prompt 资产治理、黄金样本评测、法规影响扫描、运营 KPI 和商业化基础，都已经在本地代码层形成可运行闭环。
|
|
|
|
|
|
|
|
|
|
当前不应再把 Phase15 主线描述为“还有核心功能没开发”。真正剩余的是三类边界：
|
|
|
|
|
|
|
|
|
|
1. 等价实现与原建议命名不一致。
|
|
|
|
|
2. 生产级增强项暂未做。
|
|
|
|
|
3. 2026-05-22 本轮复核时，`192.168.3.90` 应用容器没有运行，无法重新完成当天远程 HTTP 冒烟。
|
|
|
|
|
|
|
|
|
|
## 三、逐阶段结论
|
|
|
|
|
|
|
|
|
|
| 阶段 | 当前代码状态 | 结论 |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| Phase15-A 文书类型入口与动态要素表单 | 已有文书类型、动态 schema、草稿、生成页面和生成接口 | 主线已闭环 |
|
|
|
|
|
| Phase15-B 审查建议采纳闭环 | 已有风险动作状态、应用建议、手动修改、跳过、版本生成和审计 | 主线已闭环 |
|
|
|
|
|
| Phase15-C 智能条款推荐 | 已有缺失条款、行业惯例、法条关联、措辞优化和编辑器采纳路径 | 主线已闭环 |
|
|
|
|
|
| Phase15-D 富文本编辑器与 AI 侧边栏 | 已有编辑、自动保存、版本历史、AI 侧边栏、Chat、DOCX 导出和版本对比 | 主线已闭环 |
|
|
|
|
|
| Phase15-E Prompt 资产治理 | 已有 Prompt 资产、版本、发布、下线、回滚、评测和运行证据 | 主线已闭环 |
|
|
|
|
|
| Phase15-F 黄金样本与质量评测 | 已有 Prompt 黄金样本逐条评测、评测记录、发布门禁和 `/quality-evals` 页面 | 主线已闭环 |
|
|
|
|
|
| Phase15-G 法规变更影响分析 | 已有变更事件、影响项、模板/规则/合同扫描、语义匹配、worker 和页面 | 主线已闭环 |
|
|
|
|
|
| Phase15-H 运营 KPI 与商业化增强 | 已有运营 KPI、套餐用量、试用/超额提示、发票状态和销售跟进 | 主线已闭环 |
|
|
|
|
|
|
|
|
|
|
## 四、等价实现说明
|
|
|
|
|
|
|
|
|
|
以下项目不是“完全没做”，而是当前代码没有照方案建议名称逐字实现。为了避免后续误判，统一按当前代码命名理解。
|
|
|
|
|
|
|
|
|
|
| 方案建议 | 当前实现 | 是否影响主线 |
|
|
|
|
|
|---|---|---|
|
|
|
|
|
| `/api/v1/clauses/apply` | 没有单独接口；前端在 `/documents/[id]/edit` 中把推荐条款或改写结果插入正文，再通过合同版本接口保存为新版本 | 不影响当前用户闭环；若以后要开放第三方系统直接采纳条款，可补独立接口 |
|
|
|
|
|
| `clause_recommendations` 表 | 没有独立持久化推荐表；当前使用实时推荐、审计日志和 `generated_contract_versions` 保存采纳结果 | 不影响推荐和采纳；若要统计“展示、采纳、忽略、修改”完整漏斗，需要补持久化表 |
|
|
|
|
|
| `ai_quality_eval_runs` / `ai_quality_eval_items` | 当前复用 `prompt_asset_evaluation_runs` 保存 Prompt 评测运行和逐条样本报告 | 不影响 Phase15-F；若未来做跨 Prompt、跨合同、跨法规的统一质量平台，再补通用表 |
|
|
|
|
|
| `/regulation-impacts` 或 `/regulation-changes` | 当前统一命名为 `/legal-change-impacts`，模型为 `legal_change_events` 和 `legal_change_impacts` | 不影响功能；文档后续应统一使用当前代码命名 |
|
|
|
|
|
| `regulation_impact_tasks` | 当前没有单独 task 表；使用事件状态、影响项和 worker 消费 pending 事件 | 不影响当前扫描闭环；如需更复杂队列调度再补 task 表 |
|
|
|
|
|
| 模板表 `industry`、`scenario`、`elements_schema_id`、`default_prompt_asset_id` | 当前模板表已有 `document_type_code`、`template_category`、`industry_category`；场景在文书类型中；schema 按文书类型绑定；Prompt 按类型从已发布 Prompt 资产解析 | 不影响当前生成闭环；不是字段逐字实现 |
|
|
|
|
|
| 审查结果表 `processed_risk_count` 等列 | 当前从 `review_risk_actions` 实时计算处理进度，并在页面展示 | 不影响审查建议处理闭环 |
|
|
|
|
|
|
|
|
|
|
## 五、当前真正未彻底结束的事项
|
|
|
|
|
|
|
|
|
|
这些不是 Phase15 主线代码缺口，但如果要进入更重的生产运营阶段，需要单独立项。
|
|
|
|
|
|
|
|
|
|
1. 条款推荐完整行为漏斗未沉淀
|
|
|
|
|
- 当前能推荐、能插入、能改写、能保存版本。
|
|
|
|
|
- 尚未单独记录每条推荐的展示、忽略、修改、采纳全过程。
|
|
|
|
|
- 建议以后作为“运营分析增强”开发，不阻塞当前法律文书主线。
|
|
|
|
|
|
|
|
|
|
2. 通用质量评测域未独立建模
|
|
|
|
|
- 当前 Prompt 评测已经可复跑并能阻止发布。
|
|
|
|
|
- 尚未新增通用 `ai_quality_eval_runs/items`，非 Prompt 评测对象还没有统一质量域。
|
|
|
|
|
- 建议未来做“统一质量平台”时再补。
|
|
|
|
|
|
|
|
|
|
3. 专业 Word 级编辑能力未做
|
|
|
|
|
- 当前已经有页面编辑、自动保存、版本历史、DOCX 导出和段落/条款级版本对比。
|
|
|
|
|
- 尚未做 Word 高保真往返、字段级 diff、多人实时协同、复杂样式导出。
|
|
|
|
|
- 这属于体验增强，不是当前上线收费的硬阻塞。
|
|
|
|
|
|
|
|
|
|
4. 全量法规向量化未做
|
|
|
|
|
- 当前已有法条全文库、审查报告法条引用、Chat 法条来源、法规影响语义扫描。
|
|
|
|
|
- 尚未把全国全量法规做一次性向量化。
|
|
|
|
|
- 这属于大容量知识工程阶段，不应算作 Phase15 未完成。
|
|
|
|
|
|
|
|
|
|
5. 真实微信/支付宝支付和完整开票文件流未做
|
|
|
|
|
- 当前已有商业化基础、套餐、用量、订单、发票状态和销售跟进。
|
|
|
|
|
- 真实支付仍需要商户号、证书、密钥、公网 HTTPS 回调域名。
|
|
|
|
|
- 完整发票开票文件也需要后续接开票服务或人工开票文件流。
|
|
|
|
|
|
|
|
|
|
6. P3 外部集成未做
|
|
|
|
|
- 微信小程序、电子签章、第三方签署平台、重型工作流引擎在原方案中就是延后方向。
|
|
|
|
|
- 当前未实现符合方案边界，不算跑偏。
|
|
|
|
|
|
|
|
|
|
## 六、验证结果
|
|
|
|
|
|
|
|
|
|
### 6.1 后端回归
|
|
|
|
|
|
|
|
|
|
命令：
|
|
|
|
|
|
|
|
|
|
```powershell
|
|
|
|
|
$env:PYTHONPATH='backend'; python -m unittest backend.tests.test_legal_document_type_service backend.tests.test_legal_document_types_api backend.tests.test_legal_document_element_schema_service backend.tests.test_legal_document_element_schemas_api backend.tests.test_legal_document_draft_service backend.tests.test_legal_document_drafts_api backend.tests.test_contracts_api backend.tests.test_review_risk_action_service backend.tests.test_review_risk_actions_api backend.tests.test_clause_recommendation_service backend.tests.test_clauses_api backend.tests.test_prompt_asset_service backend.tests.test_prompt_assets_api backend.tests.test_prompt_runtime_service backend.tests.test_legal_change_impact_service backend.tests.test_legal_change_impacts_api backend.tests.test_operation_kpi_service backend.tests.test_operation_kpis_api
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
结果：
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
Ran 95 tests in 2.660s
|
|
|
|
|
OK
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### 6.2 前端重点页面静态检查
|
|
|
|
|
|
|
|
|
|
命令：
|
|
|
|
|
|
|
|
|
|
```powershell
|
|
|
|
|
npx eslint "src/app/documents/new/page.tsx" "src/app/documents/new/[type]/page.tsx" "src/app/documents/[id]/edit/page.tsx" "src/app/prompt-assets/page.tsx" "src/app/quality-evals/page.tsx" "src/app/legal-change-impacts/page.tsx" "src/app/operation-kpis/page.tsx" "src/components/layout/app-topbar.tsx" "src/types/api.ts"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
结果：通过，无错误输出。
|
|
|
|
|
|
|
|
|
|
### 6.3 前端生产构建
|
|
|
|
|
|
|
|
|
|
命令：
|
|
|
|
|
|
|
|
|
|
```powershell
|
|
|
|
|
npm run build
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
结果：
|
|
|
|
|
|
|
|
|
|
```text
|
|
|
|
|
Compiled successfully
|
|
|
|
|
Generating static pages (40/40)
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
构建路由包含：
|
|
|
|
|
|
|
|
|
|
- `/documents/new`
|
|
|
|
|
- `/documents/new/[type]`
|
|
|
|
|
- `/documents/[id]/edit`
|
|
|
|
|
- `/prompt-assets`
|
|
|
|
|
- `/quality-evals`
|
|
|
|
|
- `/legal-change-impacts`
|
|
|
|
|
- `/operation-kpis`
|
|
|
|
|
|
|
|
|
|
## 七、远程测试服务器现状
|
|
|
|
|
|
|
|
|
|
2026-05-22 本轮复核时，`192.168.3.90` 的 SSH 端口可连，但应用 HTTP 端口不可连：
|
|
|
|
|
|
|
|
|
|
- `192.168.3.90:22`：可连。
|
|
|
|
|
- `192.168.3.90:8001`：不可连。
|
|
|
|
|
- `192.168.3.90:3003`：不可连。
|
|
|
|
|
|
|
|
|
|
只读检查显示：
|
|
|
|
|
|
|
|
|
|
- `ai-contract-backend-restore`：已退出。
|
|
|
|
|
- `ai-contract-frontend`：已退出。
|
|
|
|
|
- `ai-contract-legal-change-worker`：已退出。
|
|
|
|
|
- `gitea`：仍在运行。
|
|
|
|
|
|
|
|
|
|
因此，本轮不能把“今天远程 HTTP 冒烟通过”写成当前事实。这个问题属于测试服务器运行状态问题，不是《法律文书能力吸收开发方案》的代码缺口。
|
|
|
|
|
|
|
|
|
|
若后续要恢复远程验证，应先重启或重新部署 `ai-contract` 后端、前端和 worker 容器，再复跑 `/health`、`/documents/new`、`/documents/[id]/edit`、`/quality-evals`、`/legal-change-impacts` 等路由烟测。
|
|
|
|
|
|
|
|
|
|
## 八、最终结论
|
|
|
|
|
|
|
|
|
|
《AI合同起草与审查助手-法律文书能力吸收开发方案-2026-05-20.md》与当前代码整体对齐。
|
|
|
|
|
|
|
|
|
|
当前没有必须回到 Phase15 主线补开发的核心功能。需要继续推进时，建议不要再围绕 Phase15-A 到 Phase15-H 反复补主线，而是按增强项单独排期：
|
|
|
|
|
|
|
|
|
|
1. 先恢复 `192.168.3.90` 应用容器，补当天远程冒烟。
|
|
|
|
|
2. 再按业务价值选择增强项：条款推荐行为漏斗、通用质量评测域、专业交付增强、全量法规向量化、真实支付、电子签章或小程序。
|
|
|
|
|
|
