yuqei
a3bb78e06b
Security Quality Gate / npm audit, Bandit, pip-audit, detect-secrets (pull_request) Failing after 16m35s
91 lines
5.2 KiB
Markdown
91 lines
5.2 KiB
Markdown
# V2 模板资产质量审计与优化记录（2026-07-09）
|
|
|
|
## 结论
|
|
|
|
本轮对 V2 已导入的 30 个 V1 模板资产完成了变量 schema、正文占位符、模糊字段、法律依据覆盖和渲染链路审计。
|
|
|
|
当前状态：
|
|
|
|
- 模板数量：30
|
|
- schema 中声明但正文未使用的变量：0
|
|
- 正文占位符缺少 schema 声明：0
|
|
- “相关方/相对方/经办人/办理机构”等容易混淆字段：0
|
|
- 法律依据或专业依据为空的模板：0
|
|
- 全量模板样例渲染：通过，未残留 `{{...}}` 占位符
|
|
- 后端模板起草关键测试：通过
|
|
|
|
## 本轮优化原则
|
|
|
|
1. 不删除后端合同通用字段 `counterparty`，只清理模板填写层面容易让用户困惑的重复变量。
|
|
2. schema 中未使用的字段不直接删除，先判断其法律或业务必要性；必要字段补入正文，确属重复或误导的字段才删除或改名。
|
|
3. 对强法务风险模板只做保守增强：补充法律依据、专业依据、复核边界和证据留存要求，不输出“保证有效/保证可执行”类绝对结论。
|
|
4. 所有模板保持 `LEGAL_REVIEW` 边界，正式交付前仍需法务或专业人员复核。
|
|
|
|
## 重点修订
|
|
|
|
- 劳动合同：删除模板填写层面的“相关方”概念，保留用人单位与劳动者双主体；将绩效、保密、竞业字段改成更具体的填写项，并写入正文。
|
|
- 授权委托书：将“授权相对方/办理机构”改为“授权事项对应机构或交易对方”，并补入原合同/项目/登记事项编号、公证/见证安排。
|
|
- 股东会决议：将“授权代表/经办人”改为“授权办理人”，并补入公司章程依据、股东名单附件、董监高任免、变更事项、回避表决、异议股东意见、工商材料、公证/见证安排。
|
|
- 对赌协议：删除重复且容易误导的“补偿上限/下限”，保留“补偿上限”；补入投资金额、投前/投后估值、审计机构、担保/增信安排。
|
|
- 投资协议：补入领投/跟投、投后估值、外资/国资/反垄断说明、交割文件清单。
|
|
- 采购合同、通用服务合同、法律意见书：补强法律依据或专业依据段落，解决法律依据偏薄问题。
|
|
|
|
## 审计明细
|
|
|
|
| 模板 ID | 分类 | 必填变量 | 选填变量 | 未使用变量 | 缺失 schema | 法律/专业依据引用 |
|
|
| --- | --- | ---: | ---: | ---: | ---: | ---: |
|
|
| TPL-AGENCY-DISTRIBUTION-001 | agency-distribution | 13 | 5 | 0 | 0 | 7 |
|
|
| TPL-COMMISSION-SERVICE-001 | commission | 7 | 6 | 0 | 0 | 3 |
|
|
| TPL-COOPERATION-FRAMEWORK-001 | cooperation | 8 | 6 | 0 | 0 | 5 |
|
|
| TPL-DATA-PROCESSING-001 | data-processing | 14 | 4 | 0 | 0 | 4 |
|
|
| TPL-DEMAND-LETTER-001 | demand-letter | 14 | 3 | 0 | 0 | 1 |
|
|
| TPL-EQUITY-TRANSFER-001 | equity-transfer | 11 | 11 | 0 | 0 | 3 |
|
|
| TPL-FINANCIAL-LEASE-001 | financial-lease | 16 | 6 | 0 | 0 | 1 |
|
|
| TPL-FRANCHISE-001 | franchise | 17 | 6 | 0 | 0 | 3 |
|
|
| TPL-GUARANTEE-001 | guarantee | 12 | 6 | 0 | 0 | 3 |
|
|
| TPL-INTERCOMPANY-LOAN-001 | intercompany-loan | 18 | 8 | 0 | 0 | 4 |
|
|
| TPL-INTERMEDIARY-001 | intermediary | 13 | 2 | 0 | 0 | 3 |
|
|
| TPL-INVESTMENT-AGREEMENT-001 | investment-agreement | 19 | 13 | 0 | 0 | 3 |
|
|
| TPL-IP-LICENSE-001 | ip-license | 14 | 6 | 0 | 0 | 4 |
|
|
| TPL-LABOR-CONTRACT-001 | labor | 8 | 11 | 0 | 0 | 5 |
|
|
| TPL-LABOR-SERVICE-001 | labor-service | 9 | 8 | 0 | 0 | 4 |
|
|
| TPL-LEASE-HOUSE-001 | lease | 11 | 7 | 0 | 0 | 2 |
|
|
| TPL-LEGAL-OPINION-001 | legal-opinion | 19 | 9 | 0 | 0 | 3 |
|
|
| TPL-NDA-COMMERCIAL-001 | nda | 12 | 5 | 0 | 0 | 3 |
|
|
| TPL-PARTNERSHIP-001 | partnership | 17 | 5 | 0 | 0 | 3 |
|
|
| TPL-POWER-OF-ATTORNEY-001 | power-of-attorney | 13 | 9 | 0 | 0 | 2 |
|
|
| TPL-PROPERTY-SERVICE-001 | property-service | 21 | 10 | 0 | 0 | 1 |
|
|
| TPL-PURCHASE-GOODS-001 | purchase | 24 | 10 | 0 | 0 | 3 |
|
|
| TPL-SALES-GOODS-001 | sales | 11 | 6 | 0 | 0 | 3 |
|
|
| TPL-SERVICE-GENERAL-001 | service | 14 | 12 | 0 | 0 | 4 |
|
|
| TPL-SHAREHOLDER-RESOLUTION-001 | shareholder-resolution | 18 | 12 | 0 | 0 | 2 |
|
|
| TPL-SOFTWARE-SAAS-001 | software-saas | 12 | 5 | 0 | 0 | 6 |
|
|
| TPL-TECH-DEVELOPMENT-001 | technology-development | 14 | 4 | 0 | 0 | 3 |
|
|
| TPL-CONTRACT-TERMINATION-NOTICE-001 | termination-notice | 15 | 3 | 0 | 0 | 1 |
|
|
| TPL-VALUATION-ADJUSTMENT-001 | valuation-adjustment | 17 | 9 | 0 | 0 | 4 |
|
|
| TPL-WORKS-001 | works | 16 | 2 | 0 | 0 | 2 |
|
|
|
|
## 验证记录
|
|
|
|
已执行：
|
|
|
|
```powershell
|
|
python -m pytest yuqei-contract-platform/services/contract-api/tests/test_contract_workflow.py -k "template_library_can_create_contract_draft or labor_template_draft_derives_counterparty_from_worker_name"
|
|
```
|
|
|
|
结果：2 passed。
|
|
|
|
已执行全量模板渲染脚本：
|
|
|
|
- 模板数：30
|
|
- 渲染失败：0
|
|
- 残留占位符：0
|
|
|
|
## 后续建议
|
|
|
|
下一步建议进入“模板内容法务精修”批次，而不是继续做字段层面的机械清理。优先级建议：
|
|
|
|
1. P0：劳动合同、股权转让、投资协议、对赌协议、股东会决议，由法务逐条复核强制性规则和风险提示。
|
|
2. P1：采购、服务、SaaS、数据处理、授权委托书，重点复核验收、数据合规、授权边界和电子签证据。
|
|
3. P2：物业、加盟、融资租赁、知识产权许可等强场景模板，按行业专项规则继续补充地方/监管差异。
|