dukang/.cursor/skills/dukang-coding/reference-frontend.md

前端速查（preV1 三 H5 + admin-web）

路由事实源：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 覆盖）。

共享包

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