问题
MKHDNZ0409260700059、MKHDNZ0409260601228 等成品明明有待发货订单,
补货预警却显示 0 单、判为「不预警」,业务反馈到系统。
根因
业务库的订单按渠道拆成**互不重叠的两张表**,而 loadPendingOrderIndex()
只读了 rpt.jst_Orders(京东/京喜/拼多多/抖音/得物/唯品会),
天猫 / 淘宝 / 1688 / 阿里巴巴渠道的待发货需求**全部被漏掉**。
实测(2026-09-19,近 30 天窗口)
- 两表店铺名交集 0(jst_Orders 398 店 vs qmcust 78 店),so_id 交集 5 条,
o_id 交集 **0 条** —— 合并无重复计件风险;
- jst_Orders 里 `shop_name LIKE '%天猫%'` = **0 行**
(不是命名差异:同一品牌在不同平台是不同店铺名,按品牌名反查会误判);
- MKH 成品待发货:仅 jst_Orders = 36 编码 / 50 件 →
合并后 = **40 编码 / 56 件**,补回 4 个编码:
MKHDNZ0409260700059 / MKHDNZ0409260601228 /
MKHDNZ0409260601530 / MKHDNZ0409260700498。
修复
- PENDING_ORDER_TABLE → PENDING_ORDER_TABLES(两张表,新增 qmcust 源);
- Promise.allSettled 并行读取,按 o_id 去重后合并(去重为防御性逻辑);
- 部分源失败时**保留成功源的数据**并透出 degraded=true,用短 TTL 尽快重试,
不再像原先那样单源失败就整表降级为空索引(那会静默漏报全部需求);
- 口径范围:**渠道全并**(2026-09-19 业务确认),含 1688 / 阿里巴巴 /
分销导单专用店铺。
测试
- 新增 2 个回归测试:两张表都读到 + 跨表同 o_id 只计一次 + 组合装不计入;
单源失败时 degraded=true 且成功源数据保留。
- 后端 337 项:336 通过,1 项失败为 Windows 平台固有差异
(resilientSecretStore 断言 0o600,Windows 实际 0o666),与本改动无关。
- 语法检查 151 文件通过。
拼多多自动化运营平台
公开的拼多多业务精简版。欢迎所有人克隆、修改、分发代码并提交 Pull Request,代码按 MIT 许可证开放。
保留商品监控、仪表盘、激励看板、营销活动、推广、商品分析、工单以及在线客户端与执行任务等现有模块。部分菜单仍沿用原项目的占位页面。
已删除市场数据、店铺管理和运营工具整组页面、Claw 对话、skills 管理、平台切换与其他平台演示页,以及对应路由、页面资源、专属配置接口和权限项。首页为仪表盘。保留业务仍使用的模型配置、商品数据查询、桌面会话和自动上架公共服务继续可用;Claw 补全与图搜备用通道已经移除,缺失资料需使用业务接口或手工补充。
本地启动
需要 Node.js 22。团队开发机器无需安装或初始化 MySQL、Redis 及第三方数据库;使用管理员发放的部署 Key,一次注册后自动连接中央系统数据库、公网 TLS Redis 和第三方数据库。完整步骤及安全边界见 远程系统数据库部署。
npm --prefix backend ci
npm --prefix frontend ci
npm run remote:dev
首次启动时填写配置请求地址和部署 Key,系统自动写入被 Git 忽略的本机配置并重启后端。保存一次性显示的管理员账号和密码后直接登录,不需要在本地创建数据库或继续执行设置向导。前端默认访问 http://localhost:5173,API 默认代理到本地后端。
验证与构建
npm --prefix backend run check
npm --prefix frontend run check
前端构建输出位于 frontend/dist。部署时需为单页应用配置路由回退,并代理 /api 与 /cubejs-api 到后端。
启动时会迁移旧侧栏配置,并删除已退役页面的权限、专属设置和专用数据表。上架测算旧偏好表中的商品分析阈值会先迁移到商品分析专用表;其他保留模块的数据不受影响。迁移仅作用于实际配置给此实例的系统数据库。
参与修改
开始开发前请阅读 仓库提交与合并规范(多用户与 AI 开发必读)。准备更新生产服务器时必须继续阅读 服务器部署规范(开发者与 AI 必读)。AI 工具的规则入口为 AGENTS.md。每个任务使用独立目录和分支,通过 PR、同步验证和独立审核合并,禁止强推或覆盖其他开发者的工作。
所有用户均可 Fork 仓库、创建分支并提交 Pull Request。直接推送本仓库需要仓库所有者授予协作者写权限。提交时请说明修改和验证结果,勿提交 .env、密码、令牌、数据库备份或真实业务数据。