本系统面向休闲农业与乡村旅游中的采摘园预约场景。游客多为家庭、亲子或团建，希望提前知道哪家靠谱、有没有名额、到店如何核销；采摘园经营者则常被电话或微信群预约打乱节奏，手工记名额容易冲突，现场核销和对账效率低。系统为游客提供按地区浏览采摘园、查看评分与评价、选择入园日期与时段、在线支付并持电子票到店核销的完整流程；为商家提供活动与时段配置、每时段名额控制、扫码或输入核销码核销、订单与评价管理；为平台提供商家入驻与资质审核、订单与投诉处理、退款与结算统计。对应采摘季与周末高峰集中、必须到店体验、客单价不高但需清晰核销等行业特点，通过分时段预约与名额控制避免超卖与现场混乱，通过电子票与核销码实现到店核销与追溯，适用于果园、农庄等“先预约再到店”的农旅与本地生活场景。
游客端微信小程序提供首页采摘园列表与详情、活动与时段选择、提交预约、支付、我的订单与电子票展示、评价及商家入驻申请；支持手机号注册与登录、修改密码与账号注销，支付支持支付宝与模拟环境，订单支持申请退款与提交投诉。商家端小程序提供商家登录、订单列表与按核销码或订单号查询、扫码核验电子票完成核销，以及活动、时段、票种、采摘产品的增删改和评价回复管理。管理端为 Vue 网页后台，提供管理员登录、仪表盘统计（商户数、待审核、订单、评价、活动等）、商家与入驻申请审核、用户与商户管理、订单退款与投诉处理、商户未结算金额查看与结算操作。后端 Spring Boot 统一提供认证与权限、商户与活动、时段与票种、订单与支付、电子票与二维码、评价与投诉、入驻与结算等接口，三端共用同一套 API，按角色区分能力。
后端为 Spring Boot 单应用，context-path 为 /api，使用 JWT 无状态鉴权，JwtFilter 解析 Authorization 头并将 userId 与 role 写入请求属性，各 Controller 据此做业务权限校验。接口按 /auth、/visitor、/merchant、/admin 划分，分别服务登录注册、游客、商家、管理员；数据层为 JPA 实体与 Repository，核心实体包括 User、Merchant、Activity、TimeSlot、Ticket、Order、Review 等，订单状态含未支付、已支付、已核销、取消、待退款、已退款。下单时校验时段剩余名额并生成订单与核销码，支付成功（支付宝回调或模拟）后扣减时段 remainCount；电子票二维码由 ZXing 生成；短信验证码当前为内存实现便于开发。游客端与商家端小程序通过 utils/config 配置 apiBase，request 封装 wx.request 并自动携带 Bearer token，页面按功能调用对应 visitor 或 merchant 接口；管理端 Vue 通过 api 封装请求访问 admin 接口。CORS 开放便于本地联调，DataInitializer 在默认 profile 下初始化管理员、示例商户与活动数据。
评论