小区活动管理需求文档 (Community Activity Management)

修订历史

1. 模块概述

本模块核心目标是为小区物业管理提供社区活动的全生命周期管理能力。覆盖从活动发起、发布、报名、参与到完成确认的完整业务闭环，提升社区活力和居民参与度。

1.1 系统目标

• 业务闭环：实现"发起 → 发布 → 报名 → 参与 → 完成"的完整活动流程

• 灵活配置：支持多种活动类型，灵活配置报名、附件、领取确认等功能

• 三端协同：物业管理后台（PC端）、物业小程序、住户小程序三端数据实时同步

• 数据统计：提供阅读量、收藏数、分享数、报名数等多维度数据统计

• 智能提醒（v1.1.0新增）：住户端智能推送正在举行中的活动，支持个性化提醒设置

1.2 适用场景

• 文化娱乐活动（中秋晚会、春节联欢等）

• 健康养生活动（健康讲座、义诊等）

• 志愿服务活动（环保志愿、社区服务等）

• 便民服务活动（免费打印照片、免费维修、物品领取等）

• 意见征集活动（问卷调查、建议收集等）

2. 功能说明

2.1 物业管理后台 (PC端)

2.1.1 活动列表管理

• 功能目标：提供活动的集中管理视图，支持查询、筛选、统计。

• 功能项：

  • 全局统计：展示今日活动/进行中活动数、总阅读量、总收藏数、总分享数

  • 搜索与筛选：支持按活动名称模糊查询、按活动状态精确筛选

  • 批量操作：支持删除活动（需二次确认）

  • 快速操作：编辑、取消活动、查看报名详情

2.1.2 活动创建与编辑

• 功能目标：灵活配置活动信息，支持草稿保存和正式发布。

• 功能项：

  • 基础信息配置：活动名称、类型、时间、地点、描述等

  • 报名配置：是否需要报名、报名时间、人数限制

  • 附件配置：是否需要上传附件、附件类型、数量限制、说明文字

  • 附件限制模式配置（v1.1.0新增）：每人限制 / 每户限制

  • 领取确认配置：是否需要物业确认领取/完成

  • 多媒体素材：活动封面、活动海报

2.1.3 报名人员管理

• 功能目标：管理活动报名信息，支持查看附件、确认领取。

• 功能项：

  • 报名列表展示：房屋信息、住户信息、报名时间、报名状态、领取状态

  • 快速查询与筛选（v1.1.0新增）：支持按姓名、房屋名称、手机号查询，按报名状态、领取状态筛选

  • 附件查看：预览业主上传的附件（图片、文件）

  • 领取确认：物业确认业主已领取/完成，记录操作时间和操作人

  • 数据导出：导出报名列表为Excel（含附件链接）

2.2 物业小程序 (员工端)

2.2.1 快速发起活动

• 功能目标：物业员工在移动端快速发起社区活动。

• 功能项：

  • 便捷入口：便捷OA → 发起活动 → 类型选择"社区活动"

  • 移动端表单：适配移动端的表单布局，支持拍照上传封面

  • 实时同步：发布后立即同步至PC后台

2.3 住户小程序 (用户端)

2.3.1 活动浏览与筛选

• 功能目标：住户浏览社区活动，按状态筛选。

• 功能项：

  • Tab页签：进行中（待举行、报名中、举行中）、已结束（已结束、已取消）

  • 活动卡片：展示封面、标题、时间、状态、已报名成员头像

  • 排序规则：按活动创建时间倒序

2.3.2 活动详情与互动

• 功能目标：查看活动详情，支持报名、收藏、分享。

• 功能项：

  • 活动信息展示：类型、名称、时间、地点、介绍、封面、海报、负责人信息

  • 报名信息展示：报名时间段、人数限制、已报名成员列表

  • 报名操作：立即报名（含上传附件）、取消报名、查看/更换附件

  • 互动操作：收藏/取消收藏、分享给好友

  • 参与状态：我的报名状态、附件状态、领取状态

2.3.3 已报名成员列表

• 功能目标：查看活动的所有报名成员。

• 功能项：

  • 成员列表：头像、昵称、住户身份标签、报名时间

  • 排序规则：按报名时间倒序

2.3.4 活动提醒弹窗（v1.1.0新增）

• 功能目标：智能推送正在举行中的活动，提升活动参与率。

• 功能项：

  • 自动弹窗：用户进入小程序首页时，自动检测并弹出正在举行中的活动

  • 弹窗内容：活动封面、标题、时间、"立即查看"和"不再提醒"按钮

  • 不再提醒：针对单个活动设置，用户可选择不再收到该活动的提醒

  • 多活动处理：如有多个活动，优先展示最新创建的活动，用户关闭后下次进入再弹出其他活动

3. 需求细节

3.1 物业管理后台 (PC端)

3.1.1 活动列表页

页面布局与字段

顶部统计卡片：

• 今日活动/进行中活动数：统计当天的活动数量 + 所有"待举行"、"报名中"、"举行中"状态的活动总数

• 总阅读量：所有活动的阅读量累加

• 总收藏数：所有活动的收藏数累加

• 总分享数：所有活动的分享数累加

搜索与筛选：

• 搜索框：按活动名称模糊查询

• 状态筛选下拉框：全部状态、草稿、待举行、报名中、举行中、已结束、已取消

列表字段：

状态逻辑：

• 草稿：保存时未发布

• 待举行：已发布，但未到报名/活动开始时间

• 报名中：当前时间在报名时间段内

• 举行中：当前时间在活动时间段内

• 已结束：当前时间已超过活动结束时间

• 已取消：手动点击"取消活动"

操作权限：

• 编辑：活动状态为"草稿"、"待举行"、"报名中"时可编辑

• 取消活动：活动状态为"待举行"、"报名中"时可取消（需二次确认）

• 删除活动：任何状态下均可删除（需二次确认）

右上角操作：

• "创建活动"按钮（蓝色）：点击打开创建活动弹框

3.1.2 创建/编辑活动弹框

弹框标题：

• 创建模式：创建活动

• 编辑模式：编辑活动

表单字段：

底部操作按钮：

• 取消：关闭弹框，不保存

• 保存草稿：不校验必填项，保存后活动状态为"草稿"

• 发布活动（创建模式）/ 更新活动（编辑模式）：

  • 校验必填项

  • 发布后活动状态根据时间判断（通常为"待举行"）

校验规则：

1. 活动结束时间必须晚于开始时间

2. 报名结束时间必须早于活动开始时间

3. 报名开始时间必须早于报名结束时间

4. 开启"是否需要报名"时，报名时间和人数限制为必填

5. 开启"是否需要上传附件"时，附件类型、限制模式、数量限制、大小限制、附件说明为必填

3.1.3 报名人员列表弹框

触发方式：

• 点击活动列表"参与情况"中的报名人数

弹框标题：

• 包含活动名称，例如："中秋节联欢晚会 - 报名人员"

顶部搜索与筛选（v1.1.0新增）：

• 搜索框：支持按姓名、房屋名称、手机号模糊查询（实时搜索）

• 报名状态筛选：全部状态、已报名、已取消（下拉选择）

• 领取状态筛选：全部状态、未领取、已领取（下拉选择，仅当活动开启"确认领取/完成"时显示）

• 重置按钮：清空所有筛选条件

顶部统计：

• 已报名人数 / 总人数限制（例如：45/50）

• 新增：已领取人数 / 已报名人数（例如：15/45）

  • 仅当活动开启"是否需要确认领取/完成"时显示

列表字段：

排序规则：

• 默认按报名时间倒序排列

• 支持按"未领取优先"排序（点击列表头部"领取状态"列可切换排序）

每户限制模式特殊展示（v1.1.0新增）：

• 当活动开启"每户限制"模式时，附件列显示格式为："已上传X/Y"

  • X：该房屋所有报名用户已上传的附件总数

  • Y：该活动设置的每户附件数量限制

• 点击"查看附件"按钮，弹出该房屋所有报名用户的附件列表（按用户分组展示）

附件查看功能：

• 点击"查看附件"按钮，弹出附件预览弹窗

• 每人限制模式：

  • 显示该用户上传的所有附件

• 每户限制模式（v1.1.0新增）：

  • 显示该房屋所有报名用户的附件，按用户分组展示

  • 每组显示：用户姓名、上传时间、附件列表

• 图片附件：显示所有图片缩略图，点击可放大查看，支持切换上一张/下一张

• 文件附件：显示文件名和大小，提供下载按钮

• 视频/音频附件：提供在线预览播放器

确认领取功能：

• 点击"确认领取"按钮，弹出二次确认弹窗："确认住户已领取？"

• 确认后：

  • 领取状态变为"已领取"（绿色对勾）

  • 记录领取时间和操作人ID

  • "确认领取"按钮变为"已领取"文字（置灰，不可点击）

导出功能：

• 弹框右上角提供"导出Excel"按钮

• 导出内容包含：房屋名称、姓名、联系方式（完整）、报名时间、状态、附件链接（如有）、领取状态（如有）、领取时间（如有）

3.1.4 二次确认弹框

取消活动确认：

• 标题：取消活动

• 内容：确定取消该活动吗？取消后活动状态变为"已取消"，住户将无法再报名。

• 按钮：取消、确定

删除活动确认：

• 标题：删除活动

• 内容：确定删除该活动吗？删除后数据无法恢复。

• 按钮：取消、确定

确认领取确认：

• 标题：确认领取

• 内容：确认住户已领取？

• 按钮：取消、确定

3.2 物业小程序 (员工端)

3.2.1 发起活动页面

导航路径：

• 便捷OA → 发起活动 → 类型选择"社区活动"

表单字段：

底部操作按钮：

• 确定发布：校验必填项，发布成功后跳转至成功提示页

数据同步：

• 发布后立即同步至PC后台的活动列表

• 活动状态根据时间自动判断

3.3 住户小程序 (用户端)

3.3.1 社区活动列表页

页面路径：

• 首页 → 社区 → 活动 Tab → 社区活动

Tab页签：

• 进行中：显示状态为"待举行"、"报名中"、"举行中"的活动

• 已结束：显示状态为"已结束"、"已取消"的活动

排序规则：

• 按活动创建时间倒序排列

活动卡片内容：

• 活动封面（如有）

• 活动标题

• 活动时间段：YYYY-MM-DD HH:mm - YYYY-MM-DD HH:mm

• 活动状态标签：待举行、报名中、举行中、已结束、已取消

• 报名信息（仅当活动需要报名时显示）：

  • 已报名成员头像（最多显示5个头像）

  • 共X人（总报名人数）

  • 如有人数限制，显示：已报名X人 / 共Y人

3.3.2 社区活动详情页

页面布局：

1. 顶部活动信息模块

2. 报名信息模块（仅当活动需要报名时显示）

3. 我的参与状态模块（仅当用户已报名时显示）

4. 活动信息模块

非必填字段无数据时，该项自动隐藏

5. 底部操作栏

立即报名交互流程：

1. 无需上传附件的活动：

   • 点击"立即报名"按钮

   • 直接报名成功，按钮变为"取消报名"

   • 顶部显示"我的参与状态"模块

2. 需要上传附件的活动：

   • 点击"立即报名"按钮

   • 弹出底部上传弹窗（非跳转新页面）

   • 弹窗内容：

     • 附件说明文字（来自活动配置）

     • 每户限制提示（v1.1.0新增）：如开启"每户限制"，显示"本户已有X人报名，共上传Y/Z个附件"

     • 上传组件（根据附件类型显示对应上传入口）

     • 已选附件预览（图片显示缩略图，文件显示文件名，可删除重选）

     • 底部按钮：取消、确认报名

   • 点击"确认报名"：

     • 每人限制模式：校验当前用户上传的附件数量是否符合要求

     • 每户限制模式（v1.1.0新增）：校验该房屋所有报名用户已上传的附件总数 + 当前上传数量是否超过限制

     • 上传附件到服务器

     • 报名成功，按钮变为"取消报名"和"查看/更换附件"

     • 顶部显示"我的参与状态"模块

查看/更换附件交互流程：

1. 点击"查看/更换附件"按钮

2. 进入附件管理界面（底部弹窗或新页面）

3. 显示已上传的附件列表：

   • 图片：显示缩略图

   • 文件：显示文件名和大小

   • 视频/音频：显示预览信息

   • 每户限制提示（v1.1.0新增）：如开启"每户限制"，显示"本户已上传X/Y个附件，您已上传Z个"

4. 提供"更换附件"按钮

5. 点击"更换附件"：

   • 弹出上传组件

   • 每户限制模式（v1.1.0新增）：校验替换后是否超过每户限制

   • 选择新附件后自动替换旧附件

   • 自动保存，无需手动确认

更换附件规则：

• 活动状态为"报名中"、"举行中"时可更换

• 活动状态为"已结束"或用户已领取后不可更换

• 每户限制模式（v1.1.0新增）：更换附件时需校验是否超过每户限制

取消报名交互流程：

1. 点击"取消报名"按钮

2. 弹出二次确认弹窗："确定取消报名？"

3. 点击"确定"：

   • 取消报名成功

   • 按钮恢复为"立即报名"

   • 已上传的附件自动删除

   • "我的参与状态"模块隐藏

   • 每户限制模式（v1.1.0新增）：该房屋的附件总数相应减少

4. 点击"取消"：关闭弹窗，不执行操作

统计逻辑：

• 阅读量：每次进入详情页 +1（同一用户多次进入多次统计）

• 收藏数：点击收藏 +1，取消收藏 -1

• 分享数：成功分享给好友 +1

收藏功能：

• 点击收藏图标，图标高亮（红色），收藏数 +1

• 再次点击，取消收藏，图标恢复默认色，收藏数 -1

• 已收藏的活动同步至"我的 - 收藏 - 活动"列表

分享功能：

• 点击分享图标，弹出微信分享菜单

• 选择好友，生成活动卡片（含封面、标题、时间）

• 分享成功后，分享数 +1

3.3.3 已报名成员列表页

触发方式：

• 点击活动详情页"报名信息模块"中的已报名成员头像区域

页面标题：

• 已报名人员

排序规则：

• 按报名时间倒序排列

列表字段：

3.3.4 我的 - 我参与的活动

页面路径：

• 我的 → 我参与的

列表展示：

• 显示用户已报名的所有活动

• 活动卡片右上角增加状态标签：

  • 未领取（橙色）：活动开启"确认领取/完成"且用户未领取

  • 已领取（绿色）：用户已领取

  • 如活动未开启"确认领取/完成"，不显示标签

3.3.5 活动提醒弹窗（v1.1.0新增）

触发时机：

• 用户进入小程序首页时，自动检测当前是否有正在"举行中"的活动

• 如有符合条件的活动，自动弹出提醒弹窗

弹窗内容：

• 活动封面：显示活动封面图（如有）

• 活动标题：大字号展示活动名称

• 活动时间：显示活动开始时间 - 结束时间

• 活动状态标签：举行中（绿色）

• 底部按钮区域：

  • 不再提醒按钮（灰色文字按钮，左侧）

  • 立即查看按钮（蓝色主按钮，右侧）

交互逻辑：

1. 点击"立即查看"：

   • 关闭弹窗

   • 跳转至该活动的详情页

2. 点击"不再提醒"：

   • 关闭弹窗

   • 将该活动ID记录到用户的"已忽略活动列表"（本地存储 + 服务器同步）

   • 后续进入小程序时，该活动不再弹出提醒

   • 提示："已设置不再提醒该活动"（Toast提示）

3. 点击弹窗外部区域（蒙层）：

   • 关闭弹窗

   • 不记录忽略状态，下次进入仍会弹出

多活动处理逻辑：

• 如果有多个正在"举行中"的活动，按活动创建时间倒序排序，优先展示最新创建的活动

• 用户关闭当前弹窗后（无论是点击"立即查看"、"不再提醒"还是蒙层），下次进入小程序时检测其余未忽略的活动，继续弹出

• 用户点击"不再提醒"后，该活动从候选列表中移除

弹窗展示规则：

• 每次进入小程序首页时只弹出一个活动

• 已点击"不再提醒"的活动不再弹出

• 活动状态必须为"举行中"（当前时间在活动时间段内）

• 同一活动每次进入都会弹出，直到用户点击"不再提醒"或活动结束

已忽略活动的管理：

• 用户点击"不再提醒"后，该活动ID存储在本地缓存和服务器用户配置中

• 如用户清除小程序缓存，服务器配置仍保留，重新登录后依然生效

• 活动结束后，该活动ID自动从"已忽略活动列表"中移除（节省存储空间）

弹窗样式说明：

• 弹窗居中显示，宽度为屏幕宽度的80%

• 圆角卡片样式，带阴影

• 封面图高度固定，宽度自适应

• 底部按钮等高，"立即查看"按钮颜色更鲜明

3.4 附件系统通用规则

3.4.1 附件类型说明

3.4.2 附件上传限制

3.4.3 附件限制模式（v1.1.0新增）

模式一：每人限制

• 每个报名用户独立拥有附件数量限制

• 例如：活动设置"每人最多上传3张照片"，小王可以上传3张，小李也可以上传3张

• 适用场景：每人需要提交独立资料的活动（如免费打印照片、才艺展示）

模式二：每户限制

• 同一房屋的所有报名用户共享附件数量限制

• 例如：活动设置"每户最多上传3张照片"，1栋101室的小王和小李都报名了，两人合计最多上传3张

• 适用场景：以家庭为单位参与的活动（如家庭照打印、户主意见征集）

每户限制模式的校验逻辑：

1. 用户报名上传附件时，查询该房屋所有已报名用户的附件总数

2. 当前上传数量 + 已有附件总数 <= 每户限制数量，允许上传

3. 超过限制时，提示："本户已上传X个附件，最多允许上传Y个，您还可以上传Z个"

4. 用户更换附件时，同样需要校验每户限制

每户限制模式的展示逻辑：

• 住户端报名时：显示"本户已有X人报名，共上传Y/Z个附件"

• 住户端附件管理：显示"本户已上传X/Y个附件，您已上传Z个"

• 物业端报名列表：附件列显示"已上传X/Y"（X为该房屋附件总数，Y为限制数量）

• 物业端附件预览：按用户分组展示该房屋所有用户的附件

3.4.4 附件处理规则

前端自动压缩：

• 图片附件：前端自动压缩到1080P分辨率，保持宽高比

• 视频附件：不压缩，由用户自行控制大小

上传流程：

1. 用户选择附件

2. 前端校验格式和大小

3. 每户限制模式（v1.1.0新增）：校验该房屋附件总数是否超过限制

4. 前端压缩（图片）

5. 上传到云存储（OSS/COS）

6. 返回附件URL存储到数据库

附件存储路径：

/community-activities/{activity_id}/registrations/{registration_id}/{filename}

附件删除规则：

• 用户取消报名时，自动删除该用户上传的所有附件

• 用户更换附件时，自动删除旧附件

• 活动删除时，自动删除该活动所有报名用户的附件

• 每户限制模式（v1.1.0新增）：删除附件时同步更新该房屋的附件总数统计

3.5 状态流转逻辑

3.5.1 活动状态流转

创建活动（保存草稿）→ 草稿
           ↓
       发布活动
           ↓
        待举行 → 报名中 → 举行中 → 已结束
           ↓                ↓
       手动取消 ←————————→ 已取消

状态判断规则：

• 草稿：保存时未点击"发布活动"

• 待举行：已发布，当前时间 < 报名开始时间（如需要报名）或 < 活动开始时间（如无需报名）

• 报名中：当前时间 >= 报名开始时间 且 <= 报名结束时间

• 举行中：当前时间 >= 活动开始时间 且 <= 活动结束时间

• 已结束：当前时间 > 活动结束时间

• 已取消：手动点击"取消活动"

状态自动流转：

• 系统定时任务每分钟检查一次活动状态，自动更新状态

3.5.2 报名状态流转

用户报名（上传附件）→ 已报名 → 用户取消报名 → 已取消
                       ↓
                  物业确认领取
                       ↓
                    已领取

报名限制规则：

• 活动状态为"报名中"时才能报名

• 如有人数限制，已报名人数达到限制后，其他用户无法报名（报名已满员）

• 用户只能报名一次同一个活动

• 用户取消报名后，可以重新报名（如未满员）

取消报名限制：

• 活动状态为"报名中"时才能取消报名

• 活动状态为"举行中"、"已结束"时不能取消报名

3.5.3 领取状态流转

已报名 → 未领取 → 物业确认领取 → 已领取

领取确认规则：

• 仅当活动开启"是否需要确认领取/完成"时，才有领取状态

• 物业在PC后台或小程序端点击"确认领取"，记录领取时间和操作人

• 已领取后不可撤销

3.6 数据统计与报表

3.6.1 活动数据统计

顶部统计卡片（PC后台）：

• 今日活动/进行中活动数

• 总阅读量

• 总收藏数

• 总分享数

单个活动统计（活动详情）：

• 阅读量

• 收藏数

• 分享数

• 报名人数（如需要报名）

• 已领取人数（如开启确认领取）

3.6.2 导出功能

报名人员列表导出（Excel格式）：

• 房屋名称

• 姓名

• 联系方式（完整）

• 报名时间

• 状态（已报名/已取消）

• 附件链接（如有）

• 每户附件统计（v1.1.0新增）：如开启"每户限制"，增加"本户附件总数"列

• 领取状态（如有）

• 领取时间（如有）

4. 关键业务规则

4.1 时间规则

1. 时间逻辑校验：

   • 报名开始时间 < 报名结束时间 < 活动开始时间 < 活动结束时间

2. 状态自动流转：

   • 系统定时任务每分钟检查一次，自动更新活动状态

3. 历史活动处理：

   • 已结束的活动不可编辑，但可删除

   • 已取消的活动不可恢复，但可删除

4.2 报名规则

1. 人数限制：

   • 不填写人数限制 = 不限制人数

   • 填写人数限制后，已报名人数达到限制时，其他用户无法报名

2. 重复报名限制：

   • 同一用户只能报名一次同一个活动

   • 取消报名后可以重新报名

3. 报名时间限制：

   • 只有在"报名中"状态时才能报名

   • "待举行"、"举行中"、"已结束"、"已取消"状态不能报名

4.3 附件规则

1. 附件必填：

   • 开启"是否需要上传附件"时，用户报名必须上传附件

   • 附件数量必须符合活动配置的要求

2. 附件更换：

   • 报名后可以随时更换附件

   • 活动状态为"已结束"或用户已领取后不可更换

3. 附件删除：

   • 用户取消报名时，自动删除附件

   • 活动删除时，自动删除所有报名用户的附件

4. 每户限制规则（v1.1.0新增）：

   • 开启"每户限制"时，同一房屋所有报名用户的附件总数不能超过限制

   • 用户上传/更换附件时，实时校验该房屋附件总数

   • 用户取消报名时，该房屋附件总数相应减少

4.4 领取确认规则

1. 领取确认前置条件：

   • 活动必须开启"是否需要确认领取/完成"

   • 用户必须处于"已报名"状态

2. 领取确认操作：

   • 仅物业端可以确认领取（PC后台或小程序）

   • 确认领取后记录操作时间和操作人

   • 已领取状态不可撤销

3. 领取确认展示：

   • 住户端可查看自己的领取状态

   • 物业端可查看所有用户的领取状态

   • 报名列表统计已领取人数

4.5 删除与取消规则

1. 删除活动：

   • 任何状态下的活动均可删除

   • 删除前需二次确认

   • 删除后数据无法恢复

   • 自动删除该活动所有报名用户的附件

2. 取消活动：

   • 仅"待举行"、"报名中"状态可取消

   • 取消前需二次确认

   • 取消后活动状态变为"已取消"

   • 已报名用户的报名记录保留，但无法继续报名

3. 取消报名：

   • 仅"报名中"状态可取消报名

   • 取消前需二次确认

   • 取消后可以重新报名（如未满员）

   • 自动删除已上传的附件

4.6 活动提醒规则（v1.1.0新增）

1. 弹窗触发条件：

   • 用户进入小程序首页时自动检测

   • 活动状态必须为"举行中"

   • 用户未对该活动点击"不再提醒"

2. 弹窗展示优先级：

   • 每次只弹出一个活动

   • 按活动创建时间倒序，优先展示最新活动

   • 已忽略的活动不再弹出

3. 不再提醒存储：

   • 用户点击"不再提醒"后，活动ID存储到本地缓存和服务器

   • 清除缓存后，服务器配置仍保留

   • 活动结束后，自动从已忽略列表中移除

5. 扩展性设计

5.1 活动类型扩展

当前支持：

• 文化娱乐

• 健康养生

• 志愿服务

扩展方向：

• 后续可通过配置文件或数据库动态扩展活动类型

• 支持自定义活动类型图标和颜色

5.2 附件类型扩展

当前支持：

• 图片、文件、图片+文件、视频、音频

扩展方向：

• 支持更多文件格式（如CAD图纸、3D模型等）

• 支持附件审核功能（物业审核业主上传的内容）

• 支持附件打标签（如"合格"、"不合格"）

5.3 活动模板扩展

未来可实现：

• 预设活动模板（如"免费打印照片活动"、"免费维修活动"）

• 模板包含预设的附件配置、表单字段、流程节点

• 物业创建活动时可选择模板，快速配置

5.4 流程节点扩展

当前流程：

• 报名 → 上传附件 → 确认领取

未来可扩展：

• 报名 → 上传附件 → 物业审核 → 审核通过 → 处理中 → 可领取 → 确认领取 → 完成评价

• 支持多阶段流程配置

• 每个阶段可配置通知推送

5.5 通知推送扩展

当前功能（v1.1.0）：

• 活动提醒弹窗（进入小程序时弹出正在举行中的活动）

未来可扩展：

• 活动发布通知（推送给全体住户）

• 报名成功通知（推送给报名用户）

• 处理进度通知（如"您的照片已打印好，请来领取"）

• 活动开始前提醒（活动开始前X小时推送）

6. 与其他模块的关联

6.1 用户体系

• 复用物业管理系统的用户体系

• 住户信息、房屋信息与现有系统打通

• 物业员工账号与现有系统一致

6.2 权限体系

• 物业管理员可以创建、编辑、删除所有活动

• 物业普通员工可以创建、编辑自己创建的活动

• 住户只能查看和参与活动

6.3 消息通知

• 活动发布、报名成功、领取确认等关键节点可发送消息通知

• 消息通知复用现有系统的通知模块

• 活动提醒弹窗（v1.1.0新增）：作为独立的提醒机制，不依赖消息通知模块

6.4 文件存储

• 活动封面、海报、业主上传的附件统一存储到云存储（OSS/COS）

• 文件存储路径规范化管理

7. 非功能性需求

7.1 性能要求

• 活动列表加载时间 < 2秒

• 活动详情页加载时间 < 1秒

• 附件上传速度 > 500KB/s（依赖网络环境）

• 支持1000+用户同时在线浏览活动

• 报名列表查询响应时间 < 1秒（v1.1.0新增）

• 活动提醒弹窗检测时间 < 500ms（v1.1.0新增）

7.2 安全要求

• 附件上传前端校验文件格式和大小，防止恶意文件上传

• 附件存储使用私有权限，仅授权用户可访问

• 敏感信息（手机号）脱敏展示

7.3 兼容性要求

• PC后台支持Chrome、Edge、Safari最新版本

• 小程序兼容微信小程序基础库 >= 2.10.0

• 移动端适配iOS 12+、Android 8.0+

7.4 可维护性要求

• 代码模块化，附件系统、状态流转逻辑可独立维护

• 活动类型、附件类型等配置项可动态扩展

• 提供详细的操作日志，便于问题排查

8. 术语说明

一、物业管理后台 (PC端)

1. 活动列表管理

• AC1.1 输入活动名称关键字能模糊搜索出匹配的活动

• AC1.2 选择活动状态筛选，列表正确展示该状态的活动

• AC1.3 顶部统计数据（今日活动数、总阅读量、总收藏数、总分享数）正确显示

2. 活动状态流转

• AC2.1 发布活动后，状态根据时间自动流转：待举行 → 报名中 → 举行中 → 已结束

• AC2.2 点击"取消活动"并确认后，状态变为"已取消"

• AC2.3 草稿状态的活动只在PC后台可见，不在住户端展示

3. 创建/编辑活动

• AC3.1 点击"保存草稿"，未填必填项也能保存，状态为"草稿"

• AC3.2 点击"发布活动"时，必填项未填写，提示错误并阻止发布

• AC3.3 勾选"是否需要报名"后，报名时间字段出现并变为必填

• AC3.4 勾选"是否需要上传附件"后，附件配置项（类型、限制模式、数量、大小、说明）出现并变为必填

• AC3.5 附件限制模式支持"每人限制"和"每户限制"两种选择

• AC3.6 时间校验：报名结束时间 < 活动开始时间 < 活动结束时间，违反时提示错误

4. 报名人员列表

• AC4.1 点击"参与情况"数字，弹出报名人员列表弹框，标题包含活动名称

• AC4.2 列表按报名时间倒序排列，正确展示房屋、姓名、联系方式（中间四位隐藏）、报名时间、状态

• AC4.3 顶部统计"已报名人数"与列表中"已报名"状态用户数一致

5. 报名列表快速查询（v1.1.0新增）

• AC5.1 搜索框输入姓名/房屋名称/手机号，列表实时展示匹配结果

• AC5.2 选择"报名状态"筛选，列表只展示对应状态的用户

• AC5.3 选择"领取状态"筛选（活动开启确认领取时），列表只展示对应状态的用户

• AC5.4 同时使用搜索和筛选，列表展示同时满足条件的用户

• AC5.5 点击"重置"按钮，清空所有筛选条件，列表恢复完整展示

6. 附件查看与领取确认

• AC6.1 当活动需要上传附件时，列表显示"查看附件"按钮

• AC6.2 点击"查看附件"，弹出预览弹窗，图片可放大查看，文件可下载

• AC6.3 每户限制模式下，附件列显示"已上传X/Y"，点击查看附件时按用户分组展示

• AC6.4 当活动开启"确认领取/完成"时，列表显示"领取状态"列和"确认领取"按钮

• AC6.5 点击"确认领取"并确认后，领取状态变为"已领取"，记录领取时间和操作人

7. 导出与删除

• AC7.1 点击"导出Excel"，导出文件包含完整字段（房屋、姓名、完整手机号、报名时间、状态、附件链接、领取状态）

• AC7.2 删除活动时，弹出二次确认，确认后活动被删除，所有报名用户的附件自动删除

二、物业小程序 (员工端)

8. 发起活动

• AC8.1 在"便捷OA → 发起活动"中能进入社区活动发起页面

• AC8.2 未填必填项时，点击"确定发布"提示错误

• AC8.3 发布成功后，PC后台活动列表立即显示该活动，状态正确

• AC8.4 支持配置"附件限制模式"（每人限制/每户限制）

三、住户小程序 (用户端)

9. 活动列表

• AC9.1 "进行中"Tab只展示"待举行"、"报名中"、"举行中"状态的活动

• AC9.2 "已结束"Tab只展示"已结束"、"已取消"状态的活动

• AC9.3 列表按活动创建时间倒序排列

10. 活动详情

• AC10.1 进入详情页后，PC后台该活动的"阅读量"+1

• AC10.2 非必填字段无数据时，该信息行自动隐藏

• AC10.3 需要报名的活动，正确展示"报名信息"模块

11. 报名与取消报名

• AC11.1 活动"报名中"状态且未满员时，显示"立即报名"按钮

• AC11.2 无需附件的活动，点击"立即报名"直接报名成功，按钮变为"取消报名"

• AC11.3 需要附件的活动，点击"立即报名"弹出上传弹窗，显示附件说明文字

• AC11.4 已报名用户点击"取消报名"并确认后，报名取消，附件自动删除

12. 附件上传（每人限制模式）

• AC12.1 上传弹窗显示附件说明、上传组件、已选附件预览、底部按钮（取消、确认报名）

• AC12.2 附件数量不符合要求时，点击"确认报名"提示错误

• AC12.3 图片超过5MB时，前端自动压缩到1080P

• AC12.4 附件格式不符合时，前端提示错误

• AC12.5 上传成功后，"我的参与状态"模块显示"已上传X张/份"

13. 附件上传（每户限制模式，v1.1.0新增）

• AC13.1 报名时显示"本户已有X人报名，共上传Y/Z个附件"

• AC13.2 当前上传数量 + 本户已上传数量 > 每户限制时，提示错误："本户已上传X个附件，最多允许上传Y个，您还可以上传Z个"

• AC13.3 上传成功后，系统正确统计本户附件总数

• AC13.4 同户其他用户取消报名后，本户附件总数相应减少

14. 附件更换

• AC14.1 已报名且活动需要上传附件时，显示"查看/更换附件"按钮

• AC14.2 点击按钮，进入附件管理界面，显示已上传的附件列表

• AC14.3 每户限制模式下，显示"本户已上传X/Y个附件，您已上传Z个"

• AC14.4 点击"更换附件"，选择新附件后自动替换旧附件，自动保存

• AC14.5 活动"已结束"或用户已领取后，不可更换附件

15. 报名限制

• AC15.1 同一用户不能重复报名同一个活动

• AC15.2 活动已满员时，按钮置灰显示"报名已满员"，点击无效

• AC15.3 活动"待举行"、"举行中"、"已结束"、"已取消"状态时，不可报名

16. 互动功能

• AC16.1 点击收藏按钮，按钮高亮（红色），PC后台"收藏数"+1

• AC16.2 再次点击，取消收藏，按钮恢复默认色，"收藏数"-1

• AC16.3 已收藏的活动显示在"我的 - 收藏 - 活动"列表中

• AC16.4 成功分享给好友后，PC后台"分享数"+1

17. 活动提醒弹窗（v1.1.0新增）

• AC17.1 进入小程序首页时，如有正在"举行中"的活动，自动弹出提醒弹窗

• AC17.2 弹窗显示活动封面、标题、时间段、"举行中"标签、"不再提醒"和"立即查看"按钮

• AC17.3 点击"立即查看"，跳转至活动详情页

• AC17.4 点击"不再提醒"，弹窗关闭，该活动不再弹出提醒，提示"已设置不再提醒该活动"

• AC17.5 点击蒙层，弹窗关闭，下次进入仍会弹出

• AC17.6 如有多个"举行中"活动，每次只弹出一个（最新创建的）

• AC17.7 用户清除小程序缓存后，已忽略的活动列表仍保留（服务器配置生效）

• AC17.8 活动结束后，自动从已忽略列表中移除

• AC17.9 活动状态为"待举行"、"报名中"、"已结束"、"已取消"时，不弹出提醒

18. 我的参与状态

• AC18.1 已报名时，详情页显示"我的参与状态"模块：报名状态、报名时间、已上传附件、领取状态

• AC18.2 物业确认领取后，领取状态实时更新为"已领取"（绿色对勾）

四、性能与兼容性

19. 性能要求

• AC19.1 活动列表加载时间 < 2秒（100条数据）

• AC19.2 活动详情页加载时间 < 1秒

• AC19.3 报名列表查询响应时间 < 1秒

• AC19.4 活动提醒弹窗检测时间 < 500ms

20. 兼容性

• AC20.1 PC后台在Chrome、Edge、Safari最新版本正常运行

• AC20.2 小程序兼容微信小程序基础库 >= 2.10.0

• AC20.3 移动端适配iOS 12+、Android 8.0+

21. 安全

• AC21.1 附件上传前端校验文件格式和大小，阻止恶意文件上传

• AC21.2 附件存储使用私有权限，非授权用户访问附件URL返回403错误

• AC21.3 手机号在列表中显示为脱敏格式（138****5678），导出Excel时显示完整号码