18 KiB
Ether 项目需求澄清文档
创建日期: 2026-02-12
状态: 待确认
用途: 测试用例编写前的需求澄清
一、登录认证模块
Q1: 密码复杂度要求
问题: 密码复杂度要求是什么？（长度、特殊字符、大小写等）
回答: 密码长度至少8位，包含至少1个大写字母、1个小写字母、1个数字和1个特殊字符。
Q2: 登录失败限制
问题: 登录失败次数限制是多少？锁定时长？
回答: 登录失败次数限制为5次，锁定时长为15分钟。
Q3: Token配置
问题: Token过期时间是多少？刷新Token机制是否已实现？
回答: Token过期时间为15分钟，刷新Token机制已实现。
Q4: 多端登录
问题: 是否支持多端登录？同一账号同时登录限制？
回答: 支持多端登录，同一账号同时登录限制为3个设备。
二、用户管理模块
Q5: 默认密码
问题: 用户创建时，默认密码是什么？是否需要强制修改？
回答: 用户创建时，默认密码为随机生成的8位密码，用户登录后需要强制修改。
Q6: 删除方式
问题: 用户删除是物理删除还是逻辑删除？
回答: 逻辑删除，用户数据会被标记为删除状态，保留在数据库中。
Q7: 状态变更处理
问题: 用户状态变更（锁定/禁用）后，已登录用户如何处理？
回答: 已登录用户会被强制登出，需要重新登录。
三、角色权限模块
Q8: 系统预设角色
问题: 系统预设角色有哪些？是否可以删除？
回答: 系统预设角色有超级管理员。不能删除。
Q9: 批量操作
问题: 权限分配时，是否支持批量操作？
回答: 支持批量操作。
Q10: 数据权限
问题: 数据权限（ALL/DEPT/SELF）具体如何影响数据查询？
回答: ALL：查询所有数据；DEPT：查询本部门及以下数据；SELF：仅查询本用户数据。
四、项目管理模块
Q11: 项目编码规则
问题: 项目编码规则是什么？
回答: 项目编码规则为项目名称的首字母缩写，例如：“项目A”的编码为“PA”。
Q12: 项目状态变更
问题: 项目状态变更（暂停/终止）后，关联数据如何处理？
回答: 暂停：暂停项目所有活动，保留数据；终止：逻辑删除项目数据。
Q13: 管理员权限区别
问题: 超级管理员与普通项目管理员的权限区别？
回答: 超级管理员拥有所有系统权限，系统初始化的时候需要超级管理员创建项目，配置权限和对应用户账户。然后分配好项目权限后，由创建的项目管理员（权限配置而来）进行具体的业务管理。
五、工单管理模块
Q14: SLA标准
问题: 工单超时预警时间是多少？SLA标准是什么？
回答: 工单超时预警时间为1天，SLA标准为1天内处理完成。
Q15: 分配规则
问题: 工单分配规则是什么？手动分配还是自动分配？
回答: 自动分配，根据工单类型和当前项目管理员的权限，自动分配工单给合适的用户。
Q16: 满意度评价
问题: 工单满意度评价是否必填？评分范围？
回答: 满意度评价必填，评分范围为1-5分。
六、巡检管理模块
Q17: 逾期处理
问题: 巡检任务逾期后的处理逻辑？
回答: 巡检任务逾期后，会自动创建工单，工单状态为“超时”。
Q18: 异常自动工单
问题: 巡检异常项是否自动创建工单？
回答: 是，异常项会自动创建工单，工单状态为“异常”。
七、访客管理模块
Q19: 二维码有效期
问题: 访客二维码有效期是多少？
回答: 访客二维码有效期为1天。
Q20: 黑名单范围
问题: 访客黑名单的生效范围？项目级还是全局？
回答: 项目级，仅对当前项目生效。
八、设备管理模块
Q21: 维保提醒
问题: 设备维保到期提醒提前多少天？
回答: 设备维保到期提醒提前15天。
Q22: 故障自动工单
问题: 设备故障是否自动创建维修工单？
回答: 是，设备故障会自动创建维修工单，工单状态为“故障”。
九、测试范围确认
请确认以下测试范围是否正确：
| 模块 | 测试范围 | 优先级 | 确认 |
|---|---|---|---|
| 登录认证 | 登录、登出、Token刷新、密码修改 | P0 | 已确认 |
| 用户管理 | CRUD、角色分配、状态变更 | P0 | 已确认 |
| 角色管理 | CRUD、权限分配 | P0 | 已确认 |
| 权限管理 | 菜单权限、按钮权限、API权限 | P0 | 已确认 |
| 项目管理 | CRUD、项目切换 | P0 | 已确认 |
| 工单管理 | CRUD、状态流转、分配、统计 | P1 | 已确认 |
| 巡检管理 | 计划、任务、记录 | P1 | 已确认 |
| 访客管理 | 预约、凭证、黑名单 | P1 | 已确认 |
| 设备管理 | 台账、维保 | P2 | 已确认 |
十、测试环境确认
Q23: 测试数据库
问题: 是否使用独立的测试数据库？
回答: 是，使用独立的测试数据库。
Q24: 测试账号
问题: 是否已准备好不同角色的测试账号？
回答: 未准备，配置符合业务需要的权限账户也是测试范围之一。
Q25: 测试数据
问题: 是否需要准备初始化测试数据？
回答: 是，需要准备初始化测试数据。
十一、E2E测试修复澄清
Q26: 用户管理页面功能确认
问题: 当前用户管理页面代码中没有"新增用户"按钮，也没有"锁定/禁用"按钮。请确认：
- 用户管理页面是否需要实现"新增用户"功能？
- 是否需要实现"锁定/禁用用户"功能？ 回答:需要新增用户，也需要实现锁定/禁用用户
Q27: 角色管理按钮文本确认
问题: 角色管理页面的按钮文本是"新建角色"，测试用例中查找"新增角色"。请确认：
- 是否修改测试用例为"新建角色"？ 回答:新建角色
Q28: 项目管理成员功能确认
问题: 当前项目管理页面没有"添加成员"相关按钮。请确认：
- 项目管理页面是否需要"添加成员"功能？还是这个功能在其他地方实现？ 回答:添加项目负责人，被添加的用户自动拥有该项目下的最高权限。并可以为该项目下的工单、巡检等业务模块分配具体的人员。被分配到的人员自动拥有该项目下的对应业务功能权限。
Q29: 工单管理按钮文本确认
问题: 工单管理页面的按钮文本是"创建工单"，测试用例中查找"新增工单"。请确认：
- 是否修改测试用例为"创建工单"？ 回答:新增工单
Q30: 工单表格显示问题
问题: 测试中发现工单表格未显示，可能是组件加载问题。请确认：
- 工单列表功能是否已完整实现？ 回答:应该完整实现，如果没有实现则需要完成具体代码。
十二、APP端开发澄清（业主端小程序）
Q31: 微信开放平台账号
问题: 微信开放平台账号是否已申请？小程序AppID和AppSecret是否已获取？
回答: 尚未申请，但是可以去做，开发阶段是否可以先跳过，需要客户去做
Q32: 微信支付商户号
问题: 微信支付商户号是否已申请？支付权限是否已开通？
回答: 尚未申请，但是可以去做，开发阶段是否可以先跳过，需要客户去做
Q33: 支付宝商户号
问题: 支付宝商户号是否已申请？支付权限是否已开通？
回答: 尚未申请，但是可以去做，开发阶段是否可以先跳过，需要客户去做
Q34: 房产绑定认证方式
问题: 业主房产绑定的认证方式是什么？
- 是否需要上传房产证照片？
- 是否需要人脸识别认证？
- 是否需要物业人工审核？ 回答: 选择小区（可默认），门牌幢，分户，自己的手机号。物业后台需确认。
Q35: 访客邀请流程
问题: 访客邀请的完整流程是什么？
- 访客凭证有效期是多久？
- 是否需要被访业主确认？
- 访客是否需要提前预约？ 回答: 访客有效期是一天，但是二维码凭证每30秒刷新一次。需要被访业主确认。可以预约也可以临时申请。
Q36: 业主端登录方式
问题: 业主端小程序支持哪些登录方式？
- 微信授权登录（必选）
- 手机号验证码登录？
- 账号密码登录？ 回答: 微信，手机号密码登录
Q37: 家庭成员管理
问题: 家庭成员管理的具体规则是什么？
- 一个房产最多绑定多少家庭成员？
- 家庭成员权限范围？
- 是否需要业主审核？ 回答: 住宅类可以绑定7个，商业物业不限制。家庭成员权限一致。不需要业主审核。
Q38: 小程序发布
问题: 小程序发布相关
- 小程序名称是否已确定？
- 小程序类目是否已选择？
- 是否需要ICP备案？ 回答: 尚未完成，我是一个软件产品，在测试阶段是否需要做完这些？
十三、APP端开发澄清（物业员工APP）
Q39: 推送服务选型
问题: APP消息推送使用哪个服务商？
- 极光推送？
- 个推？
- 其他？
- 账号是否已申请？ 回答: 尚未确定，是否有推荐，请考虑效果和成本。
推荐方案: 极光推送（JPush）
- 优势: 免费版支持日推送量1000条，满足中小规模使用；SDK成熟稳定，文档完善；支持Android和iOS双平台
- 成本: 免费版可满足初期需求，付费版按月订阅，约299元/月起
- 建议: 开发阶段使用免费版，上线后根据推送量决定是否升级
Q40: 地图服务
问题: 地图服务使用哪个服务商？
- 高德地图？
- 腾讯地图？
- 百度地图？
- Key是否已申请？ 回答: 尚未确定，是否有推荐，请考虑效果和成本。
推荐方案: 高德地图
- 优势: 定位精度高，uni-app原生支持；免费版配额充足（日调用量30万次）；支持逆地理编码、路径规划等
- 成本: 个人开发者免费，企业认证后配额更高
- 建议: 使用高德地图，申请个人开发者Key即可开始开发，后续可升级企业认证
Q41: 离线存储范围
问题: 哪些数据需要离线存储？
- 工单列表？
- 巡检任务？
- 设备信息？
- 离线数据同步策略？ 回答: 均需离线存储
Q42: 地理位置上报
问题: 地理位置上报的具体规则？
- 上报频率？
- 是否需要用户授权？
- 隐私政策是否已准备？ 回答: 地理位置主要是在巡检，巡逻，拍照或者客户有交集的场景下扫二维码或NFC的时候触发获取。需要用户授权。隐私政策未准备。
Q43: APP发布渠道
问题: APP发布渠道是什么？
- 应用商店上架（哪些商店）？
- 企业内部分发？
- 是否需要软著？ 回答: APP企业内部分发。最好有软著。
Q44: 员工端登录方式
问题: 员工APP登录方式是什么？
- 使用现有Web端账号？
- 独立账号体系？
- 是否支持手机号验证码登录？ 回答: 使用现有web账户。不支持其他方式。
Q45: 扫码功能范围
问题: 扫码功能支持哪些场景？
- 设备二维码报修？
- 巡检点签到？
- 访客凭证验证？
- 是否需要支持条形码？ 回答: 以上均支持。
十四、APP端技术架构澄清
Q46: 后端API复用
问题: APP端API是否复用现有Web端API？
- 完全复用？
- 需要新增专用API？
- 是否需要API版本管理？ 回答: 完全复用。
Q47: Token管理策略
问题: APP端Token管理策略是什么？
- 与Web端共用Token？
- 独立Token体系？
- Token刷新机制？
- 多设备登录限制？ 回答: 独立Token体系，允许多设备登录。
Q48: 项目结构规划
问题: APP项目结构如何规划？
- 业主端和员工端是否独立项目？
- 是否共享公共组件？
- 项目目录位置？ 回答: 独立项目，不共享组件（app和小程序受众，功能不一致），目录放在根目录下各自独立。
Q49: 开发优先级
问题: APP端开发优先级如何排序？
- 先开发业主端还是员工端？
- 是否可以并行开发？
- 核心功能优先级？ 回答: 并行开发。我将分两个对话进行。
Q50: 测试环境
问题: APP端测试环境如何准备？
- 是否需要独立的测试服务器？
- 测试账号如何准备？
- 支付测试环境如何配置？ 回答: 先考虑如何本地测试。
十五、APP端开发准备情况评估
15.1 需求准备情况
| 项目 | 状态 | 说明 |
|---|---|---|
| 功能清单 | ✅ 已完成 | 业主端23个特性，员工端22个特性 |
| 页面结构 | ✅ 已完成 | 详细的页面目录结构已设计 |
| 工作量估算 | ✅ 已完成 | 总计106人天 |
| 业务流程 | ✅ 已完成 | 房产认证、访客流程等已澄清 |
| 用户角色 | ✅ 已完成 | 业主、租户、员工角色已定义 |
15.2 技术准备情况
| 项目 | 状态 | 说明 |
|---|---|---|
| 技术选型 | ✅ 已完成 | uni-app + Vant Weapp / uView UI |
| 后端API | ✅ 已完成 | 完全复用现有Web端API |
| 认证授权 | ✅ 已完成 | 独立Token体系，允许多设备登录 |
| 项目结构 | ✅ 已完成 | 独立项目，根目录下各自独立 |
| 推送服务 | ✅ 已确定 | 推荐使用极光推送（JPush） |
| 地图服务 | ✅ 已确定 | 推荐使用高德地图 |
15.3 外部依赖情况
| 依赖项 | 状态 | 影响 | 开发阶段处理方案 |
|---|---|---|---|
| 微信开放平台账号 | ⚠️ 待申请 | 影响微信登录 | 先跳过，使用手机号登录测试 |
| 微信支付商户号 | ⚠️ 待申请 | 影响在线支付 | 先跳过，模拟支付流程 |
| 支付宝商户号 | ⚠️ 待申请 | 影响支付宝支付 | 先跳过，模拟支付流程 |
| 极光推送账号 | ⚠️ 待申请 | 影响APP消息推送 | 开发阶段可使用免费版 |
| 高德地图Key | ⚠️ 待申请 | 影响地图功能 | 申请个人开发者Key即可 |
15.4 关键澄清结果总结
| 问题项 | 澄清结果 |
|---|---|
| 房产绑定认证 | 选择小区+门牌幢+分户+手机号，物业后台确认 |
| 访客邀请流程 | 有效期1天，二维码30秒刷新，需业主确认，可预约或临时申请 |
| 业主端登录 | 微信授权 + 手机号密码登录 |
| 家庭成员 | 住宅类最多7人，商业物业不限制，权限一致，无需审核 |
| 员工端登录 | 使用现有Web端账号，不支持其他方式 |
| 扫码功能 | 支持设备二维码、巡检点签到、访客凭证验证、条形码 |
| 离线存储 | 工单、巡检、设备信息均需离线存储 |
| 地理位置上报 | 巡检/巡逻/拍照/扫码时触发，需用户授权 |
| APP发布 | 企业内部分发，建议申请软著 |
| 后端API | 完全复用现有Web端API |
| Token管理 | 独立Token体系，允许多设备登录 |
| 项目结构 | 业主端和员工端独立项目，根目录下各自独立 |
| 开发优先级 | 并行开发，分两个对话进行 |
| 测试环境 | 先考虑本地测试 |
15.5 开发建议
✅ 已具备开发条件，可以立即开始：
- ✅ 项目框架搭建（uni-app初始化）
- ✅ 基础组件开发（导航栏、列表、表单等）
- ✅ API请求封装（复用现有后端API）
- ✅ 状态管理配置
- ✅ 工单列表、详情展示
- ✅ 巡检任务执行
- ✅ 访客登记核验
- ✅ 个人中心
⏸️ 开发阶段可跳过/模拟的功能：
- ⏸️ 微信登录 → 使用手机号密码登录测试
- ⏸️ 在线支付 → 模拟支付流程
- ⏸️ 消息推送 → 使用极光推送免费版
- ⏸️ 地图功能 → 申请高德地图个人开发者Key
📋 建议的开发顺序：
- 第1周：项目框架搭建 + 基础组件 + API封装
- 第2周：登录认证 + 首页 + 工单模块
- 第3周：巡检模块 + 访客模块
- 第4周：个人中心 + 消息通知 + 测试优化
填写说明
- 请在每条问题的"回答"后填写具体答案
- 如有补充问题，可在相应模块下添加
- 填写完成后通知我，我将读取文件并开始开发
- APP端开发建议：可以先开始项目框架搭建，同时并行申请外部服务账号