gxwebsoft/xinlong-shop-taro
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
e39eebbf1cb5c3bf99e46faee99d2b6b04e4025c
xinlong-shop-taro/.workbuddy/memory/MEMORY.md
赵忠林 d6d6b1f5a7 feat(user): 使用微信原生 Picker 替换所在地选择弹层 
- 删除 NutUI Address 相关导入、状态及地区数据转换逻辑
- 新增派生 regionValue 用于绑定微信原生 Picker 的 value
- 将 handleRegionChange 调整为处理微信 Picker 的事件
- 将所在地选择 UI 修改为微信原生 Picker 包裹的视图结构
- 地图定位失败使用弹窗提示，引导用户手动选择或重试
- 移除手动打开地区选择器的函数及 NutUI 组件
- 保留 RegionData 用于文本智能识别解析
- 编译通过，提升在无地图或无权限环境下的地区选择稳定性
2026-07-13 08:16:17 +08:00

2.7 KiB
Raw Blame History

项目长期记忆

项目概述

  • 项目名：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秒轮询，页面隐藏暂停）

分享 / 朋友圈能力（2026-07-13 接入）

  • 统一封装：src/hooks/useShare.ts（useShare({title, path?, query?, imageUrl?})，内部一次注册 useShareAppMessage + useShareTimeline，并自动在 path/query 追加 inviter=${当前用户id} 做裂变归因；isTimelineSinglePage() 判断朋友圈单页模式 scene===1154）
  • 海报组件：src/components/SharePoster/index.tsx（Canvas 2D 绘制封面+标题+价格+小程序码，返回临时图路径作 imageUrl）
  • 小程序码接口：src/api/share.ts generateShareCode(page, inviterId) 复用 generateMiniProgramCode（scene 用 uid_${inviterId}，page 透传但后端需读取转发才生效）
  • 裂变约定：分享链接 query 用 inviter，与 src/utils/invite.ts 的 parseInviteParams 读取字段一致
  • 已接入页面：商品详情、积分商品、拼团、秒杀、活动、赛事（带 canvas 海报）；邀请下级、分销推广、升级VIP、分享赚佣金（仅 enableShare + useShare，无海报）
  • 注意：tabBar 4 页（首页/分类/订单/我的）不支持朋友圈分享；朋友圈分享必须真机测试（开发者工具无预览）