登录页面

apps/mini-user/README.md

@@ -1,6 +1,6 @@
 # @dukang/mini-user
 
-杜康好客 C 端微信小程序（Taro 4 + React）。
+杜康好客 C 端微信小程序（Taro 4 + React）。UI 对齐 `apps/h5-user`。
 
 ## 启动
 
@@ -19,27 +19,22 @@ pnpm --filter @dukang/mini-user dev:weapp
 | 环节 | 文件 | 说明 |
 |------|------|------|
 | **编译注入** | `config/index.ts` → `defineConstants.TARO_APP_API_ORIGIN` | 默认 `https://dkapi.runxian.top`；可用环境变量 `VITE_API_TARGET` 覆盖 |
-| **运行时拼装** | `src/lib/api.ts` → `resolveApiBase()` | `{origin}/api/v1`，例如 `https://dkapi.runxian.top/api/v1` |
+| **运行时拼装** | `src/lib/api.ts` → `resolveApiBase()` | `{origin}/api/v1` |
 
-本地联调 API（`localhost:3000`）时，启动前设置环境变量并重新编译：
+## 页面结构（18 页）
 
-```powershell
-$env:VITE_API_TARGET = "http://localhost:3000"
-pnpm dev:mini-user:weapp
-```
+**Tab**：首页 / 门店 / 好客权益 / 我的
 
-微信小程序还需在公众平台配置 request 合法域名：`dkapi.runxian.top`。
+**栈页**：商品详情、门店详情、确认订单、收银台、订单列表/详情、地址列表/编辑、客服、权益明细、核销/核销码/成功、登录
+
+## 布局约定
+
+- 统一 `PageShell`（`tab` / `scroll` / `sub` / `plain`）注入刘海屏 CSS 变量
+- Tab 顶栏：`TabMainHeader`；详情滚动顶栏：`PageNavBar`；子页：`SubPageHeader`
+- 样式：`src/styles/*.css` 按业务域拆分，入口 `app.css`
 
 ## 约定
 
-- `X-Client-App: USER_MINI`（与 `USER_H5` 共用用户端 API；JWT 与 Header 一致）
-- 功能对照源：`apps/h5-user` + `pages/user/` 原型
-- 底栏使用本地 PNG 图标（weapp 无法加载 Google Material 字体）
-- Tab 页：`navigationStyle: custom` + `TabMainHeader`，对齐 h5 浅色顶栏
-
-## 迁移路线（建议）
-
-1. 登录（短信 → 小程序 `wx.login` + 手机号组件）
-2. 商品详情 / 下单 / 支付
-3. 订单 3 Tab、权益、核销码
-4. 地址管理、门店详情
+- `X-Client-App: USER_MINI`
+- 底栏原生 `tabBar` + PNG（weapp）；H5 内嵌 `UserTabBar`
+- 交易/核销页面以 UI 壳为主，部分 API 可后续加深