ether-docs/_archive/DEVELOPMENT_ROADMAP.md

68 KiB
Raw Permalink Blame History

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-TOKENCookie设置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方法:添加hasAllPermissionshasAnyPermission方法,支持权限组合判断。

代码可维护性小计: 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提供getDictLabelgetDictColor工具函数。封装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将vendor、antd、echarts分离成独立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"。支持键盘导航Tab、Enter、Space提升可访问性。
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库监控LCP、FID、CLS等核心指标上报到监控平台。添加性能埋点分析页面加载时间。
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+
  • 配置白名单标签a、img、p、br、strong、em
  • 使用:富文本过滤、用户输入过滤

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.ts、user.ts、work-order.ts、equipment.ts、api.ts
  • 导出统一从index.ts导出

字典管理

  • 常量src/constants/dictionaries.ts
  • 工具src/utils/dictionary.tsgetDictLabel、getDictColor
  • 组件DictTag.vue

API规范

  • 类型ApiResponse统一响应格式
  • 工具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 测试用例

测试用例详见:


十四、更新记录

日期 更新内容 更新人
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