shanxia2.0/docs/superpowers/plans/2026-09-11-miniprogram-db-from-h5.md

地磅 H5 → miniprogram 实现计划

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 将 mobile-h5 地磅四模块完整迁入 miniprogram，Vant Weapp 视觉对齐 H5，挂在工作台「地磅管理」。

Architecture: api/db.js + dbRequest（裸 JSON）对接 /dashboard|/plans|/inventory|/weighing；pages/db/* 用 Vant Weapp；局部主题 #52B788；登录复用现壳。

Tech Stack: uni-app Vue3、@vant/weapp、现有 utils/request.js Bearer、后端既有地磅 API。

Spec: docs/superpowers/specs/2026-09-11-miniprogram-db-from-h5-design.md

---

文件结构

路径	职责
miniprogram/utils/dbRequest.js	地磅裸 JSON HTTP（尾斜杠、401、detail 错误）
miniprogram/api/db.js	dashboard/plans/inventory/weighing API
miniprogram/api/dbMaster.js	companies/cargos/vehicles 列表（选择器）
miniprogram/styles/db-theme.scss	Vant Weapp / 卡片主题
miniprogram/pages/db/**	四模块页面
miniprogram/pages.json	注册路由 + easycom
miniprogram/config/api.js	PAGE_PATHS + WORKBENCH_ROUTE_MAP
miniprogram/config/workbench-menus.js	地磅四菜单 enabled

---

Task 1: Vant Weapp + 主题

Files:

• Modify: miniprogram/package.json

• Create: miniprogram/styles/db-theme.scss

• Modify: miniprogram/styles/index.scss（按需 import）

• Modify: miniprogram/pages.json easycom

• 安装 @vant/weapp

• easycom: "^van-(.*)": "@vant/weapp/$1/index"

• 写入 #52B788 主题变量与列表卡片基础类

Task 2: dbRequest + API

Files:

• Create: miniprogram/utils/dbRequest.js

• Create: miniprogram/api/db.js

• Create: miniprogram/api/dbMaster.js

• 集合根路径 /plans /inventory /weighing 自动补尾斜杠

• 导出 list/get/related/create/update/delete/void + dashboard 四接口

• CRM/车辆 options（api/dbOptions.js）供选择器

Task 3: 路由与工作台

Files:

• Modify: miniprogram/pages.json

• Modify: miniprogram/config/api.js

• Modify: miniprogram/config/workbench-menus.js

• 注册 db 页面；接通 ROUTE_MAP；四菜单 enabled:true

Task 4: 仪表盘

Files:

• Create: miniprogram/pages/db/dashboard/index.vue

• 统计卡片 + 四组简易条形列表；快捷入口到三列表

Task 5: 计划 list + detail

Files:

• Create: miniprogram/pages/db/plans/list.vue

• Create: miniprogram/pages/db/plans/detail.vue

• 对齐 H5：搜索、日期筛选、卡片操作、关联弹层、生成出入库、删改增

Task 6: 出入库 list + detail

Files:

• Create: miniprogram/pages/db/inventory/list.vue

• Create: miniprogram/pages/db/inventory/detail.vue

• 对齐 H5 主流程（不含 fill/plan 免登录页）

Task 7: 地磅单 list + detail

Files:

• Create: miniprogram/pages/db/weighing/list.vue

• Create: miniprogram/pages/db/weighing/detail.vue

• 二次过磅、作废、毛皮净重等

Task 8: 冒烟核对

• 页面已注册；工作台四菜单已开；README 已更新（请在微信开发者工具实机冒烟）

---

Commits: 仅在用户明确要求时提交。