小程序预约功能需求文档模板

小程序预约功能需求文档模板一、文档概述1.1编写目的本文档旨在明确小程序预约功能的业务逻辑、功能需求、数据规则、接口要求及验收标准，为产品设计、技术开发、测试验收及后期运营提供统一依据。文档中所有需求项均需在开发阶段被完整实现，测试阶段逐项验证通过后方可上线。1.2适用范围本模板适用于具备预约属性的服务类小程序，涵盖医疗挂号、场馆预订、课程报名、政务办事、美容美发等场景。不同业务领域可根据实际服务内容对功能模块进行裁剪或扩展，但核心流程与规则框架应保持一致。1.3术语定义①预约：用户通过小程序提前选择服务项目、服务时间并提交申请，系统确认后生成预约单的过程。②预约时段：服务提供方开放的可被预约的最小时间区间，例如每15分钟或每30分钟为一个时段。③爽约：用户未按预约时间到场且未提前取消的行为。④改约：用户对已生效的预约单变更服务时间或服务项目的操作。⑤资源库存：某一服务项目在特定时段内可提供的预约名额数量。二、业务需求2.1业务目标预约功能的核心目标在于通过线上化手段实现服务资源的合理分配，减少用户现场排队等待时间，提升服务资源的利用效率。业务指标设计应包含：预约转化率、爽约率、时段满约率、用户平均操作时长等。上线后前3个月重点关注时段满约率与爽约率，预期时段满约率不低于70%，爽约率控制在5%以内。2.2用户角色①普通用户：通过小程序浏览服务项目、选择时段、提交预约、查看记录、取消或改约。②服务提供方工作人员：管理可预约项目、设置排班与放号规则、核销预约单、处理异常预约。③系统管理员：负责账号权限配置、基础数据维护、预约规则参数调整及数据查看。2.3总体流程预约整体流程划分为三个阶段：预约前、预约中、预约后。①预约前：服务提供方配置可预约项目、时段资源、预约限制条件；用户进入小程序查看服务详情与可约时段。②预约中：用户选择项目与时段，填写必要信息，提交预约申请，系统完成校验并锁定名额，生成预约单。③预约后：系统发送预约成功通知，用户在预约时间前收到提醒，到场后由工作人员核销，服务完成后可进行评价。三、功能需求3.1用户端功能3.1.1服务项目浏览用户进入小程序后，应能查看可预约服务项目的列表与详情。列表页需展示项目名称、服务时长、可约状态、剩余名额等关键信息。详情页除基本信息外，还应展示服务内容说明、预约规则、取消规则、注意事项。服务项目列表默认按可约时间从近到远排序，同时支持按项目类型筛选。每个项目卡片需明确标注“可约”“约满”“暂停”三种状态，状态判断依据为：该服务是否存在未来7天内未被约满的时段；若所有可约时段均无库存，则显示“约满”；若被管理员手动暂停，则显示“暂停”。3.1.2预约时段选择用户确定服务项目后，进入时段选择页面。该页面以日历形式展示未来7天的日期，用户选择某一天后，下方展示该日期下所有可预约时段。时段展示粒度由服务提供方在后台配置，默认为15分钟或30分钟，需支持自定义。每个时段需标注剩余名额数量。当剩余名额为0时，该时段置灰且不可点击。用户一次预约仅能选择一个时段，若服务项目支持连选多个连续时段，则需在项目配置中单独开启该权限，用户选择起始时段后自动识别连续区间。业务规则：①预约提前时间不得少于2小时，即用户只能预约当前时间2小时之后的时段。例如当前时间为10时整，用户最早可预约12时整的时段。②用户单日对同一服务项目的预约次数不得超过3次，且同一时段不可重复预约。③预约截止时间为时段开始前2小时，超过该时间后对应时段关闭预约入口。3.1.3预约信息填写用户选定时段后进入信息填写页面，需填写或确认以下信息：①预约人信息：默认拉取用户在小程序平台绑定的实名信息，包括姓名、手机号。若未绑定，需引导用户完成绑定。②预约备注：非必填项，设置字数上限为100字，仅允许输入中文、英文、数字及常用标点。③到访人数：若服务项目支持多人预约，需填写到访人数，人数上限由服务提供方在项目中设置，默认上限为1人。超过上限时系统提示“到访人数超过该服务单次允许上限”。④协议确认：页面底部需展示《预约服务须知》勾选项，用户需勾选同意后方可提交。须知内容可在后台配置，默认包含预约取消规则、爽约处理规则、个人信息使用说明。3.1.4预约提交与确认用户点击“提交预约”后，系统执行以下校验步骤：第一步：校验用户身份状态。若用户账号存在异常（如被限制预约），则终止提交并提示原因。第二步：校验时段库存。再次查询该时段剩余名额，若库存为0，则提示“该时段已约满，请选择其他时段”，并返回时段选择页。第三步：校验预约限制条件。包括但不限于用户当日预约次数、历史爽约次数、同一时段重复预约等。若触发限制，给出明确提示。第四步：锁定名额并生成预约单。系统将预约单状态置为“待核销”，扣减时段库存，生成唯一预约编号。预约编号规则为4位年+2位月+2位日+6位随机数字，如20250812345678。第五步：发送预约成功通知。通知包含服务名称、预约时间、预约编号、取消规则。确认页面需展示完整的预约信息，用户可在提交成功后查看预约详情，并支持一键添加到系统日历。3.1.5预约记录管理用户进入“我的预约”页面，可查看全部预约记录。记录默认按预约日期从近到远排序，支持按状态筛选，状态包括：待核销、已完成、已取消、已爽约。每条记录展示：服务名称、预约日期与时段、预约编号、当前状态、操作入口。不同状态下操作入口不同：待核销状态下提供“取消预约”和“改约”入口；已取消状态下无操作入口；已完成状态下可查看核销时间与服务评价入口。用户点击某条记录进入详情页，详情页展示完整信息，并支持再次查看预约须知。3.1.6取消与改约取消规则：①用户可取消预约的时间窗口为时段开始前1小时以上。例如预约时段为14时00分，用户最晚可在13时00分前取消。超过该时间后，“取消预约”按钮置灰，不可操作。②用户在30天内累计取消次数不得超过5次，超过后系统自动限制其未来7天的预约资格。③取消后系统立即释放该时段名额，并发送取消成功通知。改约规则：①改约等同于先取消原预约再重新预约新时段。用户发起改约时，系统先校验原预约是否满足取消条件（时段开始前1小时以上），再校验新时段是否满足预约条件。②改约操作在用户一次提交中完成，系统不产生新的预约编号，原预约编号保持不变，但需更新时段与状态。③用户每次预约仅允许改约1次，改约后不可再次改约。3.1.7消息通知小程序预约功能需支持以下类型的消息通知，通知方式采用小程序平台订阅消息模板，用户在提交预约时需授权订阅。①预约成功通知：提交成功后立即发送，内容包括服务名称、预约日期与时段、预约编号、取消截止时间。②预约提醒通知：在预约时段开始前24小时和2小时各发送一次，提醒用户按时到场。提醒内容包含服务地点、所需携带材料（若配置）。③取消成功通知：用户取消预约后发送，确认取消已办理。④改约成功通知：用户改约后发送，展示更新后的预约时间。所有通知消息需在3秒内完成触发，发送失败时进入重试队列，最多重试3次，每次间隔60秒。3.2管理端功能3.2.1预约资源管理服务提供方工作人员可配置可预约项目及对应时段资源。项目配置项包括：①项目名称：文本框输入，长度不超过50个字符。②服务时长：以分钟为单位，支持5分钟、10分钟、15分钟、30分钟、60分钟等常用值，也支持自定义输入，但必须是5的整数倍。③可预约天数：设置未来可开放预约的天数范围，默认7天，支持1天至30天。④单时段库存：每个时段可预约名额，默认1个，上限不超过100个。⑤提前预约截止时间：用户最早可预约到多久之后的时段，默认2小时。⑥取消截止时间：用户最晚取消时间，默认时段开始前1小时。⑦爽约限制规则：用户累计爽约次数达到上限后自动限制预约资格的天数，默认3次后限制7天。工作人员保存项目配置后，系统自动生成对应时段资源，无需手工逐条创建。时段生成规则为：从当前时间开始，以服务时长和时段粒度为基础，向后生成可预约天数内的所有时段。例如服务时长为30分钟，时段粒度为15分钟，则每个服务资源占用2个15分钟时段。3.2.2预约订单管理管理端提供预约订单列表，支持按服务项目、预约日期、预约状态、用户手机号等条件筛选。订单列表展示用户名称（脱敏）、手机号（中间四位隐藏）、服务项目、预约时段、预约状态、创建时间、操作入口。工作人员可对预约单执行以下操作：①核销预约：用户到场后，工作人员扫描用户出示的核销码或手动输入预约编号，系统校验预约单状态为“待核销”且当前时间在时段开始前30分钟至时段结束后30分钟内，则核销成功，状态变更为“已完成”。②标记爽约：时段结束后30分钟内用户未到场且未取消，系统自动将预约单标记为“已爽约”，同时发送爽约提醒。工作人员也可手动标记。③取消预约：因服务提供方原因需取消用户预约时，工作人员可强制取消，需填写取消原因，系统发送取消通知并释放名额。3.2.3排班管理对于依赖人员排班的服务项目，管理端需支持按天或按周配置服务人员班次。每个班次关联一个服务项目和一组可预约时段，多个班次可共享同一服务项目但分配不同库存。排班规则：①班次创建时间不得晚于服务日期前1天的18时整。②每个班次必须指定服务人员、服务时段、可接待人数。③同一服务人员在同一时段不能被分配到两个班次。④排班发布后如需调整，可对已生成的时段资源进行单独关闭或名额增减，但不影响已提交的预约单。3.2.4数据统计管理端提供数据统计看板，核心指标包括：①预约总量：按日、周、月维度统计预约单数量。②核销率：已完成预约单数除以总预约单数，目标值不低于85%。③爽约率：已爽约预约单数除以总预约单数，目标值不高于5%。④时段满约率：已约满时段数除以开放时段总数，用于评估资源紧张程度。⑤热门项目排行：按预约量降序展示前10个项目。所有统计数据需次日凌晨2时完成更新，展示时支持导出为通用表格格式，但导出文件内容需脱敏处理。四、数据需求4.1核心数据实体预约功能涉及的核心数据实体包括：用户信息、服务项目、时段资源、预约单、操作日志。①用户信息：用户标识、昵称、手机号、实名认证状态、累计预约次数、累计爽约次数、限制预约截止时间。②服务项目：项目标识、项目名称、服务时长、单时段库存、可预约天数、提前预约截止时间、取消截止时间、状态、创建时间。③时段资源：资源标识、项目标识、日期、开始时间、结束时间、总库存、剩余库存、状态。④预约单：预约编号、用户标识、项目标识、资源标识、预约日期、开始时间、结束时间、状态、核销时间、取消时间、爽约标记、创建时间、更新时间。⑤操作日志：日志标识、操作人标识、操作类型、操作对象标识、操作时间、操作内容摘要。4.2字段规范①预约编号：长度为14位纯数字，格式为4位年+2位月+2位日+6位随机数，全局唯一。②手机号：必须为11位数字，符合国内主流运营商号段规则，存储时需加密处理。③时间字段：所有时间字段统一采用东八区标准时间，精确到秒。④状态字段：预约单状态取值0至4，分别代表：0已创建待支付（若涉及）、1待核销、2已完成、3已取消、4已爽约。⑤库存字段：总库存和剩余库存均为整数，范围0至1000。4.3数据校验规则①用户提交预约时，系统必须校验该用户是否存在于用户信息库，若不存在则拒绝请求并提示绑定身份。②预约时段必须存在于时段资源表中，且对应日期和时段状态为可约。③时段剩余库存必须大于0，扣减操作使用数据库行级锁保证并发安全。④预约单创建时间不得晚于时段开始时间之前2小时，否则拒绝创建。⑤同一用户对同一时段资源只能有一条状态为非取消的预约单，重复创建时提示“该时段已存在有效预约”。五、接口需求5.1用户身份认证接口小程序端调用后端接口时，需通过平台提供的身份凭证进行鉴权。接口需在200毫秒内返回用户标识与基础信息。若鉴权失败，需返回明确的错误码，前端引导用户重新登录。5.2消息推送接口预约成功、预约提醒、取消通知等消息均通过小程序平台订阅消息接口发送。消息内容模板需提前在平台配置，接口调用频率受平台限制。系统需实现本地消息队列，将发送请求异步化处理，避免阻塞主流程。每条消息发送结果需记录日志，失败时自动重试3次。5.3支付接口（可选）若预约服务涉及收费，需接入支付接口。用户提交预约后生成待支付订单，支付时长为15分钟，超时未支付自动取消并释放库存。支付成功后系统才发送预约成功通知并核减库存。支付接口需支持原路退款，退款时长为预约取消后1至3个原支付通道工作日到账。5.4内部服务接口预约功能与其他内部系统的交互接口需定义清晰的请求与响应格式。例如与用户中心对接身份信息，与消息中心对接通知发送，与企业资源计划系统对接订单数据同步。所有内部接口均需设定超时时间为2秒，超时后执行降级策略：若库存扣减接口超时，需回滚本地事务并提示用户稍后重试；若消息发送接口超时，不影响主流程，由异步队列补偿发送。六、非功能需求6.1性能需求①并发能力：系统需支持同时在线用户数不低于500人，核心预约提交接口在每秒50次请求压力下，平均响应时间不超过800毫秒，99分位响应时间不超过1500毫秒。②吞吐量：预约单创建接口支持每秒不低于20笔订单创建。③数据库连接池：后台数据库连接池初始大小不低于20，最大连接数不低于200，避免连接等待。④缓存策略：服务项目与时段资源查询使用缓存，缓存有效期为60秒，库存扣减采用原子操作并同步更新缓存。6.2安全需求①数据传输：小程序与后端之间全链路采用加密传输协议，禁止明文传输用户手机号、预约编号等敏感信息。②身份校验：所有用户端和管理端接口必须经过身份认证，管理端接口额外校验角色权限。③防刷机制：同一用户在1分钟内提交预约请求超过5次时，触发图形验证码；超过10次时，临时限制该用户1小时内的提交操作。④数据脱敏：前端展示及日志记录中，用户手机号中间四位需隐藏；管理端导出数据时需二次脱敏。⑤审计日志：所有管理端敏感操作（如强制取消、库存调整）必须记录操作人、操作时间、操作前后值。6.3兼容性需求①小程序端需兼容主流移动设备操作系统版本，支持最近3年内发布的主流机型正常显示与操作。②页面适配屏幕宽度320像素至428像素，自适应布局不得出现横向滚动条。③字体大小需支持系统无障碍设置，放大至1.5倍时页面不出现溢出。6.4可用性需求①系统全年可用性不低于99.5%，即每月不可用时间不超过108分钟。②核心接口故障恢复时间目标为15分钟以内，需配置自动扩容与健康检查机制。③数据每日凌晨2时进行全量备份，备份保留30天，支持按需恢复至任意一天。七、异常场景与边界处理7.1并发预约冲突当多个用户同时选择同一时段的最后一个名额时，系统通过数据库行锁或乐观锁控制库存扣减。以行级锁为例，扣减操作执行时对资源行加锁，后到达的事务等待，第一个事务扣减成功后剩余库存变为0，后续事务发现库存不足则回滚并返回“该时段已约满”。前端需在收到该提示后自动刷新时段列表。7.2用户取消超时用户发起取消请求时，系统首先校验当前时间与预约时段开始时间的差值。若差值小于1小时，则拒绝取消，返回提示“已超过取消截止时间，无法取消”。该规则需在用户端展示明确的倒计时提醒，倒计时从时段开始前24小时开始计算。7.3服务临时调整若服务提供方因临时原因需暂停某时段甚至全天的预约，管理端可执行“时段关闭”操作。关闭前需校验该时段是否已有用户预约，若存在未核销预约单，须先由工作人员逐一取消并通知用户，或批量取消时系统自动发送通知。关闭后该时段不再对用户可见，已取消名额不重新释放。7.4网络异常重试小程序端提交预约请求时，若网络中断或超时，前端应展示“提交中”状态，并禁止用户重复点击。后端需实现幂等性处理：通过预约编号生成机制和唯一约束，确保同一请求即使重复提交也不会产生多条预约单。用户重新发起时，前端先调用查询接口确认上一请求是否创建成功，成功则直接展示结果，失败则允许重新提交。7.5爽约自动判定系统在每日凌晨2时执行定时任务，扫描前一日结束的预约单，将状态为“待核销”且未在场核销的记录自动标记为“已爽约”，同时累加用户爽约次数。若用户累计爽约次数达到后台配置的阈值，系统自动设置限制预约截止时间，并通过消息通知用户限制原因与解禁日期。定时任务执行失败时需触发告警，人工介入补跑。八、验收标准8.1功能验收项目①用户端预约全流程：用户浏览项目、选择时段、填写信息、提交预约、接收通知、取消预约、改约、查看记录，逐项操作成功且状态流转正确。②管理端资源管理：工作人员创建项目、生成时段、调整库存、查询订单、核销、标记爽约、强制取消，各操作结果与数据库记录一致。③通知消息：预约成功、预约提醒、取消通知、改约通知均能在触发条件满足后3秒内触达用户，消息内容完整无误。④异常场景：并发冲突、超时取消、时段关闭、网络重试等场景处理符合本模板规定逻辑，无