# 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*
