data-report/generate-data-report-ppt/references/data-schema.md

数据源 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 解析