报名签到小程序开发实战方案

做活动运营的朋友一定深有体会：报名用表单工具，签到用纸质表，最后还要人工把两份数据对上，一场百人活动就能耗掉半天时间。报名签到小程序要解决的核心问题只有一个——让「报名」和「签到」共用同一份数据，并且现场核销足够快。这篇文章聊聊我在实际项目里验证过的一套功能方案。

一、先想清楚三个角色

开发前先把角色拆开，功能边界会清晰很多：

• 参与者：浏览活动、填写报名信息、获取签到凭证、查看自己的报名记录。
• 主办方（运营）：创建活动、配置报名项、查看报名名单、现场核销、导出数据。
• 管理员：多活动管理、权限分配、数据看板。

很多小程序失败在只做了「参与者」这一端，主办方还得靠 Excel 兜底，那还不如不做。

二、核心功能模块拆解

1. 活动创建与配置

主办方需要能自定义的字段比想象中多：活动名称、时间、地点、报名截止时间、人数上限、是否需要审核、报名表单字段（姓名/手机号/公司/自定义问题）、是否收费。建议把表单字段做成可拖拽配置，而不是写死。

{
  "activityId": "act_20240501",
  "title": "产品经理线下沙龙",
  "signupLimit": 120,
  "needAudit": false,
  "formFields": [
    { "key": "name", "label": "姓名", "required": true },
    { "key": "phone", "label": "手机号", "required": true },
    { "key": "company", "label": "公司", "required": false }
  ]
}

2. 报名流程

报名页要尽量短。用户授权手机号后，只填必要字段，提交即生成一条报名记录，并返回一个唯一签到码。签到码建议用短随机串而非自增 ID，避免被猜测。

// 生成签到码
function genCheckinCode() {
  const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZ23456789';
  let code = '';
  for (let i = 0; i < 8; i++) {
    code += chars[Math.floor(Math.random() * chars.length)];
  }
  return code;
}

3. 签到核销（重点）

现场网络往往很差，签到方案必须做降级设计。我一般准备三种方式：

• 扫码签到：主办方扫用户出示的二维码，最快，但依赖网络。
• 数字码签到：用户报 8 位码，工作人员输入核销，网络差时可用。
• 名单勾选签到：工作人员直接在报名列表里点名字，完全离线可用，最后统一同步。

核销接口要做幂等，同一个人重复扫码不能产生两条签到记录，返回「已签到」提示即可。

async function checkin(activityId, code) {
  const record = await db.signup.findOne({ activityId, checkinCode: code });
  if (!record) return { ok: false, msg: '签到码无效' };
  if (record.checkedIn) return { ok: false, msg: '该用户已签到' };
  await db.signup.update(record.id, {
    checkedIn: true,
    checkinTime: Date.now()
  });
  return { ok: true, msg: '签到成功' };
}

4. 数据导出与统计

活动结束后，主办方最需要的是「报名未签到名单」和「已签到名单」两份 Excel。导出功能别藏在三级菜单里，放在活动详情页顶部。统计看板至少要有：报名数、签到数、签到率、实时签到曲线。

三、技术选型建议

• 前端：微信小程序原生或 uni-app。如果只做微信端，原生开发性能更好，扫码 API 更稳定。
• 后端：云开发（CloudBase）足够撑住中小型活动，省去服务器运维。活动量大的话再上自建 Node 服务。
• 数据库：报名表以 activityId + userId 建联合索引，签到查询走 checkinCode 唯一索引。
• 二维码：用短码生成，二维码内容建议是「活动 ID + 签到码」，避免直接暴露用户信息。

四、几个容易踩的坑

1. 重复报名：同一用户对同一活动要限制只能报一次，用唯一索引兜底，别只靠前端判断。
2. 并发超员：人数上限判断要在事务里做，否则最后几个名额容易超。
3. 签到时间窗口：活动开始前 1 小时到结束后 1 小时之外不允许签到，防止提前刷签。
4. 隐私合规：手机号等敏感字段要加密存储，导出时做脱敏，页面需有隐私协议。

五、小结

报名签到小程序的价值不在于功能多，而在于把报名和签到串成一条数据链。把活动配置、报名、核销、导出这四步做扎实，配合离线降级方案，就能覆盖绝大多数线下活动场景。先跑通最小闭环，再根据实际活动反馈加抽奖、分享裂变、电子票等功能，节奏会更稳。