# 投资模块实施方案（客运站场 / 物流园区）

> 基于 `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 是否一致。

## 八、待用户确认的点
1. 主数据源：先以"全省汇总大表"为准（M1），还是直接上"市州单表解析"？
2. 系统导出是否每月都有（可作比对基准）？是否提供项目-市州对照（系统导出无市州字段）？
3. 亿元项目筛选口径：≥1 亿（10000 万）是否准确？经济强县项目清单是否有固定名单？