泡芙萌宠屋微信小程序-泡芙萌宠屋

“泡芙萌宠屋”是一款面向社区宠物美容洗护门店的微信小程序，解决传统门店会员余额难查询、商品信息分散、电话下单易遗漏、配送状态不透明等问题。顾客可在小程序内浏览主粮、零食、洗护及日用品，查看商品详情与库存，加入购物车，授权手机号匹配线下会员，查询余额和消费记录，填写地址并提交订单；商家可在后台维护商品、会员、门店设置和订单，确认会员余额扣款后安排美团、闪送或自配送，并持续更新履约状态。项目将会员运营、零售下单和门店配送整合为一条可落地的业务闭环。

1. 整体采用“微信原生小程序 + 统一 API 适配层 + 微信云函数 + 云数据库”的分层架构。前端由 WXML、WXSS、JavaScript 构建，API 层统一封装 login、products、members、orders、admin、pay 六个核心业务域；后端以云函数承载身份校验、商品、会员、订单和门店配置逻辑，数据落入 users、members、member_logs、products、orders、settings 六类集合。云环境不可用时自动切换本地 Mock，同一套页面可独立演示和联调。

2. 我负责整体架构、顾客端与商家端功能落地。顾客端覆盖首页、商城、商品详情、购物车、结算、订单、会员和个人中心；商家端覆盖经营看板、门店设置、商品上下架、会员档案及流水、订单确认和配送管理。项目共实现 16 个页面、4 个主导航入口，并形成“待确认—已确认—配送中—已完成/已取消”的完整订单状态流。

3. 难点一是线下会员与微信身份的可靠关联。解决方案是以 OpenID 标识用户，仅接受微信官方手机号授权结果匹配会员，并通过 boundOpenid 限制同一会员被多个微信重复绑定；管理员权限同时校验已验证手机号与环境变量/门店配置白名单，避免仅依赖前端角色判断。

4. 难点二是订单、库存和会员余额的一致性。创建订单时由云函数重新读取商品快照、校验上下架与库存、计算配送费并扣减库存，避免前端金额被篡改；确认订单时增加状态与重复扣款保护，生成会员流水后同步余额和累计消费。取消订单会按是否已扣款执行余额退回、退款流水与库存回补，形成可追踪的补偿链路。

5. 难点三是正式云环境与本地演示并行。通过统一调用协议和本地 Mock 数据库复刻商品、会员、订单、扣款、退款及状态变更逻辑，降低云环境未部署或网络异常对开发演示的影响。最终实现从手机号验证、商品浏览、购物车结算到商家确认、会员扣款和配送完成的端到端闭环。