xyc
3 天以前 de1405ba56db542f64fb8bf5a381a19126837cb2
docs/database.md
@@ -491,7 +491,7 @@
## 九、专项统计-重要节假日模块
> 数据来源与模板:`docs/专项统计/重要节假日/2026年十一数据.xlsx`;快报模板:`docs/专项统计/重要节假日/湖北省国庆假期综合运输客流快报模板.docx`。首次启动会从工作簿初始化 2024/2025 年十一客流、车流数据,并初始化 2024-2026 年客运系数。
> 数据来源与模板:`docs/专项统计/重要节假日/2026年十一数据.xlsx`;快报模板:`docs/专项统计/重要节假日/湖北省国庆假期综合运输客流快报模板.docx`。首次启动会从工作簿初始化 2024/2025 年十一客流、车流数据、2024-2026 年铁路/民航前一日数据、2019 年道路数据,并初始化 2024-2026 年客运系数。
### holiday_calendar 节假日日期配置
| 字段 | 类型 | 说明 |
@@ -500,10 +500,10 @@
| 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 节假日综合运输营业性客流
| 字段 | 类型 | 说明 |
@@ -547,6 +547,8 @@
  - 2026 年普通国省道如填写环比基期,则只影响普通国省道车流量自身环比:填写时按“当日 / 环比基期 - 1”,未填写时按“当日 / 前一日 - 1”;折算人员流动量、总人员流动量等继续按 Excel 原公式计算。2024、2025 历史数据不使用该字段。
  - 公路人员流动量 = 道路营业性客运量 + 非营业性人员流动量。
- 总人员流动量 = 公路 + 铁路 + 民航 + 水路。
- 导入按“年份 + 节假日分类”读取 `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 数据。