暴雨赔偿协议批量生成复盘：一份协议签全村的机制设计

背景与目标

本职工作场景：甬金高速改扩建 TJ01 标征迁科。8 月 14-15 日东阳暴雨，沿线农户房屋进水、鱼塘农田受损，报保险公司三者险，9 月 17 日定损表出来（核损表 9月17日版，核定总额 63670 元）。涉及桐坑村、东璜山、石马村、上横塘村 4 个村 24 户，逐户签协议不现实。

我的原话需求："涉及户数比较多，就需要搞一个统一的赔偿协议，内容一致，比如一个村，搞一个，赔偿清单金额，户号等附在后面，让户主签字确认。"

过程回顾

第一步：取数。 让军师读核损表 xlsx。第一把就翻车——Windows 控制台 GBK 编码，print 中文直接 UnicodeEncodeError。改走 sys.stdout 包 utf-8 重定向输出到文件再读，数据结构摸清了：双核定列结构（申报列+最终核定列），村名户名靠空白单元格向下继承。

第二步：找参照。 翻出 8 月 28 日的《光缆抢修维修协议》当体例参照（甲方乙方、包干价、一次性了结条款的结构直接可套）。

第三步：写生成脚本。 gen_baopei.py 一把梭：读 xlsx → 按村分组 → 以 WPS 公文底稿为模板生成 5 份 docx（1 份统一范本+4 个村成品），附件带签字清单表。中途两个坑（见下）。

第四步：对账验收。 四个村合计 18760+9000+2400+33510=63670，与核损表"合计金额"总数对平——这是硬验收，不平就是数据解析错了。

第五步：二轮迭代。 我追加两条："鱼塘清理、农田损失等相关约定，保险公司只负责赔一次，后期有重复下雨的情况，不再重复赔偿。另外签字表格弄成横版，格式搞搞整齐。"军师把一次性赔付写成第三条第 4 款，附件清单用 add_section 切横版 A4，列宽重排，签字行加高到 0.9cm。

关键踩坑

坑 1：Table Grid 样式 KeyError。 脚本里 table.style = "Table Grid" 直接炸——公文底稿模板里没有这个内置样式。根因是想当然假设 python-docx 默认模板样式存在。解决：不依赖样式，直接往 tblPr 里手写 tblBorders XML。

坑 2：人民币大写函数的"零"规则写错。 18760 生成了"壹万零捌仟柒佰陆拾元整"，正确应为"壹万捌仟柒佰陆拾元整"——万级和个级之间是否要补零，取决于低段是否小于 1000，我第一版判断条件写在了错误的变量上。军师在交付前自查输出时抓到，重写成按"已处理的低段值"判断后修正。这个 bug 要是进了正式协议就是大笑话。

坑 3：空白户名的归属假设。 Excel 里桐坑村楼锡棠下面 9 项（洗衣机、冰箱、鱼塘、广场道路清理等）户名空白，按向下继承规则全归到楼锡棠一人名下、合计 17560 元。这属于"程序按规则办了但事实未必如此"——军师主动在交付时 flag 出来让我核对，这个处理是对的。

最终方案与产出

产出在 保险理赔/8.16暴雨/赔偿协议/：

• 统一范本 1 份 + 4 个村成品 docx（协议正文竖版公文版式 + 横版签字清单）
• 核心机制在第四条：各户主在清单对应行签字捺印，即视为认可协议全部条款，与单独签约同等效力——"一份协议签全村"靠这条成立
• 第三条埋了一次性了结+一次性赔付双保险，但排除"暂未核定"项（10 项核定 0 元的待补凭证项），避免农户拒签
• 脚本留存，定损表更新后重跑即重新出全套

做得好的地方

1. 把业务问题翻译成了机制设计："多户签字麻烦"→"清单签字效力等同条款"，这是法务思维不是文书思维；
2. 硬验收到位：分村合计对总数、读回 docx 验段落和表格，不是"生成了就完事"；
3. 主动 flag 数据疑点：楼锡棠归属、石马村无户主、三口二工区未定损（151759.96 元只有申报额）未纳入，三条都报了，没替我做主。

复盘与改进

• 这类"定损表→批量协议"的活以后还会再有（保险理赔是征迁常态），脚本已入任务文件夹可复用；下次类似任务直接报"照 8.16 暴雨那次的路子"即可；
• 改进一条：docx 生成类任务，表格样式一律手写 XML 边框，不再引用内置样式名。

成长评估

AI 自评失分点：①Table Grid 样式想当然假设，一把炸；②大写金额函数"零"规则 bug，靠自己抽查抓到，若漏检即出残次品；③首轮取数 GBK 崩溃，Windows 环境编码处理应一步到位。

素材点

• "一份协议签全村"的条款机制（签字效力等同+一次性赔付排除项）
• python-docx 横版节切换、手写表格边框 XML 的代码段
• 人民币大写函数的零规则正确写法
• 本职工作+AI 的实战案例：定损表 30 分钟变 5 份可签协议