烘焙预约小程序 - 技术参考

技术栈、外部服务、微信支付配置、部署与成本估算。

1. 技术栈

组件	技术选型	说明
后端	Cool Admin Node (Midway.js)	API、业务逻辑与数据存储
管理前端	Cool Admin Vue (Vue 3 + Element Plus)	管理后台 + 门店端同一套
小程序	Cool Unix (uni-app)	用户端，微信小程序
数据库	MySQL 8.0	主数据库
文件存储	阿里云 OSS / 腾讯云 COS	核销截图等图片

2. 微信开放能力

能力	用途	文档链接
微信登录	用户认证	developers.weixin.qq.com
手机号获取	绑定手机号	getPhoneNumber 接口
跳转其他小程序	点单入口（客户提供路径）	navigateToMiniProgram 接口
微信支付	订单在线支付（可选）	pay.weixin.qq.com

3. 微信支付配置（可选模块）

如需开通在线支付功能，需完成以下配置：

3.1 微信支付商户信息

商户号 (mchid)

微信支付商户 ID，从商户平台 → 账户中心 → 商户信息获取

APIv3 密钥

用于签名和解密，从商户平台 → API安全 → 设置APIv3密钥

商户证书

apiclient_cert.pem, apiclient_key.pem，从商户平台申请

小程序 AppID / AppSecret

关联小程序信息，从小程序管理后台获取

3.2 后端配置示例

# config/config.prod.yaml
wechat:
  pay:
    mchid: '商户号'
    apiKeyV3: 'APIv3密钥'
    certPath: '/path/to/apiclient_cert.pem'
    keyPath: '/path/to/apiclient_key.pem'
    notifyUrl: 'https://your-domain.com/api/order/notify'

3.3 支付流程

统一下单流程

用户提交订单 → 后端创建订单记录（status=0 待付款）

后端调用微信支付 JSAPI 统一下单接口

返回 prepay_id 等支付参数给小程序

小程序调用 wx.requestPayment() 调起支付

支付回调处理

微信支付结果通知到 notifyUrl

后端验签、解密通知内容

校验订单金额是否匹配

更新订单状态为 status=1（已支付/制作中）

退款流程

用户申请退款 → 订单状态改为 status=5（退款中）

管理员审核通过 → 调用微信退款接口

退款成功 → 订单状态改为 status=6（已退款）

3.4 微信支付相关接口

接口	说明	请求方式
JSAPI 下单	小程序支付下单	POST /v3/pay/transactions/jsapi
查询订单	查询支付状态	GET /v3/pay/transactions/out-trade-no/{out_trade_no}
关闭订单	超时关闭订单	POST /v3/pay/transactions/out-trade-no/{out_trade_no}/close
申请退款	订单退款	POST /v3/refund/domestic/refunds
查询退款	查询退款状态	GET /v3/refund/domestic/refunds/{out_refund_no}

3.5 注意事项

安全提醒

证书安全：商户证书文件需妥善保管，不可提交到代码仓库
回调验签：必须验证微信支付回调的签名，防止伪造通知
幂等处理：支付回调可能重复，需做好幂等处理（根据订单号判断是否已处理）
超时关单：建议订单创建后 15-30 分钟内未支付自动关闭
退款限制：退款金额不能超过订单实付金额，支持全额/部分退款

4. 运营成本预估

项目	说明	费用
云服务器	2核4G 参考	¥500–1500/月
对象存储	核销截图等	¥0–200/月
域名	接口域名	按年摊
SSL 证书	Let's Encrypt 或付费	¥0–500/年

5. 部署方案

后端：Cool Admin Midway → MySQL（+ Redis 可选）
管理端：Cool Admin Vue 静态部署，通过 Nginx 反向代理 API
小程序：微信开发者工具发布，请求配置好的 HTTPS 接口域名

文档版本：v2.0 · 2026-02-25

← 返回文档总览