yanhui
be52bdd0b5
需求：配件库存监控、MKH-BOM 资料两个页面各加一个同步按钮，任何时候点击都能 立即拉取最新数据，不必等凌晨 00:00 的定时刷新。 后端： - mkhBomService 新增 clearMkhBomCache()：清空本页全部服务端缓存 （businessBom / officialBomIndex / officialBomDetail / productBom / mkhProduct / replenishIndex / workOrderIndex / pendingOrderIndex / componentStock / componentLocation），返回 syncedAt + 各缓存清除条目数。 - modularStockMonitorService 新增 syncModularStock()：本页无进程内缓存 （每次请求直连副本库），同步动作 = 重新解析并返回最新监控日，前端据此重拉列表。 - 新增接口 POST /api/mkh-bom/sync、POST /api/modular-stock-monitor/sync。 前端： - api/mkhBom.js 新增 syncMkhBom；api/modularStockMonitor.js 新增 syncModularStock。 - 两个页面工具栏各加「同步最新数据」主按钮（SyncOutlined，带 loading 态）， 点击 → 调后端 sync → 成功后重新拉列表（MKH-BOM 页同时清空展开明细缓存 detailCache，避免看到旧的配件明细）→ 提示「已同步最新数据」； 失败时展示后端返回的错误信息。 口径说明（重要）： - 两页数据来自副本库 JSReportReplica，由上游聚水潭同步；应用层无法触发上游拉取。 本按钮的作用是「清服务端缓存 + 直连副本库重取最新」，保证看到的不是 2~15 分钟前的缓存结果，而不是重新跑一遍上游同步。 - 后端已内置的 dailyRefresh（cron 0 0 * * *，Asia/Shanghai）刷的是 summary_daily_* / summary_monthly_* 汇总表，不覆盖这两页数据源， 与本按钮既不重复也不冲突，可并存。 验证： - 后端 4 个改动文件 node --check 全部通过。 - 前端 4 个改动文件（含 2 个 jsx）用 @babel/parser 解析全部通过。 - 实测：syncModularStock 返回 monitorDate=2026-09-16； clearMkhBomCache 返回 syncedAt 与各缓存清除条目数。 - 单测 mkhBomService.test.js 40/40 通过，无回归。 - 前端 lint/build 未运行：frontend/node_modules 仍是之前被中断 npm ci 破坏的 坏目录（frontend/node_modules_broken_0917/，未纳入提交）。 合并前需在本机 npm ci 恢复后，打开两个页面确认按钮渲染与点击效果。 - 后端改动需重启服务后才生效。
拼多多自动化运营平台
公开的拼多多业务精简版。欢迎所有人克隆、修改、分发代码并提交 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、密码、令牌、数据库备份或真实业务数据。