需求背景

基于需求#127的议事投票功能,对议事投票模块进行功能完善和优化。

参考需求

原型设计:https://axhub.im/ax9/14c228b50b05a716/#g=1&id=1dpw28&p=%E8%AE%AE%E4%BA%8B%E6%8A%95%E7%A5%A8-%E4%B8%AD

PC后管页面(议事投票部分):https://readdy.link/share/0a81a070f9c043e27a863c6b41ae88bf

小程序设计稿:Figma设计稿

推送内容说明:系统通知汇总

核心功能模块

1. 物业小程序:复用业委会现有的满意度调查模块,为物业提供移动端投票管理功能

2. PC后管:整合物业、业委会发起的投票数据,统一管理议事投票

3. 住户/业主小程序:统一的投票入口,展示所有投票内容

详细功能说明

一、议事投票列表

表格字段:

• 投票主题:投票的名称
• 描述:投票内容描述
• 开始时间/截止时间:投票时间范围
• 投票范围:小区范围/楼栋范围/分户范围/房屋类型范围,可过滤住户角色
• 投票人数/总人数:实际投票人数/选定范围内的总人数
• 题目数:单选、多选、评分题目总数
• 状态:草稿/待投票/投票中/已完成
• 实际结束时间:截止时间或提前中止操作的时间
• 操作:继续编辑/修改/删除/查看投票情况/提前结束/统计结果

二、创建/编辑投票

基础信息:

• 投票主题(必填,15字以内)
• 内容描述(非必填,500字以内)
• 附件上传(图片/文件,50M以内)

时间范围:

• 开始时间(必填,必须大于当前时间)
• 截止时间(必填,必须大于开始时间)

问题配置:

• 题目名称(必填,15字以内)
• 题目类型:单选/多选/评分
• 选项:最多5条
• 评分分值:正整数,最大10分

投票范围:

• 房屋范围:小区/楼栋/分户/房屋类型
• 住户范围:业主/租户/家属/其他(可多选)

三、投票管理功能

• 保存草稿:不校验必填项,状态为草稿,仅创建人可见
• 创建投票:校验必填项,推送给投票范围内住户
• 提前结束:投票中状态可提前结束,需二次确认
• 删除:草稿/待投票状态可删除,需二次确认
• 查看投票情况:投票中状态可查看实时统计
• 统计结果:已完成状态可查看完整结果,含AI总结

四、住户端功能

• 正在投票:展示待投票/投票中状态的投票
• 历史投票:展示已完成状态的投票
• 投票详情:查看投票内容,提交投票选择
• 投票结果:查看统计结果和自己的选择

验收标准

一、功能完整性验收

1. PC后管-议事投票模块

• [ ] 投票列表正确展示所有字段(主题、描述、时间、范围、人数、题目数、状态等)
• [ ] 搜索功能正常(投票主题模糊搜索、状态下拉、时间范围筛选)
• [ ] 创建投票功能正常,表单校验准确
• [ ] 投票人数列表弹框正常,展示投票人、房号、投票时间
• [ ] 草稿状态可继续编辑,数据正确回填
• [ ] 待投票状态可修改,数据正确回填
• [ ] 草稿/待投票状态可删除,含二次确认
• [ ] 投票中状态可查看投票情况,实时统计准确
• [ ] 投票中状态可提前结束,含二次确认,状态正确变更
• [ ] 已完成状态可查看统计结果,数据准确

2. 创建/编辑投票表单验收

• [ ] 投票主题:必填校验,15字限制
• [ ] 内容描述:500字限制
• [ ] 附件上传:支持图片/文件,50M限制,数量无限制
• [ ] 开始时间:必填,必须大于当前时间
• [ ] 截止时间:必填,必须大于开始时间
• [ ] 题目名称:必填,15字限制
• [ ] 题目类型:单选/多选/评分正常切换
• [ ] 选项:最多5条限制
• [ ] 评分分值:正整数,最大10分
• [ ] 房屋范围:单选,楼栋/分户/房屋类型可多选
• [ ] 住户范围:可多选角色(业主/租户/家属/其他)
• [ ] 保存草稿:不校验,状态正确
• [ ] 创建投票:完整校验,推送正常

3. 投票统计验收

• [ ] 参与情况:户数参与率、人数参与率计算准确
• [ ] 单选题统计:参与人数、各选项人数、百分比正确
• [ ] 多选题统计:参与人数、各选项人数、百分比正确
• [ ] 评分题统计:参与人数、各分数人数、平均分计算准确
• [ ] 楼栋参与分布:楼栋投票人数/总人数正确,水平滚动正常
• [ ] 结果总结:有效投票、弃权人数计算准确
• [ ] AI总结功能正常,字数200以内

4. 物业小程序验收

• [ ] 复用业委会满意度调查模块
• [ ] 功能与PC后管保持一致
• [ ] 数据同步正常

5. 住户/业主小程序验收

• [ ] 只展示投票范围内的投票
• [ ] 正在投票:只展示待投票/投票中状态,按开始时间正序
• [ ] 历史投票:只展示已完成状态,按结束时间倒序
• [ ] 待投票状态:无功能按钮,不能进入详情
• [ ] 投票中状态-未投票:可进入投票页面,提交投票
• [ ] 投票中状态-已投票:可查看自己的投票选择
• [ ] 已完成状态:可查看投票结果,含自己的选择
• [ ] 附件可正常查看
• [ ] 单选/多选/评分功能正常
• [ ] 确认投票功能正常,记录正确

二、状态流转验收

• [ ] 草稿状态:仅创建人可见,住户端不可见
• [ ] 待投票状态:开始时间未到,可修改/删除
• [ ] 投票中状态:当前时间>开始时间,可查看情况/提前结束
• [ ] 已完成状态:到达截止时间或提前结束,可查看统计结果
• [ ] 实际结束时间:截止时间或提前中止时间,记录准确

三、推送通知验收

• [ ] 创建投票时推送给投票范围内所有住户
• [ ] 投票结果生成时推送给创建人
• [ ] 推送渠道:优先服务号,其次企业微信/线上客服
• [ ] 推送内容符合腾讯文档规范

四、数据准确性验收

• [ ] 投票人数统计准确
• [ ] 总人数根据投票范围计算准确
• [ ] 户数参与率计算准确(去重房屋数)
• [ ] 人数参与率计算准确
• [ ] 各选项票数统计准确
• [ ] 百分比计算准确
• [ ] 评分平均分计算准确

五、边界场景验收

• [ ] 投票范围为空时的处理
• [ ] 无人投票时的统计显示
• [ ] 附件大小超限提示
• [ ] 字数超限提示
• [ ] 时间选择异常提示
• [ ] 网络异常时的容错处理
• [ ] 并发投票时的数据一致性

六、界面交互验收

• [ ] 界面与原型设计一致
• [ ] PC后管与Readdy页面一致
• [ ] 小程序与Figma设计稿一致
• [ ] 弹框显示正常
• [ ] 二次确认提示清晰
• [ ] 表单校验提示友好
• [ ] 水平滚动流畅

七、性能验收

• [ ] 列表加载速度<2秒
• [ ] 投票提交响应<1秒
• [ ] 统计结果生成<3秒
• [ ] AI总结生成<5秒
• [ ] 大量数据时分页/滚动正常

八、兼容性验收

• [ ] PC端主流浏览器(Chrome、Edge、Firefox)正常
• [ ] 小程序在微信最新版本正常
• [ ] 不同分辨率下显示正常