B2C小程序商城-邡乡里集市

立项背景和目标：本地居民购物分散、门店获客与收银工具割裂，亟需统一入口。本项目建设「邡乡里集市」微信小程序，目标是打通线上下单到家与到店扫码付款，服务社区消费者与周边商家，提升本地消费便利性与门店经营效率。

软件功能与核心模块：用户端含首页与分类浏览、搜索秒杀、购物车与预下单、组合支付收银台、订单全生命周期（催单、轨迹、售后）、钱包/优惠券/福币/购物卡、付款码与扫码付、消息中心及商家入驻。商家端含经营首页、商品管理、订单履约（顺丰配送或自行配送）、扫码收款与收款记录、门店设置与账单统计。平台侧统一会员资产与营销能力。

业务流程与功能路径：消费者路径为「发现商品→加购→选择地址与预约送达时段→领用优惠券→提交并支付→查单/催单/确认收货」。到店场景为「出示付款码或扫商家码→支付→核销完成」。商家路径为「上架商品→待配送订单确认配送方式并开始配送→顺丰查看轨迹或自配确认送达；线下则扫用户码完成收银」。两端共用同一小程序，按角色进入对应功能，形成到家与到店闭环。

整体架构与技术栈：采用 uni-app + Vue3 开发微信小程序，UI 使用 uview-plus，状态管理使用 Vuex（用户/商家双 Token 与角色切换）。工程按主包 Tab 页与 home/mine/merchant/user 分包组织，控制包体积。网络层统一封装鉴权与重试，业务接口按用户端、商家端拆分，并通过 normalize 做订单状态、配送类型、分页等数据适配。后端通过 HTTPS 接口交互，关键链路包括预下单算价与预约时段、下单支付、商家开始配送（deliver_type：顺丰/自配）及轨迹查询。

本人负责模块与结果：本人承担本小程序前端主体开发与联调，覆盖用户端与商家端全部业务页面及公共能力。用户端包括首页/分类/搜索秒杀、购物车与预下单支付、订单（催单/轨迹/售后）、钱包与券福币购物卡、付款码与扫码付、消息、地址及入驻等；商家端包括经营首页、商品管理、订单履约（顺丰/自配）、扫码收款与记录、门店设置与账单等。同时完成双端登录鉴权与角色切换、接口封装与数据适配、分包与自定义 TabBar、列表分页与订阅消息等基础能力。成果为打通「线上下单到家」与「到店扫码收银」完整闭环，主流程可联调验收并达到可上线演示标准。

遇到的难点与解决方案：一是送达时段原先前端本地生成，与后端规则不一致，改为以 trade 返回的 booking.dates/slots 为准渲染并提交，避免 booking_time 传汉字导致失败。二是商家开始配送需区分顺丰与自配，列表与详情在确认前增加配送方式选择，自配无轨迹走完成配送，顺丰保留轨迹与联系骑手。三是双端 Token 与角色切换易串号，采用用户/商家 Token 分槽存储并按角色切换当前凭证。四是分页与 iOS 滚动高度异常，统一 adaptPageList/useList 触底逻辑，并对 scroll-view 做 flex 高度适配，保证列表可继续加载。