# 数据源 Schema

数据输入为 Excel 文件，每个工作表（Sheet）代表一个自然日的订单明细数据。

## 工作表命名规则

- 日报数据源：`YYYY年MM月DD日`（如 `2026年04月10日`）
- 脚本通过日期字符串匹配对应工作表

## 字段映射

| Excel 列名 | 内部字段名 | 数据类型 | 说明 |
|-----------|-----------|---------|------|
| 序号 | `seq` | int | 行序号 |
| 目的国家 | `country` | str | 订单目的国家/地区 |
| 合同号 | `contract_no` | str | 唯一合同编号 |
| 用户名称/公司 | `customer` | str | 客户名称 |
| 意向车型及数量 | `product_info` | str | 车型及台数描述 |
| 订单总数量 | `order_qty` | int | 该合同的车辆总台数 |
| 负责人 | `owner` | str | 跟单负责人姓名 |
| 当前状态 | `status` | str | 订单阶段，见下方状态枚举 |
| 拟定合同时间 | `contract_date` | datetime | 合同拟定日期 |
| 跟单天数 | `tracking_days` | int | 从合同拟定到当前日期的天数 |
| 定金支付时间 | `deposit_date` | datetime | 定金支付日期 |
| 订金认领时间 | `deposit_claim_date` | datetime | 订金认领日期 |
| 订单生成时间 | `order_gen_date` | datetime | 订单在系统生成日期 |
| 价格评审时间 | `price_review_date` | datetime | 价格评审完成日期 |
| 合同评审时间 | `contract_review_date` | datetime | 合同评审完成日期 |
| 合同提交盖章申请时间 | `seal_apply_date` | datetime | 盖章申请日期 |
| 合同盖章时间 | `seal_date` | datetime | 合同盖章完成日期 |
| 车辆下线入库状态 | `inventory_status` | str | 车辆生产/入库状态描述 |
| 尾款支付时间 | `final_pay_date` | datetime | 尾款支付日期 |
| 尾款认领时间 | `final_claim_date` | datetime | 尾款认领日期 |
| 智慧关务信息维护 | `customs_date` | datetime | 关务信息维护日期 |
| 许可证办理时间 | `license_date` | datetime | 进口许可证办理日期 |
| 车辆发运时间 | `ship_date` | datetime | 实际发运日期 |
| 预计开票时间 | `invoice_date` | datetime | 预计开票日期 |
| 今日进度更新 | `progress_update` | str | 当日最新进度描述 |
| 是否更新 | `is_updated` | str (是/否) | 当日是否有进度更新 |
| 支持需求 | `support_request` | str | 需要跨部门支持的需求描述 |
| 4月交付 | `deliver_apr` | int | 标记为4月交付的台数 |
| 5月预测 | `forecast_may` | int | 标记为5月预测交付的台数 |

## 订单状态枚举

| 状态代码 | 状态名称 | 说明 |
|---------|---------|------|
| A | 合同拟定中 | 合同尚未盖章确认 |
| B | 已锁定合同待付订金 | 合同已盖章，等待客户支付订金 |
| C | 已付订金待生产 | 订金已到账，等待排产 |
| D | 已生产待付尾款 | 车辆已生产/入库，等待尾款 |
| E | 已付尾款待发运 | 尾款已到账，等待发运安排 |
| F | 已发运 | 车辆已发运 |

## 数据校验规则

1. **必填字段**：`country`, `contract_no`, `order_qty`, `owner`, `status`, `contract_date`
2. `order_qty` 必须为正整数
3. `status` 必须为 A-F 中的一个
4. `is_updated` 只能为 "是" 或 "否"
5. 日期字段若为字符串，尝试按 `YYYY-MM-DD` 解析