市州月报填报口径与统一模板（2026-09-20）

起因：用户提问「他们导入的数据按哪个格式来最好？要不要生成两个模板（客运站一个、物流园一个）？
这几个表的更新其实很简单——按项目名称更新汇总表指定指标、新增项目就新增到明细表，
预安排汇总表和明细表方式一样，剩下三张表项目固定只更新指标——为什么现在弄得有点复杂了？」

一、结论先说

只有一个数据页「月报」+ 一个「填报说明」页。第 4 行是表头，一行一条项目，共 17 列：

列	表头	程序里的去向
A	序号	仅用于识别市州小节行/合计行，不参与匹配
B	县（市、区）	项目主档 `county`（全省汇总表要显示这一列）
C	项目名称及站级	匹配键（市州 + 类别 + 项目名称）
D	投资建设单位名称	主档 `builder_name`
E	建设性质	主档 `construct_nature`（下拉：新建/续建/改扩建/改建）
F	开工年	主档 `start_time`
G	竣工年	主档 `end_time`
H	计划总投资（万元）	主档 `total_investment`
I	自开始建设累计完成投资（万元）	当期月度数
J	本年计划投资（万元）	当期月度数
K	自年初累计完成投资（万元）	当期月度数
L	其中：本月完成投资（万元）	当期月度数
M	建设阶段	当期月度数
N	形象进度	当期月度数
O	工可批复文号	主档 `approval_gk`
P	初设/施工图批复文号	主档 `approval_cs`
Q	备注	不取数

主档列（A、B、D、E、F、G、H、O、P）：第一次建档时写入，之后只要项目名不变就不动；
月度数（I、J、K、L、M、N）：每个月报多少写多少，同一（项目，报表期）覆盖式重建；
「项目名称及站级」是唯一匹配键：改一个字 = 新建一个项目，所以要求与批复名称一字不差；
「填报说明」页写了 11 条要求（一份文件只放本市州、文件名带市州名、数值不带字符、
县（市、区）必填、建设性质只能四选一、新增项目直接加行、隐藏行不放数据、合计行可不填等）。

版式不统一：27 份市州月报里，20 份与省统一模板一致，7 份有差异——
随州多一个 Sheet2、神农架/潜江/襄阳拆成多个分月页签、襄阳整体右移 1 列、
恩施/黄石合并表头、武汉（南山/汉口）只报两个项目的简表。详见
docs/投资/输出/市州月报格式差异报告_2026-07.md。程序为了读全，只能一个版式一个兜底分支。
一个文件里混多个市州：《湖北省十堰交通物流基础设施投资统计汇总表（月报）》一个页签收了全省，
2026 年 8 月这份 38 行里只有 7 行是十堰，另外 27 行武汉 + 4 行黄石。
程序支持按「小节行」切换市州（这是有意做的功能），所以能读进来，但代价是：
只要重导 8 月物流，这 31 个项目就会重新建到武汉/黄石名下（今天做回归重导时复现，已再次清除，见测试报告 P3）。
项目清单有两个来源：一是市州当月报上来的，二是母版/库里已经有的（如预安排母版里的武汉物流行）。
于是产生「有总投资、没有本期月度数」的项目，要不要补进小计/合计就成了要单独决策的事。
列位置靠兜底：早期实现按「自年初累计 = 自开始建设累计 + 2 列」这类列序推算，
市州一挪列就得再加一条兜底——这是「猜」出来的复杂度，不是业务复杂度。

模板解决的是「怎么读」。下面 3 件事定下来，整条链就没有歧义了：

#	待定事项	建议
1	年度项目清单以谁为准？库里有什么就出什么，还是以「年度预安排计划表」为准？	以年度预安排计划表为准（随母版下发或单独建一张《年度预安排计划》表），每月只更新指标
2	某市州当月没报怎么办？	该市州指标留空 + 导出前弹窗列出「未报送市州」，不阻断导出
3	市州新增的项目插到哪？	插到该市州「预安排计划内」小节末尾；计划外的单独标注，导向上仍出但明显区别于计划内

8 月及以前：已按旧格式导入完毕，程序继续兼容旧版式，**不改、不重导**（8 月十堰源文件清理另行确认）。
9 月起：市州按统一模板填报；建议再加一个「模板体检」——导入时校验表头是否为本模板 17 列，
是则走「按表头取数」的直路，不是则**弹窗提示**（哪一列对不上），而不是继续猜列位置。
这样解析逻辑可以退化成「按表头名取值」，现有那些容错兜底分支可以逐步下线，复杂度自然就降下来了。