# P37 电子签章与合同存证包

版本：v1.0　日期：2026-11-18　适用站点：PCB之家（Max Edition）

## 一、目标

把撮合订单从「聊天确认」推进到「可追溯的书面确认」，让需求方与服务商在订单维度完成签约、变更与验收确认，并留下可核验的记录。本期先做订单内确认流与存证台账，不接入第三方电子签章服务。

## 二、范围与边界

### 本期实现

1. 订单合同确认单：生成含订单号、标的摘要、金额、交期、质保月数、双方主体、签署时间的确认单。
2. 变更单：金额、交期、数量、规格任一项调整必须发起变更，双方确认后生效，历史版本留档。
3. 验收确认：需求方点击验收即生成验收确认记录，与服务商交付物、质检报告关联。
4. 存证台账：按订单聚合确认单、变更单、验收记录，含哈希摘要与生成时间，可在订单详情内查看与打印。
5. 争议引用：发起纠纷时自动引用对应版本确认单与变更单编号。

### 本期不实现

- 第三方 CA 证书、时间戳服务与真实法律效力签章。
- 人脸核身、企业工商信息在线核验。
- 合同模板在线编辑与版本审批流。
- 与资金托管、发票、报关单证联动。

## 三、为什么先做确认流

撮合场景的高频争议是「当时说的是这个价/这个交期」。确认单与变更单把口头约定变成带版本的结构化记录，配合履约节点与交付物留痕，可在纠纷处理时快速还原事实。真正的电子签章依赖第三方资质，属于后续能力，不在本站交付范围。

## 四、数据结构

### 合同确认单 `order_contracts`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | text | 主键，形如 `CT-<订单号>-<版本>` |
| order_id | text | 关联订单 |
| version | int | 版本号，从 1 递增 |
| kind | text | `initial` 合同 / `change` 变更单 / `acceptance` 验收确认 |
| summary | jsonb | 标的摘要：层数、板厚、尺寸、数量、工艺 |
| amount | numeric | 金额 |
| lead_time_days | int | 交期 |
| warranty_months | int | 质保月数 |
| clause | text | 付款、交付、验收、违约条款要点 |
| digest | text | 内容哈希摘要，用于比对是否被篡改 |
| buyer_confirmed_at | timestamptz | 需求方确认时间 |
| provider_confirmed_at | timestamptz | 服务商确认时间 |
| status | text | `draft` / `pending` / `effective` / `void` |
| created_at | timestamptz | 生成时间 |

### 存证台账 `order_evidence_ledger`

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| id | text | 主键 |
| order_id | text | 关联订单 |
| ref_type | text | `contract` / `change` / `acceptance` / `deliverable` / `milestone` |
| ref_id | text | 关联记录编号 |
| digest | text | 摘要 |
| snapshot | jsonb | 记录快照，避免源记录变更后无法还原 |
| at | timestamptz | 入账时间 |

## 五、页面与交互

### 1. 订单详情 · 合同卡片

- 顶部展示当前有效版本号与状态（草稿 / 待双方确认 / 已生效 / 已作废）。
- 点击「发起合同确认」生成初版确认单，双方各点一次「确认」，两次确认齐全后状态转为已生效，同时写入存证台账。
- 已生效后金额、交期、数量、规格字段锁定，只能通过「发起变更」修改。

### 2. 变更单

- 选择变更项（金额 / 交期 / 数量 / 规格），填写变更后值与原因，生成新版本。
- 新版本待双方确认期间，订单履约可继续，但交付物界面标注「变更待确认」。
- 双方确认后旧版本状态置为 `void`，新版本生效，台账新增一条记录。

### 3. 验收确认

- 需求方在订单完成前触发，系统汇总已归档的质检报告、出货单、签收单。
- 生成验收确认记录，写入台账，作为后续评价与信用加分依据。
- 质检报告缺失时提示「建议先归档质检报告再验收」，允许继续但记录该事实。

### 4. 存证台账

- 时间轴展示该订单全部存证记录，支持按类型筛选。
- 每条记录可展开快照，展示当时摘要；提供「打印当前视图」，用于线下沟通与内部归档。

## 六、状态机

```
draft → pending → effective → void
                    ↑
                 change（新版本 pending）
```

- 任一方拒签：状态回到 `draft`，记录拒签原因。
- 订单取消或纠纷中：确认单保持原状态，新增一条 `void` 说明，不删除历史。

## 七、合规与文案要求

- 不使用「具有法律效力」「等同纸质合同」等表述；统一写「订单内确认记录，便于双方核对与争议还原」。
- 不承诺签章被第三方机构认可。
- 金额、交期等条款措辞避免绝对化，保留「以双方确认版本为准」。

## 八、验收标准

1. 新订单默认无确认单，发起后可生成初版并进入待确认。
2. 双方确认齐全后状态为已生效，字段锁定；仅变更可解锁。
3. 每次状态变化在台账新增一条不可修改的记录。
4. 变更后旧版本保留并标记作废，可从台账追溯到旧版本内容。
5. 验收确认记录与交付物、履约节点正确关联。
6. 全部记录刷新页面后仍可读取，不因本机缓存清空而丢失关键结论。

## 九、与现有模块的关系

- 履约节点：确认单生效是进入「开工」的前置提示项，不强制阻断。
- 交付物留痕：验收确认引用已归档文件编号。
- 信用体系：验收确认完成是评价与信用加分的前置条件。
- 纠纷处理：纠纷页引用确认单版本号与变更记录编号。