xyc
1 天以前 73e810fc9569597be99accd08d63aab6e7c0daac
docs/database.md
@@ -526,7 +526,7 @@
| road_category | varchar(32) | 高速公路 EXPRESSWAY / 普通国省道 NATIONAL_PROVINCIAL |
| vehicle_type | varchar(32) | 小客车 SMALL_PASSENGER / 中小客车 MEDIUM_SMALL_PASSENGER |
  | vehicle_count | decimal(30,15) | 车流量(万辆次) |
  | comparison_base | decimal(30,15) | 普通国省道环比基期(万辆次,仅当年使用) |
  | comparison_base | decimal(30,15) | 普通国省道环比基期(万辆次,人工备用值,仅 2026 年启用、不参与计算) |
  | created_at / updated_at | datetime | 创建/更新时间 |
唯一键:`(year, flow_date, road_category, vehicle_type)`。
@@ -544,11 +544,11 @@
### 计算与导入导出口径
  - 非营业性人员流动量 =(高速车流 + 普通国省道车流)× 当年节假日客运系数。
  - 2026 年普通国省道如填写环比基期,则只影响普通国省道车流量自身环比:填写时按“当日 / 环比基期 - 1”,未填写时按“当日 / 前一日 - 1”;折算人员流动量、总人员流动量等继续按 Excel 原公式计算。2024、2025 历史数据不使用该字段。
  - 普通国省道环比固定按“当日 / 前一日 - 1”计算;2024/2025/2026 各年一致。`comparison_base`(Excel 普通国省道表 C 列“环比基期”)自 2026-10-05 起仅作人工备用:导入导出原样保存/回写,不参与环比、折算或累计;导出时 C 列照常写出,E 列“环比”公式始终引用上一行同年 D 列。
  - 公路人员流动量 = 道路营业性客运量 + 非营业性人员流动量。
- 总人员流动量 = 公路 + 铁路 + 民航 + 水路。
- 导入按“年份 + 节假日分类”读取 `holiday_calendar` 中 `day_index>=1` 的日期,将工作簿“第N日”行覆盖写入当年客流/车流;同时读取当前年份铁路、民航的“前一日”行,写入 `day_index=0` 对应的日期。
- 日常导入只读取所选年份的当年列(道路表的 2019/2024/2025 列均不读取);2019 年道路数据和 2024/2025/2026 年前一日铁路、民航数据由启动初始化直接写入数据库。
- 日常导入只读取所选年份的当年列(道路表的 2019/2024/2025 列均不读取);2019 年道路数据和 2024/2025/2026 年前一日铁路、民航数据由启动初始化直接写入数据库。2019 年 10 月 1-8 日的 `holiday_calendar` 配置用于在系统配置和节假日统计页查看该历史基线。
- 导入前检查比本次最新导入日更早的历史日期是否发生变化;如有变化先不写库,返回差异清单,用户确认后才允许覆盖。
- 记录“前一日”的铁路、民航数据后,假期第 1 日的铁路、民航环比按该数据计算;公路、水路、总人员流动量在第 1 日仍不计算环比。
- 导出以源工作簿为底稿,回填库内数据与客运系数;快报按日期生成 Word,同比固定使用 2025、2024 两年,不使用 2019 数据。