100 lines
3.3 KiB
Markdown
100 lines
3.3 KiB
Markdown
# 地磅 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:** 仅在用户明确要求时提交。
|