512 lines
18 KiB
Markdown
512 lines
18 KiB
Markdown
# 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: 用户管理页面功能确认
|
||
|
||
**问题**: 当前用户管理页面代码中没有"新增用户"按钮，也没有"锁定/禁用"按钮。请确认：
|
||
|
||
1. 用户管理页面是否需要实现"新增用户"功能？
|
||
2. 是否需要实现"锁定/禁用用户"功能？
|
||
**回答**:需要新增用户，也需要实现锁定/禁用用户
|
||
|
||
### 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 开发建议
|
||
|
||
**✅ 已具备开发条件，可以立即开始：**
|
||
|
||
1. ✅ 项目框架搭建（uni-app初始化）
|
||
2. ✅ 基础组件开发（导航栏、列表、表单等）
|
||
3. ✅ API请求封装（复用现有后端API）
|
||
4. ✅ 状态管理配置
|
||
5. ✅ 工单列表、详情展示
|
||
6. ✅ 巡检任务执行
|
||
7. ✅ 访客登记核验
|
||
8. ✅ 个人中心
|
||
|
||
**⏸️ 开发阶段可跳过/模拟的功能：**
|
||
|
||
1. ⏸️ 微信登录 → 使用手机号密码登录测试
|
||
2. ⏸️ 在线支付 → 模拟支付流程
|
||
3. ⏸️ 消息推送 → 使用极光推送免费版
|
||
4. ⏸️ 地图功能 → 申请高德地图个人开发者Key
|
||
|
||
**📋 建议的开发顺序：**
|
||
|
||
1. **第1周**：项目框架搭建 + 基础组件 + API封装
|
||
2. **第2周**：登录认证 + 首页 + 工单模块
|
||
3. **第3周**：巡检模块 + 访客模块
|
||
4. **第4周**：个人中心 + 消息通知 + 测试优化
|
||
|
||
---
|
||
|
||
## 填写说明
|
||
|
||
1. 请在每条问题的"**回答**"后填写具体答案
|
||
2. 如有补充问题，可在相应模块下添加
|
||
3. 填写完成后通知我，我将读取文件并开始开发
|
||
4. **APP端开发建议**：可以先开始项目框架搭建，同时并行申请外部服务账号
|