# 项目长期记忆

## 项目概述
- 项目名：xinlong-shop-taro（Taro 微信小程序商城）
- 技术栈：Taro + React + TypeScript + Tailwind CSS
- 后端 API 前缀：`/shop/`、`/api/`
- 门店店员身份判断：通过 `getMyClerk()` API (`/shop/shop-store-user/my`) 返回值判断
- VIP/分销商申请记录表：`ShopDealerApply`，状态码 10待审核/20通过/30驳回

## VIP 会员机制
- 用户在 `vip-upgrade` 页面提交门店名称和地址申请
- 门店店员在 `vip-review` 页面审核（通过/驳回）
- VIP 会员特权：商品显示 `dealerPrice` 价格，下单使用该价格结算
- VIP 状态判断：`isVipMember()` 从 localStorage 缓存读取，`checkAndCacheVipStatus(userId)` 异步更新

## 商品价格字段约定
- `product.price` - 到手价（主价格）
- `product.salePrice` - 市场价（划掉的）
- `product.dealerPrice` - VIP 会员专享价
- `product.memberStorePrice` - 会员价

## 关键文件位置
- VIP 工具：`src/utils/vip.ts`
- VIP Hook：`src/hooks/useVipStatus.ts`
- VIP 审核页：`src/pages/user/vip-review/index.tsx`
- VIP 升级页：`src/pages/user/vip-upgrade/index.tsx`
- 门店中心：`src/pages/store/center/index.tsx`

## 订阅消息
- 模板 ID：`sh1K9iK7vZjebUNFu6OsMsnsJxm4whThWGrhN7I4zVg`（交易提醒）
- 字段：订单号(`character_string1`)、商品名称(`thing4`)、联系人(`thing10`)、联系电话(`phone_number7`)、送货地址(`thing8`)
- 场景说明：下单提醒
- 新订单检测 Hook：`src/hooks/useNewOrderDetector.ts`（30秒轮询，页面隐藏暂停）
