feat: 启用运营分析模块，新增模块化库存监控与 MKH-BOM 资料 #6

yanhui · 2026-09-15T16:54:37+08:00

yanhui commented

2026-09-15 16:54:37 +08:00

目的与范围

解决的问题：此前被列入退役名单的运营分析类页面（商品监控、激励看板、营销活动、推广模块、商品分析）不可用；同时缺少「模块化库存监控」及其「配件库存监控」「MKH-BOM资料」子页面。
修改的模块/文件：后端路由/服务/定时任务、前端页面与 API 封装、侧边栏与路由配置、系统设置项、测试与文档，共 66 个文件（+13379 / -483）。
是否使用 AI 及负责开发者：由 AI 辅助开发，负责开发者 yanhui。

同步与兼容性

起始基线 SHA：8448f7a0e849ac04c7f572bb3fb1fa89765c0945
最近同步的 main SHA：8448f7a0e849ac04c7f572bb3fb1fa89765c0945（推送前已 git fetch，主分支无新提交，未产生 merge）
待审核任务分支 SHA：445347e664a555cdc8bc2a0a7c488f111db2039e
并行 PR、共享接口、迁移/配置影响：
- 新增 3 个迁移脚本，均为 CREATE TABLE IF NOT EXISTS 形式，未修改任何已执行的历史迁移
- 新增数据源读取逻辑（database_configs.name = 'product_information_database'，PostgreSQL），凭据仅从系统库配置读取、不落代码；未配置时接口返回 503 并给出可读提示
- 侧边栏新增一级/二级菜单，并对存量侧边栏配置做兼容合并（激励看板由分组内提升为顶层入口，保留原标签/排序的迁移规则）
- 移除 /api/dashboard 路由，仪表盘预览页改用 /api/productAnalysis；已确认前端不再存在 /api/dashboard 引用
冲突及处理理由：无冲突（基于最新 main 创建任务分支后直接提交）
如何确认保留了其他开发者的已有行为：
- 推送前发现工作区中 AGENTS.md、仓库提交与合并规范.md、服务器部署规范.md 三份文档存在对已合并内容（提交 d726dfd 的《数据表、索引与映射负载要求》）的回退。已整体还原为 origin/main 版本，不纳入本次提交，避免撤销他人已合并的规范
- 已逐项核对全部 66 个文件的差异，未发现撤销他人逻辑、丢失依赖或在役配置项的情况

验证

实际执行的命令及结果：
- 前端：npm --prefix frontend run check 等价三步 —— lint 通过、test 16/16 通过、build 通过（含 verify-planning-entry 校验）
- 后端：node scripts/check-syntax.js → 149 个文件通过；逐文件 node --test test/*.test.js → 38/39 通过
未运行或失败的检查及原因：
- resilientSecretStore.test.js 失败 1 项：断言密钥备份文件权限为 0o600，Windows 下 chmod 无法表达该权限（实际 0o666）。属既有的平台相关失败，本次未修改该文件，Linux CI 不受影响
- 本机 frontend/ 下存在未纳入版本库的旧依赖备份目录 node_modules_old_*，会被 ESLint 全量扫描（产生十余万条第三方报错）。因此 lint 步骤以 --ignore-pattern node_modules_old_*/** 排除该目录后执行，其余步骤与仓库 check 完全一致
- 未连接生产库执行任何迁移；迁移脚本仅随代码提交，实际执行按《服务器部署规范》在部署环节进行
顺带修复的真实缺陷：retiredRoutes.test.js 原本用 parent.filename.endsWith('/api/planningUpload.js') 判断是否注入 mock。Windows 下 filename 为反斜杠路径，该判断恒为 false，导致 mock 全部失效、真实模块去连中央系统库而挂起超时（Linux CI 上正常）。已改为平台无关的路径匹配，该测试由「90s 超时」变为「1.5s 通过」
人工验证路径：本地启动前后端，进入「模块化库存监控 → 配件库存监控 / MKH-BOM资料」核对字段口径、预警与 A4 打印模板；进入「营销管理」「商品管理」「激励看板」等页面核对数据加载

风险与回退

已知风险：
1. 本次恢复启用的运营分析页面依赖中央系统库与业务库数据，首次访问可能触发较重的远程查询
2. MKH-BOM 的配件明细目前在产品资料系统数据库中仅匹配到 1 条编码（MKH-DNZ0384），其余商品需上游补录 componentDetails 后才完整；页面已对该编码做置顶展示，不阻塞其余商品
3. 产品资料系统数据库需在「系统设置 - 数据库配置」中完成配置，否则相关页面提示未配置
回退方式：整体 revert 本次提交即可恢复原有退役状态。新增表均为 CREATE TABLE IF NOT EXISTS，回退代码不影响已有数据；本次无破坏性数据变更。

提交身份：在本机未配置 git 身份的情况下，使用账号 yanhui 的提交身份（yanhui <2353496031@qq.com>，取自仓库平台账号信息），通过 git -c user.name/user.email 临时指定，未修改任何仓库或全局 git 配置。

推送路径说明：当前推送账号 yanhui 对 lunanting/cangku 无写入权限（pre-receive hook declined: User permission denied for writing），故按《仓库提交与合并规范》第 2/4 节的 Fork 流程，推送至 Fork yanhui/cangku 后发起本 PR。

## 目的与范围 - **解决的问题**：此前被列入退役名单的运营分析类页面（商品监控、激励看板、营销活动、推广模块、商品分析）不可用；同时缺少「模块化库存监控」及其「配件库存监控」「MKH-BOM资料」子页面。 - **修改的模块/文件**：后端路由/服务/定时任务、前端页面与 API 封装、侧边栏与路由配置、系统设置项、测试与文档，共 66 个文件（+13379 / -483）。 - **是否使用 AI 及负责开发者**：由 AI 辅助开发，负责开发者 yanhui。 ## 同步与兼容性 - **起始基线 SHA**：`8448f7a0e849ac04c7f572bb3fb1fa89765c0945` - **最近同步的 main SHA**：`8448f7a0e849ac04c7f572bb3fb1fa89765c0945`（推送前已 `git fetch`，主分支无新提交，未产生 merge） - **待审核任务分支 SHA**：`445347e664a555cdc8bc2a0a7c488f111db2039e` - **并行 PR、共享接口、迁移/配置影响**： - 新增 3 个迁移脚本，均为 `CREATE TABLE IF NOT EXISTS` 形式，未修改任何已执行的历史迁移 - 新增数据源读取逻辑（`database_configs.name = 'product_information_database'`，PostgreSQL），凭据仅从系统库配置读取、不落代码；未配置时接口返回 503 并给出可读提示 - 侧边栏新增一级/二级菜单，并对存量侧边栏配置做兼容合并（激励看板由分组内提升为顶层入口，保留原标签/排序的迁移规则） - 移除 `/api/dashboard` 路由，仪表盘预览页改用 `/api/productAnalysis`；已确认前端不再存在 `/api/dashboard` 引用 - **冲突及处理理由**：无冲突（基于最新 main 创建任务分支后直接提交） - **如何确认保留了其他开发者的已有行为**： - 推送前发现工作区中 `AGENTS.md`、`仓库提交与合并规范.md`、`服务器部署规范.md` 三份文档存在对**已合并内容**（提交 `d726dfd` 的《数据表、索引与映射负载要求》）的回退。已整体还原为 `origin/main` 版本，**不纳入本次提交**，避免撤销他人已合并的规范 - 已逐项核对全部 66 个文件的差异，未发现撤销他人逻辑、丢失依赖或在役配置项的情况 ## 验证 - **实际执行的命令及结果**： - 前端：`npm --prefix frontend run check` 等价三步 —— lint 通过、test 16/16 通过、build 通过（含 `verify-planning-entry` 校验） - 后端：`node scripts/check-syntax.js` → 149 个文件通过；逐文件 `node --test test/*.test.js` → **38/39 通过** - **未运行或失败的检查及原因**： - `resilientSecretStore.test.js` 失败 1 项：断言密钥备份文件权限为 `0o600`，Windows 下 `chmod` 无法表达该权限（实际 `0o666`）。属**既有的平台相关失败**，本次未修改该文件，Linux CI 不受影响 - 本机 `frontend/` 下存在**未纳入版本库**的旧依赖备份目录 `node_modules_old_*`，会被 ESLint 全量扫描（产生十余万条第三方报错）。因此 lint 步骤以 `--ignore-pattern node_modules_old_*/**` 排除该目录后执行，其余步骤与仓库 `check` 完全一致 - 未连接生产库执行任何迁移；迁移脚本仅随代码提交，实际执行按《服务器部署规范》在部署环节进行 - **顺带修复的真实缺陷**：`retiredRoutes.test.js` 原本用 `parent.filename.endsWith('/api/planningUpload.js')` 判断是否注入 mock。Windows 下 `filename` 为反斜杠路径，该判断恒为 `false`，导致 mock 全部失效、真实模块去连中央系统库而**挂起超时**（Linux CI 上正常）。已改为平台无关的路径匹配，该测试由「90s 超时」变为「1.5s 通过」 - **人工验证路径**：本地启动前后端，进入「模块化库存监控 → 配件库存监控 / MKH-BOM资料」核对字段口径、预警与 A4 打印模板；进入「营销管理」「商品管理」「激励看板」等页面核对数据加载 ## 风险与回退 - **已知风险**： 1. 本次恢复启用的运营分析页面依赖中央系统库与业务库数据，首次访问可能触发较重的远程查询 2. MKH-BOM 的配件明细目前在产品资料系统数据库中仅匹配到 1 条编码（`MKH-DNZ0384`），其余商品需上游补录 `componentDetails` 后才完整；页面已对该编码做置顶展示，不阻塞其余商品 3. 产品资料系统数据库需在「系统设置 - 数据库配置」中完成配置，否则相关页面提示未配置 - **回退方式**：整体 revert 本次提交即可恢复原有退役状态。新增表均为 `CREATE TABLE IF NOT EXISTS`，回退代码不影响已有数据；本次无破坏性数据变更。 --- 提交身份：在本机未配置 git 身份的情况下，使用账号 `yanhui` 的提交身份（`yanhui <2353496031@qq.com>`，取自仓库平台账号信息），通过 `git -c user.name/user.email` 临时指定，**未修改任何仓库或全局 git 配置**。推送路径说明：当前推送账号 `yanhui` 对 `lunanting/cangku` 无写入权限（`pre-receive hook declined: User permission denied for writing`），故按《仓库提交与合并规范》第 2/4 节的 Fork 流程，推送至 Fork `yanhui/cangku` 后发起本 PR。

yanhui added 1 commit 2026-09-15 16:54:37 +08:00

feat: 启用运营分析模块，新增模块化库存监控与 MKH-BOM 资料 445347e664

本次将此前被列入退役名单的运营分析相关模块恢复为可用，并新增「模块化库存监控」
一级菜单及其两个子页面。

主要变更：
1. 恢复启用：商品监控、激励看板、营销活动、推广模块、商品分析
   - retiredFeatures 移出对应退役名单与清表语句，改为正常保留
   - 补齐后端路由、前端页面与 API 封装、侧边栏配置、桌面客户端能力项
   - 同步更新 retiredFeatures / retiredRoutes / retiredNavigation / desktopSessionService 测试
2. 新增「模块化库存监控」一级菜单
   - 配件库存监控：仅取「简尚-崔桥工厂半成品包装项目仓」SKU 的实时库存、
     当日入库/出库、近 7 日日均发货量、库存可用天数与预警（库存可用天数 ≤ 7 预警）
   - MKH-BOM资料：按商品编码展示配件明细、数量、仓位、库存，支持 A4 纵向打印
3. 新增产品资料系统数据库（PostgreSQL）连接模块：读取系统库 database_configs 中
   name = product_information_database 的配置，凭据只从配置读取，不落代码
4. 新增系统设置页配置项：商品标签配置、部门商品标签配置、部门SKU负责人配置
5. 旧 /api/dashboard 接口迁移至 /api/productAnalysis，仪表盘预览页改用新接口，
   相应移除 dashboard 路由模块及其测试
6. 修复 retiredRoutes 测试在 Windows 下挂起超时的问题：该测试用
   parent.filename.endsWith('/api/planningUpload.js') 判断是否注入 mock，
   而 Windows 的 filename 为反斜杠路径，导致判断恒为 false、mock 全部失效、
   真实模块去连中央系统库而挂起（Linux CI 正常）。改为平台无关的路径匹配。
7. .gitignore 忽略本地验证产物（outputs/、.git-status.txt）

验证：
- 前端：lint / test（16 项）/ build（含 planning entry 校验）全部通过
- 后端：语法检查 149 个文件通过；测试 38/39 通过
- 已知未通过项：resilientSecretStore.test.js 断言密钥备份文件权限为 0o600，
  Windows 下 chmod 无法表达该权限（实际为 0o666），属既有的平台相关失败，
  与本次改动无关，本次未修改该文件
- 说明：本机 frontend/ 下存在未纳入版本库的旧依赖备份目录 node_modules_old_*，
  会污染 ESLint 扫描（十余万条第三方报错），故 lint 步骤以
  --ignore-pattern node_modules_old_*/** 排除后执行，其余步骤与仓库 check 一致

未提交内容：本地验证截图 outputs/ 与 .git-status.txt 已被 .gitignore 排除。

yanhui merged commit 4c2ebef988 into main

2026-09-16 13:49:36 +08:00

yanhui referenced this issue from a commit

2026-09-16 13:49:36 +08:00

Merge pull request 'feat: 启用运营分析模块，新增模块化库存监控与 MKH-BOM 资料' (#6) from yanhui/codex/yanhui-operation-modules-001 into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: lunanting/cangku#6