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