ether-docs/pending-features.md

402 lines
12 KiB
Markdown
Raw 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 智慧物业管理平台 - 待开发功能列表
## 概述
本文档记录了系统中待开发功能模块,供后续开发参考。
---
## 待开发功能
### 1. APP端功能业主端/员工端)
**状态**: 后端API已完成APP前端待开发
**业主端小程序 (APP-O01~O23)**:
- [ ] 项目初始化与框架搭建
- [ ] 微信登录授权
- [ ] 手机号绑定
- [ ] 房产绑定认证
- [ ] 首页展示
- [ ] 在线报修申请
- [ ] 工单进度查询
- [ ] 工单历史记录
- [ ] 账单查询
- [ ] 微信支付对接
- [ ] 支付宝支付对接
- [ ] 缴费记录查询
- [ ] 访客邀请
- [ ] 访客凭证生成
- [ ] 访客邀请记录
- [ ] 投诉建议提交
- [ ] 投诉处理进度
- [ ] 消息通知中心
- [ ] 物业公告查看
- [ ] 个人中心
- [ ] 家庭成员管理
- [ ] 消息设置
- [ ] 工单满意度评价
**物业员工APP (APP-E01~E22)**:
- [ ] 项目初始化与框架搭建
- [ ] 用户登录
- [ ] 工作台首页
- [ ] 待办事项展示
- [ ] 工单列表/详情/接单/处理/完成
- [ ] 扫码报修
- [ ] 巡检任务列表/执行
- [ ] 巡检扫码签到
- [ ] 巡检异常上报
- [ ] 访客登记/凭证验证
- [ ] 通行记录
- [ ] 消息通知
- [ ] 个人中心
- [ ] 工作统计
- [ ] 离线数据存储
- [ ] 地理位置上报
---
### 2. 第三方集成
**状态**: 待开发
| 编号 | 特性名称 | 状态 | 说明 |
|------|----------|------|------|
| P4-001 | 集成配置管理 | ⬜ 待开发 | 集成配置CRUD |
| P4-002 | 适配器框架 | ⬜ 待开发 | 统一适配器接口 |
| P4-003 | 数据同步引擎 | ⬜ 待开发 | 定时/实时数据同步 |
| P4-010 | 停车系统适配器 | ⬜ 待开发 | 停车系统接口适配 |
| P4-020 | 明源云适配器 | ⬜ 待开发 | 明源云接口适配 |
| P4-030 | IoT平台适配器 | ⬜ 待开发 | IoT平台接口适配 |
| P4-040 | 财务系统适配器 | ⬜ 待开发 | 财务系统接口适配 |
---
### 3. 前端优化改进项
**状态**: 待开发
| 编号 | 特性名称 | 优先级 | 说明 |
|------|----------|--------|------|
| OPT-SEC-001 | Token管理优化 | 高 | 双Token机制、加密存储 |
| OPT-SEC-002 | XSS防护增强 | 高 | xss库过滤、白名单配置 |
| OPT-SEC-003 | CSRF防护 | 高 | CSRF Token、SameSite Cookie |
| OPT-PERF-001 | 列表虚拟滚动 | 高 | 后端分页、虚拟表格 |
| OPT-PERF-002 | 请求优化 | 高 | 取消重复请求、请求缓存 |
| OPT-PERF-003 | WebSocket替代轮询 | 高 | 实时通信、断线重连 |
| OPT-MAINT-001 | 权限指令注册 | 中 | 全局指令注册、Store方法完善 |
| OPT-UX-001 | 表单分步优化 | 中 | Steps组件、分步验证 |
---
## 已完成功能
| 功能模块 | 状态 | 说明 | 完成日期 |
|----------|------|------|----------|
| 项目管理 | ✅ 完成 | 项目CRUD、空间管理 | 2026-02-10 |
| 合同管理 | ✅ 完成 | 合同CRUD、租户关联 | 2026-02-12 |
| 业主管理 | ✅ 完成 | 业主信息管理 | 2026-02-08 |
| 用户管理 | ✅ 完成 | 用户CRUD、部门管理 | 2026-02-05 |
| 权限管理 | ✅ 完成 | 角色/权限管理 | 2026-02-06 |
| 设备管理 | ✅ 完成 | 设备台账、维保管理、二维码、统计 | 2026-02-20 |
| 收费管理 | ✅ 完成 | 收费项目、账单管理、支付、统计、导出 | 2026-02-20 |
| **工单管理** | ✅ 完成 | 工单CRUD、状态流转、派单、评价、统计 | 2026-02-14 |
| **巡检管理** | ✅ 完成 | 巡检计划、任务、点、路径、排班、打卡 | 2026-02-14 |
| **访客管理** | ✅ 完成 | 访客预约、登记、凭证、记录查询 | 2026-02-10 |
| **通知管理** | ✅ 完成 | 通知渠道、模板、规则、历史记录 | 2026-02-08 |
| **投诉建议** | ✅ 完成 | 投诉提交、处理流程、统计分析 | 2026-02-14 |
| **满意度调查** | ✅ 完成 | 调查创建、回应收集、统计分析 | 2026-02-14 |
| **问卷调查** | ✅ 完成 | 问卷创建、回应收集、结果分析 | 2026-02-14 |
| **知识库管理** | ✅ 完成 | 分类管理、文章管理、搜索功能 | 2026-02-14 |
| **公告管理** | ✅ 完成 | 公告发布、推送通知、阅读统计 | 2026-02-14 |
| **智能派单** | ✅ 完成 | 位置距离、技能匹配、负载均衡、规则配置 | 2026-02-14 |
| **运营大屏** | ✅ 完成 | 数据可视化、实时监控、大屏展示 | 2026-02-14 |
| **SLA监控** | ✅ 完成 | 工单时效监控、超时预警、升级处理 | 2026-02-14 |
| **租户管理** | ✅ 完成 | 租户信息、租赁合同、到期提醒 | 2026-02-14 |
| **车位管理** | ✅ 完成 | 车位信息、租赁/出售、状态监控 | 2026-02-14 |
| **能耗管理** | ✅ 完成 | 能耗设备、数据录入、费用计算、报表分析 | 2026-02-14 |
---
## 工单管理模块详情
### 已实现功能
#### 工单基础管理
- [x] 工单列表查询(分页、筛选)
- [x] 工单详情查看
- [x] 工单创建/编辑
- [x] 工单状态流转(待派单/处理中/已完成/已关闭)
- [x] 工单派单
- [x] 工单评价
- [x] 工单统计报表
#### 工单关联功能
- [x] 工单关联设备
- [x] 设备维修历史查询
- [x] 工单满意度评价
### API 端点
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/v1/ops/work-orders` | GET | 查询工单列表 |
| `/api/v1/ops/work-orders` | POST | 创建工单 |
| `/api/v1/ops/work-orders/{id}` | GET | 查询工单详情 |
| `/api/v1/ops/work-orders/{id}` | PUT | 更新工单 |
| `/api/v1/ops/work-orders/{id}/assign` | POST | 派单 |
| `/api/v1/ops/work-orders/{id}/accept` | POST | 接单 |
| `/api/v1/ops/work-orders/{id}/complete` | POST | 完成工单 |
| `/api/v1/ops/work-orders/{id}/close` | POST | 关闭工单 |
| `/api/v1/ops/work-orders/statistics` | GET | 工单统计 |
### 数据库表
| 表名 | 说明 |
|------|------|
| `ops_work_order` | 工单主表 |
| `ops_work_order_flow` | 工单流转记录 |
---
## 巡检管理模块详情
### 已实现功能
#### 巡检计划管理
- [x] 巡检计划CRUD
- [x] 巡检周期设置(日/周/月/季/年)
- [x] 巡检计划启用/禁用
- [x] 巡检计划复制
#### 巡检点管理
- [x] 巡检点CRUD
- [x] 巡检点二维码生成
- [x] 巡检点NFC标签
- [x] 巡检项管理
#### 巡检任务管理
- [x] 巡检任务自动生成
- [x] 巡检任务分配
- [x] 巡检任务执行
- [x] 巡检打卡签到
- [x] 巡检异常上报
#### 巡检路径与排班
- [x] 巡检路径编排
- [x] 巡检排班管理
### API 端点
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/v1/ops/inspection/plans` | GET/POST | 巡检计划列表/创建 |
| `/api/v1/ops/inspection/plans/{id}` | GET/PUT/DELETE | 巡检计划详情/更新/删除 |
| `/api/v1/ops/inspection/points` | GET/POST | 巡检点列表/创建 |
| `/api/v1/ops/inspection/tasks` | GET | 巡检任务列表 |
| `/api/v1/ops/inspection/tasks/{id}` | GET | 巡检任务详情 |
| `/api/v1/ops/inspection/checkin` | POST | 巡检打卡 |
### 数据库表
| 表名 | 说明 |
|------|------|
| `ops_inspection_plan` | 巡检计划表 |
| `ops_inspection_point` | 巡检点表 |
| `ops_inspection_item` | 巡检项表 |
| `ops_inspection_task` | 巡检任务表 |
| `ops_inspection_path` | 巡检路径表 |
| `ops_inspection_schedule` | 巡检排班表 |
| `ops_inspection_checkin` | 巡检打卡记录表 |
---
## 访客管理模块详情
### 已实现功能
- [x] 访客预约管理
- [x] 访客登记
- [x] 访客记录查询
- [x] 访客凭证生成与验证
- [x] 访客二维码
### API 端点
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/v1/mdm/visitors` | GET/POST | 访客列表/创建 |
| `/api/v1/auth/visitor-credentials` | GET/POST | 访客凭证管理 |
### 数据库表
| 表名 | 说明 |
|------|------|
| `mdm_visitor` | 访客主表 |
| `auth_visitor_credential` | 访客凭证表 |
---
## 通知管理模块详情
### 已实现功能
- [x] 通知渠道管理
- [x] 通知模板管理
- [x] 通知规则管理
- [x] 通知历史记录
- [x] 工单事件通知集成
### API 端点
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/v1/ops/notification-channels` | GET/POST | 通知渠道管理 |
| `/api/v1/ops/notification-templates` | GET/POST | 通知模板管理 |
| `/api/v1/ops/notification-rules` | GET/POST | 通知规则管理 |
| `/api/v1/ops/notification-history` | GET | 通知历史记录 |
### 数据库表
| 表名 | 说明 |
|------|------|
| `ops_notification_channel` | 通知渠道表 |
| `ops_notification_template` | 通知模板表 |
| `ops_notification_rule` | 通知规则表 |
| `ops_notification_history` | 通知历史表 |
---
## 设备管理模块详情
### 已实现功能
#### 设备基础管理
- [x] 设备列表查询(分页、筛选)
- [x] 设备详情查看
- [x] 设备新增/编辑/删除
- [x] 设备分类管理10种设备类型
- [x] 设备状态管理(正常/维修/故障/报废)
- [x] 设备编码自动生成
- [x] 设备搜索功能
#### 设备维保管理
- [x] 维保计划管理
- [x] 维保记录管理
- [x] 维保执行流程
- [x] 维保统计分析
#### 设备故障管理
- [x] 设备故障报告
- [x] 自动创建维修工单
- [x] 维修历史查询
#### 设备二维码
- [x] 单个设备二维码生成
- [x] 批量二维码生成
- [x] 扫码获取设备信息
#### 设备统计分析
- [x] 设备概览统计
- [x] 按状态统计
- [x] 按类型统计
- [x] 故障率统计
- [x] 维保趋势统计
- [x] 故障设备排行
### API 端点
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/v1/asset/equipments` | GET | 查询设备列表 |
| `/api/v1/asset/equipments` | POST | 创建设备 |
| `/api/v1/asset/equipments/{id}` | GET | 查询设备详情 |
| `/api/v1/asset/equipments/{id}` | PUT | 更新设备 |
| `/api/v1/asset/equipments/{id}` | DELETE | 删除设备 |
| `/api/v1/asset/equipments/type/{type}` | GET | 按类型查询 |
| `/api/v1/asset/equipments/status/{status}` | GET | 按状态查询 |
| `/api/v1/asset/equipments/generate-code` | GET | 生成设备编码 |
| `/api/v1/asset/equipments/{id}/report-fault` | POST | 报告故障 |
| `/api/v1/asset/equipment/qrcode/{id}` | GET | 获取二维码 |
| `/api/v1/asset/equipment/statistics/overview` | GET | 统计概览 |
| `/api/v1/asset/maintenance-plans` | GET/POST | 维保计划管理 |
| `/api/v1/asset/maintenance-records` | GET/POST | 维保记录管理 |
### 数据库表
| 表名 | 说明 |
|------|------|
| `asset_equipment` | 设备主表 |
| `asset_maintenance_plan` | 维保计划表 |
| `asset_maintenance_record` | 维保记录表 |
---
## 收费管理模块详情
### 已实现功能
#### 收费项目管理
- [x] 收费项目CRUD
- [x] 8种收费类型支持
- [x] 项目启用/禁用
#### 账单管理
- [x] 账单CRUD
- [x] 账单状态管理(待缴/部分/已缴/逾期/取消)
- [x] 账单分页查询
- [x] 按状态筛选
#### 支付管理
- [x] 支付记录创建
- [x] 5种支付方式支持
- [x] 在线支付(微信/支付宝)
- [x] 支付状态查询
- [x] 支付退款
- [x] 支付回调处理
#### 统计分析
- [x] 收费统计概览
- [x] 今日应收/实收
- [x] 待收/逾期金额
- [x] 账单状态统计
#### 导出功能
- [x] 账单列表导出
- [x] 支付记录导出
- [x] 统计报表导出
- [x] 业主缴费明细导出
### API 端点
| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/v1/finance/fee-items` | GET | 查询收费项目列表 |
| `/api/v1/finance/fee-items` | POST | 创建收费项目 |
| `/api/v1/finance/bills` | GET | 查询账单列表 |
| `/api/v1/finance/bills` | POST | 创建账单 |
| `/api/v1/finance/bills/{id}/pay` | POST | 账单支付 |
| `/api/v1/finance/statistics` | GET | 收费统计 |
| `/api/v1/finance/bills/export` | GET | 导出账单 |
| `/api/v1/finance/payments/export` | GET | 导出支付记录 |
### 数据库表
| 表名 | 说明 |
|------|------|
| `fin_fee_item` | 收费项目表 |
| `fin_fee_bill` | 账单表 |
| `fin_fee_payment` | 支付记录表 |
---
## 相关文档
- [API文档](./api-docs.md)
- [特性清单](./01-REQUIREMENTS/FEATURE_LIST.md)
- [数据库设计-资产域](./02-DESIGN/domains/03-ASSET.md)
- [数据库设计-财务域](./02-DESIGN/domains/04-FINANCE.md)
---
*最后更新: 2026-02-24*