128 lines
4.7 KiB
Markdown
128 lines
4.7 KiB
Markdown
# 前端速查（preV1 三 H5 + admin-web）
|
||
|
||
> 路由事实源：[`pages/ROUTE_MAP.md`](../../../pages/ROUTE_MAP.md)
|
||
|
||
## 四 App 概览
|
||
|
||
| 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:3010`（可用 `VITE_API_TARGET` 覆盖）。
|
||
|
||
## 共享包
|
||
|
||
```typescript
|
||
import { OrderStatus, ClientApp } from '@dukang/shared-types';
|
||
import { PageHeader } from '@dukang/shared-ui';
|
||
```
|
||
|
||
H5 三端引用 `@dukang/shared-ui`（`tokens.css`）。admin-web 使用 Ant Design 5，不引用 shared-ui。
|
||
|
||
## h5-user 路由（jacy-dukang）
|
||
|
||
| 路由 | 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 |
|
||
|
||
### 订单 5 Tab
|
||
|
||
```
|
||
待付款 | 已付款 (`paid`) | 已完成
|
||
```
|
||
|
||
## 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 端订单 **3 Tab**（`pending_pay` / `paid` / `completed`）
|
||
- 个人中心无会员等级（V1 不做会员体系）
|
||
- 清香型 4 SKU 可购；酱香/浓香灰态
|
||
- 门店列表仅 `OPEN` 状态
|
||
- 原型只读：`pages/{端}/*/code.html`，勿改原型目录
|
||
|
||
## preV1 与 V2 UI 差异
|
||
|
||
| 项 | preV1 | V2 |
|
||
|----|-------|-----|
|
||
| C/合伙人载体 | H5 | 微信小程序 |
|
||
| 总部 | admin-web 内部 | mini-hq 小程序 |
|
||
| 支付页 | Mock 同步成功 | 微信 JSAPI |
|