农家乐小程序开发实战：从零到上线

为什么农家乐需要一个小程序？

过去几年，我陆续帮几个做农家乐的朋友做过线上化的尝试。最早是公众号加H5，后来是美团、携程这类平台，但抽成高、用户留不住。直到微信小程序成熟后，我才发现它几乎是农家乐这个场景的天然匹配：用户微信扫码即用，不需要下载，分享到群里也方便，老板还能直接触达客户。

这篇文章我会从产品设计、技术选型到核心功能实现，完整复盘一次农家乐小程序的开发过程。适合有一定前端基础、想接私活或做自己产品的独立开发者阅读。

核心功能拆解

农家乐的业务其实不复杂，但细节很多。我一般把功能拆成四块：

• 展示模块：环境照片、房型/餐位、周边景点、导航地址。
• 预约模块：选择日期、人数、套餐，提交后老板确认。
• 支付模块：定金或全款，微信支付。
• 会员与营销：优惠券、积分、分享有礼、拼团。

其中预约和支付是最容易出问题的环节，下面重点讲。

技术选型

我的建议很直接：原生小程序 + 云开发。农家乐这种项目预算通常不高，云开发能省掉服务器和运维成本，数据库、云函数、存储一站式搞定。如果客户要求后台管理系统，可以用云开发的管理端或者简单搭一个 Node.js 服务。

前端框架方面，原生写法足够，没必要上 uni-app 或 Taro，除非客户明确要 App。原生小程序的性能、调试体验都更好。

预约功能的数据设计

预约的核心是库存和时间的冲突判断。很多新手直接用一个 orders 表存订单，结果经常出现同一间房被重复预订。正确的做法是拆成两张表：

// 库存表 inventory
{
  _id: "room_001_2024-06-01",
  roomId: "room_001",
  date: "2024-06-01",
  total: 5,
  booked: 2
}

// 订单表 orders
{
  _id: "...",
  openid: "...",
  roomId: "room_001",
  date: "2024-06-01",
  count: 1,
  status: "pending" // pending / paid / cancelled
}

下单时在云函数里用事务更新库存，避免并发超卖：

const db = cloud.database()
const _ = db.command

exports.main = async (event) => {
  const { roomId, date, count } = event
  const invId = `${roomId}_${date}`
  return await db.runTransaction(async transaction => {
    const inv = await transaction.collection('inventory').doc(invId).get()
    if (inv.data.total - inv.data.booked < count) {
      throw new Error('库存不足')
    }
    await transaction.collection('inventory').doc(invId).update({
      data: { booked: _.inc(count) }
    })
    const order = await transaction.collection('orders').add({
      data: { roomId, date, count, status: 'pending', createTime: Date.now() }
    })
    return order._id
  })
}

注意云开发的 runTransaction 有调用次数限制，高峰期要做好降级方案。

微信支付接入要点

小程序支付需要先开通微信支付商户号，然后在云开发控制台绑定。核心流程是：小程序端调用云函数下单 → 云函数调用统一下单接口 → 返回支付参数 → 小程序端 wx.requestPayment 拉起支付。

几个容易踩的坑：

• 商户号和小程序的 appid 必须关联。
• 回调地址必须用云函数接收，不要用普通 HTTP 服务，否则容易被拦截。
• 支付成功后一定要在回调里更新订单状态，不能只依赖前端返回。
• 退款接口要单独申请权限。

上线与运营建议

小程序上线后，真正的挑战才开始。我的经验是：

1. 线下引导扫码：在餐桌、房卡、收银台放二维码，扫码领优惠券。
2. 分享有礼：用户分享给好友，双方各得一张券，裂变效果比投广告好。
3. 社群沉淀：把客户拉进微信群，节假日提前发活动。
4. 数据复盘：每周看一次访问来源、转化率、复购率，别凭感觉做决策。

农家乐小程序的本质不是技术炫技，而是把线下熟客关系搬到线上，让老板能反复触达客户。技术只是工具，运营才是核心。

如果你也在做类似项目，欢迎交流。下一篇我会写如何用云开发做一套简单的后台管理系统，把订单、库存、优惠券都管起来。