# 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端开发建议**：可以先开始项目框架搭建，同时并行申请外部服务账号