feat: 技术支持工单/企微权限/开发版本管理/消息推送等迭代
This commit is contained in:
@@ -1,72 +0,0 @@
|
||||
# @dukang/mini-user
|
||||
|
||||
杜康好客 C 端微信小程序(Taro 4 + React)。UI 对齐 `apps/h5-user`。
|
||||
|
||||
## 启动
|
||||
|
||||
```bash
|
||||
# H5 预览(联调 API)
|
||||
pnpm --filter @dukang/mini-user dev
|
||||
# → http://localhost:5177
|
||||
|
||||
# 微信小程序(本地联调,development)
|
||||
pnpm --filter @dukang/mini-user dev:weapp
|
||||
|
||||
# 微信小程序(生产构建 → API: https://api.dukanghaoke.com)
|
||||
pnpm build:mini-user:weapp
|
||||
# 用微信开发者工具打开 apps/mini-user(miniprogramRoot = dist/)
|
||||
```
|
||||
|
||||
## API 地址
|
||||
|
||||
| 环节 | 文件 | 说明 |
|
||||
|------|------|------|
|
||||
| **编译注入** | `config/index.ts` → `defineConstants.TARO_APP_API_ORIGIN` | `dev:weapp` / watch → `localhost:3000`;`build:weapp`(`--mode production`)→ `https://api.dukanghaoke.com`;可用 `VITE_API_TARGET` 覆盖 |
|
||||
| **运行时拼装** | `src/lib/api.ts` → `resolveApiBase()` | `{origin}/api/v1` |
|
||||
|
||||
### 微信登录 `invalid code`
|
||||
|
||||
`wx.login` 的 code 只能由**与小程序 appid 匹配**的后端 `jscode2session` 兑换。
|
||||
|
||||
| 项 | 当前值 |
|
||||
|----|--------|
|
||||
| 小程序 appid | `project.config.json` → `wxda31c8e8e85051e7` |
|
||||
| 后端须配置 | `WX_MINI_APP_ID` / `WX_MINI_APP_SECRET`(与上表一致) |
|
||||
|
||||
**本地联调(不接真实微信)**:保持默认即可(API → `localhost:3000`),并开启 Mock:
|
||||
|
||||
```bash
|
||||
# 终端 1
|
||||
pnpm dev:api # server/.env 保持 MOCK_SMS=true / MOCK_WECHAT=true
|
||||
|
||||
# 终端 2
|
||||
pnpm dev:mini-user # H5 预览 :5177
|
||||
# 或
|
||||
pnpm --filter @dukang/mini-user dev:weapp
|
||||
```
|
||||
|
||||
**连远程 API**:
|
||||
|
||||
```bash
|
||||
$env:VITE_API_TARGET="https://api.dukanghaoke.com"; pnpm --filter @dukang/mini-user dev
|
||||
```
|
||||
|
||||
并在 `api.dukanghaoke.com` 所在服务器配置 `WX_MINI_APP_ID=wxda31c8e8e85051e7` 及对应 AppSecret。
|
||||
|
||||
## 页面结构(18 页)
|
||||
|
||||
**Tab**:首页 / 门店 / 好客权益 / 我的
|
||||
|
||||
**栈页**:商品详情、门店详情、确认订单、收银台、订单列表/详情、地址列表/编辑、客服、权益明细、核销/核销码/成功、登录
|
||||
|
||||
## 布局约定
|
||||
|
||||
- 统一 `PageShell`(`tab` / `scroll` / `sub` / `plain`)注入刘海屏 CSS 变量
|
||||
- Tab 顶栏:`TabMainHeader`;详情滚动顶栏:`PageNavBar`;子页:`SubPageHeader`
|
||||
- 样式:`src/styles/*.css` 按业务域拆分,入口 `app.css`
|
||||
|
||||
## 约定
|
||||
|
||||
- `X-Client-App: USER_MINI`
|
||||
- 底栏原生 `tabBar` + PNG(weapp);H5 内嵌 `UserTabBar`
|
||||
- 交易/核销页面以 UI 壳为主,部分 API 可后续加深
|
||||
Reference in New Issue
Block a user