每日运行先检查京东日账单、京东钱包和抖音账单的月份覆盖,按旧到新补齐缺口,历史未补齐时暂停拉取新数据。页面回验按京东/京喜各自口径核对,并在服务端已完整但本地状态滞后时回填状态,避免重复导入;上传断开统一进入重试流程。 > 开工时标题使用 `WIP: <任务名称>` 并先填写“任务占用与边界”。Codex 完成独立合并前自审后补齐其余内容并移除 `WIP:`。 ## 任务占用与边界 - 任务名称: - 实际开发者: - 任务来源/团队分工: - 目标结果: - 预计修改路径: - 将写入的公共契约(路由、Controller 方法、Repository、表/视图、`source_key`、`scope`、权限名、菜单键或共享组件): - 仅复用、明确不修改的公共契约: - 数据源、表/视图和字段: - 上游 `source_key` / `scope`: - 权限名、菜单键或共享组件: - 明确不修改的范围: ## 开工碰撞检查 - [ ] Codex 已执行 `scripts/codex-task-preflight.ps1` - [ ] 已检查最新 `main` 和所有远程任务分支 - [ ] 已搜索主线既有页面、接口、Repository 和数据查询 - [ ] 已把“将写入”和“仅复用、不修改”的公共契约分开;仅复用项不作为单独阻断条件 - [ ] 未发现实际写入重叠;或已在下方写明相关分支、具体重叠项和协调结论 相关分支、重叠项与协调结论: ## 实际改动 - 完成内容: - Codex 实际修改的文件: - 新增或变更的公共契约: - 与原计划的差异: ## 验证证据 - 正常流程: - 空数据/错误输入/无权限场景: - 受影响旧功能: - 自动测试及结果: - 实际页面、接口或只读业务查询结果: ## 风险检查 - [ ] 不涉及金额、权限、审批、数据库迁移、生产配置或数据修复 - [ ] 如涉及上述高风险内容,已在下方写明影响、回滚和所需授权 - [ ] 未提交 `.env`、密码、Token、私钥、真实财务数据、生产日志或构建产物 - [ ] 前端改动符合 `DESIGN.md`;无前端改动则写“不适用” 高风险影响、回滚和授权状态: ## 合并前复查 - [ ] 已重新拉取远程引用并用实际修改范围再次运行碰撞检查 - [ ] PR 不再是 `WIP:`,所有测试结果已经补齐 - [ ] Codex 已重新读取原始需求和验收标准,并逐文件审核 `origin/main...任务分支` 的完整 diff - [ ] Codex 自审确认无越界修改、重复实现、敏感内容、未处理冲突和未验证结果 - [ ] 合并顺序不会覆盖其他未合并任务 - [ ] 已授权当前任务的 Codex 执行 Squash merge、验证 `main` 并清理任务分支 - [ ] 如涉及生产迁移、数据修复、删除、覆盖配置或部署,已另行取得对应高风险授权 Reviewed-on: #873
聚胜算每日账单导出(头条放心购 / 京东日账单)
把聚胜算「经营中心 → 平台原始账单[新]」的账单定时导出并导入财务系统(浏览器自动化 + 受控导入)。
平台
-Platform |
胜算页签 | 导入命令 | 财务系统落点 |
|---|---|---|---|
toutiao |
头条放心购 → 资金流水 | business-mirror:import-douyin-authoritative |
账单流水数据 › 店铺收款账户账单 › 抖音账户 |
jd |
京东商城 → 京东日账单 | business-mirror:import-jd-daily |
京东账单 + 京喜账单(一次导入按店铺名拆两边,两边合计恒等于导出行数) |
jd-wallet |
京东商城 → 京东钱包 | business-mirror:import-jd-wallet |
京东网银钱包账户 |
用法
# 三个平台都跑:区间「月初 → 昨日」
pwsh -File scripts\erp-daily-bills\run-erp-daily.ps1
# 只跑京东,补历史月份
pwsh -File scripts\erp-daily-bills\run-erp-daily.ps1 -Platform jd -Through 2026-07-31
# 只跑京东钱包,补历史月份
pwsh -File scripts\erp-daily-bills\run-erp-daily.ps1 -Platform jd-wallet -Through 2026-07-31
# 只导出不导入(排查;仍会做覆盖核查)
pwsh -File scripts\erp-daily-bills\run-erp-daily.ps1 -Platform toutiao -Through 2026-10-05 -SkipImport
- 归期:
--through(默认昨日)所在月份;每月 1 日自动导出上一个整月。 - 先补旧账再拉新账:每次运行先核对
2026-07-01至本次截止日的覆盖情况。发现历史月份缺失、截止日不足、行数或金额不一致时,按月份从旧到新重导并复核;历史补数未通过时,不继续拉取该平台的新日期。 - 每日失败自动顺延:当天任一平台导出、上传或导入失败,不写成功状态;次日覆盖核查会重新发现缺口并优先补齐。
- 无差异跳过:该平台该月已导入且笔数/收入/支出完全一致时跳过导入(
-ForceImport可强制重刷);状态记在runtime/private/erp-exports/imported-state.json。 - 超过胜算同步导出上限(响应
超出同步导出允许最大数据量)时,脚本自动轮询「异步导出下载管理」取回本次任务的全部分片,逐片转 CSV 后合并成一份再导入;仍可用-Start/-Through分段导出。 - 导入前用页面笔数(共 N 条)与导出行数核对,不一致就跳过导入(
-ForceImport可强制),避免只导入一部分。 - 稳定性:导出最多重试 3 次(胜算页面偶发日历面板/授权弹窗异常);上传与"导入+回验"失败自动重试 3 次(含重新上传 CSV),用于吸收服务器 SSH 偶发断连。
- 失败即失败:导出/转 CSV/笔数核对/上传/导入回验任一步失败,都会不写本地状态、不归档,并在结束时以退出码 1 结束(下次运行会重新导入),不会把失败当成功记入
imported-state.json。
覆盖校验
导入后可核对三个数据集在指定区间内是否逐月覆盖到截止日:
docker exec -u www-data caiwu_app php artisan business-mirror:verify-erp-daily-coverage --from=2026-07-01 --to=2026-10-19
命令会逐个月份检查期间起止范围、有效版本行数和登记行数;缺月、只导到月中或行数不一致都会返回失败。
组成
| 文件 | 作用 |
|---|---|
run-erp-daily.ps1 |
统一入口:导出 → 转 CSV → 差异判断 → 上传 → 受控导入 → 页面回验 → 归档 → 日志 |
export-daily.mjs |
浏览器自动化导出(登录、切页签、设日期、查询、导出、取下载直链) |
erp-session.mjs |
胜算登录与会话工具(凭据读 runtime/private/敏感信息.md,可用 ERP_SECRET_FILE 覆盖) |
cdp.mjs |
无依赖的 Edge DevTools Protocol 驱动 |
xlsx-to-csv.py |
导出文件(xlsx)转 UTF-8 CSV,并输出笔数/收入/支出核对数 |
说明
- 导入走财务系统既有受控导入命令(带笔数/收支核对、原子切换、保留旧版本可回滚),不改上游数据。
- 凭据、导出文件、日志都写
runtime/private/(.gitignore忽略),不进仓库。 - 定时:Windows 计划任务每天 09:30 调
run-erp-daily.ps1(京东取昨日;头条取月初→昨日)。