# 地址合同「套打」模板制作说明

> 适用版本：v115 起（2026-09-10 套打改造）。**旧版「AcroForm 表单域 + 签名字体」方案已废弃**。
> 配置入口：**系统管理 → 合同模板**（按「出租人（甲方）」维护，重复上传同出租人 = 替换底图）。

---

## 1. 原理：什么是套打

合同纸是**提前印好正文、条款、盖章**的（扫描成 PDF = **底图**）。
系统不重新排版合同，而是把「客户名 / 面积 / 金额 / 日期」等变量，按**毫米坐标**叠印到底图的空格、下划线上，
打印出来就是一份填写完整的正式合同。这就是「套打」（print overlay）。

```
底图 PDF（印好的合同纸）  +  毫米坐标 JSON（字段 → X/Y）
        ↓  生成时把合同值按坐标叠印
完整 PDF（底图 + 文字）  或  套打层（只有文字，打到预印纸上）
```

坐标规则：
- 原点在页面**左下角**；**X 向右增大、Y 向上增大**，单位 **毫米**；
- 标准 A4 = **210 × 297 mm**；
- 底图若是「横向纸张 + 旋转 270°」的扫描件，系统会自动烘焙旋转，**你按最终显示方向量坐标即可**。

---

## 2. 准备底图 PDF

1. 把纸质合同**扫描或拍照转成 PDF**（建议 300dpi 以上，文字清晰）；
2. **只保留合同正文页**，去掉封面、空白页、装订线黑边；
3. 如果是多页合同，**页序要与实际打印顺序一致**（第 1 页就是第 1 页）；
4. 上传前用任意 PDF 阅读器确认：**页面是正向的**（不用手动旋转，系统会处理 `/Rotate`）；
5. 底图上的空格位置要留够空间 —— 字放不下时系统不会自动缩小，请调整模板或字号。

> 注意：底图**不需要**画任何表单框、也不需要嵌入字体。中文由系统字体渲染。

---

## 3. 上传底图

1. 进入 **系统管理 → 合同模板**；
2. 顶部表单填写：
   - **出租人**：必须与地址合同里填写的「出租人」**完全一致**（系统按此匹配模板），如 `王五`；
   - **底图 PDF**：选择第 2 步准备好的文件；
3. 点「上传 / 替换」；
4. 上传成功后**自动弹出坐标设置窗口**（也可在列表里点「坐标设置」再次打开）。

---

## 4. 设置字段坐标

弹窗分左右两块：

### 左侧：底图预览
- 按页显示底图，圆点 = 已配置字段的落点（编号对应右侧表格行号）；
- 多页模板可点上方「第 N 页」按钮切换；
- 点「打印 A4 标尺纸」可生成一张带毫米刻度的 A4 纸：**打印后与合同纸叠放**，直接读出空格处的 X / Y，比在屏幕上估算准得多。

### 右侧：字段坐标表格

| 列 | 说明 |
|---|---|
| 字段 | 下拉选择要套打的字段（见 §5 清单） |
| X (mm) | 距页面**左边缘**的距离 |
| Y (mm) | 距页面**下边缘**的距离（注意：不是从上往下） |
| 字号 | 数字，一般 12–16；太小打印不清，太大溢出格子 |
| 颜色 | 默认 `#4a4a4a`（近黑灰），与预印黑字协调；需要醒目可用纯黑 `#000000` |

> **签名字段**（`签名`）：选中它时会**自动切换成手写体**（`Handwrite`，字体随系统自带，不用你管）并把字号提到 24 左右，
> 位置一般落在签约页「法定代表人：____」的下划线上，**字底边坐在下划线上**即可。

操作：
- 点 **「+ 添加字段」** 新增一行 → 选字段 → 填坐标；
- 点某行 **「删除」** 移除；
- 保存时**未选择字段的空行会被自动忽略**；
- 保存后回到列表，「坐标状态」显示「已设置」。

### 坐标怎么量（推荐顺序）
1. 先用「打印 A4 标尺纸」打出标尺；
2. 与合同纸背面透光/叠放对齐，读出每个空格中心的 X / Y；
3. 填进表格 → 保存 → 生成一份 PDF 试打；
4. 打印后如整体偏移，**不用改坐标**，在生成弹窗里调「打印偏移 X/Y」即可（正数向右/向上）。

---

## 5. 可用字段清单

字段名由系统固定，模板里只能从下表选（下拉里就是这些）：

| 字段 key | 中文含义 | 值示例 |
|---|---|---|
| `lessor` | 出租人 | `王五` |
| `company_name` | 客户公司名称 | `广州XX科技有限公司` |
| `customer_name` | 客户名称 | `广州XX科技有限公司` |
| `legal_person` | 法人姓名 | `李四`（可配手写体） |
| `signature` | **签名**（= 法人姓名，手写体） | `李四`（生成时可勾选是否输出） |
| `contact_info` | 联系方式 | `13800138000` |
| `full_address` | **完整地址**（场地详细地址 + 房号） | `广州市黄埔区神舟路9号4栋420房D143` |
| `venue_address` | 场地详细地址 + 房号（与 `full_address` 同值） | `广州市黄埔区神舟路9号4栋420房D143` |
| `room_number` | 房号 | `D143` |
| `address_type` | 地址类型 | `注册地址` |
| `area` | 面积 | `120㎡` |
| `start_date` | 开始日期 | `2026年9月10日` |
| `end_date` | 结束日期 | `2027年9月9日` |
| `sign_date` | 签约日期 | `2026年9月10日` |
| `contract_amount` | 合同金额（小写） | `2000` |
| `actual_amount` | 实际金额（小写） | `2000` |
| `contract_amount_chinese` | 金额大写 | `贰仟元整` |
| `amount_period` | 金额周期 | `月` / `年` |
| `customer_type` | 客户类型 | `同行` / `直客` |
| `contract_remark` | 合同备注 | `——` |
| `peer_name` | 对方名称 | `——` |
| `peer_contact` | 对方联系方式 | `——` |
| `salesman_name` | 业务员 | `小李` |
| `created_date` | 制单日期 | `2026年9月10日` |
| `contract_no` | 合同编号 | `HT2026-0001` |

> 合同中该字段为空时，**该位置会留白**、不报错；生成后会以提示形式列出空值字段。

---

## 6. 生成与打印

在**地址合同列表**里对某条已审批的合同点 **「生成PDF」**：

| 方式 | 产物 | 用途 |
|---|---|---|
| **完整 PDF**（默认） | 底图 + 文字，保存到系统 | 电子存档、线上发送；列表出现「下载PDF」按钮 |
| **仅套打层** | 只有文字、无底图，不保存 | **在预印合同纸上套打**：把这张纸直接放进打印机打印到合同纸上 |

- **打印偏移 X/Y**：打印后整体偏了才调，正数 = 向右 / 向上（mm）；日常保持 0。
- **是否签名**：勾选后，按模板里 **`signature`（签名）** 字段的坐标，用**手写体**把**法人姓名**签在合同纸上（如「乙方 法定代表人：____」处）。不勾则该处留白（适合底图已盖手签章、或本次不需要签的情况）。
  - 默认跟随合同本身的「是否签名」设置；每次生成都可以临时改。
  - 勾选与否只影响**本次生成**，不会改动合同数据。
  - 模板里没有配 `signature` 字段时，勾选也不会出现签名（先去坐标设置里加一行 `签名`）。
- 点「预览套打层」可先看文字落点，不必真的打印。

> 套打层打印时请确认打印机**没有开启「缩放适应页面」**（一定要 100% / 实际大小），否则坐标会整体走样。

---

## 7. 常见问题

| 现象 | 原因 | 处理 |
|---|---|---|
| 提示「该出租人尚未配置套打模板」 | 模板的「出租人」与合同的「出租人」不一致 | 到合同模板页核对，两者必须完全一致 |
| 提示「该模板尚未配置任何字段坐标」 | 只上传了底图、没设坐标 | 点「坐标设置」添加字段并保存 |
| 生成的字整体偏移 | 打印缩放 / 底图扫描比例 | 先确认 100% 打印；仍偏则在生成弹窗调「打印偏移」 |
| 文字上下颠倒 / 竖排 | 底图是横向扫描件 | 系统已自动烘焙旋转；若仍异常请重新导出正向底图 |
| 文字跑到别的格子里 | 坐标量错（Y 是从**下边缘**算） | 用「打印 A4 标尺纸」重新量 |
| 某字段位置空白 | 该合同此字段为空 | 属正常；看生成提示里列出的空值字段 |
| 字太大/太小 | 字号设置 | 在坐标表格里调该字段「字号」，或调「默认字号」 |

---

## 8. 验收要点

- ✅ 底图是**正向**的、只含合同正文页；
- ✅ 模板「出租人」与合同「出租人」完全一致；
- ✅ 每个需要填写的空格都配了字段与坐标；
- ✅ 生成后中文正常、金额/日期格式正确、不越界、不颠倒；
- ✅ 真机打印一次（100% 缩放），确认与预印空格严丝合缝。
