# 地磅 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`

- [x] 集合根路径 `/plans` `/inventory` `/weighing` 自动补尾斜杠
- [x] 导出 list/get/related/create/update/delete/void + dashboard 四接口
- [x] CRM/车辆 options（`api/dbOptions.js`）供选择器

### Task 3: 路由与工作台

**Files:**
- Modify: `miniprogram/pages.json`
- Modify: `miniprogram/config/api.js`
- Modify: `miniprogram/config/workbench-menus.js`

- [x] 注册 db 页面；接通 ROUTE_MAP；四菜单 enabled:true

### Task 4: 仪表盘

**Files:**
- Create: `miniprogram/pages/db/dashboard/index.vue`

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

### Task 5: 计划 list + detail

**Files:**
- Create: `miniprogram/pages/db/plans/list.vue`
- Create: `miniprogram/pages/db/plans/detail.vue`

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

### Task 6: 出入库 list + detail

**Files:**
- Create: `miniprogram/pages/db/inventory/list.vue`
- Create: `miniprogram/pages/db/inventory/detail.vue`

- [x] 对齐 H5 主流程（不含 fill/plan 免登录页）

### Task 7: 地磅单 list + detail

**Files:**
- Create: `miniprogram/pages/db/weighing/list.vue`
- Create: `miniprogram/pages/db/weighing/detail.vue`

- [x] 二次过磅、作废、毛皮净重等

### Task 8: 冒烟核对

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

---

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