XiangPu 香烛小程序

这是“香烛/佛缘香阁”双端小程序项目的源码备份仓库，包含用户端和商家端两个 uni-app / HBuilderX 微信小程序项目。

当前备份时间：2026-05-01。

项目目录

• 香烛用户端-new：用户下单小程序
• 香烛商家端-new：商家管理小程序

注意：实际开发目录在 HBuilderX 项目目录中，后续不要再改旧目录。

• 用户端本地目录：C:\Users\Administrator\Documents\HBuilderProjects\香烛用户端-new\香烛用户端-new
• 商家端本地目录：C:\Users\Administrator\Documents\HBuilderProjects\香烛商家端-new\香烛商家端-new

技术栈

• uni-app / Vue 3
• HBuilderX
• 微信小程序
• uniCloud 阿里云服务空间
• 云对象：products、orders、shop
• 云数据库集合：products、orders、shop_config

已实现功能

用户端

• 首页展示店铺名称、首页展示图、公告、分类、匠心优选商品
• 商品分类页、商品详情页
• 浮动购物车、购物车页
• 确认订单页
  • 支持“送货上门”和“到店自取”
  • 支持省/市/区选择
  • 支持 chooseLocation 辅助填写收货地址
  • 定位失败也允许手动填写地址后下单
• 下单成功页
• 我的订单页
  • 订单标题改为 订单 #后6位
  • 支持取消订单、再次购买、联系商家
• 价格显示支持小数，最多两位小数，整数不强制显示 .00
• iPhone 12 等真机上的右侧贴边、横向溢出、滑动卡顿问题已做多轮修复

商家端

• 商家登录页
• 订单管理页
  • 查看订单
  • 商家处理订单状态：待接单、已接单、配送中、已送达、已完成
  • 显示用户地址和定位提示
• 商品管理页
  • 新增/编辑商品
  • 商品主图和详情图上传
  • 图片本地预览
  • 防止云上传失败后把临时图片保存为正式商品图
  • 价格输入支持小数
  • 支持上架/下架、匠心优选、分类管理入口
• 流水统计页
  • 今日、本月、具体日期统计
  • 日历选择日期
  • 修复“本月/今日”切换状态和日历显示问题
• 店铺设置页
  • 店铺名称、公告、首页展示图、营业时间、客服电话、营业状态
  • 商品分类管理
  • 商家首页左上角标题关联店铺名称
• 多个页面已修复按钮文字不居中、右侧贴边、上下滑动卡顿问题

云函数与数据库

两个项目都包含 uniCloud-aliyun 目录。主要云对象：

• cloudfunctions/products
  • 商品列表、详情、保存、上下架
  • 已加分页/限量读取，避免免费额度下数据库读资源爆掉
• cloudfunctions/orders
  • 创建订单、用户订单、商家订单、更新状态、取消订单
  • 已加分页、时间范围查询、排序失败兜底
• cloudfunctions/shop
  • 获取/更新店铺配置

数据库索引文件：

• orders.index.json
• products.index.json

上线或换云空间后，需要在 uniCloud 控制台确认索引已建好，尤其是：

• orders.create_time
• orders.status + create_time
• orders._openid + create_time
• products.sort + create_time
• products.category + sort + create_time
• products.is_on_sale + sort + create_time

当前重要状态

• 当前项目仍处于本地调试/真机预览阶段，尚未正式上线。
• uniCloud 免费版读操作额度很低，之前出现过 DB read action failed, resource exhausted，原因是数据库每日读 RU 超限。
• 已从代码层面做了分页、限量读取、索引配置，但长期稳定仍需要正确建索引和确认云空间额度。
• 图片上传失败曾出现 uploadFile:fail url not in domain list，原因是微信小程序后台 uploadFile 合法域名 配置错到了用户端小程序，需要给商家端 AppID 配置正确域名。
• 之前对话里暴露过一次 uniCloud ClientSecret，正式上线前建议在 uniCloud 控制台重置。

上线前检查清单

• 微信公众平台确认两个小程序 AppID 是否对应正确：
  • 用户端 AppID
  • 商家端 AppID
• 为两个小程序分别配置服务器域名：
  • request 合法域名
  • uploadFile 合法域名
  • downloadFile 合法域名
• 商家端图片上传必须真机验证成功。
• 在 uniCloud 控制台确认 orders、products 索引已创建。
• 上传部署云对象：
  • products
  • orders
  • shop
• 初始化数据库时不要误点清空或重建已有正式数据。
• 小程序备案。
• 如需线上收款，再申请微信支付商户号。
• 正式上线前重置已暴露过的云空间 ClientSecret。

待完成 / 可优化

• 商家端真实登录与权限控制，目前更偏本地/简化登录。
• 商品、订单、流水列表可继续完善“加载更多/分页 UI”。
• 图片上传成功后可增加更明确的成功提示和云图校验。
• 用户端订单详情页可单独拆出来，当前主要是订单列表展示。
• 可接入订阅消息：用户下单提醒商家、订单状态提醒用户。
• 如需要在线支付，接入微信支付商户号。
• 商家端可增加订单搜索、按日期筛选、导出流水。
• 可增加数据备份和操作日志。

开发注意事项

• 不要改旧目录，当前有效目录都带 -new。
• 不要提交 unpackage/、.hbuilderx/、node_modules/。
• 不要提交任何真实密钥、ClientSecret、访问令牌。
• 前端页面样式修改通常不需要上传云函数，只需 HBuilderX 重新运行。
• 修改 uniCloud-aliyun/cloudfunctions 后，需要重新上传部署对应云对象。
• 修改数据库索引后，需要在 HBuilderX 或 uniCloud 控制台初始化/创建索引。

Git 备份说明

本仓库用于备份当前源码。编译产物不入库。后续新的 AI agent 接手时，建议先读本 README，再查看两个项目的 pages、common、uniCloud-aliyun 目录。