# @dukang/mini-user

杜康好客 C 端微信小程序（Taro 4 + React）。UI 对齐 `apps/h5-user`。

## 启动

```bash
# H5 预览（联调 API）
pnpm --filter @dukang/mini-user dev
# → http://localhost:5177

# 微信小程序
pnpm --filter @dukang/mini-user dev:weapp
# 用微信开发者工具打开 apps/mini-user（miniprogramRoot = dist/）
```

## API 地址

| 环节 | 文件 | 说明 |
|------|------|------|
| **编译注入** | `config/index.ts` → `defineConstants.TARO_APP_API_ORIGIN` | 默认 `https://dkapi.runxian.top`；可用环境变量 `VITE_API_TARGET` 覆盖 |
| **运行时拼装** | `src/lib/api.ts` → `resolveApiBase()` | `{origin}/api/v1` |

## 页面结构（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 可后续加深