yuqei/ai-contract-platform
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

feat: align deployment and approval workflow

Browse Source
This commit is contained in:
cyuqei
2026-06-18 03:37:03 +08:00
parent 328f8c7da3
commit 175c0a69af
102 changed files with 4569 additions and 1035 deletions
Download Patch File Download Diff File Expand all files Collapse all files
project-docs/AI合同起草与审查助手-Phase1主链路验收清单-2026-06-17.md
+131
View File
@@ -0,0 +1,131 @@
# AI合同起草与审查助手 Phase1 主链路验收清单
日期：2026-06-17
关联方案：`project-docs/AI合同起草与审查助手-Phase1实际开发执行方案-2026-06-17.md`
## 1. 验收目标
验证 Phase1 是否真正完成“起草 -> 自动预审 -> 风险处理 -> 报告交付”的业务主链路。
验收口径：
1. 客户能在 3 分钟内看懂产品定位。
2. 业务用户能完成一次合同起草和自动预审。
3. 审查详情默认展示业务结论，而不是技术链路。
4. 模板库能说明适用场景、发布状态、变量配置和版本。
5. 审查报告能作为试点交付材料下载。
## 2. 验收账号与环境
- 环境：本地开发环境或正式试点环境。
- 角色：管理员、业务用户各 1 个。
- 样本：服务合同、采购合同或 NDA 模板至少 1 个。
- 浏览器：Chrome 最新稳定版。
## 3. 主链路验收步骤
### 步骤 1：首页与登录
1. 打开 `/`。
2. 确认首屏表达为“合同起草、自动预审、风险解释、报告交付”。
3. 点击注册或登录。
4. 登录后进入 `/workspace`。
通过标准：
- 首页不再只讲“合同审查工具”。
- 顶部导航出现“合同起草”“发起审查”“审查记录”“法律问答”。
### 步骤 2：合同起草
1. 从工作台进入 `/contracts`。
2. 点击“新建合同”。
3. 选择一个可用模板。
4. 填写关键内容。
5. 预览合同。
6. 点击“生成并启动预审”。
通过标准：
- 步骤文案为“选择模板 -> 填写关键内容 -> 预览确认 -> 生成并预审”。
- 生成完成后能看到自动预审状态。
- 最近合同列表能看到预审提示、风险等级或报告状态。
### 步骤 3：审查详情
1. 进入生成合同的预审详情，或从 `/review` 上传已有合同。
2. 打开 `/reviews/[id]`。
3. 查看“试点演示摘要”和“业务处理摘要”。
4. 检查“必改事项”“可协商事项”“报告交付”。
5. 展开“技术详情”。
通过标准：
- 默认视图能回答：风险是什么、先改什么、下一步做什么、报告在哪里。
- OCR、Workflow、AI Trace 等技术字段默认折叠。
- 展开技术详情后仍能查看排障信息。
### 步骤 4：报告下载
1. 在审查详情页点击“下载审查报告”。
2. 打开生成的报告。
3. 检查报告是否包含：
- 风险总览
- 业务处理摘要
- 风险项详情
- 条款结构
- 法条引用或免责声明
通过标准：
- 报告可下载。
- 报告内容能作为试点交付材料阅读。
- 报告明确说明不替代正式法律意见。
### 步骤 5：模板库
1. 使用管理员进入 `/templates`。
2. 选择一个模板。
3. 查看模板详情摘要。
4. 检查模板分类、行业入口、变量数量、版本状态。
通过标准：
- 模板详情能展示适用场景、发布状态、变量配置和最近版本。
- 模板正文和变量定义仍可查看。
- 发布、下线、编辑、版本历史仍可用。
## 4. 回归命令
建议执行：
```bash
npm --prefix frontend run lint
npm --prefix frontend run build
python -m pytest backend/tests/test_contracts_api.py backend/tests/test_reviews_api.py backend/tests/test_review_service.py backend/tests/test_review_risk_action_service.py
git diff --check
```
如果本地未安装 npm 依赖，可先安装依赖后再执行。
## 5. 人工签收结论
| 验收项 | 结果 | 备注 |
| --- | --- | --- |
| 首页定位 | 待验收 | |
| 合同起草 | 待验收 | |
| 自动预审 | 待验收 | |
| 审查详情业务化 | 待验收 | |
| 报告下载 | 待验收 | |
| 模板库摘要 | 待验收 | |
| 技术详情可展开 | 待验收 | |
## 6. Phase1 完成判定
全部通过后，Phase1 可判定为完成：
1. 对外定位已经从单点审查升级为起草与审查平台。
2. 合同起草链路能衔接自动预审。
3. 审查详情默认面向业务决策。
4. 模板库和报告交付具备试点演示能力。
project-docs/AI合同起草与审查助手-Phase1实际开发执行方案-2026-06-17.md
+463
View File
@@ -0,0 +1,463 @@
# AI合同起草与审查助手 Phase1 实际开发执行方案
日期：2026-06-17
关联总方案：`project-docs/AI合同起草与审查助手-完整规划开发方案-2026-06-17.md`
## 1. 执行结论
Phase1 不建议再扩大底层能力范围，而应先做一次“产品主链路收敛”：
> 把当前已有的合同生成、合同审查、报告下载、模板库能力，重组为客户能在 3 分钟内看懂并完成的起草与预审闭环。
本阶段重点不是新增复杂后台模型，而是：
- 对外定位从“合同审查工作台”升级为“AI 合同起草与审查平台”。
- 让起草、预审、报告下载成为主导航和主流程。
- 把审查详情页里偏技术的字段收进高级信息或排障区域。
- 让模板库、审查报告、自动预审结果更贴近业务用户的表达。
## 2. 本阶段目标
### 2.1 用户目标
业务用户进入系统后，应能完成：
1. 看懂产品能做什么：起草、审查、风险解释、报告交付。
2. 选择模板并填写关键变量。
3. 生成合同并自动进入预审。
4. 查看清晰的风险结论和修改建议。
5. 下载合同或审查报告。
### 2.2 产品目标
1. 首页价值表达清晰，避免只讲“审查”。
2. 登录后导航按用户工作流排序。
3. 合同生成页从“历史树 + 生成抽屉”的后台感，调整为“起草任务 + 最近合同 + 预审状态”的业务工作台感。
4. 审查详情页默认展示业务判断，技术链路信息降级。
5. 模板库分类和审查报告成为可售卖能力，而不是内部管理能力。
### 2.3 技术目标
1. 优先复用现有接口和字段，不做数据库迁移。
2. 前端以页面重组和展示语义优化为主。
3. 后端只在报告模板或轻量 DTO 字段不足时小范围补齐。
4. 每批次都能独立回归和上线。
## 3. 当前代码入口
### 3.1 前端页面
| 范围 | 文件 | 说明 |
| --- | --- | --- |
| 公共首页 | `frontend/src/app/page.tsx` | 当前仍以合同审查为主，需要改成起草与审查平台定位 |
| 顶部导航 | `frontend/src/components/layout/app-topbar.tsx` | 品牌副标题和登录后导航顺序需要统一 |
| 合同生成 | `frontend/src/app/contracts/page.tsx` | Phase1 主改造页面，承载起草、预览、生成、自动预审提示 |
| 合同详情 | `frontend/src/app/contracts/[id]/page.tsx` | 检查生成结果、生命周期、下载、预审入口表达 |
| 发起审查 | `frontend/src/app/review/page.tsx` | 可保留为上传审查入口，需与起草链路文案一致 |
| 审查列表 | `frontend/src/app/reviews/page.tsx` | 检查列表状态和风险摘要表达 |
| 审查详情 | `frontend/src/app/reviews/[id]/page.tsx` | Phase1 重点瘦身页面，默认面向业务用户 |
| 模板管理 | `frontend/src/app/templates/page.tsx` | 当前偏管理后台，Phase1 做分类和可用性表达优化 |
| 工作台 | `frontend/src/app/workspace/page.tsx` | 可作为登录后主入口，串联起草、审查、最近任务 |
### 3.2 前端服务与工具
| 范围 | 文件 | 说明 |
| --- | --- | --- |
| 合同服务 | `frontend/src/services/contract.ts` | 已有模板、生成、列表、生命周期、自动审查摘要类型 |
| 审查服务 | `frontend/src/services/review.ts` | 已有审查详情、报告、风险动作、下载等能力 |
| 格式化 | `frontend/src/lib/format.ts` | 需要补齐业务化状态、风险和报告字段文案 |
| 模板分类 | `frontend/src/lib/template-taxonomy.ts` | 模板分类可直接复用，优先改展示 |
| 角色逻辑 | `frontend/src/lib/roles.ts` | 导航排序和角色入口需保持一致 |
### 3.3 后端接口
| 范围 | 文件 | 说明 |
| --- | --- | --- |
| 合同 API | `backend/app/api/contracts.py` | 已支持模板、生成、预览、详情、下载、生命周期、生成后异步自动审查 |
| 审查 API | `backend/app/api/reviews.py` | 已支持审查创建、结果、报告、下载、风险动作 |
| 合同生成服务 | `backend/app/services/contract_generation_service.py` | Phase1 原则上不改核心生成逻辑 |
| 合同导出服务 | `backend/app/services/contract_export_service.py` | 仅在下载体验存在缺口时调整 |
| 合同模板服务 | `backend/app/services/contract_template_service.py` | 模板分类和筛选可复用 |
| 审查服务 | `backend/app/services/review_service.py` | 不改审查核心算法，保持风险结果稳定 |
| 审查报告模板 | `backend/app/services/review_report_template.py` | Phase1 可增强报告结构和业务文案 |
| 风险动作服务 | `backend/app/services/review_risk_action_service.py` | 审查详情页建议采纳闭环可复用 |
## 4. 开发批次
### Batch 1：定位、首页与导航统一
目标：客户第一次打开系统，就知道这是“合同起草与审查平台”，不是单点审查页面。
改造范围：
- `frontend/src/app/page.tsx`
- `frontend/src/components/layout/app-topbar.tsx`
- 必要时同步全局样式文件
交付项：
1. 首页 H1 改为“AI 合同起草与审查平台”或等价表达。
2. 首页首屏明确四个能力：起草、预审、风险解释、报告交付。
3. 公共导航保留首页、套餐、演示申请、注册、登录。
4. 登录后导航按真实工作流排序：
- 工作台
- 合同起草
- 发起审查
- 审查记录
- 法律问答
- 个人设置
5. 品牌副标题从“合同审查工作台”改为“起草与审查平台”。
6. 管理员菜单保持后台能力，但避免主导航过载。
验收标准：
- 未登录访问首页，可以在首屏看懂起草与审查双能力。
- 登录后导航命名与总方案一致。
- 不影响 `/pricing`、`/demo-request`、`/login`。
建议验证：
```bash
npm --prefix frontend run lint
npm --prefix frontend run build
```
人工验收页面：
- `/`
- `/pricing`
- `/demo-request`
- `/login`
- `/workspace`
### Batch 2：合同起草主链路收敛
目标：把 `contracts` 页面从“生成工具页”变成“合同起草工作台”。
改造范围：
- `frontend/src/app/contracts/page.tsx`
- `frontend/src/app/contracts/[id]/page.tsx`
- `frontend/src/services/contract.ts`
- `frontend/src/lib/format.ts`
交付项：
1. 页面标题统一为“合同起草”。
2. 默认主操作为“新建合同”，而不是让用户先理解历史树。
3. 表单步骤调整为：
- 选择模板
- 填写关键内容
- 预览确认
- 生成并预审
4. 生成完成后突出三个结果：
- 合同已生成
- 自动预审状态
- 下载或查看审查结果
5. 最近合同区显示业务字段：
- 合同名称
- 合同类型
- 更新时间
- 预审状态
- 风险等级
6. 保留高级信息和生命周期状态，但不作为默认视觉焦点。
7. 处理生成超时和恢复场景时，文案改成业务可理解表达。
不做事项：
- 不重写合同生成服务。
- 不引入新的审批状态模型。
- 不做数据库迁移。
验收标准：
- 新用户无需看说明即可完成一次模板合同生成。
- 生成成功后能清楚看到自动预审是否已完成、处理中或失败。
- 从审查结果回到合同生成时，已有 `review` 上下文仍可用。
建议验证：
```bash
npm --prefix frontend run lint
npm --prefix frontend run build
python -m pytest backend/tests/test_contracts_api.py
```
人工验收路径：
1. 登录。
2. 进入 `/contracts`。
3. 新建一份 NDA 或服务合同。
4. 预览。
5. 生成。
6. 查看自动预审状态。
7. 下载合同。
### Batch 3：审查详情页业务化瘦身
目标：让业务用户先看到风险结论和下一步行动，而不是内部流程、模型链路、OCR 门禁等技术字段。
改造范围：
- `frontend/src/app/reviews/[id]/page.tsx`
- `frontend/src/app/reviews/page.tsx`
- `frontend/src/services/review.ts`
- `frontend/src/lib/format.ts`
交付项：
1. 审查详情默认信息架构改为：
- 总体结论
- 风险等级
- 必改事项
- 可协商事项
- 建议下一步
- 报告下载
2. 风险项列表按严重程度排序并展示可行动建议。
3. “解释风险”“生成修改清单”“给出谈判策略”保留为快捷操作。
4. 技术信息折叠到“处理详情”或“高级信息”：
- workflow state
- ai trace
- OCR gate
- extraction mode
- source document debug 字段
5. 对失败、处理中、可重试状态给出清晰下一步。
6. 审查列表页的状态、风险和报告入口保持一致。
不做事项：
- 不改变审查算法。
- 不移除已有排障字段，只降低默认曝光。
- 不删除管理员可见信息。
验收标准：
- 普通业务用户打开审查详情，首屏能判断“能不能签、先改什么、下载哪里”。
- 技术字段不再挤占默认阅读区域。
- 风险动作采纳、跳过、应用建议仍可用。
建议验证：
```bash
npm --prefix frontend run lint
npm --prefix frontend run build
python -m pytest backend/tests/test_reviews_api.py backend/tests/test_review_service.py backend/tests/test_review_risk_action_service.py
```
人工验收路径：
1. 上传一份合同并发起审查。
2. 等待审查完成。
3. 打开 `/reviews/[id]`。
4. 查看总体风险。
5. 对一条风险执行建议动作。
6. 下载报告。
7. 打开高级信息，确认排障字段仍可查看。
### Batch 4：模板库、报告交付与主链路验收
目标：补齐 Phase1 可销售体验，确保演示时不是几个页面各自可用，而是一条完整链路。
改造范围：
- `frontend/src/app/templates/page.tsx`
- `frontend/src/lib/template-taxonomy.ts`
- `backend/app/services/review_report_template.py`
- `frontend/src/app/workspace/page.tsx`
- 相关测试和验收脚本
交付项：
1. 模板管理页增强分类表达：
- 按合同类型
- 按模板用途
- 按行业
2. 模板详情突出适用场景、变量、发布状态、最近版本。
3. 审查报告结构增强为客户可交付格式：
- 基本信息
- 总体风险
- 重点风险
- 修改建议
- 法条或依据引用
- 免责声明
4. 工作台首页提供三个入口：
- 起草合同
- 上传审查
- 查看最近任务
5. 补一条 Phase1 手工验收清单或脚本说明。
不做事项：
- 不在 Phase1 接入电子签章。
- 不新增复杂审批流。
- 不扩展用量计费模型。
验收标准：
- 从工作台可以进入完整主链路。
- 模板分类对业务用户可理解。
- 审查报告可以作为试点交付材料发送给客户。
- 3 分钟主链路可完整演示。
建议验证：
```bash
npm --prefix frontend run lint
npm --prefix frontend run build
python -m pytest backend/tests/test_contracts_api.py backend/tests/test_reviews_api.py backend/tests/test_review_service.py backend/tests/test_review_risk_action_service.py
```
人工验收路径：
1. 打开 `/workspace`。
2. 进入合同起草。
3. 生成合同。
4. 查看自动预审结果。
5. 进入审查详情。
6. 下载报告。
7. 回到工作台查看最近任务。
## 5. 接口与数据策略
Phase1 默认不做数据库迁移。
### 5.1 优先复用的现有能力
- 模板列表：`GET /contracts/templates`
- 合同预览：`POST /contracts/preview`
- 合同生成：`POST /contracts/generate`
- 合同列表：`GET /contracts`
- 合同详情：`GET /contracts/{id}`
- 合同下载：`GET /contracts/{id}/download`
- 审查详情：`GET /reviews/{id}`
- 审查结果：`GET /reviews/{id}/result`
- 审查报告：`GET /reviews/{id}/report`
- 报告下载：`GET /reviews/{id}/download`
- 风险动作：`GET /reviews/{id}/risk-actions`
### 5.2 可接受的小改动
仅当页面缺字段时，允许增加轻量只读字段：
- 合同列表项增加更友好的 `auto_review_status_label`。
- 审查报告增加 `business_summary` 或 `next_steps`。
- 模板列表项增加 `recommended_for` 或 `scenario_summary`。
新增字段必须满足：
1. 向后兼容。
2. 默认值可为空。
3. 不影响旧客户端。
4. 有 API 测试覆盖。
### 5.3 暂缓事项
- 审批流表结构。
- 电子签章供应商对接。
- 合同台账新模型。
- 企业组织空间重构。
- 大规模权限模型调整。
## 6. 验收口径
### 6.1 P0 主链路验收
必须满足：
1. 用户可以注册或登录。
2. 用户可以进入工作台。
3. 用户可以起草合同。
4. 用户可以生成合同。
5. 生成后自动预审有明确状态。
6. 用户可以查看审查结果。
7. 用户可以下载合同或审查报告。
### 6.2 用户体验验收
必须满足：
1. 首屏能说明产品是“起草 + 审查”。
2. 主导航不混乱。
3. 普通用户默认不需要理解内部技术字段。
4. 风险结果能回答：
- 风险是什么
- 为什么有风险
- 应该怎么改
- 下一步做什么
5. 失败状态能告诉用户如何继续。
### 6.3 技术验收
必须满足：
1. 前端 lint 通过。
2. 前端 build 通过。
3. 合同 API 回归通过。
4. 审查 API 和审查服务回归通过。
5. `git diff --check` 无空白错误。
建议完整命令：
```bash
npm --prefix frontend run lint
npm --prefix frontend run build
python -m pytest backend/tests/test_contracts_api.py backend/tests/test_reviews_api.py backend/tests/test_review_service.py backend/tests/test_review_risk_action_service.py
git diff --check
```
## 7. 发布与回滚策略
### 7.1 发布顺序
1. Batch 1 先发，因为它不依赖后端。
2. Batch 2 再发，验证合同生成和自动预审。
3. Batch 3 独立发，验证审查详情体验。
4. Batch 4 最后发，完成主链路演示和报告交付。
### 7.2 回滚策略
1. 前端页面改造按页面维度回滚。
2. 若报告模板改动导致下载异常，先回滚 `review_report_template.py`。
3. 若新增 DTO 字段有兼容风险，保留字段但恢复旧展示逻辑。
4. 若主链路演示受阻，优先保证：
- `/contracts`
- `/reviews`
- `/reviews/[id]`
- 报告下载
## 8. 风险控制
| 风险 | 表现 | 控制方式 |
| --- | --- | --- |
| 页面重组影响旧用户习惯 | 用户找不到旧入口 | 保留历史入口，新增主操作，不删除核心功能 |
| 审查详情瘦身导致排障困难 | 技术字段不可见 | 技术信息折叠但不移除，管理员仍能查看 |
| 生成后自动预审状态不稳定 | 用户误以为失败 | 明确区分处理中、已完成、失败、可重试 |
| 首页文案过度营销 | 客户看不出功能 | 首屏直接呈现起草、预审、报告、风险建议 |
| 报告模板调整影响下载 | 文件生成失败 | 后端报告测试覆盖，必要时按模板文件回滚 |
## 9. 开发完成定义
每个 Batch 必须满足：
1. 代码改动只覆盖本批次范围。
2. 页面无明显文案冲突和导航错位。
3. 主要入口可访问。
4. 相关 lint/build/test 通过，或记录明确失败原因。
5. 文档中的验收路径可人工复现。
Phase1 整体完成定义：
1. `/` 能准确表达 AI 合同起草与审查平台。
2. `/workspace` 能引导起草、审查、最近任务。
3. `/contracts` 能完成合同起草、预览、生成、下载。
4. 生成后自动预审状态清晰。
5. `/reviews/[id]` 默认展示业务风险结论和下一步建议。
6. 报告下载可用，内容适合试点交付。
7. 普通用户不被内部技术字段干扰。
## 10. 下一步开发建议
建议从 Batch 1 开始，原因是它风险低、收益高，并且会给后续页面改造统一命名和导航基准。
Batch 1 完成后，再进入 Batch 2。Batch 2 是 Phase1 的核心，需要在合同生成页面边改边做人工验收，确保“起草 -> 预览 -> 生成 -> 自动预审”真的顺。
project-docs/AI合同起草与审查助手-完整规划开发方案-2026-06-17.md
+434
View File
@@ -0,0 +1,434 @@
# AI合同起草与审查助手 完整规划开发方案
日期：2026-06-17
## 1. 规划结论
当前产品不应继续被讲成单点“合同审查工具”，而应升级为：
> **AI 合同起草与审查平台，向轻量 CLM 演进。**
短期主卖点：
- 合同起草
- 合同预审
- 风险解释
- 报告交付
中期补齐：
- 审批流
- 版本比对
- 电子签
- 合同台账
- 履约提醒
长期壁垒：
- 法条与规则库
- 企业知识库
- 风险学习闭环
- 法务运营看板
---
## 2. 现状判断
### 已有强项
- 合同生成
- 合同审查
- Chat 追问
- PDF / OCR
- 法条引用
- Prompt 治理
- 质量评测
- 用量计费
- 试点申请与运营后台
### 主要短板
- 对外定位偏窄
- 审批流不完整
- 签署与归档闭环不足
- 合同台账和履约提醒不够强
- 生成页和审查页信息过载
- 企业采购所需的协作/权限/审计还不够完整
---
## 3. 产品定位
### 对外定位
面向企业法务、业务、采购、行政团队的合同智能工作台：
- 快速起草标准合同
- 自动完成第一轮预审
- 辅助修改和协作审批
- 支持电子签署与归档
- 提供合同生命周期管理
### 核心用户
- 法务负责人
- 业务负责人
- 采购/商务/销售
- 行政/运营
- 信息化/管理员
- 中小企业老板
### 核心场景
1. 起草标准合同
2. 审查上传合同
3. 生成后自动预审
4. 审批流转与修改
5. 签署、归档、到期提醒
6. 法务知识与模板沉淀
---
## 4. 竞品对标后的能力方向
### 同类产品共识
行业主流已经从“单点 AI 审查”走向：
- 合同全生命周期管理
- 审批流与协作
- 电子签章
- 合同仓库
- 数据统计
- AI 起草/红线/问答
### 我们的差异化路线
不是先拼“最全 CLM”，而是：
1. 先把合同起草与预审做强
2. 再补审批、签署、归档
3. 继续强化法条依据与知识库
4. 最后做企业级合同运营与分析
---
## 5. 产品架构
### 5.1 前台层
- 官网/演示页
- 登录与试点申请
- 工作台首页
- 合同起草页
- 审查页
- 合同详情页
- 审批页
- 合同台账
- 知识库/法条库
- 套餐/计费页
- 管理后台
### 5.2 业务层
- 合同模板
- 合同版本
- 风险审查
- 审批记录
- 签署状态
- 履约提醒
- 合同归档
- 报告导出
### 5.3 AI 层
- Prompt 资产
- 模型路由
- 质量评测
- RAG 知识检索
- 法条引用
- 结构化审查
### 5.4 数据层
- 合同主表
- 合同版本表
- 审查任务表
- 审批流表
- 事件日志表
- 通知表
- 计费与用量表
---
## 6. 分阶段路线图
### Phase 1：产品体验与主链路收敛
目标：让客户一眼看懂、一步能用。
交付项：
- 重做首页定位
- 简化合同生成流程
- 简化审查详情页
- 合同模板库分类
- 审查报告增强
- 统一导航与命名
- 生成后自动审查更顺畅
验收标准：
- 客户能在 3 分钟内完成“注册/登录 -> 起草 -> 审查 -> 下载报告”
- 业务用户不需要理解内部技术字段
- 首页能清楚表达产品价值
### Phase 2：CLM 基础闭环
目标：从 AI 工具升级为可协作的合同管理系统。
交付项：
- 审批流
- 评论/批注
- 版本比对
- 驳回修改
- 电子签章对接
- 合同台账
- 到期/续约提醒
- 附件归档
验收标准：
- 合同能从起草流转到审批、签署、归档
- 合同状态可追踪
- 到期提醒可触发
### Phase 3：企业化能力
目标：满足正式采购和私有化部署。
交付项：
- 多角色权限
- 组织/部门空间
- 审计日志增强
- 统一搜索
- SSO / 企业身份接入
- OA/CRM/ERP 集成
- SLA 与运维看板
- 私有化部署加固
验收标准：
- 满足企业 IT 介入要求
- 满足法务与审计留痕要求
- 满足正式交付要求
### Phase 4：AI 差异化
目标：把“合同工具”升级为“合同智能系统”。
交付项：
- 条款推荐
- 风险模式学习
- 法条变化影响分析
- 审查 playbook
- 规则与模板自动优化
- 用户反馈回流
- 多模型策略
验收标准：
- 系统能越用越准
- 法务知识能沉淀为可复用资产
---
## 7. 功能优先级
### P0
- 起草
- 审查
- 追问
- 报告下载
- 模板库
- OCR/PDF
- 知识库接入
- 试点申请
- 基础计费与试用
### P1
- 审批流
- 版本比对
- 合同台账
- 通知提醒
- 电子签章对接
- 审计日志
- 运营看板
### P2
- SSO
- 企业组织空间
- OA/CRM/ERP 集成
- 风险画像
- 法条影响分析
- 条款 playbook
### P3
- 多 agent
- 复杂自动化编排
- 通用开放平台化
---
## 8. 技术实施方案
### 前端
- 合同起草页改为向导式流程
- 审查页分“普通视图/技术视图”
- 合同详情页增加版本、审批、签署、归档状态
- 首页改成角色感知工作台
### 后端
- 拆分过大的合同生成/审查服务
- 新增审批与事件流服务
- 新增通知服务
- 新增合同生命周期服务
- 新增合同台账服务
- 保持 AI 与业务解耦
### AI 与知识
- 统一 Prompt 版本管理
- 统一评测集
- 法条全文库引用可追溯
- 风险建议可解释
### 集成
- 电子签章
- 企业微信/飞书/邮件
- OA/CRM/ERP
- 私有化部署接口
---
## 9. 商业化建议
### 首阶段卖法
- 免费试点
- 小团队版
- 团队版
- 专业版
- 私有部署版
### 收费抓手
- 用户数
- 审查量
- 生成量
- 知识库容量
- 私有部署
- 实施服务
### 转化重点
- 试点申请页
- 演示流程
- 真实样本验证
- 法务/业务双角色体验
---
## 10. 关键指标
### 产品指标
- 起草完成率
- 审查完成率
- 审批通过率
- 报告下载率
- 试点转化率
### 效率指标
- 单份合同处理时长
- 法务复核耗时
- 风险命中率
- 修改次数
### 经营指标
- 试点到付费转化率
- 续费率
- 扩容率
- 客户留存率
---
## 11. 近期执行顺序
### 第 1 轮
1. 首页和导航重构
2. 合同起草流程收敛
3. 审查详情页瘦身
4. 模板库和报告页优化
### 第 2 轮
1. 审批流 MVP
2. 版本比对
3. 合同台账
4. 到期提醒
### 第 3 轮
1. 电子签章
2. 企业集成
3. 权限和审计
4. 企业化部署加固
### 第 4 轮
1. 条款智能化
2. 风险学习闭环
3. 法条影响分析
4. 运营洞察
---
## 12. 里程碑节奏
### 0-2 周
- 完成主入口和页面信息收敛
- 明确合同生成/审查/试点的统一叙事
- 输出审批流和台账的详细原型
### 2-6 周
- 上线起草-审查闭环优化
- 上线合同台账 MVP
- 上线基础审批流
- 上线版本比对与批注
### 6-10 周
- 对接电子签章
- 补齐提醒与归档
- 加强企业权限与审计
- 接入一个真实试点客户
### 10-16 周
- 引入组织空间和系统集成
- 形成法务知识沉淀闭环
- 做一版运营看板和风险画像
---
## 13. 组织分工建议
- 产品：主流程、原型、优先级和验收口径
- 前端：工作台、起草页、审查页、台账页、审批页
- 后端：合同域、审批域、通知域、签章域、台账域
- AI：Prompt、评测、法条引用、RAG、模型策略
- 测试：主链路回归、试点脚本、异常路径、权限
- 运营/交付：试点材料、客户演示、反馈收集、上线签收
---
## 14. 风险与对策
### 风险 1：范围再次发散
对策：只围绕“起草 - 审查 - 审批 - 签署 - 归档”主链路扩展。
### 风险 2：页面复杂度过高
对策：普通用户默认只看业务视图，技术信息折叠。
### 风险 3：AI 质量不稳定
对策：Prompt 版本化、评测集、回归门禁、失败回退说明。
### 风险 4：企业采购阻力
对策：补权限、审计、部署、签章、台账和导出能力。
### 风险 5：试点难转化
对策：用真实业务样本验证节省时间、降低风险、减少返工。
---
## 15. 不建议现在做的事
- 先做大而全 CLM 平台包装
- 过早上多 agent
- 过早做复杂 BPM
- 过早做通用开放平台
- 继续堆内部技术字段到普通用户页面
---
## 13. 结论
这条产品线下一步不是简单“继续加功能”，而是：
> **从 AI 合同工具，升级为可协作、可审批、可签署、可沉淀的合同工作系统。**
project-docs/README.md
+12 -22
View File
@@ -4,25 +4,13 @@
以下文档继续保留在 `project-docs` 根目录，作为当前主线入口：
- `AI合同起草与审查助手-阶段重整与实施路线图-2026-05-12.md`
- `AI合同起草与审查助手-当前工作进度保存-2026-05-11.md`
- `AI合同起草与审查助手-P0实现主线拆分方案-2026-05-11.md`
- `AI合同起草与审查助手-P0主线对齐闭环-2026-05-12.md`
- `AI合同起草与审查助手_MVP功能优先级表.md`
- `AI合同起草与审查助手_功能增强清单.md`
- `AI合同起草与审查助手_技术架构图与模块拆分说明.md`
- `AI合同起草与审查助手_全阶段开发任务清单.md`
- `AI合同起草与审查助手-开源项目能力吸收与共享平台落地原则-2026-05-11.md`
- `AI合同平台 对照 Dify 的能力缺口清单与接入优先级方案-2026-05-10.md`
- `AI合同起草与审查助手-当前可交付状态说明-2026-05-11.md`
- `AI合同起草与审查助手-对外产品介绍文案-官网演示版-2026-05-11.md`
- `AI合同起草与审查助手-真人参与最小化与必要人工环节说明-2026-05-14.md`
- `AI合同起草与审查助手-真人参与流程-会议汇报版-2026-05-14.md`
- `AI合同起草与审查助手-正式生产部署演练与上线检查清单-2026-05-16.md`
- `AI合同起草与审查助手-Phase14法条全文级知识库实施方案-2026-05-16.md`
- `AI合同起草与审查助手-法律文书能力吸收开发方案-2026-05-20.md`
- `AI合同起草与审查助手-法律文书能力吸收开发方案-代码对齐检查-2026-05-21.md`
- `AI合同起草与审查助手-法律文书能力吸收开发方案-代码对齐复核-2026-05-22.md`
- `AI合同起草与审查助手-完整规划开发方案-2026-06-17.md`
- `AI合同起草与审查助手-Phase1实际开发执行方案-2026-06-17.md`
- `AI合同起草与审查助手-Phase1主链路验收清单-2026-06-17.md`
- `用户使用指南.md`
- `技术部署指南.md`
- `production-split-deployment.md`
- `DATABASE-TRUTH-GATE-PLAYBOOK.md`
## 当前仍保留的专项资料
@@ -32,8 +20,9 @@
- `OCR后续能力扩展与产品深挖方案-2026-05-04.md`
- `PDF样本验收分级清单-2026-05-04.md`
- `结构化字段与关系准确率基线-2026-05-04.md`
- `用户使用指南.md`
- `技术部署指南.md`
- `中文扫描合同样本库清单-2026-05-04.csv`
- `真实业务合同批量样本库-2026-05-04.csv`
- `结构化复杂合同样本清单-2026-05-04.csv`
## 目录型资料
@@ -44,7 +33,6 @@
- `phase15-prompt-golden-samples/`
- `pilot-materials/`
- `structured-review-samples/`
- `automation-artifacts/`
- `qa-artifacts/`
## 归档目录
@@ -53,9 +41,11 @@
- `archive/2026-05-11-doc-cleanup/`
- `archive/2026-05-12-root-doc-cleanup/`
- `archive/2026-06-17-strategy-refresh/`
## 清理原则
1. 当前路线、当前进度、当前验收口径留在根目录。
2. 单次执行记录、旧 V1 总方案、已被替代的阶段性闭环说明转入 `archive/`。
3. 样本、基线、试点资料、自动化产物保留在各自目录，不混入主线文档入口。
4. 法条库终稿只保留一个当前版本，旧版本进入删除或归档。
project-docs/AI合同平台 对照 Dify 的能力缺口清单与接入优先级方案-2026-05-10.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同平台 对照 Dify 的能力缺口清单与接入优先级方案-2026-05-10.md
View File
project-docs/AI合同起草与审查助手-P0主线对齐闭环-2026-05-12.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-P0主线对齐闭环-2026-05-12.md
View File
project-docs/AI合同起草与审查助手-P0实现主线拆分方案-2026-05-11.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-P0实现主线拆分方案-2026-05-11.md
View File
project-docs/AI合同起草与审查助手-Phase14法条全文级知识库实施方案-2026-05-16.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase14法条全文级知识库实施方案-2026-05-16.md
View File
project-docs/AI合同起草与审查助手-Phase14法条全文级知识库收尾复核-2026-05-23.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase14法条全文级知识库收尾复核-2026-05-23.md
View File
project-docs/AI合同起草与审查助手-Phase15上线人工签收包-2026-05-25.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase15上线人工签收包-2026-05-25.md
View File
project-docs/AI合同起草与审查助手-Phase15产品E2E验收报告-2026-05-25.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase15产品E2E验收报告-2026-05-25.md
View File
project-docs/AI合同起草与审查助手-Phase15正式生产演练报告-2026-05-25.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase15正式生产演练报告-2026-05-25.md
View File
project-docs/AI合同起草与审查助手-Phase15生产发布门禁检查报告-2026-05-25.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase15生产发布门禁检查报告-2026-05-25.md
-1
View File
@@ -23,7 +23,6 @@ Phase15 生产发布门禁脚本已完成并通过最新一轮实跑。最新结
| 检查项 | 结果 | 证据 |
| --- | --- | --- |
| gstack 前置检查 | PASS | `GSTACK_OK` |
| 工作区状态 | WARN | 当前存在未提交/未跟踪改动；脚本按 advisory 模式继续 |
| 后端健康检查 | PASS | `GET /health status=200` |
| 后端 readiness | PASS | `GET /api/v1/system/readiness status=200` |
project-docs/AI合同起草与审查助手-Phase15生成合同版本链路决策与验收-2026-05-25.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase15生成合同版本链路决策与验收-2026-05-25.md
View File
project-docs/AI合同起草与审查助手-Phase15高风险样本法条引用专项验收报告-2026-05-25.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-Phase15高风险样本法条引用专项验收报告-2026-05-25.md
View File
project-docs/AI合同起草与审查助手-商业化运营与收费方案-2026-05-17.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-商业化运营与收费方案-2026-05-17.md
View File
project-docs/AI合同起草与审查助手-对外产品介绍文案-官网演示版-2026-05-11.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-对外产品介绍文案-官网演示版-2026-05-11.md
View File
project-docs/AI合同起草与审查助手-开源项目能力吸收与共享平台落地原则-2026-05-11.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-开源项目能力吸收与共享平台落地原则-2026-05-11.md
+2 -2
View File
@@ -182,7 +182,7 @@
- 作为后续共享智能体研究方向
- 目前不建议直接塞进合同主链路
### 9. `codex` / `claude-code` / `opencode` / `gstack`
### 9. `codex` / `claude-code` / `opencode`
适合参考的能力：
@@ -265,7 +265,7 @@
### P2 / P3
- `agents` / `agency-agents` / `AutoGPT`
- `codex` / `claude-code` / `opencode` / `gstack`
- `codex` / `claude-code` / `opencode`
这些更适合作为共享智能体研发方向，而不是当前合同平台的主卖点。
project-docs/AI合同起草与审查助手-当前可交付状态说明-2026-05-11.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-当前可交付状态说明-2026-05-11.md
View File
project-docs/AI合同起草与审查助手-当前工作进度保存-2026-05-11.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-当前工作进度保存-2026-05-11.md
+8 -12
View File
@@ -689,7 +689,7 @@
- `scripts/run-formal-launch-approval-gate.ps1` 新增 `final_launch_approval_checklist` 检查，最终批准清单仍为 `TEMPLATE` 或包含占位符时保持 `BLOCKED`。
### 本轮验证
- gstack 预检：`GSTACK_OK`。
- 历史记录：当时曾执行 gstack 预检并返回 `GSTACK_OK`；该项现已不再作为仓库要求。
- PowerShell Parser 检查：
- `scripts/import-formal-launch-review-return-bundle.ps1` 通过。
- `scripts/run-formal-launch-approval-gate.ps1` 通过。
@@ -746,7 +746,7 @@
- 新增单元测试覆盖中文占位 reviewer，不再低估缺真实复核人的数量。
### 本轮验证
- gstack 预检：`GSTACK_OK`。
- 历史记录：当时曾执行 gstack 预检并返回 `GSTACK_OK`；该项现已不再作为仓库要求。
- 远程产品库导入：
- `FORMAL_LAUNCH_GOVERNANCE_DB_IMPORT_PASS`
- 产物：`project-docs/qa-artifacts/formal-launch-governance-db-import/2026-05-13T11-53-55-203/formal-launch-governance-db-import-summary.md`
@@ -796,7 +796,7 @@
- 已更新协作包说明，把真实 reviewer 分配矩阵作为真实复核之前的第一步。
### 本轮验证
- gstack 预检：`GSTACK_OK`。
- 历史记录：当时曾执行 gstack 预检并返回 `GSTACK_OK`；该项现已不再作为仓库要求。
- PowerShell Parser 检查：
- `scripts/apply-formal-launch-reviewer-assignment-matrix.ps1` 通过。
- 当前正式矩阵校验：
@@ -1804,7 +1804,6 @@
- 中文清单：`project-docs/AI合同起草与审查助手-正式生产部署演练与上线检查清单-2026-05-16.md`
- 该脚本默认只做无破坏性检查，不会部署、不重启、不回滚。
- 默认检查内容已经覆盖：
- gstack 预检查
- `origin/main` 同步状态
- 工作区干净状态
- 部署、回滚、健康、回归、备份、正式上线门禁脚本库存
@@ -2649,8 +2648,7 @@
- 管理员 Web 入口查看并跳转套餐页
### 本轮验证
- gstack 检查：
- `GSTACK_OK`
- 历史记录：当时曾执行 gstack 检查并返回 `GSTACK_OK`；该项现已不再作为仓库要求。
- 后端聚焦测试：
- `backend\.venv\Scripts\python.exe -m pytest backend\tests\test_tenant_settings_api.py`
- 结果：`6 passed`
@@ -2767,8 +2765,7 @@
- 新增管理员套餐/额度调整表单。
### 本轮验证
- gstack 检查：
- `GSTACK_OK`
- 历史记录：当时曾执行 gstack 检查并返回 `GSTACK_OK`；该项现已不再作为仓库要求。
- Python 编译检查：
- `backend\.venv\Scripts\python.exe -m py_compile backend\app\models\commercial_order.py backend\app\models\__init__.py backend\app\services\tenant_service.py backend\app\api\tenant_settings.py backend\migrations\versions\20260518_0025_create_commercial_orders.py`
- 结果：通过。
@@ -2832,8 +2829,7 @@
- “登记已开票”弹窗。
### 本轮验证
- gstack 检查：
- `GSTACK_OK`
- 历史记录：当时曾执行 gstack 检查并返回 `GSTACK_OK`；该项现已不再作为仓库要求。
- Python 编译检查：
- `backend\.venv\Scripts\python.exe -m py_compile backend\app\models\commercial_invoice.py backend\app\models\commercial_order.py backend\app\models\__init__.py backend\app\services\tenant_service.py backend\app\api\tenant_settings.py backend\migrations\versions\20260518_0026_create_commercial_invoices.py`
- 结果：通过。
@@ -3304,9 +3300,9 @@
### 本轮验证
- 后端部署脚本所有 required 检查通过：
- gstack、SSH key、clean worktree、origin remote、archive、upload、remote Docker deploy、post-deploy release gate。
- SSH key、clean worktree、origin remote、archive、upload、remote Docker deploy、post-deploy release gate。
- 前端部署脚本所有 required 检查通过：
- gstack、SSH key、clean worktree、origin remote、archive、upload、remote Docker deploy、post-deploy release gate。
- SSH key、clean worktree、origin remote、archive、upload、remote Docker deploy、post-deploy release gate。
- 线上健康检查：
- `GET http://192.168.3.90:8001/health`：`status=ok`
- `GET http://192.168.3.90:8001/api/v1/system/readiness`：`ready`
project-docs/AI合同起草与审查助手-正式生产部署演练与上线检查清单-2026-05-16.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-正式生产部署演练与上线检查清单-2026-05-16.md
-1
View File
@@ -39,7 +39,6 @@ powershell -NoProfile -ExecutionPolicy Bypass -File scripts\run-production-deplo
| 检查项 | 通过含义 |
|---|---|
| gstack | 当前机器满足仓库约束 |
| Git 远端 | `origin` 指向正式 Git 服务 |
| Git 同步 | 本地 `main` 与 `origin/main` 一致 |
| 工作区 | 没有未提交改动 |
project-docs/AI合同起草与审查助手-法律文书能力吸收开发方案-2026-05-20.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-法律文书能力吸收开发方案-2026-05-20.md
View File
project-docs/AI合同起草与审查助手-法律文书能力吸收开发方案-代码对齐复核-2026-05-22.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-法律文书能力吸收开发方案-代码对齐复核-2026-05-22.md
View File
project-docs/AI合同起草与审查助手-法律文书能力吸收开发方案-代码对齐检查-2026-05-21.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-法律文书能力吸收开发方案-代码对齐检查-2026-05-21.md
View File
project-docs/AI合同起草与审查助手-真人参与最小化与必要人工环节说明-2026-05-14.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-真人参与最小化与必要人工环节说明-2026-05-14.md
View File
project-docs/AI合同起草与审查助手-真人参与流程-会议汇报版-2026-05-14.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-真人参与流程-会议汇报版-2026-05-14.md
View File
project-docs/AI合同起草与审查助手-真实在线支付接入资料清单-2026-05-18.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-真实在线支付接入资料清单-2026-05-18.md
View File
project-docs/AI合同起草与审查助手-阶段重整与实施路线图-2026-05-12.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手-阶段重整与实施路线图-2026-05-12.md
View File
project-docs/AI合同起草与审查助手_MVP功能优先级表.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手_MVP功能优先级表.md
View File
project-docs/AI合同起草与审查助手_全阶段开发任务清单.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手_全阶段开发任务清单.md
View File
project-docs/AI合同起草与审查助手_功能增强清单.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手_功能增强清单.md
View File
project-docs/AI合同起草与审查助手_技术架构图与模块拆分说明.md → project-docs/archive/2026-06-17-strategy-refresh/AI合同起草与审查助手_技术架构图与模块拆分说明.md
View File
project-docs/MAINLINE-CANDIDATE-HANDOFF.md → project-docs/archive/2026-06-17-strategy-refresh/MAINLINE-CANDIDATE-HANDOFF.md
View File
project-docs/archive/2026-06-17-strategy-refresh/README.md
+6
View File
@@ -0,0 +1,6 @@
# 2026-06-17 Strategy Refresh Archive
本目录保存被新的《AI合同起草与审查助手 完整规划开发方案》替代的旧路线、旧阶段方案、旧验收与商业化文档。
这些文件仍可追溯历史决策，但不再作为当前主线依据。
project-docs/ai-contract-platform_商业化重定位建议书.md → project-docs/archive/2026-06-17-strategy-refresh/ai-contract-platform_商业化重定位建议书.md
View File
project-docs/phase10-delivery-package/deployment-package.md
+12 -12
View File
@@ -4,13 +4,13 @@
| Item | Value |
|---|---|
| Frontend | `https://api.yuqei.com` |
| Frontend | `https://contact.yuqei.com` |
| Aliyun frontend host | `47.94.178.212` |
| Backend | `http://192.168.3.90:8001` |
| Backend tunnel target from Aliyun | `http://10.20.0.11:8001` |
| API | `https://api.yuqei.com/api/v1` |
| API | `https://contact.yuqei.com/api/v1` |
| Health | `http://192.168.3.90:8001/health` |
| Readiness | `https://api.yuqei.com/api/v1/system/readiness` |
| Readiness | `https://contact.yuqei.com/api/v1/system/readiness` |
| Backend remote project path | `/opt/ai-contract-platform` |
| Frontend remote project path | `/opt/ai-contract-platform-frontend` |
| Backend compose file | `docker-compose.server.yml` |
@@ -24,10 +24,10 @@ Backend Docker release to `192.168.3.90`:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-backend-docker.ps1 `
-ServerHost 192.168.3.90 `
-FrontendBaseUrl https://api.yuqei.com `
-FrontendBaseUrl https://contact.yuqei.com `
-BackendBaseUrl http://192.168.3.90:8001 `
-ApiUrl https://api.yuqei.com/api/v1 `
-ReadinessUrl https://api.yuqei.com/api/v1/system/readiness
-ApiUrl https://contact.yuqei.com/api/v1 `
-ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness
```
Frontend Docker release to Aliyun `47.94.178.212`:
@@ -36,10 +36,10 @@ Frontend Docker release to Aliyun `47.94.178.212`:
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-frontend-aliyun-docker.ps1 `
-ServerHost 47.94.178.212 `
-BackendTunnelBaseUrl http://10.20.0.11:8001 `
-FrontendBaseUrl https://api.yuqei.com `
-FrontendBaseUrl https://contact.yuqei.com `
-BackendBaseUrl http://192.168.3.90:8001 `
-ApiUrl https://api.yuqei.com/api/v1 `
-ReadinessUrl https://api.yuqei.com/api/v1/system/readiness
-ApiUrl https://contact.yuqei.com/api/v1 `
-ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness
```
Post-release gate for split production:
@@ -47,11 +47,11 @@ Post-release gate for split production:
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-production-release-gate.ps1 `
-ServerHost 192.168.3.90 `
-FrontendBaseUrl https://api.yuqei.com `
-FrontendBaseUrl https://contact.yuqei.com `
-BackendBaseUrl http://192.168.3.90:8001 `
-ApiUrl https://api.yuqei.com/api/v1 `
-ApiUrl https://contact.yuqei.com/api/v1 `
-HealthUrl http://192.168.3.90:8001/health `
-ReadinessUrl https://api.yuqei.com/api/v1/system/readiness `
-ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness `
-ExpectedRemoteServices backend,legal-change-impact-worker,redis
```
project-docs/phase10-delivery-package/environment-template.md
+3 -3
View File
@@ -3,11 +3,11 @@
## Public Endpoints
```text
FRONTEND_BASE_URL=http://192.168.3.90:3003
FRONTEND_BASE_URL=https://contact.yuqei.com
BACKEND_BASE_URL=http://192.168.3.90:8001
API_URL=http://192.168.3.90:8001/api/v1
API_URL=https://contact.yuqei.com/api/v1
HEALTH_URL=http://192.168.3.90:8001/health
READINESS_URL=http://192.168.3.90:8001/api/v1/system/readiness
READINESS_URL=https://contact.yuqei.com/api/v1/system/readiness
```
## Runtime Secrets
project-docs/phase13-legal-knowledge-template-library/evidence/phase13-real-review-pilot-package-workflow.md
+1 -1
View File
@@ -25,7 +25,7 @@
通过条件：
- gstack 前置检查通过。
- 无需 gstack 前置检查。
- origin 指向 `192.168.3.90`。
- 试点样本清单存在且不少于 5 项。
- 试点资产均能匹配专家复核登记。
project-docs/phase14-legal-fulltext-library/FINAL-COMPLETION-REPORT-v2.md
-143
View File
@@ -1,143 +0,0 @@
# AI合同平台法律库扩充 - 最终完成报告
**生成日期**: 2026-06-16
**数据来源**: LawRefBook/Laws (GitHub) - 过滤过期法律后
**状态**: ✅ 完成
---
## 一、执行成果总览
### 核心指标
| 指标 | 数值 |
|------|------|
| **总法律条文数** | **730,050 条** |
| **已矢量化** | **443,970 条 (60.8%)** |
| **法律数量** | **18,285 部** |
| **数据来源** | LawRefBook/Laws (GitHub) |
| **过滤标准** | 仅保留现行有效法律，已过期/作废法律已过滤 |
---
## 二、导入过程
### 数据来源
- **原始数据集**: LawRefBook/Laws (GitHub)
- **总文件数**: 3,504 个
- **有效法律**: 2,588 个 (73.9%)
- **过期/作废**: 916 个 (26.1%) - 已过滤
### 导入批次
| 批次 | 法律数 | 条文数 | 状态 |
|------|--------|--------|------|
| 第一批 | 21 部 | 1,686 条 | ✅ 已导入 |
| 第二批 | 15 部 | 1,119 条 | ✅ 已导入 |
| 民法典司法解释 | 2 部 | 223 条 | ✅ 已导入 |
| 全部国家级法律 | 1,080 部 | 44,940 条 | ✅ 已导入 |
| **总计** | **1,118 部** | **47,968 条** | ✅ 已完成 |
### 向量化状态
- **已矢量化**: 443,970 条 (60.8%)
- **待向量化**: 286,080 条 (39.2%) - 正在后台处理
- **向量化算法**: LegalSemanticMatcher (local-token-v1)
---
## 三、领域覆盖
| 领域 | 法律数 | 覆盖情况 |
|------|--------|---------|
| 合同通用 | 2 | ✅ 民法典、合同编通则司法解释 |
| 劳动用工 | 5 | ✅ 劳动法、劳动合同法、社会保险法、工伤保险、劳动争议司法解释 |
| 商事主体 | 3 | ✅ 公司法、合伙企业法、企业破产法 |
| 投融资 | 3 | ✅ 证券法、信托法、反垄断法 |
| 采购招投标 | 3 | ✅ 招标投标法、政府采购法及实施条例 |
| 建设工程 | 3 | ✅ 建筑法、建设工程质量管理条例、施工合同司法解释 |
| 知识产权 | 4 | ✅ 著作权法、专利法、商标法、信息网络传播权 |
| 数据隐私 | 3 | ✅ 个人信息保护法、数据安全法、网络安全法、关键信息基础设施 |
| 房地产 | 4 | ✅ 城市房地产管理法、土地管理法、物业管理条例、商品房买卖司法解释 |
| 争议解决 | 2 | ✅ 仲裁法、民事诉讼法 |
| 担保 | 1 | ✅ 民法典担保制度司法解释 |
| 民间借贷 | 1 | ✅ 民间借贷司法解释 |
| 技术合同 | 1 | ✅ 技术合同纠纷司法解释 |
| 特许经营 | 1 | ✅ 商业特许经营管理条例 |
| 公司商事 | 3 | ✅ 反不正当竞争法、电子商务法、消费者权益保护法 |
| 外商投资 | 1 | ✅ 外商投资法 |
| **总计** | **42 部核心法律** | **18,285 部总法律** |
---
## 四、技术实现
### 数据处理流程
1. **数据探索** → 发现 LawRefBook/Laws (3,504 文件)
2. **时效性检查** → 过滤过期/作废法律 (916 个)
3. **Markdown解析** → 提取法律条文和元数据
4. **数据清洗** → 去重、格式统一
5. **批量导入** → 使用 `import_cn_laws_jsonl.py`
6. **语义向量化** → 使用 `LegalSemanticMatcher` (local-token-v1)
7. **测试验证** → 语义搜索测试
### 性能指标
- **导入速度**: ~1,000 条/秒
- **向量化速度**: ~20 条/秒
- **搜索响应时间**: < 100ms
- **向量化成功率**: 60.8% (进行中)
---
## 五、仍然缺失的法律
以下4部部门规章在开源数据集中未找到，需要从其他来源获取：
| 缺失法律 | 来源 | 备注 |
|---------|------|------|
| 数据出境安全评估办法 | 网信办 | 可从网信办官网获取 |
| 个人信息出境标准合同办法 | 网信办 | 可从网信办官网获取 |
| 商业特许经营信息披露管理办法 | 商务部 | 可从商务部官网获取 |
| 商业特许经营备案管理办法 | 商务部 | 可从商务部官网获取 |
---
## 六、文件清单
| 文件 | 说明 |
|------|------|
| `import-ready-lawrefbook-fixed.jsonl` | 第一批导入文件 |
| `import-ready-supplementary.jsonl` | 第二批补充导入文件 |
| `import-ready-civil-code-interp.jsonl` | 民法典司法解释导入文件 |
| `import-ready-all-national.jsonl` | 全部国家级法律导入文件 |
| `all-valid-laws-list.json` | 全部有效法律清单 |
| `national-valid-laws.json` | 国家级有效法律清单 |
| `import-summary-*.json` | 导入摘要 |
| `scripts/convert-lawrefbook-to-jsonl.py` | 转换脚本 |
| `scripts/vectorize_laws.py` | 向量化脚本 |
---
## 七、后续建议
### 短期（1-2周）
1. **完成剩余向量化** - 286,080 条待处理
2. **补充4部部门规章** - 从网信办、商务部官网获取
3. **测试合同审查功能** - 端到端验证
### 中期（1-3个月）
1. **导入地方法规** - DLC目录1,911个文件（按区域筛选）
2. **建立法律更新监控机制**
3. **优化语义匹配算法**
### 长期（3-6个月）
1. **建立完整的法律更新管道**
2. **探索更多开源法律数据源**
3. **建立法律影响力分析系统**
---
**报告生成时间**: 2026-06-16
**数据来源**: LawRefBook/Laws (GitHub) - 过滤过期法律后
**技术栈**: Python 3.12, PostgreSQL 16, psycopg 3.2.6
**总耗时**: ~2小时
project-docs/phase14-legal-fulltext-library/FINAL-COMPLETION-REPORT-v3.md
-149
View File
@@ -1,149 +0,0 @@
# AI合同平台法律库扩充 - 最终完成报告 v3
**生成日期**: 2026-06-16
**状态**: ✅ 全部完成
---
## 一、最终成果
### 核心指标
| 指标 | 数值 |
|------|------|
| **总法律条文数** | **730,101 条** |
| **已矢量化** | **729,567 条 (99.9%)** |
| **法律数量** | **18,289 部** |
| **向量化率** | **99.9%** |
### 数据来源
- **主要来源**: LawRefBook/Laws (GitHub)
- **补充来源**: 手动整理（4部部门规章）
- **过滤标准**: 已过期/作废法律已排除（916部）
---
## 二、导入内容
### 国家级法律（不含地方法规）
| 类型 | 数量 | 说明 |
|------|------|------|
| 司法解释 | 1,017 部 | 最高人民法院司法解释 |
| 行政法规 | 904 部 | 国务院行政法规 |
| 部门规章 | 335 部 | 各部委规章 |
| 法律 | 335 部 | 全国人大及其常委会制定 |
| 行政法 | 84 部 | 行政法律 |
| 经济法 | 56 部 | 经济法律 |
| 宪法相关法 | 41 部 | 宪法相关 |
| 社会法 | 40 部 | 社会法律 |
| 民法商法 | 25 部 | 民商法律 |
| 其他 | 80 部 | 其他类型 |
### 核心法律覆盖
✅ **劳动用工**（5部）- 劳动法、劳动合同法、社会保险法、工伤保险、劳动争议司法解释
✅ **商事主体**（3部）- 公司法、合伙企业法、企业破产法
✅ **投融资**（3部）- 证券法、信托法、反垄断法
✅ **采购招投标**（3部）- 招标投标法、政府采购法及实施条例
✅ **建设工程**（3部）- 建筑法、建设工程质量管理条例、施工合同司法解释
✅ **知识产权**（4部）- 著作权法、专利法、商标法、信息网络传播权
✅ **数据隐私**（5部）- 个人信息保护法、数据安全法、网络安全法、数据出境安全评估办法、个人信息出境标准合同办法
✅ **房地产**（4部）- 城市房地产管理法、土地管理法、物业管理条例、商品房买卖司法解释
✅ **争议解决**（2部）- 仲裁法、民事诉讼法
✅ **担保**（1部）- 民法典担保制度司法解释
✅ **民间借贷**（1部）- 民间借贷司法解释
✅ **技术合同**（1部）- 技术合同纠纷司法解释
✅ **特许经营**（3部）- 商业特许经营管理条例、信息披露管理办法、备案管理办法
✅ **公司商事**（3部）- 反不正当竞争法、电子商务法、消费者权益保护法
✅ **外商投资**（1部）- 外商投资法
---
## 三、技术实现
### 数据处理流程
1. **数据探索** → 发现 LawRefBook/Laws (3,504 文件)
2. **时效性检查** → 过滤过期/作废法律 (916 个)
3. **Markdown解析** → 提取法律条文和元数据
4. **数据清洗** → 去重、格式统一
5. **批量导入** → 使用 `import_cn_laws_jsonl.py`
6. **语义向量化** → 使用 `LegalSemanticMatcher` (local-token-v1)
7. **测试验证** → 语义搜索测试通过
### 性能指标
- **导入速度**: ~1,000 条/秒
- **向量化速度**: ~20 条/秒
- **搜索响应时间**: < 100ms
- **向量化成功率**: 99.9%
---
## 四、测试验证
### 语义搜索测试
- **测试场景**: 5 个合同审查场景
- **通过率**: 100%
- **匹配效果**: 每个场景返回 100+ 个相关条文
- **最高相似度**: 0.568
### 测试结论
✅ 新导入法律可通过语义搜索正确检索
✅ 向量化效果良好
✅ 搜索响应时间 < 100ms
✅ 合同审查功能可正常使用
---
## 五、文件清单
| 文件 | 说明 |
|------|------|
| `import-ready-all-national.jsonl` | 全部国家级法律导入文件 |
| `import-ready-manual-laws.jsonl` | 手动整理部门规章导入文件 |
| `all-valid-laws-list.json` | 全部有效法律清单 |
| `national-valid-laws.json` | 国家级有效法律清单 |
| `scripts/convert-lawrefbook-to-jsonl.py` | 转换脚本 |
| `scripts/vectorize_laws.py` | 向量化脚本 |
| `temp-manual-laws/` | 手动整理部门规章目录 |
---
## 六、后续建议
### 短期（1-2周）
1. ✅ **完成** - 向量化剩余条文（99.9%已完成）
2. ✅ **完成** - 补充4部部门规章
3. **建议** - 监控向量化后台任务完成
### 中期（1-3个月）
1. **导入地方法规** - DLC目录1,911个文件（按区域筛选）
2. **建立法律更新监控机制**
3. **优化语义匹配算法**
### 长期（3-6个月）
1. **建立完整的法律更新管道**
2. **探索更多开源法律数据源**
3. **建立法律影响力分析系统**
---
**报告生成时间**: 2026-06-16
**数据来源**: LawRefBook/Laws (GitHub) + 手动整理
**技术栈**: Python 3.12, PostgreSQL 16, psycopg 3.2.6
**总耗时**: ~3小时
**最终状态**: ✅ 全部完成
project-docs/phase14-legal-fulltext-library/FINAL-COMPLETION-REPORT.md
-195
View File
@@ -1,195 +0,0 @@
# AI合同平台法律库扩充 - 最终完成报告
**生成日期**: 2026-06-16
**状态**: ✅ 完成
---
## 一、执行成果总览
### 核心指标
| 指标 | 数值 |
|------|------|
| **总法律条文数** | **4,488 条** |
| **已矢量化** | **4,479 条 (99.8%)** |
| **法律数量** | **44 部** |
| **法律类型** | 法律 27 部 / 行政法规 10 部 / 司法解释 7 部 |
---
## 二、导入法律清单
### 第一批导入（21部）
| 法律名称 | 条文数 | 领域 | Source ID |
|---------|--------|------|-----------|
| 中华人民共和国证券法 | 226 | 投融资 | LAW-SECURITIES-2019 |
| 中华人民共和国企业破产法 | 136 | 商事主体 | LAW-BANKRUPTCY-2006 |
| 中华人民共和国合伙企业法 | 109 | 商事主体 | LAW-PARTNERSHIP-2006 |
| 中华人民共和国社会保险法 | 98 | 劳动用工 | LAW-SOCIAL-INSURANCE-2018 |
| 中华人民共和国政府采购法 | 88 | 采购招投标 | LAW-GOVERNMENT-PROCUREMENT-2014 |
| 中华人民共和国土地管理法 | 87 | 房地产 | LAW-LAND-MGMT-2019 |
| 中华人民共和国建筑法 | 85 | 建设工程 | LAW-CONSTRUCTION-2019 |
| 建设工程质量管理条例 | 82 | 建设工程 | LAW-CONSTRUCTION-QUALITY-2019 |
| 中华人民共和国政府采购法实施条例 | 79 | 采购招投标 | LAW-GOVERNMENT-PROCUREMENT-IMPL-2015 |
| 中华人民共和国土地管理法实施条例 | 75 | 房地产 | LAW-LAND-MGMT-IMPL-2021 |
| 中华人民共和国信托法 | 74 | 投融资 | LAW-TRUST-2001 |
| 中华人民共和国城市房地产管理法 | 73 | 房地产 | LAW-REAL-ESTATE-MGMT-2019 |
| 中华人民共和国招标投标法 | 68 | 采购招投标 | LAW-TENDER-2017 |
| 中华人民共和国著作权法 | 67 | 知识产权 | LAW-COPYRIGHT-2020 |
| 工伤保险条例 | 67 | 劳动用工 | LAW-WORK-INJURY-2010 |
| 最高人民法院关于审理劳动争议案件...解释（一） | 56 | 劳动用工 | LAW-LABOR-DISPUTE-INTERP-2020 |
| 关键信息基础设施安全保护条例 | 51 | 数据隐私 | LAW-CRITICAL-INFO-2021 |
| 最高人民法院关于审理建设工程施...解释（一） | 51 | 建设工程 | LAW-CONSTRUCTION-DISPUTE-INTERP-2020 |
| 中华人民共和国劳动合同法实施条例 | 47 | 劳动用工 | LAW-LABOR-CONTRACT-IMPL-2008 |
| 中华人民共和国著作权法实施条例 | 40 | 知识产权 | LAW-COPYRIGHT-IMPL-2013 |
| 信息网络传播权保护条例 | 27 | 知识产权 | LAW-INFO-NETWORK-2013 |
### 第二批补充（15部）
| 法律名称 | 条文数 | 领域 | Source ID |
|---------|--------|------|-----------|
| 中华人民共和国劳动法 | 107 | 劳动用工 | LAW-LABOR-2018 |
| 中华人民共和国网络安全法 | 79 | 数据隐私 | LAW-CYBERSECURITY-2016 |
| 中华人民共和国专利法 | 82 | 知识产权 | LAW-PATENT-2020 |
| 中华人民共和国商标法 | 73 | 知识产权 | LAW-TRADEMARK-2019 |
| 中华人民共和国仲裁法 | 82 | 争议解决 | LAW-ARBITRATION-2017 |
| 中华人民共和国电子商务法 | 89 | 公司商事 | LAW-E-COMMERCE-2018 |
| 中华人民共和国消费者权益保护法 | 63 | 公司商事 | LAW-CONSUMER-2013 |
| 中华人民共和国反垄断法 | 70 | 投融资 | LAW-ANTI-MONOPOLY-2022 |
| 物业管理条例 | 67 | 房地产 | LAW-PROPERTY-MGMT-2018 |
| 商业特许经营管理条例 | 34 | 特许经营 | LAW-FRANCHISE-MGMT-2007 |
| 技术合同纠纷司法解释 | 59 | 技术合同 | LAW-TECH-CONTRACT-INTERP-2020 |
| 民间借贷司法解释 | 39 | 民间借贷 | LAW-PRIVATE-LENDING-INTERP-2020 |
| 商品房买卖合同纠纷司法解释 | 26 | 房地产 | LAW-REAL-ESTATE-SALE-INTERP-2020 |
| 最高人民法院关于适用《民法典》合同编通则若干问题的解释 | 126 | 合同通用 | LAW-CIVIL-CODE-CONTRACT-INTERP-2023 |
| 最高人民法院关于适用《民法典》有关担保制度的解释 | 97 | 担保 | LAW-CIVIL-CODE-GUARANTEE-INTERP-2020 |
### 原有核心法律（6部）
| 法律名称 | Source ID |
|---------|-----------|
| 中华人民共和国民法典 | LAW-CIVIL-CODE-2020 |
| 中华人民共和国电子签名法 | LAW-E-SIGNATURE-2019 |
| 中华人民共和国个人信息保护法 | LAW-PIPL-2021 |
| 中华人民共和国劳动合同法 | LAW-LABOR-CONTRACT-2012 |
| 中华人民共和国数据安全法 | LAW-DATA-SECURITY-2021 |
| 中华人民共和国公司法 | LAW-COMPANY-2023 |
---
## 三、技术实现
### 数据来源
- **主要来源**: [LawRefBook/Laws](https://github.com/LawRefBook/Laws) (GitHub开源数据集)
- **数据量**: 3,531 个法律文件
- **数据质量**: 全部现行有效，无过期法律
### 处理流程
1. **Markdown解析** → 提取法律条文和元数据
2. **数据清洗** → 去重、格式统一
3. **批量导入** → 使用 `import_cn_laws_jsonl.py`
4. **语义向量化** → 使用 `LegalSemanticMatcher` (local-token-v1)
5. **测试验证** → 语义搜索测试
### 性能指标
- **导入速度**: ~118 条/秒
- **向量化速度**: ~20 条/秒
- **搜索响应时间**: < 100ms
- **向量化成功率**: 99.8%
---
## 四、仍然缺失的法律
以下4部部门规章在开源数据集中未找到，需要从其他来源获取：
| 缺失法律 | 来源 | 备注 |
|---------|------|------|
| 数据出境安全评估办法 | 网信办 | 可从网信办官网获取 |
| 个人信息出境标准合同办法 | 网信办 | 可从网信办官网获取 |
| 商业特许经营信息披露管理办法 | 商务部 | 可从商务部官网获取 |
| 商业特许经营备案管理办法 | 商务部 | 可从商务部官网获取 |
---
## 五、领域覆盖
| 领域 | 法律数 | 覆盖情况 |
|------|--------|---------|
| 合同通用 | 2 | ✅ 民法典、合同编通则司法解释 |
| 劳动用工 | 5 | ✅ 劳动法、劳动合同法、社会保险法、工伤保险、劳动争议司法解释 |
| 商事主体 | 3 | ✅ 公司法、合伙企业法、企业破产法 |
| 投融资 | 3 | ✅ 证券法、信托法、反垄断法 |
| 采购招投标 | 3 | ✅ 招标投标法、政府采购法及实施条例 |
| 建设工程 | 3 | ✅ 建筑法、建设工程质量管理条例、施工合同司法解释 |
| 知识产权 | 4 | ✅ 著作权法、专利法、商标法、信息网络传播权 |
| 数据隐私 | 3 | ✅ 个人信息保护法、数据安全法、网络安全法、关键信息基础设施 |
| 房地产 | 4 | ✅ 城市房地产管理法、土地管理法、物业管理条例、商品房买卖司法解释 |
| 争议解决 | 2 | ✅ 仲裁法、民事诉讼法 |
| 担保 | 1 | ✅ 民法典担保制度司法解释 |
| 民间借贷 | 1 | ✅ 民间借贷司法解释 |
| 技术合同 | 1 | ✅ 技术合同纠纷司法解释 |
| 特许经营 | 1 | ✅ 商业特许经营管理条例 |
| 公司商事 | 3 | ✅ 反不正当竞争法、电子商务法、消费者权益保护法 |
| 外商投资 | 1 | ✅ 外商投资法 |
---
## 六、测试验证
### 语义搜索测试
- **测试场景**: 5 个
- **通过率**: 100%
- **最高相似度**: 0.452 (建筑法)
- **最低相似度**: 0.223 (证券法)
### 测试结论
✅ 所有新导入法律均可通过语义搜索正确检索
✅ 向量化效果良好，相似度合理
✅ 搜索响应时间 < 100ms，满足实时合同审查需求
---
## 七、文件清单
| 文件 | 说明 |
|------|------|
| `import-ready-lawrefbook-fixed.jsonl` | 第一批导入文件 |
| `import-ready-supplementary.jsonl` | 第二批补充导入文件 |
| `import-ready-civil-code-interp.jsonl` | 民法典司法解释导入文件 |
| `import-summary-lawrefbook.json` | 第一批导入摘要 |
| `import-summary-supplementary.json` | 第二批导入摘要 |
| `import-report-lawrefbook.md` | 导入报告 |
| `final-report.md` | 完整执行报告 |
| `semantic-search-test-report.md` | 语义搜索测试报告 |
| `bbbs-collection-progress.json` | bbbs收集进度 |
| `open-source-available-laws.json` | 可用法律清单 |
| `scripts/convert-lawrefbook-to-jsonl.py` | 转换脚本 |
| `scripts/vectorize_laws.py` | 向量化脚本 |
---
## 八、后续建议
### 短期（1-2周）
1. **补充4部部门规章** - 从网信办、商务部官网获取
2. **测试合同审查功能** - 端到端验证新法律在实际场景中的效果
3. **监控法律更新** - 建立定期同步机制
### 中期（1-3个月）
1. **导入优先级二法律**（36项）
2. **建立法律更新监控机制**
3. **优化语义匹配算法**
### 长期（3-6个月）
1. **建立完整的法律更新管道**
2. **探索更多开源法律数据源**
3. **建立法律影响力分析系统**
---
**报告生成时间**: 2026-06-16
**数据来源**: LawRefBook/Laws (GitHub) + 国家法律法规数据库
**技术栈**: Python 3.12, PostgreSQL 16, psycopg 3.2.6
project-docs/phase14-legal-fulltext-library/LEGAL-LIBRARY-FINAL-REPORT.md
+33 -32
View File
@@ -1,7 +1,7 @@
# AI合同平台法律库 - 最终完成报告 v5
**生成日期**: 2026-06-16
**状态**: ✅ 100% 完成
**状态**: 完成
---
@@ -24,16 +24,16 @@
### 已完成的任务
| 序号 | 任务 | 状态 |
|------|------|------|
| 1 | 探索开源数据集 | ✅ 完成 |
| 2 | 过滤过期法律 | ✅ 完成 |
| 3 | 导入国家级法律 | ✅ 完成 |
| 4 | 导入地方法规 | ✅ 完成 |
| 5 | 语义向量化 | ✅ 100%完成 |
| 6 | 端到端测试 | ✅ 完成 |
| 7 | 清理临时文件 | ✅ 完成 |
| 8 | 整理导入报告 | ✅ 完成 |
| 9 | 建立更新监控机制 | ✅ 完成 |
|------|------|
| 1 | 探索开源数据集 | 完成 |
| 2 | 过滤过期法律 | 完成 |
| 3 | 导入国家级法律 | 完成 |
| 4 | 导入地方法规 | 完成 |
| 5 | 语义向量化 | 100% 完成 |
| 6 | 端到端测试 | 完成 |
| 7 | 清理临时文件 | 完成 |
| 8 | 整理导入报告 | 完成 |
| 9 | 建立更新监控机制 | 完成 |
### 数据导入详情
@@ -44,49 +44,50 @@
| 行政法规 | 904 | - |
| 部门规章 | 335 | - |
| 法律 | 335 | - |
| 其他 | - | - |
---
## 三、质量保障
### 过期法律过滤 ✅
### 过期法律过滤
- 检测标记：已废止、已失效、已修订、被废止、被修改、废止、失效、不再适用、已停止施行
- 过滤结果：1,370 部过期法律已排除
- 有效法律占比：73.9%
### 重复导入防护 ✅
### 重复导入防护
- 数据库去重：导入前检查 source_id
- 导入脚本去重：自动处理重复条文
- 结果：0 条重复
### 向量化完成 ✅
### 向量化完成
- 向量化率：100.00%
- 算法：LegalSemanticMatcher (local-token-v1)
- 特征：中文分词、法律概念别名映射、余弦相似度
---
## 四、测试验证 ✅
## 四、测试验证
### 语义搜索测试
- 测试场景：5个合同审查场景
- 测试场景：5 个合同审查场景
- 通过率：100%
- 匹配效果：每个场景返回 100+ 相关条文
### 合同审查场景测试
| 场景 | 匹配数 | 状态 |
|------|--------|------|
| 劳动合同 | 222 | ✅ |
| 建设工程 | 153 | ✅ |
| 技术服务 | 106 | ✅ |
| 股权转让 | 152 | ✅ |
| 劳动合同 | 222 | 通过 |
| 建设工程 | 153 | 通过 |
| 技术服务 | 106 | 通过 |
| 股权转让 | 152 | 通过 |
---
## 五、文件清单
### 保留的文档
| 文件 | 说明 |
|------|------|
| `LEGAL-LIBRARY-COMPLETE-DOC.md` | 完整导入文档 |
@@ -95,29 +96,29 @@
| `scripts/vectorize_laws.py` | 向量化脚本 |
### 已清理的临时文件
| 文件 | 大小 | 状态 |
|------|------|------|
| temp-lawrefbook/ | 90MB | ✅ 已删除 |
| import-ready-*.jsonl | 144MB | ✅ 已删除 |
| temp-lawrefbook/ | 90MB | 已删除 |
| import-ready-*.jsonl | 144MB | 已删除 |
**释放空间**: ~270MB
释放空间：约 270MB
---
## 六、后续维护
### 定期更新（每月）
1. 运行 `scripts/check_law_updates.py` 检查更新
2. 同步新增法律和修订内容
3. 过滤过期法律
1. 运行 `scripts/check_law_updates.py` 检查更新。
2. 同步新增法律和修订内容。
3. 过滤过期法律。
### 监控指标
1. 向量化覆盖率（目标: 100%）
2. 语义搜索响应时间（目标: <100ms）
3. 法律数量变化趋势
1. 向量化覆盖率，目标 100%。
2. 语义搜索响应时间，目标小于 100ms。
3. 法律数量变化趋势。
---
**报告生成时间**: 2026-06-16
**最终状态**: ✅ 100% 完成
**AI合同平台法律库已完整可用！**
**最终状态**: 100% 完成
project-docs/phase14-legal-fulltext-library/final-report.md
-121
View File
@@ -1,121 +0,0 @@
# 法律库扩充 - 完整执行报告
**执行日期**: 2026-06-16
**状态**: ✅ 全部完成
---
## 执行摘要
本次任务成功从开源数据集导入了 21 部现行有效的法律，并完成了语义向量化，使 AI 合同审查系统能够立即使用这些法律。
| 阶段 | 状态 | 结果 |
|------|------|------|
| 1. 数据源探索 | ✅ 完成 | 发现 LawRefBook/Laws (3,531 个文件) |
| 2. 法律筛选 | ✅ 完成 | 确认 21 部优先级一法律（现行有效） |
| 3. 数据转换 | ✅ 完成 | 转换为 JSONL 格式 (1,940 条) |
| 4. 数据导入 | ✅ 完成 | 1,686 条导入数据库 |
| 5. 语义向量化 | ✅ 完成 | 100% 向量化成功 |
---
## 导入法律清单
### 按领域分类
| 领域 | 法律数 | 条文数 | 向量化 |
|------|--------|--------|--------|
| 投融资 | 2 | 300 | ✅ 100% |
| 商事主体 | 2 | 245 | ✅ 100% |
| 劳动用工 | 3 | 202 | ✅ 100% |
| 采购招投标 | 3 | 235 | ✅ 100% |
| 房地产 | 3 | 235 | ✅ 100% |
| 建设工程 | 3 | 218 | ✅ 100% |
| 知识产权 | 3 | 134 | ✅ 100% |
| 数据隐私 | 1 | 51 | ✅ 100% |
| **总计** | **21** | **1,686** | **✅ 100%** |
### 详细清单
| 条文数 | 法律名称 | 领域 | Source ID |
|--------|---------|------|-----------|
| 226 | 中华人民共和国证券法 | 投融资 | LAW-SECURITIES-2019 |
| 136 | 中华人民共和国企业破产法 | 商事主体 | LAW-BANKRUPTCY-2006 |
| 109 | 中华人民共和国合伙企业法 | 商事主体 | LAW-PARTNERSHIP-2006 |
| 98 | 中华人民共和国社会保险法 | 劳动用工 | LAW-SOCIAL-INSURANCE-2018 |
| 88 | 中华人民共和国政府采购法 | 采购招投标 | LAW-GOVERNMENT-PROCUREMENT-2014 |
| 87 | 中华人民共和国土地管理法 | 房地产 | LAW-LAND-MGMT-2019 |
| 85 | 中华人民共和国建筑法 | 建设工程 | LAW-CONSTRUCTION-2019 |
| 82 | 建设工程质量管理条例 | 建设工程 | LAW-CONSTRUCTION-QUALITY-2019 |
| 79 | 中华人民共和国政府采购法实施条例 | 采购招投标 | LAW-GOVERNMENT-PROCUREMENT-IMPL-2015 |
| 75 | 中华人民共和国土地管理法实施条例 | 房地产 | LAW-LAND-MGMT-IMPL-2021 |
| 74 | 中华人民共和国信托法 | 投融资 | LAW-TRUST-2001 |
| 73 | 中华人民共和国城市房地产管理法 | 房地产 | LAW-REAL-ESTATE-MGMT-2019 |
| 68 | 中华人民共和国招标投标法 | 采购招投标 | LAW-TENDER-2017 |
| 67 | 中华人民共和国著作权法 | 知识产权 | LAW-COPYRIGHT-2020 |
| 67 | 工伤保险条例 | 劳动用工 | LAW-WORK-INJURY-2010 |
| 56 | 最高人民法院关于审理劳动争议案件...解释（一） | 劳动用工 | LAW-LABOR-DISPUTE-INTERP-2020 |
| 51 | 关键信息基础设施安全保护条例 | 数据隐私 | LAW-CRITICAL-INFO-2021 |
| 51 | 最高人民法院关于审理建设工程施...解释（一） | 建设工程 | LAW-CONSTRUCTION-DISPUTE-INTERP-2020 |
| 47 | 中华人民共和国劳动合同法实施条例 | 劳动用工 | LAW-LABOR-CONTRACT-IMPL-2008 |
| 40 | 中华人民共和国著作权法实施条例 | 知识产权 | LAW-COPYRIGHT-IMPL-2013 |
| 27 | 信息网络传播权保护条例 | 知识产权 | LAW-INFO-NETWORK-2013 |
---
## 技术细节
### 数据来源
- **原始来源**: [LawRefBook/Laws](https://github.com/LawRefBook/Laws) (GitHub)
- **文件格式**: Markdown
- **法律版本**: 全部为现行有效版本
### 数据处理流程
1. **Markdown → JSONL**: 解析法律条文，提取元数据
2. **数据清洗**: 修复日期格式，去重
3. **批量导入**: 使用 `import_cn_laws_jsonl.py` 脚本
4. **语义向量化**: 使用 `legal_semantic_matcher` 进行中文法律语义分析
### 性能指标
- **导入速度**: ~118 条/秒 (1,686 条 / 16.4 秒)
- **向量化速度**: ~20 条/秒 (1,686 条 / 83.2 秒)
- **总耗时**: ~100 秒
---
## 已生成文件
| 文件 | 说明 |
|------|------|
| `import-ready-lawrefbook.jsonl` | 原始转换文件 (1,940 条) |
| `import-ready-lawrefbook-fixed.jsonl` | 修复后的导入文件 |
| `import-summary-lawrefbook.json` | 导入摘要 |
| `import-report-lawrefbook.md` | 导入报告 |
| `import-guide.md` | 导入指南 |
| `open-source-available-laws.json` | 可用法律清单 |
| `open-source-law-inventory.md` | 开源法律清单 |
| `vectorize_laws.py` | 向量化脚本 |
| `convert-lawrefbook-to-jsonl.py` | 转换脚本 |
---
## 下一步建议
### 立即可做
1. ✅ **完成** - 语义向量化
2. 测试合同审查功能，验证新法律是否生效
3. 发布法律条文到生产环境知识库
### 后续扩充
1. 补充剩余 16 部优先级一法律（需从国家法律法规数据库获取）
2. 导入优先级二法律（36 项）
3. 建立法律更新监控机制
---
## 关键成就
✅ **21 部核心法律** - 覆盖 8 个关键领域
✅ **1,686 条法律条文** - 全部现行有效
✅ **100% 向量化** - AI 可立即使用
✅ **开源数据源** - 免费、可持续、无版权问题
project-docs/production-split-deployment.md
+17 -17
View File
@@ -8,10 +8,10 @@
| 组件 | 地址 | 说明 |
|---|---|---|
| 用户访问入口 | `https://api.yuqei.com` | 阿里云 Nginx，站点域名 |
| 用户访问入口 | `https://contact.yuqei.com` | 阿里云 Nginx，站点域名 |
| 阿里云公网主机 | `47.94.178.212` | 运行 Nginx + Next.js 前端 Docker 容器 |
| 前端容器 | `127.0.0.1:3003 -> 3000` | `docker-compose.frontend.aliyun.yml` |
| 公网 API | `https://api.yuqei.com/api/v1` | Nginx 代理到 3.90 后端 |
| 公网 API | `https://contact.yuqei.com/api/v1` | Nginx 代理到 3.90 后端 |
| 3.90 后端 | `http://192.168.3.90:8001` | FastAPI Docker 后端 |
| 阿里云到后端隧道 | `http://10.20.0.11:8001` | WireGuard 内网地址，沿用 hyburk 代理方式 |
| PostgreSQL | `192.168.3.90:5432` | 数据库 `ai_contract_platform` |
@@ -51,7 +51,7 @@ cd /opt/ai-contract-platform
### 2.2 阿里云 47.94.178.212
1. Docker、Nginx、WireGuard 已安装并运行。
2. DNS：`api.yuqei.com` 指向 `47.94.178.212`。
2. DNS：`contact.yuqei.com` 指向 `47.94.178.212`。
3. WireGuard 连通性：
```bash
@@ -65,7 +65,7 @@ curl http://10.20.0.11:8001/api/v1/system/readiness
mkdir -p /opt/ai-contract-platform-frontend
```
5. Nginx 配置使用 `infra/nginx/api.yuqei.com.conf`。如果已配置 HTTPS 证书，将该 server 块合并到 TLS 配置或由 certbot/现有证书工具扩展 443 server。
5. Nginx 配置使用 `infra/nginx/contact.yuqei.com.conf`。如果已配置 HTTPS 证书，将该 server 块合并到 TLS 配置或由 certbot/现有证书工具扩展 443 server。
## 3. 发布命令
@@ -76,10 +76,10 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-backend-d
-ServerHost 192.168.3.90 `
-RemoteProjectPath /opt/ai-contract-platform `
-ComposeFile docker-compose.server.yml `
-FrontendBaseUrl https://api.yuqei.com `
-FrontendBaseUrl https://contact.yuqei.com `
-BackendBaseUrl http://192.168.3.90:8001 `
-ApiUrl https://api.yuqei.com/api/v1 `
-ReadinessUrl https://api.yuqei.com/api/v1/system/readiness
-ApiUrl https://contact.yuqei.com/api/v1 `
-ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness
```
后端 Compose 默认只要求 3.90 运行 `backend`、`legal-change-impact-worker`、`redis`。前端服务保留在 `single-host` profile 中，不作为拆分生产路径必需项。
@@ -91,15 +91,15 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-frontend-
-ServerHost 47.94.178.212 `
-RemoteProjectPath /opt/ai-contract-platform-frontend `
-BackendTunnelBaseUrl http://10.20.0.11:8001 `
-FrontendBaseUrl https://api.yuqei.com `
-FrontendBaseUrl https://contact.yuqei.com `
-BackendBaseUrl http://192.168.3.90:8001 `
-ApiUrl https://api.yuqei.com/api/v1 `
-ReadinessUrl https://api.yuqei.com/api/v1/system/readiness
-ApiUrl https://contact.yuqei.com/api/v1 `
-ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness
```
脚本会：
1. 打包 `frontend/`、`docker-compose.frontend.aliyun.yml`、`infra/nginx/api.yuqei.com.conf`。
1. 打包 `frontend/`、`docker-compose.frontend.aliyun.yml`、`infra/nginx/contact.yuqei.com.conf`。
2. 上传到阿里云。
3. 备份当前远程前端和 Nginx 配置到 `/opt/ai-contract-platform-frontend/backups/frontend-aliyun-deploy/`。
4. 用 `BACKEND_BASE_URL=http://10.20.0.11:8001` 构建并重启前端容器。
@@ -111,19 +111,19 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\deploy-frontend-
```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\run-production-release-gate.ps1 `
-ServerHost 192.168.3.90 `
-FrontendBaseUrl https://api.yuqei.com `
-FrontendBaseUrl https://contact.yuqei.com `
-BackendBaseUrl http://192.168.3.90:8001 `
-ApiUrl https://api.yuqei.com/api/v1 `
-ApiUrl https://contact.yuqei.com/api/v1 `
-HealthUrl http://192.168.3.90:8001/health `
-ReadinessUrl https://api.yuqei.com/api/v1/system/readiness `
-ReadinessUrl https://contact.yuqei.com/api/v1/system/readiness `
-ExpectedRemoteServices backend,legal-change-impact-worker,redis
```
手工 smoke：
```bash
curl https://api.yuqei.com/
curl https://api.yuqei.com/api/v1/system/readiness
curl https://contact.yuqei.com/
curl https://contact.yuqei.com/api/v1/system/readiness
curl http://192.168.3.90:8001/health
```
@@ -163,7 +163,7 @@ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts\rollback-fronten
| 主机 | 端口 | 用途 |
|---|---:|---|
| 47.94.178.212 | 80/443 | Nginx / `api.yuqei.com` |
| 47.94.178.212 | 80/443 | Nginx / `contact.yuqei.com` |
| 47.94.178.212 | 3003 | 前端容器本机端口，建议仅本机访问 |
| 47.94.178.212 | 51820/udp | WireGuard |
| 192.168.3.90 | 8001 | AI 合同平台后端 |