海西蒙古族藏族自治州网站建设_网站建设公司_数据统计_seo优化

第四天：社团活动管理模块开发
一、需求分析
社团活动是社团运营的核心内容之一，第四天的工作重点在于实现社团活动的发布、编辑、展示、报名参与、状态管理等完整功能链。活动管理模块直接影响社团成员的参与度和活跃度，是评价社团工作成效的重要指标。根据系统设计，每个活动由所属社团、标题、内容、时间、地点、最大参与人数、当前参与人数、状态、创建者等属性组成。活动状态分为未开始（status=0）、进行中（status=1）、已结束（status=2）、取消（status=3）四种状态，系统应支持根据当前时间自动更新活动状态，或者由社团管理员手动更新状态。在活动发布方面，只有社团管理员才能发布本社团的活动，发布时需要填写完整的活动信息，包括活动标题、活动内容、活动开始时间和结束时间、活动地点、最大参与人数等。活动发布后自动进入未开始状态，在活动开始时间到达后由系统自动更新为进行中状态，在活动结束时间到达后更新为已结束状态。社团管理员也可以手动将活动状态设为取消，已取消的活动不再接受新的报名。成员参与活动需要通过报名功能实现，报名时可以选择报名参加活动，系统会检查活动是否还有剩余名额，如果名额已满则提示报名失败。报名成功后，活动记录中的当前参与人数字段会自动加一。用户也可以取消报名，取消后参与人数相应减一。为了方便成员了解活动情况，系统还应提供我参与的活动查询功能，展示当前用户已报名的所有活动列表，包括已结束和进行中的活动。此外，活动列表应支持按社团筛选、按状态筛选、按时间排序等功能，帮助用户快速找到感兴趣的活动。活动详情页面应展示活动的完整信息，并显示已报名成员列表（如果活动允许公开显示参与成员的话）。
二、开发任务
本次开发任务涵盖活动全生命周期的管理功能。首先是活动发布功能的实现，社团管理员可以发布本社团的活动，发布接口需要验证当前用户是否为该社团的社团管理员。接收的参数包括活动标题、活动内容、活动开始时间、活动结束时间、活动地点、最大参与人数等。活动创建时，当前参与人数初始为0，状态初始为未开始（status=0），创建者为当前登录用户。活动标题在本社团内应具有唯一性，防止活动混淆。活动内容支持富文本或长文本格式，允许管理员详细描述活动流程、注意事项、报名要求等信息。其次是活动列表查询功能的实现，提供多种筛选和排序方式的活动列表查询接口。可以按社团ID筛选（查询指定社团的所有活动）、按活动状态筛选（查询未开始、进行中、已结束、取消的活动）、按时间范围筛选（查询指定时间段内的活动）、按创建时间排序或按开始时间排序。返回结果应包含活动的核心信息，社团管理员可以查看本社团的所有活动，普通用户只能查看状态为正常（未开始、进行中、已结束）的活动。第三是活动详情查询功能的实现，查询单个活动的详细信息，包括活动内容、参与人数统计、报名成员列表等。活动详情应对所有已登录用户开放，未登录用户不能查看活动详情。社团管理员查看本社团活动详情时，还应显示报名成员的详细信息列表。第四是活动报名功能的实现，用户可以报名参加活动，报名接口需要验证活动状态是否为未开始或进行中、活动是否还有剩余名额、用户是否已经报过名。验证通过后，在报名记录表中插入报名记录，并更新活动的当前参与人数。如果活动名额已满，应返回名额已满的提示。第五是取消报名功能的实现，用户可以取消已报名的活动，取消接口需要验证报名记录是否存在、活动的状态是否允许取消（已结束的活动不能取消）。验证通过后，删除报名记录或更新报名状态，并更新活动的当前参与人数减一。第六是活动编辑功能的实现，社团管理员可以编辑本社团的未开始状态活动，编辑接口需要验证用户权限和活动状态。活动开始后不允许编辑，只能取消。编辑时可以修改活动内容、时间、地点等信息，但如果修改最大参与人数，需要确保当前参与人数不超过新的最大人数限制。第七是活动状态管理功能的实现，社团管理员可以将进行中的活动设为已结束，将未开始的活动设为取消；系统也可以通过定时任务自动更新活动状态。活动取消时，应通知所有已报名成员取消原因和时间安排变化。
三、实现步骤
接下来详细说明各功能的实现步骤。活动发布功能需要设计CreateActivityDTO数据传输对象，包含活动标题、活动内容、活动开始时间、活动结束时间、活动地点、最大参与人数等字段，添加必要的校验注解如非空校验、最大长度校验、时间逻辑校验（开始时间应早于结束时间）。ClubController中新增createActivity接口，从JWT令牌获取当前登录用户ID，验证用户是否为该社团的社团管理员，然后调用ActivityService的createActivity方法。Service层首先根据社团ID查询社团信息验证社团状态正常，然后创建Activity实体对象，设置各项属性，当前参与人数设为0，状态设为0，创建者ID设为当前用户ID，调用Mapper插入数据库。活动列表查询功能需要在ActivityService中定义listActivities方法，参数包括社团ID（可选）、活动状态（可选）、开始时间（可选）、结束时间（可选）、页码、每页数量等。Mapper层编写动态SQL，使用WHERE条件根据参数组合筛选数据，使用ORDER BY子句按创建时间或开始时间排序。返回分页结果，包含活动列表和总数。分页计算公式为：LIMIT (page-1)*size, size。活动详情查询功能需要设计GetActivityDetailVO视图对象，包含Activity的所有字段以及社团名称、创建者姓名、当前参与人数、最大参与人数、报名状态等信息。ActivityService的getActivityById方法首先查询活动基本信息，如果活动不存在抛出异常，如果活动已取消且当前用户不是社团管理员则抛出无权访问异常。然后查询活动的报名记录数量和已报名用户信息，组装成详情对象返回。活动报名功能需要设计ActivityParticipant视图对象，包含报名记录相关信息。ClubController中新增joinActivity接口，参数包括活动ID。Service层首先查询活动信息，验证活动状态是否为0或1（未开始或进行中）、当前参与人数是否小于最大参与人数。然后根据活动ID和用户ID查询apply_record表，检查是否已存在报名记录，如果已存在抛出已报名异常。接下来创建ApplyRecord实体对象，设置社团ID、活动ID、用户ID、申请理由（可选）、状态设为已通过（因为是直接报名不需要审核）、创建时间等，调用Mapper插入。最后更新Activity的当前参与人数加一。取消报名功能的实现类似，验证报名记录存在后删除记录或更新状态，并更新活动的当前参与人数减一。活动编辑功能需要验证当前状态为未开始，然后更新活动信息，注意检查最大参与人数的合法性。
四、验证方法
活动管理模块的验证需要覆盖各种业务场景和边界条件。首先验证活动发布功能，使用社团管理员账号发布活动，验证活动创建成功并返回活动ID；使用普通用户账号发布活动，验证返回权限不足提示；发布活动时不填写必填字段，验证前端表单校验提示；发布后查询活动列表，验证新活动出现在列表中状态为未开始。其次验证活动列表查询功能，查询所有社团的活动列表，验证返回正确的活动数据；按社团筛选，验证只返回指定社团的活动；按状态筛选，验证只返回对应状态的活动；验证分页功能正确，分页信息与实际数据一致。第三验证活动详情查询功能，查询正常活动的详情，验证返回完整的活动信息；查询不存在的活动ID，验证返回活动不存在提示；查询已取消的活动，验证返回相应的状态提示；未登录状态查询，验证返回401错误。第四验证活动报名功能，对未开始的活动进行报名，验证报名成功；活动进行中时报名，验证报名成功；活动已结束时报名，验证返回活动已结束提示；活动名额已满时报名，验证返回名额已满提示；重复报名同一活动，验证返回已报名提示。第五验证取消报名功能，取消已报名的活动，验证取消成功；取消后重新报名，验证功能正常；活动已结束后取消，验证返回不能取消提示。第六验证活动编辑功能，编辑未开始的活动信息，验证编辑成功；编辑已开始的活动，验证返回不能编辑提示；修改最大参与人数小于当前参与人数，验证返回非法操作提示。第七验证活动状态管理，手动将活动设为已结束，验证状态更新成功；手动将活动设为取消，验证活动取消成功；取消活动后验证已报名成员收到通知。