# 山峡化工 · 微信小程序（miniprogram）

基于 [uni-app](https://uniapp.dcloud.net.cn/) 的微信小程序工程。地磅业务 UI 使用自研 `components/db-ui/*`（视觉对齐 mobile-h5 Vant4 主色 `#52B788`）。

> 说明：`@vant/weapp` 依赖微信原生 `Behavior`，在 uni-app H5/Vite 下会报 `Behavior is not defined`，故地磅页不直接引用 Weapp 组件。

## 技术栈

- uni-app（Vue 3 + Composition API）
- Pinia + Vuex（遗留壳）
- 地磅 UI：`components/db-ui`（对齐 Vant 视觉）
- RSA 登录加密 + `utils/request.js` / 地磅 `utils/dbRequest.js`

## 已接通业务：地磅管理

工作台「地磅管理」四菜单（自 `mobile-h5` 迁移）：

| 菜单 | 路径 |
|------|------|
| 仪表盘 | `pages/db/dashboard/index` |
| 计划管理 | `pages/db/plans/*` |
| 出入库管理 | `pages/db/inventory/*` |
| 地磅单管理 | `pages/db/weighing/*` |

- API：`pages/db/api/db.js`（分包内，避免占用主包）→ `/dashboard` `/plans` `/inventory` `/weighing`（裸 JSON）
- 表单选择：`api/dbOptions.js`（CRM 客户/产品 + 运输车辆；主包组件共用）
- 日期工具：`pages/db/utils/dbDate.js`
- 样式：`styles/db-theme.scss`（局部主题，不改全局三墙壳色）
- 仪表盘图表：数字卡片 + 简易条形列表（非 ECharts）

未迁：基础资料/用户管理菜单、免登录第三方填写页。

## 壳页面

登录 / 首页 / 待办 / 工作台 / 我的；CRM / 报销 / 运输菜单仍为灰卡。

## 本地开发

1. HBuilderX 打开 `miniprogram/`（`manifest.json` → `mp-weixin.appid` 已填生产 AppID）
2. 环境开关：只改 `config/env.js` 的 **`APP_ENV`**（勿再单独改地址）
   - `local`：本机 API + 本机 H5
   - `test`：测试门户 API + H5（`121.43.228.102:9911`）
   - `testLocalH5`：测试 API + 本机 H5（仅联调 webview 样式）
   - `production`：生产 `https://w.shanxiachem.com`
3. 启动 `backend/`（local 时）→ 运行到微信开发者工具

上生产时：将 `APP_ENV` 改为 `'production'` 即可，无需再改其它 URL。

### 正式发版上传（微信）

**务必先确认环境，再发行上传**（HBuilderX 不会自动改 `APP_ENV`）：

1. 终端执行 `npm run env:show` 查看当前 `APP_ENV`；或打开小程序看底部彩色条 / 启动弹窗
2. 改为生产：`config/env.js` 中 `export const APP_ENV = 'production'`
3. `npm run release:check-api`（非 production 会直接失败，禁止继续）
4. HBuilderX：**发行 → 小程序-微信**（会压缩 JS）
5. 用发行产物在微信开发者工具中上传

非生产包在登录页 / 工作台 / 我的底部有常驻环境条（本机=红、测试=橙），启动也会弹窗提示。

已配置：`pages/db`、`pages/bx` 分包；`lazyCodeLoading=requiredComponents`；`mp-weixin.setting.minified=true`。

```bash
cd miniprogram
npm install
npm run release:check-api   # 发版前：要求 APP_ENV=production
```

### 生产信息（来自 https://w.shanxiachem.com/）

| 项 | 地址 |
|----|------|
| Web | https://w.shanxiachem.com/ |
| API | https://w.shanxiachem.com/api |
| 静态资源 | https://w.shanxiachem.com/shanxia-static/ |
| MinIO 附件 | https://res.shanxiachem.com/ruoyi |
| 微信 AppID | `wx7db1ddb2a90c9425` |

微信公众平台合法域名请配置：`w.shanxiachem.com`（request / uploadFile / downloadFile）。

设计与计划：`docs/superpowers/specs/2026-09-11-miniprogram-db-from-h5-design.md`、`docs/superpowers/plans/2026-09-11-miniprogram-db-from-h5.md`