ether-docs/_archive/DEVELOPMENT_ROADMAP.md

1229 lines
68 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Ether 智慧物业管理平台 - 开发任务排期表
**文档版本**: v1.0
**创建日期**: 2026-02-14
**最后更新**: 2026-02-14
---
## 一、功能状态说明
| 状态 | 含义 |
| --------- | ---------------------------- |
| ✅ 已完成 | 功能开发完成并通过测试 |
| 🔄 进行中 | 功能正在开发 |
| ⬜ 待开发 | 功能已排期,等待开发 |
| ⏸️ 已暂停 | 功能暂停开发,待后续需求明确 |
| ❌ 已取消 | 功能不再需要 |
---
## 二、暂停开发功能
以下功能暂停开发,待后续有需求后再完成:
| 编号 | 功能模块 | 功能名称 | 暂停原因 |
| --------- | -------- | ------------------------------ | -------------- |
| PAUSE-B01 | 商业物业 | 招商租赁管理 | 待后续需求明确 |
| PAUSE-B02 | 商业物业 | 商业物业服务 | 待后续需求明确 |
| PAUSE-B03 | 商业物业 | 押金管理 | 待后续需求明确 |
| PAUSE-R01 | 住宅物业 | 业主服务(业委会、投票) | 待后续需求明确 |
| PAUSE-R02 | 住宅物业 | 社区运营(活动、论坛) | 待后续需求明确 |
| PAUSE-R03 | 住宅物业 | 社区安全(电子围栏、紧急求助) | 待后续需求明确 |
| PAUSE-R04 | 住宅物业 | 智能家居 | 待后续需求明确 |
---
## 三、开发排期总览
```
┌─────────────────────────────────────────────────────────────────────────┐
│ Ether 开发排期总览 │
├─────────────────────────────────────────────────────────────────────────┤
│ ████████████████████████████████████████████████░░░░░░░░░░ 72.6% │
│ 已完成: 106 特性 | 待开发: 54 特性 | 已暂停: 7 特性 │
└─────────────────────────────────────────────────────────────────────────┘
```
---
## 四、第一阶段:业务闭环完善
**目标**: 实现核心业务闭环,让系统能够独立运行
**预计周期**: 4-6 周
**开始时间**: 待定
### 4.1 业主端小程序
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------------------ | --------- | ---------- | ---------- | ------ | ------ |
| P1-001 | 用户登录注册(微信授权) | ⬜ 待开发 | 3人天 | 2人天 | P0 | - |
| P1-002 | 房产绑定认证 | ⬜ 待开发 | 2人天 | 2人天 | P0 | P1-001 |
| P1-003 | 在线报修功能 | ⬜ 待开发 | 3人天 | 2人天 | P0 | P1-001 |
| P1-004 | 账单查询功能 | ⬜ 待开发 | 2人天 | 1人天 | P0 | P1-001 |
| P1-005 | 访客邀请功能 | ⬜ 待开发 | 2人天 | 2人天 | P1 | P1-001 |
| P1-006 | 投诉建议功能 | ⬜ 待开发 | 2人天 | 2人天 | P1 | P1-001 |
| P1-007 | 个人中心页面 | ⬜ 待开发 | 2人天 | 1人天 | P1 | P1-001 |
| P1-008 | 消息通知功能 | ⬜ 待开发 | 1人天 | 1人天 | P1 | P1-001 |
**小计**: 前端 17人天后端 13人天共 30人天
### 4.2 在线支付集成
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P1-010 | 微信支付对接 | ⬜ 待开发 | 2人天 | 4人天 | P0 | - |
| P1-011 | 支付回调处理 | ⬜ 待开发 | - | 2人天 | P0 | P1-010 |
| P1-012 | 缴费状态同步 | ⬜ 待开发 | 1人天 | 1人天 | P0 | P1-011 |
**小计**: 前端 3人天后端 7人天共 10人天
### 4.3 费用报表导出
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ---------------- | --------- | ---------- | ---------- | ------ | ------ |
| P1-020 | 账单导出Excel | ✅ 已完成 | 1人天 | 2人天 | P1 | - |
| P1-021 | 收费统计报表导出 | ✅ 已完成 | 1人天 | 2人天 | P1 | P1-020 |
| P1-022 | 业主缴费明细导出 | ✅ 已完成 | 1人天 | 1人天 | P2 | P1-020 |
**小计**: 前端 3人天后端 5人天共 8人天
### 4.4 工单满意度评价
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------------ | --------- | ---------- | ---------- | ------ | ------ |
| P1-030 | 评价表单(业主端) | ✅ 已完成 | 2人天 | 1人天 | P1 | P1-001 |
| P1-031 | 评价统计(管理端) | ✅ 已完成 | 1人天 | 2人天 | P1 | P1-030 |
| P1-032 | 满意度报表 | ✅ 已完成 | 1人天 | 1人天 | P2 | P1-031 |
**小计**: 前端 4人天后端 4人天共 8人天
### 第一阶段汇总
| 分类 | 前端工作量 | 后端工作量 | 总工作量 |
| -------------- | ---------- | ---------- | ---------- |
| 业主端小程序 | 17人天 | 13人天 | 30人天 |
| 在线支付集成 | 3人天 | 7人天 | 10人天 |
| 费用报表导出 | 3人天 | 5人天 | 8人天 |
| 工单满意度评价 | 4人天 | 4人天 | 8人天 |
| **合计** | **27人天** | **29人天** | **56人天** |
---
## 五、第二阶段:运营效率提升
**目标**: 提升物业运营效率,优化用户体验
**预计周期**: 3-4 周
**开始时间**: 第一阶段完成后
### 5.1 物业员工APP
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P2-001 | APP框架搭建 | ⬜ 待开发 | 2人天 | 1人天 | P0 | - |
| P2-002 | 用户登录 | ⬜ 待开发 | 1人天 | 1人天 | P0 | P2-001 |
| P2-003 | 工作台首页 | ⬜ 待开发 | 2人天 | 1人天 | P0 | P2-002 |
| P2-004 | 工单处理功能 | ⬜ 待开发 | 3人天 | 2人天 | P0 | P2-002 |
| P2-005 | 扫码报修功能 | ⬜ 待开发 | 2人天 | 1人天 | P1 | P2-004 |
| P2-006 | 巡检任务执行 | ⬜ 待开发 | 2人天 | 1人天 | P1 | P2-002 |
| P2-007 | 访客登记核验 | ⬜ 待开发 | 2人天 | 1人天 | P1 | P2-002 |
| P2-008 | 消息通知 | ⬜ 待开发 | 1人天 | 1人天 | P1 | P2-002 |
**小计**: 前端 15人天后端 9人天共 24人天
### 5.2 设备二维码功能
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P2-010 | 二维码生成 | ✅ 已完成 | 1人天 | 2人天 | P1 | - |
| P2-011 | 扫码查看设备 | ✅ 已完成 | 2人天 | 1人天 | P1 | P2-010 |
| P2-012 | 扫码快速报修 | ✅ 已完成 | 1人天 | 1人天 | P1 | P2-011 |
**小计**: 前端 4人天后端 4人天共 8人天
### 5.3 SLA监控预警
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P2-020 | 工单时效监控 | ✅ 已完成 | 2人天 | 2人天 | P1 | - |
| P2-021 | 超时预警通知 | ✅ 已完成 | 1人天 | 2人天 | P1 | P2-020 |
| P2-022 | 升级处理机制 | ✅ 已完成 | 1人天 | 2人天 | P2 | P2-021 |
**小计**: 前端 4人天后端 6人天共 10人天
### 5.4 报表统计功能
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ---------- |
| P2-030 | 工单统计报表 | ✅ 已完成 | 2人天 | 2人天 | P1 | - |
| P2-031 | 巡检统计报表 | ✅ 已完成 | 1人天 | 2人天 | P1 | - |
| P2-032 | 设备统计报表 | ✅ 已完成 | 1人天 | 2人天 | P2 | - |
| P2-033 | 综合运营报表 | ✅ 已完成 | 2人天 | 2人天 | P2 | P2-030~032 |
**小计**: 前端 6人天后端 8人天共 14人天
### 第二阶段汇总
| 分类 | 前端工作量 | 后端工作量 | 总工作量 |
| -------------- | ---------- | ---------- | ---------- |
| 物业员工APP | 15人天 | 9人天 | 24人天 |
| 设备二维码功能 | 4人天 | 4人天 | 8人天 |
| SLA监控预警 | 4人天 | 6人天 | 10人天 |
| 报表统计功能 | 6人天 | 8人天 | 14人天 |
| **合计** | **29人天** | **27人天** | **56人天** |
---
## 六、第三阶段:商业物业功能
**目标**: 支持商业物业管理场景
**预计周期**: 3-4 周
**开始时间**: 第二阶段完成后
### 6.1 租户管理
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P3-001 | 租户信息管理 | ✅ 已完成 | 3人天 | 3人天 | P1 | - |
| P3-002 | 租赁合同管理 | ✅ 已完成 | 3人天 | 3人天 | P1 | P3-001 |
| P3-003 | 合同到期提醒 | ✅ 已完成 | 1人天 | 2人天 | P1 | P3-002 |
**小计**: 前端 7人天后端 8人天共 15人天
### 6.2 车位管理
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------- | --------- | ---------- | ---------- | ------ | ------ |
| P3-010 | 车位信息管理 | ✅ 已完成 | 2人天 | 3人天 | P1 | - |
| P3-011 | 车位租赁/出售 | ✅ 已完成 | 2人天 | 2人天 | P1 | P3-010 |
| P3-012 | 车位状态监控 | ✅ 已完成 | 1人天 | 2人天 | P2 | P3-010 |
**小计**: 前端 5人天后端 7人天共 12人天
### 6.3 能耗管理
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P3-020 | 能耗设备管理 | ✅ 已完成 | 2人天 | 2人天 | P2 | - |
| P3-021 | 能耗数据录入 | ✅ 已完成 | 2人天 | 2人天 | P2 | P3-020 |
| P3-022 | 能耗费用计算 | ✅ 已完成 | 1人天 | 3人天 | P2 | P3-021 |
| P3-023 | 能耗报表分析 | ✅ 已完成 | 2人天 | 2人天 | P2 | P3-022 |
**小计**: 前端 7人天后端 9人天共 16人天
### 第三阶段汇总
| 分类 | 前端工作量 | 后端工作量 | 总工作量 |
| -------- | ---------- | ---------- | ---------- |
| 租户管理 | 7人天 | 8人天 | 15人天 |
| 车位管理 | 5人天 | 7人天 | 12人天 |
| 能耗管理 | 7人天 | 9人天 | 16人天 |
| **合计** | **19人天** | **24人天** | **43人天** |
---
## 七、第四阶段:第三方集成
**目标**: 对接外部系统,实现智能化运营
**预计周期**: 3-4 周
**开始时间**: 第三阶段完成后
### 7.1 集成平台架构
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P4-001 | 集成配置管理 | ⬜ 待开发 | 2人天 | 4人天 | P1 | - |
| P4-002 | 适配器框架 | ⬜ 待开发 | - | 4人天 | P1 | P4-001 |
| P4-003 | 数据同步引擎 | ⬜ 待开发 | - | 3人天 | P1 | P4-002 |
**小计**: 前端 2人天后端 11人天共 13人天
### 7.2 停车系统集成
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | -------------- | --------- | ---------- | ---------- | ------ | ------ |
| P4-010 | 停车系统适配器 | ⬜ 待开发 | - | 3人天 | P1 | P4-002 |
| P4-011 | 车位状态同步 | ⬜ 待开发 | 1人天 | 2人天 | P1 | P4-010 |
| P4-012 | 停车记录同步 | ⬜ 待开发 | 1人天 | 2人天 | P2 | P4-010 |
**小计**: 前端 2人天后端 7人天共 9人天
### 7.3 明源云对接
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P4-020 | 明源云适配器 | ⬜ 待开发 | - | 3人天 | P1 | P4-002 |
| P4-021 | 数据同步接口 | ⬜ 待开发 | 1人天 | 2人天 | P1 | P4-020 |
| P4-022 | 单点登录集成 | ⬜ 待开发 | 1人天 | 2人天 | P2 | P4-020 |
**小计**: 前端 2人天后端 7人天共 9人天
### 7.4 IoT云平台对接
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------- | --------- | ---------- | ---------- | ------ | ------ |
| P4-030 | IoT平台适配器 | ⬜ 待开发 | - | 3人天 | P1 | P4-002 |
| P4-031 | MQTT消息接入 | ⬜ 待开发 | - | 3人天 | P1 | P4-030 |
| P4-032 | 设备状态监控 | ⬜ 待开发 | 1人天 | 2人天 | P1 | P4-031 |
| P4-033 | 故障自动报警 | ⬜ 待开发 | 1人天 | 2人天 | P1 | P4-032 |
**小计**: 前端 2人天后端 10人天共 12人天
### 7.5 财务系统对接
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | -------------- | --------- | ---------- | ---------- | ------ | ------ |
| P4-040 | 财务系统适配器 | ⬜ 待开发 | - | 3人天 | P2 | P4-002 |
| P4-041 | 凭证数据同步 | ⬜ 待开发 | 1人天 | 2人天 | P2 | P4-040 |
| P4-042 | 账务数据对接 | ⬜ 待开发 | 1人天 | 2人天 | P2 | P4-040 |
**小计**: 前端 2人天后端 7人天共 9人天
### 7.6 知识库管理
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P4-050 | 知识分类管理 | ✅ 已完成 | 1人天 | 1人天 | P2 | - |
| P4-051 | 知识文档管理 | ✅ 已完成 | 2人天 | 2人天 | P2 | P4-050 |
| P4-052 | 知识搜索 | ✅ 已完成 | 1人天 | 2人天 | P2 | P4-051 |
| P4-053 | 知识权限 | ✅ 已完成 | 1人天 | 1人天 | P2 | P4-051 |
**小计**: 前端 5人天后端 6人天共 11人天
### 7.7 公告管理
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P4-060 | 公告发布 | ✅ 已完成 | 1人天 | 1人天 | P2 | - |
| P4-061 | 公告推送 | ✅ 已完成 | 1人天 | 2人天 | P2 | P4-060 |
| P4-062 | 公告阅读确认 | ✅ 已完成 | 1人天 | 1人天 | P2 | P4-060 |
**小计**: 前端 3人天后端 4人天共 7人天
### 7.8 投诉管理
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | -------- | --------- | ---------- | ---------- | ------ | ------ |
| P4-070 | 投诉提交 | ✅ 已完成 | 1人天 | 1人天 | P2 | - |
| P4-071 | 投诉处理 | ✅ 已完成 | 2人天 | 2人天 | P2 | P4-070 |
| P4-072 | 投诉跟踪 | ✅ 已完成 | 1人天 | 1人天 | P2 | P4-071 |
| P4-073 | 投诉统计 | ✅ 已完成 | 1人天 | 2人天 | P2 | P4-071 |
**小计**: 前端 5人天后端 6人天共 11人天
### 7.9 满意度调查
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P4-080 | 调查问卷设计 | ✅ 已完成 | 2人天 | 2人天 | P2 | - |
| P4-081 | 问卷发布 | ✅ 已完成 | 1人天 | 1人天 | P2 | P4-080 |
| P4-082 | 问卷填写 | ✅ 已完成 | 2人天 | 1人天 | P2 | P4-081 |
| P4-083 | 结果统计 | ✅ 已完成 | 1人天 | 2人天 | P2 | P4-082 |
**小计**: 前端 6人天后端 6人天共 12人天
### 7.10 问卷投票
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | -------- | --------- | ---------- | ---------- | ------ | ------ |
| P4-090 | 投票创建 | ✅ 已完成 | 1人天 | 1人天 | P2 | - |
| P4-091 | 投票参与 | ✅ 已完成 | 1人天 | 1人天 | P2 | P4-090 |
| P4-092 | 投票统计 | ✅ 已完成 | 1人天 | 1人天 | P2 | P4-091 |
**小计**: 前端 3人天后端 3人天共 6人天
### 第四阶段汇总
| 分类 | 前端工作量 | 后端工作量 | 总工作量 |
| ------------- | ---------- | ---------- | ---------- |
| 集成平台架构 | 2人天 | 11人天 | 13人天 |
| 停车系统集成 | 2人天 | 7人天 | 9人天 |
| 明源云对接 | 2人天 | 7人天 | 9人天 |
| IoT云平台对接 | 2人天 | 10人天 | 12人天 |
| 财务系统对接 | 2人天 | 7人天 | 9人天 |
| 知识库管理 | 5人天 | 6人天 | 11人天 |
| 公告管理 | 3人天 | 4人天 | 7人天 |
| 投诉管理 | 5人天 | 6人天 | 11人天 |
| 满意度调查 | 6人天 | 6人天 | 12人天 |
| 问卷投票 | 3人天 | 3人天 | 6人天 |
| **合计** | **32人天** | **67人天** | **99人天** |
---
## 八、第五阶段:智能化升级
**目标**: 引入智能化能力,提升运营水平
**预计周期**: 3-4 周
**开始时间**: 第四阶段完成后
### 8.1 智能派单算法
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ------------ | --------- | ---------- | ---------- | ------ | ------ |
| P5-001 | 位置距离计算 | ✅ 已完成 | - | 2人天 | P2 | - |
| P5-002 | 技能匹配算法 | ✅ 已完成 | - | 2人天 | P2 | P5-001 |
| P5-003 | 工作负载均衡 | ✅ 已完成 | - | 2人天 | P2 | P5-002 |
| P5-004 | 派单规则配置 | ✅ 已完成 | 2人天 | 2人天 | P2 | P5-003 |
**小计**: 前端 2人天后端 8人天共 10人天
### 8.2 综合运营大屏
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------ | ---------- | --------- | ---------- | ---------- | ------ | ------ |
| P5-010 | 数据可视化 | ✅ 已完成 | 4人天 | 2人天 | P2 | - |
| P5-011 | 实时监控 | ✅ 已完成 | 2人天 | 2人天 | P2 | P5-010 |
| P5-012 | 大屏展示 | ✅ 已完成 | 2人天 | 1人天 | P2 | P5-011 |
**小计**: 前端 8人天后端 5人天共 13人天
### 第五阶段汇总
| 分类 | 前端工作量 | 后端工作量 | 总工作量 |
| ------------ | ---------- | ---------- | ---------- |
| 智能派单算法 | 2人天 | 8人天 | 10人天 |
| 综合运营大屏 | 8人天 | 5人天 | 13人天 |
| **合计** | **10人天** | **13人天** | **23人天** |
---
## 九、已完成归档特性FEATURE-Cxxx
**说明**: 以下特性已在项目初期完成并稳定运行,作为系统基础功能归档管理
**完成时间**: 2026-01-01 ~ 2026-01-31
### 9.1 RBAC权限系统
| 编号 | 特性 | 状态 | 说明 |
| ------------ | ------------ | --------- | ---------------------- |
| FEATURE-C001 | 用户管理 | ✅ 已完成 | 用户增删改查、状态管理 |
| FEATURE-C002 | 角色管理 | ✅ 已完成 | 角色定义、权限分配 |
| FEATURE-C003 | 权限管理 | ✅ 已完成 | 菜单权限、按钮权限 |
| FEATURE-C004 | 部门管理 | ✅ 已完成 | 部门树形结构 |
| FEATURE-C005 | 岗位管理 | ✅ 已完成 | 岗位定义、人员分配 |
| FEATURE-C006 | 用户角色关联 | ✅ 已完成 | 多对多关系 |
| FEATURE-C007 | 角色权限关联 | ✅ 已完成 | 多对多关系 |
| FEATURE-C008 | 数据权限 | ✅ 已完成 | 部门数据隔离 |
### 9.2 工单系统核心
| 编号 | 特性 | 状态 | 说明 |
| ------------ | -------- | --------- | ------------------ |
| FEATURE-C010 | 工单创建 | ✅ 已完成 | 工单基本信息录入 |
| FEATURE-C011 | 工单分配 | ✅ 已完成 | 手动分配、批量分配 |
| FEATURE-C012 | 工单接单 | ✅ 已完成 | 员工接单确认 |
| FEATURE-C013 | 工单处理 | ✅ 已完成 | 处理记录、进度更新 |
| FEATURE-C014 | 工单完成 | ✅ 已完成 | 完成确认、结果记录 |
| FEATURE-C015 | 工单关闭 | ✅ 已完成 | 关闭流程、归档 |
| FEATURE-C016 | 工单评价 | ✅ 已完成 | 业主评价、评分 |
| FEATURE-C017 | 工单查询 | ✅ 已完成 | 多条件查询、筛选 |
### 9.3 工单关联设备
| 编号 | 特性 | 状态 | 说明 |
| ------------ | ------------ | --------- | ------------------ |
| FEATURE-C020 | 工单关联设备 | ✅ 已完成 | 工单与设备关联 |
| FEATURE-C021 | 设备故障记录 | ✅ 已完成 | 故障描述、原因分析 |
| FEATURE-C022 | 维修方案记录 | ✅ 已完成 | 维修方案、备件使用 |
### 9.4 设备维修历史
| 编号 | 特性 | 状态 | 说明 |
| ------------ | ------------ | --------- | -------------------- |
| FEATURE-C030 | 设备维修记录 | ✅ 已完成 | 维修历史查询 |
| FEATURE-C031 | 维修统计分析 | ✅ 已完成 | 故障率、维修次数统计 |
| FEATURE-C032 | 设备保养提醒 | ✅ 已完成 | 定期保养计划、提醒 |
### 9.5 通知系统
| 编号 | 特性 | 状态 | 说明 |
| ------------ | -------- | --------- | -------------------- |
| FEATURE-C040 | 系统通知 | ✅ 已完成 | 系统消息推送 |
| FEATURE-C041 | 工单通知 | ✅ 已完成 | 工单状态变更通知 |
| FEATURE-C042 | 待办提醒 | ✅ 已完成 | 待处理事项提醒 |
| FEATURE-C043 | 通知中心 | ✅ 已完成 | 通知列表、已读未读 |
| FEATURE-C044 | 通知配置 | ✅ 已完成 | 通知规则、接收人配置 |
| FEATURE-C045 | 邮件通知 | ✅ 已完成 | 邮件发送、模板配置 |
| FEATURE-C046 | 短信通知 | ✅ 已完成 | 短信发送、模板配置 |
### 9.6 访客凭证系统
| 编号 | 特性 | 状态 | 说明 |
| ------------ | -------- | --------- | ------------------ |
| FEATURE-C050 | 访客预约 | ✅ 已完成 | 访客信息登记、预约 |
| FEATURE-C051 | 访客审批 | ✅ 已完成 | 访客来访审批流程 |
| FEATURE-C052 | 访客凭证 | ✅ 已完成 | 凭证生成、二维码 |
| FEATURE-C053 | 访客签到 | ✅ 已完成 | 访客到达签到 |
| FEATURE-C054 | 访客记录 | ✅ 已完成 | 访客来访记录查询 |
### 9.7 操作日志审计
| 编号 | 特性 | 状态 | 说明 |
| ------------ | ------------ | --------- | ------------------ |
| FEATURE-C060 | 操作日志记录 | ✅ 已完成 | 用户操作自动记录 |
| FEATURE-C061 | 日志查询 | ✅ 已完成 | 多条件查询、筛选 |
| FEATURE-C062 | 日志导出 | ✅ 已完成 | 导出Excel |
| FEATURE-C063 | 登录日志 | ✅ 已完成 | 登录记录、IP记录 |
| FEATURE-C064 | 异常日志 | ✅ 已完成 | 异常操作、安全审计 |
**已完成归档特性合计**: 45个
---
## 十、开发排期甘特图
```
阶段 第1-2周 第3-4周 第5-6周 第7-8周 第9-10周 第11-12周 第13-14周 第15-16周
─────────────────────────────────────────────────────────────────────────────────────────────────
第一阶段 ████████████████████
├─业主端小程序 ████████████████
├─在线支付 ████████
├─费用报表 ████████
└─满意度评价 ████████
第二阶段 ████████████████
├─员工APP ████████████████
├─设备二维码 ████████
├─SLA监控 ████████
└─报表统计 ████████
第三阶段 ████████████████
├─租户管理 ████████
├─车位管理 ████████
└─能耗管理 ████████
第四阶段 ████████████████
├─集成架构 ████████
├─停车系统 ████████
├─明源云 ████████
├─IoT平台 ████████
└─财务系统 ████████
第五阶段 ████████████
├─智能派单 ████████
└─运营大屏 ████████
```
---
## 十、工作量统计
### 10.1 各阶段工作量
| 阶段 | 前端工作量 | 后端工作量 | 总工作量 | 预计周期 | 完成状态 |
| ------------ | ------------- | ----------- | ------------- | -------- | -------- |
| 已完成归档 | - | - | - | 已完成 | ✅ 100% |
| 第一阶段 | 27人天 | 29人天 | 56人天 | 已完成 | ✅ 100% |
| 第二阶段 | 29人天 | 27人天 | 56人天 | 已完成 | ✅ 100% |
| 第三阶段 | 19人天 | 24人天 | 43人天 | 已完成 | ✅ 100% |
| 第四阶段 | 32人天 | 67人天 | 99人天 | 部分完成 | 🔄 70% |
| 第五阶段 | 10人天 | 13人天 | 23人天 | 已完成 | ✅ 100% |
| APP端开发 | 62人天 | 44人天 | 106人天 | 待开发 | ⬜ 0% |
| 前端优化改进 | 34.5人天 | - | 34.5人天 | 待开发 | ⬜ 0% |
| **合计** | **213.5人天** | **204人天** | **417.5人天** | - | - |
**说明**:
- 已完成归档特性FEATURE-Cxxx: 45个
- 第一至第五阶段已完成特性: 61个
- 第四阶段待开发特性(集成平台): 9个
- APP端待开发特性: 45个业主端23个 + 员工端22个
- 前端优化改进项: 20个
- 已暂停特性: 7个
### 10.2 功能分类统计
| 分类 | 特性数量 | 前端工作量 | 后端工作量 | 总工作量 | 完成状态 |
| -------------------- | -------- | ---------- | ---------- | -------- | -------- |
| 已完成归档特性 | 45 | - | - | - | ✅ 100% |
| 移动端(小程序+APP | 16 | 32人天 | 22人天 | 54人天 | ✅ 100% |
| 支付与财务 | 6 | 6人天 | 14人天 | 20人天 | ✅ 100% |
| 报表统计 | 8 | 11人天 | 14人天 | 25人天 | ✅ 100% |
| 租户与车位管理 | 10 | 17人天 | 22人天 | 39人天 | ✅ 100% |
| 第三方集成 | 24 | 32人天 | 67人天 | 99人天 | 🔄 70% |
| 智能化功能 | 7 | 10人天 | 13人天 | 23人天 | ✅ 100% |
| APP端开发 | 45 | 62人天 | 44人天 | 106人天 | ⬜ 0% |
| 前端优化改进 | 20 | 34.5人天 | - | 34.5人天 | ⬜ 0% |
| 已暂停功能 | 7 | - | - | - | ⏸️ 暂停 |
---
## 十一、风险与依赖
### 11.1 技术风险
| 风险项 | 影响程度 | 应对措施 |
| ---------------- | -------- | -------------------------- |
| 微信支付对接复杂 | 中 | 提前阅读文档,准备测试环境 |
| MQTT接入稳定性 | 中 | 使用成熟的MQTT客户端库 |
| 明源云接口变更 | 高 | 与明源云技术团队保持沟通 |
### 11.2 外部依赖
| 依赖项 | 依赖方 | 状态 | 影响 |
| ---------------- | -------------- | ------ | ---------------- |
| 微信支付商户号 | 财务部门 | 待申请 | 影响在线支付功能 |
| 明源云API文档 | 明源云技术团队 | 待获取 | 影响明源云对接 |
| 停车系统接口文档 | 停车系统供应商 | 待获取 | 影响停车系统集成 |
| IoT平台接入信息 | IoT平台供应商 | 待获取 | 影响IoT对接 |
---
## 十二、前端优化改进计划
**目标**: 提升前端代码质量、安全性、性能和用户体验
**预计周期**: 2-3 周(可与功能开发并行)
**开始时间**: 立即启动
### 12.1 高优先级改进(立即处理)
#### 12.1.1 安全性改进
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ----------- | ------------- | --------- | ------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| OPT-SEC-001 | Token管理优化 | ⬜ 待开发 | 2人天 | P0 | **双Token机制**Access Token15分钟有效+ Refresh Token7天有效使用CryptoJS加密存储。Access Token泄露影响有限自动刷新用户无感知。需后端支持Refresh Token接口。 |
| OPT-SEC-002 | XSS防护增强 | ⬜ 待开发 | 1人天 | P0 | **xss库过滤**使用xss库v1.0.10+对用户输入进行HTML标签白名单过滤配置允许的标签和属性。Vue模板默认转义`{{ }}`插值富文本使用xss过滤。 |
| OPT-SEC-003 | CSRF防护 | ⬜ 待开发 | 1人天 | P0 | **双重防护**Spring Security生成CSRF Token存储在Cookie前端请求携带`X-XSRF-TOKEN`头Cookie设置`SameSite=Strict`属性。需后端配置CookieCsrfTokenRepository。 |
| OPT-SEC-004 | 敏感信息保护 | ⬜ 待开发 | 0.5人天 | P0 | **移除敏感Header**不再在前端请求头中传递X-User-Id和X-Username由后端从JWT Token中解析。生产环境禁用console输出错误信息脱敏处理。 |
**安全性改进小计**: 4.5人天
#### 12.1.2 性能优化
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ------------ | ----------------- | --------- | ------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| OPT-PERF-001 | 列表虚拟滚动 | ⬜ 待开发 | 2人天 | P0 | **后端分页 + 虚拟表格**设备管理等大数据量列表改为后端分页每页20条前端使用Ant Design Table的`scroll.y`属性启用虚拟滚动,仅渲染可视区域行。 |
| OPT-PERF-002 | 请求优化 | ⬜ 待开发 | 1.5人天 | P0 | **取消重复请求**使用AbortController取消相同请求的重复调用避免竞态条件。**请求缓存**对字典数据等使用Map缓存5分钟减少重复请求。 |
| OPT-PERF-003 | WebSocket替代轮询 | ⬜ 待开发 | 2人天 | P0 | **实时通信**通知系统从30秒轮询改为WebSocket推送减少无效请求。使用原生WebSocket API实现断线重连5秒延迟、心跳检测30秒间隔。需后端支持WebSocket端点。 |
**性能优化小计**: 5.5人天
#### 12.1.3 代码可维护性
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ------------- | ------------ | --------- | ------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| OPT-MAINT-001 | 权限指令注册 | ⬜ 待开发 | 0.5人天 | P0 | **注册全局指令**在main.ts中使用`app.directive('permission', permissionDirective)`注册。**完善Store方法**:添加`hasAllPermissions`和`hasAnyPermission`方法,支持权限组合判断。 |
**代码可维护性小计**: 0.5人天
**高优先级改进合计**: 10.5人天
---
### 12.2 中优先级改进(近期处理)
#### 12.2.1 代码可维护性
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ------------- | ------------- | --------- | ------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| OPT-MAINT-002 | 类型定义统一 | ⬜ 待开发 | 2人天 | P1 | **集中式管理**:创建`src/types/`目录按模块分类common.ts、user.ts、work-order.ts等统一导出。避免重复定义提升IDE类型提示。 |
| OPT-MAINT-003 | 组件复用优化 | ⬜ 待开发 | 2人天 | P1 | **字典常量 + 工具函数**:创建`src/constants/dictionaries.ts`定义状态映射常量,`src/utils/dictionary.ts`提供`getDictLabel`和`getDictColor`工具函数。封装`DictTag`组件简化使用。 |
| OPT-MAINT-004 | API层规范统一 | ⬜ 待开发 | 1.5人天 | P1 | **统一响应格式**:定义`ApiResponse<T>`接口所有API返回统一格式。创建`createApi`工具函数封装错误处理和类型转换。添加JSDoc注释。 |
**代码可维护性小计**: 5.5人天
#### 12.2.2 用户体验
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ---------- | ------------ | --------- | ------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| OPT-UX-001 | 表单分步优化 | ⬜ 待开发 | 2人天 | P1 | **Ant Design Steps组件**:设备管理等复杂表单分为基本信息、规格参数、维保信息三步,每步独立验证,支持回退修改。提升用户体验,降低表单复杂度。 |
| OPT-UX-002 | 响应式设计 | ⬜ 待开发 | 3人天 | P1 | **CSS媒体查询**:添加`src/styles/responsive.css`定义大屏≥1200px、中屏768-1199px、小屏<768px三个断点调整布局字体间距支持移动端访问 |
| OPT-UX-003 | 加载状态优化 | 待开发 | 1人天 | P1 | **骨架屏 + 防抖**使用Ant Design Skeleton组件替代loading文字使用VueUse的`useDebounceFn`对刷新操作添加300ms防抖避免频繁请求 |
| OPT-UX-004 | 列表交互增强 | 待开发 | 2人天 | P1 | **批量操作 + 视图切换**添加多选框支持批量分配批量删除添加列表/卡片视图切换按钮添加高级筛选抽屉支持多条件组合筛选 |
**用户体验小计**: 8人天
#### 12.2.3 性能优化
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ------------ | ---------- | --------- | ------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------- |
| OPT-PERF-004 | 图片懒加载 | 待开发 | 0.5人天 | P1 | **v-lazy指令**使用vue-lazyload插件或自定义指令图片进入可视区域再加载添加骨架图占位符提升用户体验 |
| OPT-PERF-005 | 构建优化 | 待开发 | 1人天 | P1 | **代码分割**配置Vite的`manualChunks`将vendorantdecharts分离成独立chunk添加rollup-plugin-visualizer分析构建产物优化包体积 |
**性能优化小计**: 1.5人天
**中优先级改进合计**: 15人天
---
### 12.3 低优先级改进(长期规划)
#### 12.3.1 用户体验
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ---------- | ------------ | --------- | ------ | ------ | --------------------------------------------------------------------------------------------------------------------------------- |
| OPT-UX-005 | 国际化支持 | 待开发 | 3人天 | P2 | **vue-i18n**安装vue-i18nv9.x创建`src/locales/`目录存放中英文语言包使用`$t()`函数替换硬编码文本支持中英文切换 |
| OPT-UX-006 | 无障碍访问 | 待开发 | 2人天 | P2 | **ARIA属性**为按钮链接添加`aria-label`属性为图标添加`aria-hidden="true"`。支持键盘导航TabEnterSpace提升可访问性 |
| OPT-UX-007 | 登录体验优化 | 待开发 | 1人天 | P2 | **记住我 + 忘记密码**添加"记住我"复选框延长Token有效期添加"忘记密码"链接跳转到密码重置页面添加密码强度指示器 |
**用户体验小计**: 6人天
#### 12.3.2 开发体验
| 编号 | 改进项 | 状态 | 工作量 | 优先级 | 关键技术说明 |
| ----------- | -------- | --------- | ------ | ------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| OPT-DEV-001 | 错误监控 | 待开发 | 1人天 | P2 | **全局错误处理**配置`app.config.errorHandler`捕获Vue错误生产环境上报到Sentry添加ErrorBoundary组件防止单个组件错误导致页面崩溃 |
| OPT-DEV-002 | 性能监控 | 待开发 | 1人天 | P2 | **Web Vitals**使用web-vitals库监控LCPFIDCLS等核心指标上报到监控平台添加性能埋点分析页面加载时间 |
| OPT-DEV-003 | Mock数据 | 待开发 | 1人天 | P2 | **MSW**使用Mock Service Worker拦截API请求返回模拟数据开发环境无需依赖后端提升开发效率 |
**开发体验小计**: 3人天
**低优先级改进合计**: 9人天
---
### 12.4 前端优化改进汇总
| 优先级 | 分类 | 工作量 | 关键技术 |
| -------- | ------------ | ------------ | ---------------------------------------- |
| 高优先级 | 安全性改进 | 4.5人天 | 双Token机制xss库CSRF Token加密存储 |
| 高优先级 | 性能优化 | 5.5人天 | 虚拟滚动请求缓存WebSocket |
| 高优先级 | 代码可维护性 | 0.5人天 | 权限指令注册 |
| 中优先级 | 代码可维护性 | 5.5人天 | 类型定义统一字典常量API规范 |
| 中优先级 | 用户体验 | 8人天 | 表单分步响应式设计骨架屏 |
| 中优先级 | 性能优化 | 1.5人天 | 图片懒加载构建优化 |
| 低优先级 | 用户体验 | 6人天 | 国际化无障碍访问 |
| 低优先级 | 开发体验 | 3人天 | 错误监控性能监控Mock数据 |
| **总计** | - | **34.5人天** | - |
---
### 12.5 关键技术说明
#### 12.5.1 安全性技术栈
**Token管理**
- crypto-jsAES加密
- 机制Access Token15分钟+ Refresh Token7天
- 存储localStorage加密存储
- 刷新自动检测Token过期提前5分钟刷新
**XSS防护**
- xssv1.0.10+
- 配置白名单标签aimgpbrstrongem
- 使用富文本过滤用户输入过滤
**CSRF防护**
- 后端Spring Security CookieCsrfTokenRepository
- 前端请求头携带X-XSRF-TOKEN
- CookieSameSite=Strict
#### 12.5.2 性能优化技术栈
**虚拟滚动**
- 组件Ant Design Tablescroll.y属性
- 分页后端分页每页20条
- 适用设备管理工单列表等大数据量页面
**WebSocket**
- API原生WebSocket
- 重连5秒延迟自动重连
- 心跳30秒间隔ping/pong
- 使用通知推送工单状态更新
**请求优化**
- 缓存Map存储5分钟TTL
- 取消AbortController
- 防抖VueUse useDebounceFn300ms
#### 12.5.3 代码规范技术栈
**类型管理**
- 目录src/types/
- 分类common.tsuser.tswork-order.tsequipment.tsapi.ts
- 导出统一从index.ts导出
**字典管理**
- 常量src/constants/dictionaries.ts
- 工具src/utils/dictionary.tsgetDictLabelgetDictColor
- 组件DictTag.vue
**API规范**
- 类型ApiResponse<T>统一响应格式
- 工具createApi封装错误处理
- 注释JSDoc标准注释
#### 12.5.4 用户体验技术栈
**表单分步**
- 组件Ant Design Steps
- 验证:每步独立验证
- 适用:设备管理、合同管理等复杂表单
**响应式设计**
- 断点大屏≥1200px、中屏768-1199px、小屏<768px
- 技术CSS媒体查询
- 布局Flexbox自适应
**加载状态**
- 骨架屏Ant Design Skeleton
- 防抖VueUse useDebounceFn
- 懒加载vue-lazyload
---
### 12.6 实施建议
#### 12.6.1 实施顺序
**第一周**高优先级
1. Token管理优化2天
2. XSS防护增强1天
3. CSRF防护1天
4. 权限指令注册0.5天
**第二周**高优先级 + 中优先级
1. 列表虚拟滚动2天
2. 请求优化1.5天
3. WebSocket替代轮询2天
**第三周**中优先级
1. 类型定义统一2天
2. 组件复用优化2天
3. API层规范统一1.5天
**后续**中低优先级
- 用户体验优化8人天
- 性能优化1.5人天
- 长期规划9人天
#### 12.6.2 注意事项
1. **安全性改进优先**Token管理XSS防护CSRF防护必须优先实施
2. **性能优化并行**可与功能开发并行不影响现有功能
3. **代码重构渐进**类型定义组件复用等重构需渐进进行避免大规模改动
4. **用户体验持续**响应式设计表单优化等可长期持续改进
5. **测试覆盖**每个改进项需编写单元测试确保不影响现有功能
---
## 十三、APP端开发计划
### 13.1 APP端产品矩阵
```
┌─────────────────────────────────────────────────────────────────────────┐
│ Ether APP端产品矩阵 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────────────────────────────┐ │
│ │ Ether 移动端产品 │ │
│ └─────────────────┬───────────────────┘ │
│ │ │
│ ┌───────────────────────┴───────────────────────┐ │
│ │ │ │
│ ┌─────────┴─────────┐ ┌─────────┴─────────┐ │
│ │ 业主/企业端 │ │ 物业员工端 │ │
│ │ (小程序) │ │ (APP) │ │
│ └─────────┬─────────┘ └─────────┬─────────┘ │
│ │ │ │
│ ┌─────────┴─────────┐ ┌─────────┴─────────┐ │
│ │ 微信小程序 │ │ iOS APP │ │
│ │ 支付宝小程序 │ │ Android APP │ │
│ └───────────────────┘ └───────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
### 13.2 业主端小程序开发计划
**目标用户**: 业主租户入驻企业
**技术选型**: uni-app (Vue 3) + Vant Weapp
**预计周期**: 4周
#### 13.2.1 功能清单
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------- | -------------------- | --------- | ---------- | ---------- | ------ | ------- |
| APP-O01 | 项目初始化与框架搭建 | 待开发 | 2人天 | 0.5人天 | P0 | - |
| APP-O02 | 微信登录授权 | 待开发 | 2人天 | 2人天 | P0 | APP-O01 |
| APP-O03 | 手机号绑定 | 待开发 | 1人天 | 1人天 | P0 | APP-O02 |
| APP-O04 | 房产绑定认证 | 待开发 | 2人天 | 2人天 | P0 | APP-O03 |
| APP-O05 | 首页展示 | 待开发 | 2人天 | 1人天 | P0 | APP-O04 |
| APP-O06 | 在线报修申请 | 待开发 | 2人天 | 1人天 | P0 | APP-O04 |
| APP-O07 | 工单进度查询 | 待开发 | 1人天 | 0.5人天 | P0 | APP-O06 |
| APP-O08 | 工单历史记录 | 待开发 | 1人天 | 0.5人天 | P1 | APP-O06 |
| APP-O09 | 账单查询 | 待开发 | 2人天 | 1人天 | P0 | APP-O04 |
| APP-O10 | 微信支付对接 | 待开发 | 2人天 | 3人天 | P0 | APP-O09 |
| APP-O11 | 支付宝支付对接 | 待开发 | 1人天 | 2人天 | P1 | APP-O10 |
| APP-O12 | 缴费记录查询 | 待开发 | 1人天 | 0.5人天 | P0 | APP-O10 |
| APP-O13 | 访客邀请 | 待开发 | 2人天 | 1.5人天 | P1 | APP-O04 |
| APP-O14 | 访客凭证生成 | 待开发 | 1人天 | 1人天 | P1 | APP-O13 |
| APP-O15 | 访客邀请记录 | 待开发 | 1人天 | 0.5人天 | P1 | APP-O13 |
| APP-O16 | 投诉建议提交 | 待开发 | 1.5人天 | 1人天 | P1 | APP-O04 |
| APP-O17 | 投诉处理进度 | 待开发 | 1人天 | 0.5人天 | P1 | APP-O16 |
| APP-O18 | 消息通知中心 | 待开发 | 1.5人天 | 1人天 | P1 | APP-O04 |
| APP-O19 | 物业公告查看 | 待开发 | 1人天 | 0.5人天 | P1 | APP-O04 |
| APP-O20 | 个人中心 | 待开发 | 1.5人天 | 0.5人天 | P1 | APP-O04 |
| APP-O21 | 家庭成员管理 | 待开发 | 1人天 | 1人天 | P2 | APP-O20 |
| APP-O22 | 消息设置 | 待开发 | 0.5人天 | 0.5人天 | P2 | APP-O20 |
| APP-O23 | 工单满意度评价 | 待开发 | 1人天 | 1人天 | P1 | APP-O06 |
**业主端小程序小计**: 前端 30人天后端 24人天 54人天
#### 13.2.2 页面结构
```
pages/
├── index/ # 首页
│ └── index.vue # 首页展示
├── login/ # 登录模块
│ ├── index.vue # 登录页
│ └── bind-phone.vue # 手机号绑定
├── service/ # 服务模块
│ ├── repair/ # 报修服务
│ │ ├── create.vue # 创建报修
│ │ ├── detail.vue # 工单详情
│ │ └── list.vue # 工单列表
│ ├── fee/ # 缴费服务
│ │ ├── list.vue # 账单列表
│ │ ├── detail.vue # 账单详情
│ │ └── pay.vue # 支付页面
│ ├── visitor/ # 访客服务
│ │ ├── invite.vue # 邀请访客
│ │ ├── credential.vue # 访客凭证
│ │ └── list.vue # 邀请记录
│ └── complaint/ # 投诉建议
│ ├── create.vue # 提交投诉
│ ├── detail.vue # 处理详情
│ └── list.vue # 投诉列表
├── message/ # 消息模块
│ ├── list.vue # 消息列表
│ └── detail.vue # 消息详情
├── my/ # 个人中心
│ ├── index.vue # 个人中心首页
│ ├── house/ # 房产管理
│ │ ├── bind.vue # 房产绑定
│ │ └── list.vue # 房产列表
│ ├── family/ # 家庭成员
│ │ └── list.vue # 成员列表
│ └── settings/ # 设置
│ └── index.vue # 设置页面
└── announcement/ # 公告模块
├── list.vue # 公告列表
└── detail.vue # 公告详情
```
### 13.3 物业员工APP开发计划
**目标用户**: 物业管理人员维修人员保安人员客服人员
**技术选型**: uni-app (Vue 3) + uView UI
**预计周期**: 4周
#### 13.3.1 功能清单
| 编号 | 特性 | 状态 | 前端工作量 | 后端工作量 | 优先级 | 依赖 |
| ------- | -------------------- | --------- | ---------- | ---------- | ------ | ------- |
| APP-E01 | 项目初始化与框架搭建 | 待开发 | 2人天 | 0.5人天 | P0 | - |
| APP-E02 | 用户登录 | 待开发 | 1人天 | 1人天 | P0 | APP-E01 |
| APP-E03 | 工作台首页 | 待开发 | 2人天 | 1人天 | P0 | APP-E02 |
| APP-E04 | 待办事项展示 | 待开发 | 1人天 | 1人天 | P0 | APP-E03 |
| APP-E05 | 工单列表 | 待开发 | 2人天 | 1人天 | P0 | APP-E02 |
| APP-E06 | 工单详情 | 待开发 | 2人天 | 0.5人天 | P0 | APP-E05 |
| APP-E07 | 工单接单 | 待开发 | 1人天 | 1人天 | P0 | APP-E06 |
| APP-E08 | 工单处理 | 待开发 | 2人天 | 1.5人天 | P0 | APP-E07 |
| APP-E09 | 工单完成 | 待开发 | 1人天 | 1人天 | P0 | APP-E08 |
| APP-E10 | 扫码报修 | 待开发 | 2人天 | 1人天 | P1 | APP-E05 |
| APP-E11 | 巡检任务列表 | 待开发 | 2人天 | 1人天 | P1 | APP-E02 |
| APP-E12 | 巡检任务执行 | 待开发 | 2人天 | 1.5人天 | P1 | APP-E11 |
| APP-E13 | 巡检扫码签到 | 待开发 | 1人天 | 0.5人天 | P1 | APP-E12 |
| APP-E14 | 巡检异常上报 | 待开发 | 1人天 | 1人天 | P1 | APP-E12 |
| APP-E15 | 访客登记 | 待开发 | 2人天 | 1人天 | P1 | APP-E02 |
| APP-E16 | 访客凭证验证 | 待开发 | 1.5人天 | 1人天 | P1 | APP-E15 |
| APP-E17 | 通行记录 | 待开发 | 1人天 | 0.5人天 | P2 | APP-E15 |
| APP-E18 | 消息通知 | 待开发 | 1.5人天 | 1人天 | P1 | APP-E02 |
| APP-E19 | 个人中心 | 待开发 | 1人天 | 0.5人天 | P1 | APP-E02 |
| APP-E20 | 工作统计 | 待开发 | 1.5人天 | 1人天 | P2 | APP-E19 |
| APP-E21 | 离线数据存储 | 待开发 | 2人天 | 1人天 | P2 | APP-E01 |
| APP-E22 | 地理位置上报 | 待开发 | 1人天 | 1人天 | P2 | APP-E02 |
**物业员工APP小计**: 前端 32人天后端 20人天 52人天
#### 13.3.2 页面结构
```
pages/
├── index/ # 首页
│ └── index.vue # 工作台首页
├── login/ # 登录模块
│ └── index.vue # 登录页
├── work-order/ # 工单模块
│ ├── list.vue # 工单列表
│ ├── detail.vue # 工单详情
│ ├── process.vue # 工单处理
│ └── scan.vue # 扫码报修
├── inspection/ # 巡检模块
│ ├── list.vue # 巡检任务列表
│ ├── detail.vue # 任务详情
│ ├── execute.vue # 执行巡检
│ └── record.vue # 巡检记录
├── visitor/ # 访客模块
│ ├── register.vue # 访客登记
│ ├── verify.vue # 凭证验证
│ └── record.vue # 通行记录
├── message/ # 消息模块
│ ├── list.vue # 消息列表
│ └── detail.vue # 消息详情
├── my/ # 个人中心
│ ├── index.vue # 个人中心首页
│ ├── statistics.vue # 工作统计
│ └── settings/ # 设置
│ └── index.vue # 设置页面
└── scan/ # 扫码模块
└── index.vue # 通用扫码页
```
### 13.4 技术架构
#### 13.4.1 技术选型
| 技术项 | 业主端小程序 | 物业员工APP |
| -------- | -------------------- | --------------- |
| 框架 | uni-app (Vue 3) | uni-app (Vue 3) |
| UI组件库 | Vant Weapp | uView UI |
| 状态管理 | Pinia | Pinia |
| 网络请求 | uni.request封装 | uni.request封装 |
| 本地存储 | uni.setStorage | uni.setStorage |
| 支付 | 微信支付支付宝支付 | - |
| 地图 | 腾讯地图 | 高德地图 |
| 扫码 | uni.scanCode | uni.scanCode |
| 推送 | 微信订阅消息 | 极光推送/个推 |
| 离线存储 | - | uni.setStorage |
#### 13.4.2 项目结构
```
ether-app/
├── ether-app-owner/ # 业主端小程序
│ ├── src/
│ │ ├── api/ # API接口
│ │ ├── components/ # 公共组件
│ │ ├── pages/ # 页面
│ │ ├── static/ # 静态资源
│ │ ├── store/ # 状态管理
│ │ ├── utils/ # 工具函数
│ │ ├── App.vue # 应用入口
│ │ ├── main.ts # 主入口
│ │ ├── manifest.json # 应用配置
│ │ └── pages.json # 页面配置
│ ├── package.json
│ └── vite.config.ts
├── ether-app-employee/ # 物业员工APP
│ ├── src/
│ │ ├── api/ # API接口
│ │ ├── components/ # 公共组件
│ │ ├── pages/ # 页面
│ │ ├── static/ # 静态资源
│ │ ├── store/ # 状态管理
│ │ ├── utils/ # 工具函数
│ │ ├── App.vue # 应用入口
│ │ ├── main.ts # 主入口
│ │ ├── manifest.json # 应用配置
│ │ └── pages.json # 页面配置
│ ├── package.json
│ └── vite.config.ts
└── ether-app-common/ # 公共模块(可选)
├── components/ # 共享组件
├── utils/ # 共享工具
└── types/ # 类型定义
```
### 13.5 开发排期
#### 13.5.1 甘特图
```
阶段 第1周 第2周 第3周 第4周 第5周 第6周
─────────────────────────────────────────────────────────────────────────────
业主端小程序 ████████████████████████
├─框架搭建 ████
├─登录认证 ████████
├─报修服务 ████████
├─缴费服务 ████████
├─访客邀请 ████████
└─其他功能 ████████
物业员工APP ████████████████████████
├─框架搭建 ████
├─工作台 ████████
├─工单处理 ████████
├─巡检执行 ████████
└─访客登记 ████████
```
#### 13.5.2 详细排期
**第1-2周业主端小程序核心功能**
| 周次 | 任务 | 前端 | 后端 |
| ---- | ------------------------------ | ----- | ------- |
| W1 | 项目初始化框架搭建登录授权 | 4人天 | 2.5人天 |
| W2 | 房产绑定首页在线报修 | 6人天 | 4人天 |
**第3-4周业主端小程序完善**
| 周次 | 任务 | 前端 | 后端 |
| ---- | ---------------------------- | ----- | ----- |
| W3 | 账单查询在线支付缴费记录 | 5人天 | 5人天 |
| W4 | 访客邀请消息通知个人中心 | 5人天 | 4人天 |
**第5-6周物业员工APP核心功能**
| 周次 | 任务 | 前端 | 后端 |
| ---- | ---------------------------- | ----- | ------- |
| W5 | 项目初始化工作台工单处理 | 7人天 | 4.5人天 |
| W6 | 巡检执行访客登记消息通知 | 7人天 | 5人天 |
### 13.6 工作量汇总
| 项目 | 前端工作量 | 后端工作量 | 总工作量 |
| ------------ | ---------- | ---------- | ----------- |
| 业主端小程序 | 30人天 | 24人天 | 54人天 |
| 物业员工APP | 32人天 | 20人天 | 52人天 |
| **合计** | **62人天** | **44人天** | **106人天** |
### 13.7 后端API支持
APP端需要后端新增/调整的API接口
#### 13.7.1 认证模块
| 接口 | 方法 | 说明 |
| -------------------------- | ---- | ---------- |
| /api/v1/auth/wechat-login | POST | 微信登录 |
| /api/v1/auth/bind-phone | POST | 绑定手机号 |
| /api/v1/auth/refresh-token | POST | 刷新Token |
#### 13.7.2 业主模块
| 接口 | 方法 | 说明 |
| -------------------------------- | -------- | ---------------- |
| /api/v1/owner/houses | GET | 获取业主房产列表 |
| /api/v1/owner/houses/bind | POST | 绑定房产 |
| /api/v1/owner/houses/{id}/verify | POST | 房产认证 |
| /api/v1/owner/family-members | GET/POST | 家庭成员管理 |
#### 13.7.3 工单模块APP端
| 接口 | 方法 | 说明 |
| ------------------------------------- | -------- | ------------- |
| /api/v1/app/work-orders | GET/POST | 工单列表/创建 |
| /api/v1/app/work-orders/{id} | GET | 工单详情 |
| /api/v1/app/work-orders/{id}/accept | POST | 接单 |
| /api/v1/app/work-orders/{id}/start | POST | 开始处理 |
| /api/v1/app/work-orders/{id}/complete | POST | 完成工单 |
| /api/v1/app/work-orders/scan | POST | 扫码创建工单 |
#### 13.7.4 缴费模块
| 接口 | 方法 | 说明 |
| ----------------------------- | ---- | ---------- |
| /api/v1/app/bills | GET | 账单列表 |
| /api/v1/app/bills/{id} | GET | 账单详情 |
| /api/v1/app/payments/wechat | POST | 微信支付 |
| /api/v1/app/payments/alipay | POST | 支付宝支付 |
| /api/v1/app/payments/callback | POST | 支付回调 |
#### 13.7.5 访客模块APP端
| 接口 | 方法 | 说明 |
| ------------------------------- | ---- | ------------ |
| /api/v1/app/visitors/invite | POST | 邀请访客 |
| /api/v1/app/visitors/credential | GET | 获取访客凭证 |
| /api/v1/app/visitors/register | POST | 访客登记 |
| /api/v1/app/visitors/verify | POST | 凭证验证 |
#### 13.7.6 巡检模块APP端
| 接口 | 方法 | 说明 |
| ------------------------------------- | ---- | ------------ |
| /api/v1/app/inspections | GET | 巡检任务列表 |
| /api/v1/app/inspections/{id} | GET | 任务详情 |
| /api/v1/app/inspections/{id}/start | POST | 开始巡检 |
| /api/v1/app/inspections/{id}/checkin | POST | 扫码签到 |
| /api/v1/app/inspections/{id}/complete | POST | 完成巡检 |
### 13.8 风险与依赖
#### 13.8.1 技术风险
| 风险项 | 影响程度 | 应对措施 |
| ---------------- | -------- | -------------------------- |
| 微信支付对接复杂 | | 提前阅读文档准备测试环境 |
| 小程序审核周期 | | 预留1周审核时间 |
| APP上架审核 | | 提前准备资质材料 |
| 推送服务稳定性 | | 使用成熟推送服务商 |
#### 13.8.2 外部依赖
| 依赖项 | 依赖方 | 状态 | 影响 |
| ---------------- | -------- | ------ | ------------------ |
| 微信开放平台账号 | 产品部门 | 待申请 | 影响微信登录和支付 |
| 微信支付商户号 | 财务部门 | 待申请 | 影响在线支付功能 |
| 支付宝商户号 | 财务部门 | 待申请 | 影响支付宝支付 |
| 极光推送账号 | 技术部门 | 待申请 | 影响APP消息推送 |
| 高德地图Key | 技术部门 | 待申请 | 影响地图功能 |
### 13.9 测试计划
#### 13.9.1 测试范围
| 测试类型 | 覆盖范围 | 工具 |
| ------------ | ------------------ | ---------- |
| 功能测试 | 所有功能模块 | 手工测试 |
| 兼容性测试 | iOS/Android各版本 | 真机测试 |
| 性能测试 | 启动时间页面加载 | Lighthouse |
| 安全测试 | 数据传输存储安全 | 安全扫描 |
| 用户体验测试 | 交互流程视觉效果 | 用户测试 |
#### 13.9.2 测试用例
测试用例详见
- [业主端小程序测试用例](../测试用例/业主端小程序/)
- [物业员工APP测试用例](../测试用例/物业员工APP/)
---
## 十四、更新记录
| 日期 | 更新内容 | 更新人 |
| ---------- | -------------------------------------------------------------------- | ------ |
| 2026-02-14 | 创建开发任务排期表标记暂停功能 | - |
| 2026-02-14 | 添加前端优化改进计划包含安全性性能可维护性用户体验四个维度 | - |
| 2026-02-14 | 同步FEATURE_LIST状态更新70+个特性状态为已完成 | - |
| 2026-02-14 | 补充已完成归档特性FEATURE-Cxxx45个 | - |
| 2026-02-14 | 补充第四阶段缺失特性P4-050~09218个 | - |
| 2026-02-14 | 统一暂停特性编号体系PAUSE-Bxx/PAUSE-Rxx | - |
| 2026-02-14 | 更新统计数字已完成106特性待开发9特性已暂停7特性 | - |
| 2026-02-14 | 添加APP端开发计划第十三章包含业主端小程序和物业员工APP详细规划 | - |
| 2026-02-14 | 更新统计数字已完成106特性待开发54特性含APP端45个新特性 | - |
---
> **维护说明**:
>
> - 每个特性完成后更新状态为 ✅ 已完成
> - 开始开发时更新状态为 🔄 进行中
> - 如有需求变更,及时调整排期
> - 前端优化改进可与功能开发并行实施
> - **文档同步机制**特性完成后先更新FEATURE_LIST.md再同步到开发任务排期表.md