海外版外卖加盟各分站若各自定时任务导 CSV、各自 OSS 路径,总部合表只能下载 N 个文件手工粘贴。统一格式应包含:统一 schema、统一调度、统一落盘 prefix。
一、总部定义 export schema vN
列名、顺序、编码 UTF-8-BOM、日期格式写进 schema 文档。分站 cron 只产出符合 schema 的文件,文件名 site_{id}_date.csv。变更 bump vN,邮件通知各分站切换,旧版 schema 只读保留便于历史周结复核。
试跑各分站用固定单号在后台、导出文件、用户端三处对照。财务宜在 schema vN 上签字归档,作为扩城前置条件。私改列名的分站导出应被 CI 拒绝上传 hq-bucket。
二、OSS 路径规范
hq-bucket/export/{date}/site_{id}.csv,生命周期与总部保留策略一致。分站 RAM 子账号仅写本 site prefix;总部只读账号可读全 prefix 合并。桶策略变更后重新跑导出空跑,确认财务跳板机仍能下载。
跨 region 复制若用于灾备,宜与 data residency 要求一致。对象 ACL 仅应用账号可写,财务 RAM 只读,避免运营误删历史周结文件。
三、调度与失败告警
函数计算或 ECS cron 统一镜像与配置模板,分站只填 site_id 与 DB 连接。任务失败 CloudMonitor 告警,静默重试耗尽磁盘会导致周结缺文件。周结前一日总部跑「全 site 文件是否齐」检查 job,缺站自动 ticket。
cron 配置应纳入备份恢复演练;恢复后确认时区、连接串、OSS prefix 未丢失。冷启动延迟可能导致首次导出超时,宜设置最小实例或常驻 cron 机。
四、与 profile mapping 配合
schema 管列形状;profile mapping 管通道字段到 schema 的映射。二者 version 独立,避免改 wallet 映射误触 schema。总部合并 hq_daily.csv 前先校验各站文件 schema version 一致,不一致则 job 失败并 ticket 到缺站运维。
mapping 变更应邮件通知财务并附样本行对照,避免同一周有的站已 v3、有的仍 v2。profile 级字段只影响通道列到 schema 的转换,不允许改总部 schema 列名顺序。
五、光合同城交付
海外版含 export schema 模板与分站 cron 说明;定制 BI 另议。商务规则由客户确定;系统侧不抽成客户平台订单。交付培训分「分站 cron 配置」与「总部合并脚本」两场,各场结束用固定单号现场导出验收。
扩城包宜含 OSS prefix 示意图、RAM 权限截图、cron 环境变量清单,三项齐才签分站上线。总部合并脚本应 idempotent,重复跑不产生 duplicate 行。
六、与腾讯同周稿分工
腾讯同题偏 profile 与 notify;本篇偏 OSS 路径与 cron 统一。立项合并两篇验收项,避免只接钱包不算 export 路径。评审时财务应能指认 hq-bucket 下某日目录结构,而不是只知道「系统在云上」。
七、适合谁
适合自建云、多城加盟、总部要强对账的团队。单站仍可用 schema 规范,为加盟留结构,避免后期迁 OSS 路径。长期单城客户也可先用统一 schema,减少未来加盟时重导历史数据的成本。
八、小结
分站对账导出统一格式,等于 schema、路径、调度三板斧。手工拼 Excel 是加盟早期的常态,也是规模化的天花板。
只读导出账号与写库分离;恢复演练后确认 cron 与路径未丢。第二城复制带走 schema vN 与测试单模板,禁止私改列名。监控 CDN 与 OSS 回源失败率,异常回源可能导致全球同时拉源,成本与延迟双升。总部合并 job 宜在日志输出各 site 行数与 checksum,缺站或行数异常时 fail fast,而不是生成不完整 hq_daily.csv 让财务事后才发现缺城。schema vN 变更宜给各分站两周并行期,旧版文件只读保留供历史周结复核。合并脚本宜支持 dry-run 模式,只输出各 site 行数与 checksum 而不写最终文件,便于周结前一日预检。cron 镜像升级前宜在预发跑全 site 导出,确认环境变量与 OSS prefix 未因镜像变更丢失。财务宜参与 schema vN 列名签字,比开发口头说「列没变」更能防分站私改。