| | |
|---|
| | | |
|---|
| | | ## 九、专项统计-重要节假日模块 |
|---|
| | | |
|---|
| | | > 数据来源与模板：`docs/专项统计/重要节假日/2026年十一数据.xlsx`；快报模板：`docs/专项统计/重要节假日/湖北省国庆假期综合运输客流快报模板.docx`。首次启动会从工作簿初始化 2024/2025 年十一客流、车流数据，并初始化 2024-2026 年客运系数。 |
|---|
| | | > 数据来源与模板：`docs/专项统计/重要节假日/2026年十一数据.xlsx`；快报模板：`docs/专项统计/重要节假日/湖北省国庆假期综合运输客流快报模板.docx`。首次启动会从工作簿初始化 2024/2025 年十一客流、车流数据、2024-2026 年铁路/民航前一日数据、2019 年道路数据，并初始化 2024-2026 年客运系数。 |
|---|
| | | |
|---|
| | | ### holiday_calendar 节假日日期配置 |
|---|
| | | | 字段 | 类型 | 说明 | |
|---|
| | |
|---|
| | | | year | int | 年份 | |
|---|
| | | | holiday_type | varchar(32) | 春节 SPRING_FESTIVAL / 五一 LABOR_DAY / 十一 NATIONAL_DAY | |
|---|
| | | | holiday_date | date | 节假日具体日期 | |
|---|
| | | | day_index | int | 第几日，从 1 开始 | |
|---|
| | | | day_index | int | 0=前一日，1..N=假期第 N 日 | |
|---|
| | | | created_at / updated_at | datetime | 创建/更新时间 | |
|---|
| | | |
|---|
| | | 唯一键：`(year, holiday_type, day_index)`、`(year, holiday_type, holiday_date)`。仅 admin 可通过系统配置菜单维护。 |
|---|
| | | 唯一键：`(year, holiday_type, day_index)`、`(year, holiday_type, holiday_date)`。仅 admin 可通过系统配置菜单维护；`day_index=0` 用于铁路、民航的前一日环比基数。 |
|---|
| | | |
|---|
| | | ### holiday_passenger_flow 节假日综合运输营业性客流 |
|---|
| | | | 字段 | 类型 | 说明 | |
|---|
| | |
|---|
| | | | 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)`。 |
|---|
| | |
|---|
| | | |
|---|
| | | ### 计算与导入导出口径 |
|---|
| | | - 非营业性人员流动量 =（高速车流 + 普通国省道车流）× 当年节假日客运系数。 |
|---|
| | | - 2026 年普通国省道如填写环比基期，则只影响普通国省道车流量自身环比：填写时按“当日 / 环比基期 - 1”，未填写时按“当日 / 前一日 - 1”；折算人员流动量、总人员流动量等继续按 Excel 原公式计算。2024、2025 历史数据不使用该字段。 |
|---|
| | | - 普通国省道环比固定按“当日 / 前一日 - 1”计算；2024/2025/2026 各年一致。`comparison_base`（Excel 普通国省道表 C 列“环比基期”）自 2026-10-05 起仅作人工备用：导入导出原样保存/回写，不参与环比、折算或累计；导出时 C 列照常写出，E 列“环比”公式始终引用上一行同年 D 列。 |
|---|
| | | - 公路人员流动量 = 道路营业性客运量 + 非营业性人员流动量。 |
|---|
| | | - 总人员流动量 = 公路 + 铁路 + 民航 + 水路。 |
|---|
| | | - 导入按“年份 + 节假日分类”读取 `holiday_calendar` 的日期，将工作簿“第N日”行覆盖写入当年客流/车流；日常只读取所选年份的当年列，历史年份仅首次初始化。 |
|---|
| | | - 导入按“年份 + 节假日分类”读取 `holiday_calendar` 中 `day_index>=1` 的日期，将工作簿“第N日”行覆盖写入当年客流/车流；同时读取当前年份铁路、民航的“前一日”行，写入 `day_index=0` 对应的日期。 |
|---|
| | | - 日常导入只读取所选年份的当年列（道路表的 2019/2024/2025 列均不读取）；2019 年道路数据和 2024/2025/2026 年前一日铁路、民航数据由启动初始化直接写入数据库。2019 年 10 月 1-8 日的 `holiday_calendar` 配置用于在系统配置和节假日统计页查看该历史基线。 |
|---|
| | | - 导入前检查比本次最新导入日更早的历史日期是否发生变化；如有变化先不写库，返回差异清单，用户确认后才允许覆盖。 |
|---|
| | | - 导出以源工作簿为底稿，回填库内数据与客运系数；快报按日期生成 Word 并替换模板中的当日、累计、环比和同比内容。 |
|---|
| | | - 记录“前一日”的铁路、民航数据后，假期第 1 日的铁路、民航环比按该数据计算；公路、水路、总人员流动量在第 1 日仍不计算环比。 |
|---|
| | | - 导出以源工作簿为底稿，回填库内数据与客运系数；快报按日期生成 Word，同比固定使用 2025、2024 两年，不使用 2019 数据。 |
|---|
