从10到100：基于java的志愿者小程序开发笔记背景当前志愿服务活动中，组织者与志愿者之间存在信息不对称、管理效率低

背景

当前志愿服务活动中，组织者与志愿者之间存在信息不对称、管理效率低下等痛点。传统的管理方式依赖人工统计和线下沟通，难以满足日益增长的志愿服务需求。

研究意义

对志愿者：提供及时的信息获取渠道，简化活动参与流程，清晰管理个人服务记录。
对组织方：实现活动管理的高效化，数据统计的精准化，以及服务质量的可量化。

系统需求分析

在这里插入图片描述

业务流程设计

预约流程：用户浏览活动 -> 选择时段 -> 提交预约 -> 生成核销码。
核销流程：用户出示二维码 -> 管理员扫码 -> 系统校验 -> 更新状态为“已完成”。
管理流程：管理员登录 -> 发布活动/设置规则 -> 监控报名情况 -> 现场核销 -> 导出数据。

关键代码片段

package com.volunteer.entity;

import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;

@Data
@TableName("t_appointment")
public class Appointment {
    @TableId(type = IdType.AUTO)

package com.volunteer.service.impl;

import com.volunteer.entity.Activity;
import com.volunteer.entity.Appointment;
import com.volunteer.mapper.ActivityMapper;
import com.volunteer.mapper.AppointmentMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

import java.time.LocalDateTime;
import java.util.UUID;

@Service
public class AppointmentServiceImpl {

    @Autowired
    private ActivityMapper activityMapper;
    @Autowired
    private AppointmentMapper appointmentMapper;

    /**
     * 用户预约活动
     * @param userId 用户ID
     * @param activityId 活动ID
     * @param timeSlot 时段
     * @return 预约结果
     */
    @Transactional(rollbackFor = Exception.class)
    public boolean bookActivity(Long userId, Long activityId, String timeSlot) {
        // 1. 查询活动信息 (使用 selectById 并锁定行，或使用版本号机制)
        // 这里演示简单的检查逻辑，生产环境建议结合 Redis 预减库存
        Activity activity = activityMapper.selectById(activityId);
        
        if (activity == null || activity.getStatus() != 1) {
            throw new RuntimeException("活动不存在或未开启");
        }
        
        if (activity.getBookedCount() >= activity.getTotalQuota()) {
            throw new RuntimeException("名额已满");
        }

        // 2. 检查用户是否重复预约该时段
        long count = appointmentMapper.selectCount(
            new LambdaQueryWrapper<Appointment>()
                .eq(Appointment::getUserId, userId)
                .eq(Appointment::getActivityId, activityId)
                .eq(Appointment::getTimeSlot, timeSlot)
                .in(Appointment::getStatus, 0, 1) // 只查有效预约
        );
        if (count > 0) {
            throw new RuntimeException("您已预约该时段");
        }

        // 3. 扣减库存 (利用数据库原子更新，防止并发超卖)
        // SQL: UPDATE t_activity SET booked_count = booked_count + 1 
        //      WHERE activity_id = ? AND booked_count < total_quota
        int updatedRows = activityMapper.decrementQuota(activityId);
        if (updatedRows == 0) {
            throw new RuntimeException("预约失败，名额已被抢光");
        }

        // 4. 创建预约记录
        Appointment appointment = new Appointment();
        appointment.setUserId(userId);
        appointment.setActivityId(activityId);
        appointment.setTimeSlot(timeSlot);
        appointment.setVerifyCode(UUID.randomUUID().toString().replace("-", "")); // 生成核销码
        appointment.setStatus(0); // 待参加
        appointment.setBookTime(LocalDateTime.now());
        
        appointmentMapper.insert(appointment);
        return true;
    }
}

数据库设计

字段名	类型	长度	主键	非空	默认值	说明
`user_id`	BIGINT	20	YES	YES	AUTO_INC	用户ID
`openid`	VARCHAR	64	NO	YES	-	微信OpenID (唯一标识)
`name`	VARCHAR	50	NO	YES	-	真实姓名
`phone`	VARCHAR	20	NO	NO	-	联系电话
`specialty`	VARCHAR	255	NO	NO	-	服务特长/技能
`avatar_url`	VARCHAR	255	NO	NO	-	头像链接
`created_at`	DATETIME	-	NO	YES	NOW()	注册时间
`updated_at`	DATETIME	-	NO	YES	NOW()	更新时间

字段名	类型	长度	主键	非空	默认值	说明
`activity_id`	BIGINT	20	YES	YES	AUTO_INC	活动ID
`title`	VARCHAR	100	NO	YES	-	活动标题
`type`	VARCHAR	50	NO	YES	-	活动类型 (如: 环保, 助老)
`description`	TEXT	-	NO	NO	-	活动详情描述
`location`	VARCHAR	255	NO	NO	-	活动地点
`total_quota`	INT	11	NO	YES	0	总招募人数
`booked_count`	INT	11	NO	YES	0	已报名人数
`start_time`	DATETIME	-	NO	YES	-	活动开始时间
`end_time`	DATETIME	-	NO	YES	-	活动结束时间
`status`	TINYINT	1	NO	YES	1	状态 (0:下架, 1:进行中, 2:已结束)
`created_by`	BIGINT	20	NO	YES	-	创建者ID (Admin)
`created_at`	DATETIME	-	NO	YES	NOW()	发布时间

字段名	类型	长度	主键	非空	默认值	说明
`content_id`	BIGINT	20	YES	YES	AUTO_INC	内容ID
`category`	VARCHAR	50	NO	YES	-	分类 (notice, knowledge, etc.)
`title`	VARCHAR	100	NO	YES	-	标题
`body`	LONGTEXT	-	NO	NO	-	正文内容 (HTML/Markdown)
`cover_img`	VARCHAR	255	NO	NO	-	封面图URL
`view_count`	INT	11	NO	YES	0	浏览次数
`created_at`	DATETIME	-	NO	YES	NOW()	发布时间

字段名	类型	长度	主键	非空	默认值	说明
`admin_id`	BIGINT	20	YES	YES	AUTO_INC	管理员ID
`username`	VARCHAR	50	NO	YES	-	登录用户名
`password_hash`	VARCHAR	100	NO	YES	-	加密后的密码
`role`	VARCHAR	20	NO	YES	'admin'	角色 (super_admin, admin, checker)
`is_active`	TINYINT	1	NO	YES	1	账户状态 (0:禁用, 1:启用)
`last_login`	DATETIME	-	NO	NO	-	最后登录时间