Merge commit 'a0ee3a21cd01229a555384ad5e1f4b3ccdcdd620' into dev_jacy

2026-07-01 19:38:05 +08:00
parent 9cbd65f8d7 a0ee3a21cd
commit a1cbfc7241
23 changed files with 1080 additions and 171 deletions
@@ -2,14 +2,18 @@

 > 路由事实源：[`pages/ROUTE_MAP.md`](../../../pages/ROUTE_MAP.md)

-## App 配置
+## 四 App 概览

-| App | Filter | Dev | X-Client-App |
-|-----|--------|-----|--------------|
-| h5-user | @dukang/h5-user | pnpm dev:user | USER_H5 |
-| h5-shop | @dukang/h5-shop | pnpm dev:shop | SHOP_H5 |
-| h5-partner | @dukang/h5-partner | pnpm dev:partner | PARTNER_H5 |
-| admin-web | @dukang/admin-web | pnpm dev:admin | AdminAuth（内部） |
+| App | 目录 | 端口 | 负责人 | X-Client-App | 原型 |
+|-----|------|------|--------|--------------|------|
+| h5-user | apps/h5-user | 5173 | jacy-dukang | USER_H5 | pages/user/ |
+| h5-shop | apps/h5-shop | 5174 | 刘京尧 | SHOP_H5 | pages/shop/ |
+| h5-partner | apps/h5-partner | 5175 | 刘京尧 | PARTNER_H5 | pages/partner/ |
+| admin-web | apps/admin-web | 5175 | jacy-dukang | HQ_WEB | pages/hq/ |
+
+> **h5-partner 与 admin-web 端口同为 5175**，勿同时 `dev:partner` + `dev:admin`。
+
+Vite 代理：`/api` → `localhost:3000`。

 ## 共享包

@@ -18,42 +22,100 @@ import { OrderStatus, ClientApp } from '@dukang/shared-types';
 import { PageHeader } from '@dukang/shared-ui';
 ```

-## h5-user 主路由（OWNER A）
+H5 三端引用 `@dukang/shared-ui`（`tokens.css`）。admin-web 使用 Ant Design 5，不引用 shared-ui。

-| Route | 页面 | 关键 API |
-|-------|------|----------|
-| `/login` | 登录 | POST /auth/sms/send, /auth/login/sms |
-| `/` | 首页 | GET /catalog/products |
-| `/product/:id` | 详情 | GET /catalog/products/:id |
-| `/order/confirm` | 确认订单 | POST /trade/orders/preview, /trade/orders |
-| `/pay` | Mock 支付 | POST /trade/orders/:id/pay |
-| `/orders` | 5 Taber | GET /trade/orders?tab= |
-| `/benefit` | 权益 | GET /benefit/coupons |
-| `/redeem` | 出码 | POST /redeem/token |
-| `/stores` | 门店 | GET /stores（仅 OPEN） |
+## h5-user 路由（jacy-dukang）

-## h5-shop 主路由（OWNER D）
+| 路由 | Page | 主要 API |
+|------|------|----------|
+| /login | LoginPage | /auth/* |
+| / | HomePage | /catalog |
+| /product/:id | ProductDetailPage | /catalog |
+| /order/confirm | OrderConfirmPage | /trade/orders/preview |
+| /pay | PayPage | /trade/orders/:id/pay |
+| /orders | OrderListPage | /trade/orders?tab= |
+| /orders/:id | OrderDetailPage | /trade/orders/:id |
+| /stores | StoreListPage | /stores |
+| /stores/:id | StoreDetailPage | /stores/:id |
+| /benefit | BenefitPage | /benefit |
+| /benefit/:id | BenefitDetailPage | /benefit/:id |
+| /redeem | RedeemPage | /redeem |
+| /redeem/code | RedeemCodePage | /redeem |
+| /redeem/success | RedeemSuccessPage | — |
+| /addresses | AddressListPage | /user/addresses |
+| /mine | MinePage | /user/me |

-| Route | 页面 | 关键 API |
-|-------|------|----------|
-| `/login` | 登录 | POST /shop/auth/login/sms |
-| `/redeem` | 核销确认 | POST /shop/redeem/confirm |
-| `/records` | 核销记录 | GET /shop/redeem/records |
+### 订单 5 Tab

-## h5-partner 主路由（OWNER B）
+```
+all | pending_pay | pending_ship | pending_receive | completed
+```

-| Route | 页面 | 关键 API |
-|-------|------|----------|
-| `/stores/new` | 录店 | POST /partner/stores |
-| `/stores` | 门店管理 | GET /partner/stores |
-| `/orders` | 辖区订单 | GET /partner/orders |
+## h5-shop 路由（刘京尧）
+
+| 路由 | Page | 主要 API |
+|------|------|----------|
+| /login | LoginPage | /shop/auth/* |
+| / | HomePage | /shop/dashboard |
+| /redeem | RedeemConfirmPage | /shop/redeem/* |
+| /redeem/success | RedeemSuccessPage | — |
+| /records | RecordsPage | /shop/redeem/records |
+| /status | StatusPage | /shop/store |
+| /mine | MinePage | /shop/store |
+
+## h5-partner 路由（刘京尧）
+
+| 路由 | Page | 主要 API |
+|------|------|----------|
+| /login | LoginPage | /partner/auth/* |
+| / | HomePage | /partner/dashboard |
+| /stores | StoreListPage | /partner/stores |
+| /stores/new | StoreCreatePage | /partner/stores |
+| /stores/:id | StoreDetailPage | /partner/stores/:id |
+| /orders | OrderListPage | /partner/orders |
+| /orders/:id | OrderDetailPage | /partner/orders/:id |
+| /center | CenterPage | /partner/me |
+| /center/bills | BillsPage | /partner/settlement/* |
+| /reshipments | ReshipPage | /partner/after-sales/reshipments |
+| /reports/weekly | WeeklyReportPage | /partner/reports/weekly |
+| /leaderboard | LeaderboardPage | /partner/dashboard/leaderboard |
 | — | Mock 推进配送 | POST /partner/orders/:id/mock-advance-delivery |

+## admin-web 路由（jacy-dukang）
+
+| 路由 | Page | 主要 API |
+|------|------|----------|
+| /login | LoginPage | /admin/auth/login |
+| / | DashboardPage | /admin/dashboard |
+| /users | UsersPage | /admin/users |
+| /orders | OrdersPage | /admin/orders |
+| /stores | StoresPage | /admin/stores |
+| /store-accounts | StoreAccountsPage | /admin/store-accounts |
+| /store-media | StoreMediaPage | /admin/store-media |
+| /partners | PartnersPage | /admin/partners |
+| /partner-accounts | PartnerAccountsPage | /admin/partner-accounts |
+| /cities | CitiesPage | /admin/cities |
+| /hq-accounts | HqAccountsPage | /admin/hq-accounts |
+| /benefit/coupons | BenefitCouponsPage | /admin/benefit/coupons |
+| /benefit/ledgers | BenefitLedgersPage | /admin/benefit/ledgers |
+| /redeem-records | RedeemRecordsPage | /admin/redeem-records |
+| /deliveries | DeliveriesPage | /admin/deliveries |
+
+## 端 → API 前缀
+
+| 端 | API 前缀 | NestJS Module |
+|----|----------|---------------|
+| C 端 | /auth, /user, /catalog, /trade, /benefit, /redeem, /stores | iam, catalog, trade, benefit, redeem, store |
+| 门店 | /shop/auth, /shop/redeem, /shop/store | iam, redeem, store |
+| 合伙人 | /partner/* | iam, store, trade, settlement |
+| 总部 | /admin/* | iam, catalog, store, trade, settlement, ops |
+
 ## UI 硬约束

 - C 端订单 **5 Tab**（含 pending_ship）
 - 个人中心无会员等级（V1 不做会员体系）
 - 清香型 4 SKU 可购；酱香/浓香灰态
+- 门店列表仅 `OPEN` 状态
 - 原型只读：`pages/{端}/*/code.html`，勿改原型目录

 ## preV1 与 V2 UI 差异