投资模块实施方案（客运站场 / 物流园区）
基于 docs/扩展表模板/投资/ 全部样例实拆整理（2026-08-23）
结论先行：**主数据源走"全省汇总大表 + 市州上报表解析"，投资系统导出仅作审核比对**；建议分两期落地，第一期先让 4 张领导报表跑通。
一、数据源实拆结论
1. 投资系统查询导出（最干净，但字段最少）
查询结果(投资系统-客运+物流 2026.7).xls（149 行 × 8 列）：
| 列 |
字段 |
样例 |
| A |
行号 |
2 |
| B |
单位（即项目名称） |
汉口客运中心 |
| C |
时期 |
2026年7月 |
| D |
计划总投资 |
315700 |
| E |
自开始建设至本月累计完成投资 |
177685.4 |
| F |
本年计划投资 |
30000 |
| G |
自年初累计完成投资 |
4000 |
| H |
当月完成投资 |
500 |
- 优点：结构固定、无需容错解析。
- 局限：**无市州、无进度/形象进度/批复文号**，只能支撑 4 张输出表里的数值列，不足以独立生成领导报表。
2. 市州上报表（格式不统一，需容错解析）
- 客运站场样例：宜昌 18 列、汇总大表 20 列；物流样例：黄石 23 列、汇总表 24 列。
- 公共字段（列位置因表而异，须按表头关键词匹配）：
序号 / 项目名称及站级 / 投资建设单位 / 建设性质（新建/续建/改扩建）/ 开工时间 / 竣工时间 / 计划总投资 / 自开始建设累计完成投资 / 本年计划投资 / 自年初累计完成投资 / 其中本月完成投资 / 建设阶段（在建/完工/前期）/ 形象进度 / 工可批复 / 初设批复 / 建筑面积 / 用工人数。
- 分组行：
一、使用交通部车购税资金建设项目、二、使用省燃油税返还资金建设项目、三、农村综合运输服务站/一般项目、四、候车亭/农村综合服务站、五、计划外项目；市州小计行含"小计/合计"。
- 文件混存：
.xls / .xlsx / .et / .pdf，标题行位置不一（部分无标题直接是表头）。
3. 全省汇总中间表（推荐一期主入口）
6月/7月客运站投资明细表.xlsx：两 sheet（明细 121 行 × 20 列 + 汇总），已是全省 17 市州分组合计结构，格式统一。6月物流站场投资明细.xls：4 sheet（月2 建设规模表 / 分项目投资完成情况 / 分市州规划内外项目完成情况 / 市州汇总），格式统一。
4. 输出 4 张表（给领导，需求见 每个月做出这些固定格式的表，给领导看.txt）
| # |
表名 |
结构 |
关键口径 |
| 1 |
2026年全省预安排计划进度情况汇总 |
28 列，双层表头；合计/客运站场/物流 大块 + 17 市州小计 + 项目明细 |
序号/市州/县区/项目/性质/建设时间/总投资/累计完成/2026年计划(合计·部·省·自筹·进度)/2026·2027建议计划/前期工作/1-N月累计完成/实际进度/省补资金/备注 |
| 2 |
"十五五"规划物流项目进展 |
市州小计 + 项目明细 |
序号/项目/企业/开工/完工/总投资/累计完成/本月完成/进度/进展描述 |
| 3 |
湖北省（客货站场）亿元投资项目 |
2 sheet：投资总表(6列季度口径) + 规上项目表(24列) |
规上项目：省份/市州/项目/类别/建设内容/状态/性质/开工/总投资/累计/各月计划与完成；**筛选≥1亿元项目** |
| 4 |
（经济强县项目）交通物流基础设施投资统计 |
17 列 |
序号/项目/企业/总投资/累计完成/本年计划/自年初累计/本月完成/进度/进展/工可初设批复 |
洞察：4 张输出表是同一批项目数据的 4 种视角（全省计划全景 / 十五五物流重点 / 亿元规模以上 / 经济强县），抽一套项目主档即可复用。
二、数据模型（建议 2 张表）
investment_project 项目主档（按项目名+类型唯一）
| 字段 |
说明 |
| id / project_name |
主键 / 项目名称（唯一键：project_name + category） |
| category |
客运站场 / 物流园区 |
| city / county |
市州 / 县（市、区） |
| construct_nature |
新建/续建/改扩建 |
| start_year / end_year |
开工 / 竣工时间 |
| total_investment |
计划总投资（万元，double） |
| approval_gk / approval_cs |
工可 / 初设批复文号 |
| planned_level |
是否 2026 预安排计划内 / "十五五"重点 / 亿元项目标记 |
| source |
数据来源（全省汇总表/市州报表/系统导出） |
investment_monthly 月度完成表（report_period + project_id）
| 字段 |
说明 |
| report_period |
报表期 2026-07 |
| project_id |
关联主档 |
| year_plan |
本年计划投资 |
| year_cum |
自年初累计完成投资 |
| month_done |
当月完成投资 |
| start_cum |
自开始建设累计完成投资 |
| progress_stage / progress_desc |
建设阶段 / 形象进度 |
| building_area |
建筑面积（客运表） |
报表期以页面选择为准；金额/面积统一 double 存储，不做 BigDecimal。
三、导入设计（两期）
一期：全省汇总大表 + 系统导出（快速跑通 4 张表）
- 新增导入类型"投资月报"：支持
6月/7月客运站投资明细表.xlsx（明细 sheet）与 6月物流站场投资明细.xls（分项目投资完成情况 sheet）两类统一格式。
- 解析要点：跳过分组行/小计行（关键词：市州名+数字列、
小计/合计、一、二、三…），识别项目明细行；表头按关键词映射列。
- 幂等：同报表期删除旧数据（主档按名 upsert，月度表按 period 删除重建）。
- 同时导入
查询结果(投资系统…).xls 作为审核比对基准（存 investment_system 表或直接审核时读文件→建议存表）。
二期：17 市州单表容错解析
- 解析器三级容错：①按关键词定位表头行（
项目名称+总投资）→ ②按表头关键词映射列（计划.*总投资→总投资等）→ ③分组/小计行过滤。
- 格式注册表：每种市州格式 = 一个解析器配置（列映射 + 标题行偏移 + 跳过行模式），新增格式加配置不改代码。
- 支持
.xls/.xlsx；.et（WPS）与 .pdf 先提示"请另存为 xls/xlsx"。
四、审核规则（规则表驱动，report_type=INVEST）
| 规则 |
比较类型 |
说明 |
| 与投资系统数对比 |
CROSS_DIFF |
计划总投资/自年初累计/当月完成 与系统导出差异超阈值（如总投资>5% 或绝对差>100万） |
| 完成超计划 |
RANGE |
当月完成 > 本年计划剩余；累计完成 > 计划总投资×1.05 |
| 进度矛盾 |
LOGIC |
阶段=完工但完成率<1；阶段=在建但累计=0 |
| 必填缺失 |
NULL_CHECK |
项目名/总投资/累计完成 为空 |
五、报表生成（复用现有导出框架）
- 4 个端点：
/api/report/export/investPlan（预安排计划表）、investFiveYearLogistics（十五五物流）、investBillion（亿元项目，含投资总表+规上项目表两 sheet）、investCounty（经济强县表）。
- 动态月份：
period=2026-07 → 标题/列头用 1-7月累计；市州顺序沿用 RegionUtil.cityList()。
- 亿元项目表：按
total_investment ≥ 10000 万元 筛选；投资总表按季度口径从月度完成推导（一季度=1-3月、二季度=4-6月…）。
六、前端
DataImport.vue：新增"投资月报"（全省汇总大表）与"投资系统导出"两种导入类型。ReportExport.vue：新增"投资报表（INVEST）"卡片，4 个生成按钮。AuditResult.vue：报表类型增加"投资月报"（可选，二期）。
七、里程碑与工作量（单人）
| 里程碑 |
内容 |
工作量 |
| M1 |
全省汇总大表导入 + 主档/月度表 + 4 张报表输出 |
后端 4~5 人天 + 前端 1~2 人天 |
| M2 |
市州单表容错解析 + 系统导出比对审核 |
后端 4~6 人天 |
| M3 |
前端入口整合 + 联调（与市州核对 6/7 月样例） |
2~3 人天 |
不含需求确认与数据口径核实；建议 M1 完成即让用户用 6/7 月样例核对 4 张输出表与现有 Excel 是否一致。
八、待用户确认的点
- 主数据源：先以"全省汇总大表"为准（M1），还是直接上"市州单表解析"？
- 系统导出是否每月都有（可作比对基准）？是否提供项目-市州对照（系统导出无市州字段）？
- 亿元项目筛选口径：≥1 亿（10000 万）是否准确？经济强县项目清单是否有固定名单？
