物业工单

sa-admin/.../property/workorder/WorkOrderController

工单分页、分配、处理、支付回调、进度查询；支持按状态查询

新增“我的待处理工单数/列表”聚合接口；增加门户所需优先级/SLA字段计算

与投诉联动（工单完成回写投诉）；权限依赖员工角色

投诉管理

sa-admin/.../property/complaint/ComplainController

投诉登记、查询、处理进度、完成

补充“待处理投诉计数”接口

投诉可生成工单；需要社区范围权限

审批中心

sa-admin/.../approval/MyApprovalController

待处理/相关/抄送列表与统计(MyApprovalStatisticsVO)

复用统计与列表，门户只做展示与跳转

基于Flowable，权限由角色、候选人控制

用户统计

sa-admin/.../user/statistics/UserStatisticsController

当前用户会议数、审批数、培训时长统计

直接复用用于数据总览

需要身份证信息时受限于业委会成员表

财务账单/收费

sa-admin/.../finance/fee/RoomBillController

欠费统计、一键催缴、账单列表

抽取社区层面的欠费概览指标

与支付、住户数据强关联，需按社区过滤

消息/通知

sa-admin/.../system/notice/NoticeService & messager

站内信、短信、微信通知发送

门户提醒角标，复用未读数

需要登录态与渠道配置

菜单/权限

sa-admin/.../system/menu/MenuService

菜单树、权限点

用于快速入口配置及鉴权

仅PC后台；移动端不在范围

What做什么

- 核心功能是什么？- 包含哪些子功能？- 不包含什么（边界）？

统一门户首页，聚合待办（审批/工单/投诉/欠费催缴）、快捷入口、数据总览（个人统计、社区经营指标）。

是否需要短信/微信提醒入口；是否展示公告/消息中心；是否支持可拖拽布局。

Why为什么

- 解决什么问题？- 业务价值是什么？- 不做会怎样？

减少分散入口带来的时间成本，缩短工单/审批响应时效，提升管理透明度。

提供SLA红线预警，降低逾期赔付风险；统计闭环助力绩效考核。

Who谁

- 目标用户是谁？- 涉及哪些角色？- 各角色权限差异？

物业主管、工程/客服负责人、财务/收费员、社区运营管理员、平台超管。

外包商/供应商可能需要只读待办；政府监管账号可能需只看数据不操作。

When何时

- 什么场景下使用？- 触发条件是什么？- 有时间限制吗？

每日上班首屏、交接班、月度结算前、投诉高峰期；待办超时前出现提醒。

夜间低负载可缓存；重大事件（停电/暴雨）时需要突发公告位。

Where何处

- 在哪个模块/页面？- 入口在哪里？- 多端支持？

PC管理后台首页 /portal；顶部导航或登录后默认页；当前仅PC，不含小程序端。

未来可扩展APP端轻量门户；大屏模式用于会议展示。

How如何做

- 操作流程是什么？- 关键交互是什么？- 异常如何处理？

筛选社区/时间→查看待办列表→一键跳转或快捷处理→查看数据卡片→自定义入口；异常展示错误提示，允许重新拉取。

需要定时刷新或手动刷新；离线/超时返回缓存数据。

How Much多少

- 数据量级预估？- 性能要求？- 开发成本评估？

待办列表单页<500条，统计接口需<=2s；缓存与分批请求降低压力；预估开发3-5人日（含后端聚合、前端页面、测试）。

大社区并发时需限流与降级；指标计算可异步预聚合。

✅ 包含

PC后台统一门户、待办聚合（审批/工单/投诉/欠费催缴）、快捷入口配置、数据总览卡片、筛选/刷新、权限控制、基础通知角标。

❌ 不包含

移动端/小程序门户、新审批流程设计、财务深度报表新开发、IM在线沟通。

⚠️ 待确认

是否需要拖拽自定义布局；是否支持跨社区合并统计；是否展示公告/通知列表。

📋 后续迭代

大屏模式、个人KPI看板、AI智能派单建议、SLA自动升级策略配置。

可复用功能/组件列表

• 审批待办与统计（MyApprovalController、MyApprovalStatisticsVO）。

• 工单查询/处理（WorkOrderController）与投诉处理（ComplainController）。

• 用户统计数据（UserStatisticsController）。

• 欠费/财务数据接口（RoomBillController）。

• 通知/站内信能力（NoticeService）。

• 权限与菜单（MenuService）用于入口控制。

需修改的现有功能

• 补充待办计数/聚合接口（工单、投诉）。

• 为门户提供合并响应的聚合API与缓存。

• 若需SLA红线，工单/投诉需输出预计完成时间。

与现有功能的关联关系

• 工单完成自动回写投诉进度；审批节点关联财务付款。

• 权限沿用角色/社区范围；入口展示需校验权限点。

• 通知角标依赖消息未读数。

新旧功能边界划分

• 门户仅做聚合展示与跳转，不修改业务流程。

• 业务操作仍落在原模块（审批详情、工单详情等）。

• 配置仅影响门户视图，不改变菜单权限。

所属小区

下拉选择

是

当前登录默认社区

过滤待办与数据总览范围

角色身份

下拉选择

否

当前登录角色

用于筛选待办来源（如仅工程/客服）

任务类型

多选下拉

否

审批、工单、投诉、欠费

控制待办模块显示

时间范围

日期选择

否

最近7天

用于数据总览及待办创建时间筛选

关键词

文本输入

否

-

模糊搜索待办标题/编号

待办类型

moduleType

审批/工单/投诉/欠费

是

用于分类与图标展示

标题/编号

title/code

文本

是

点击跳转原模块详情

优先级

priority

颜色标签

是

按高-中-低排序

创建时间

createTime

YYYY-MM-DD HH:mm:ss

是

支持时间排序

截止时间/SLA

dueTime

YYYY-MM-DD HH:mm，红色高亮逾期

是

用于超时提醒

当前处理人/候选人

assignee/candidates

文本

否

展示责任人

状态

status

标签

是

待处理/处理中/待支付等

入口名称

entryName

文本/图标

是

用户自定义命名

模块

moduleKey

文本

否

工单/审批/收费/统计等

目标路径

targetUrl

链接

否

点击跳转

权限标识

permission

文本

否

用于前端显示控制

排序号

sort

数字

是

决定展示顺序

审批待办数

approval.pendingCount

数字+趋势

否

复用MyApprovalStatisticsVO

工单待处理数

workOrder.pendingCount

数字+环比

否

需新增统计接口

投诉未结数

complaint.pendingCount

数字

否

聚合complain待处理

欠费总额

fee.overdueAmount

金额

否

RoomBill欠费统计

学习时长

user.trainingTotalHours

数字(小时)

否

UserStatistics数据

去处理

行内始终显示

用户具备对应模块权限

跳转原业务详情页

批量标记已读

选中多条待办

选中项不为空

调用对应模块已读/领取接口

自定义快捷入口

有配置权限

必填项通过校验

打开配置弹框并保存

查看全部数据

数据总览卡片区域

无

跳转到对应统计页面

刷新

始终显示

无

重新拉取聚合数据

入口名称

文本输入

是

-

最大20字符

显示名称

模块选择

下拉选择

是

-

必须在已有菜单列表

决定权限校验

目标路径

文本输入

是

选模块时自动带出

合法URL

跳转地址

权限标识

文本输入

否

模块默认权限

与菜单权限一致

控制显示

排序号

数字输入

否

999

正整数

展示顺序

是否默认显示

开关

否

否

-

控制是否加入首页

保存

始终显示

必填校验通过

写入用户配置并刷新入口区

取消

始终显示

无

关闭弹框，不保存

处理结果

下拉选择

是

-

必须在状态枚举

同意/驳回/完成

处理备注

文本输入

否

-

最大200字

记录原因

附件/图片

文件上传

否

-

大小<=10MB

上传凭证

预计完成时间

日期时间

否

-

晚于当前时间

用于重新计算SLA

提交处理

始终显示

必填项完成

调用原模块处理接口

转派/指派

待办类型=工单

用户有派单权限

跳转到工单分派页

communityId

数字

是

当前社区

筛选范围

role

字符串

否

登录角色

过滤待办来源

moduleTypes

字符串数组

否

["approval","workOrder","complaint","fee"]

需要展示的模块

dateRange

日期区间

否

最近7天

统计/列表时间范围

id

原模块主键

数字

否

跳转用

title

原模块标题/编号

文本

是

可搜索

moduleType

聚合生成

标签

是

区分模块

status

原模块状态

标签

是

同步业务状态

priority

聚合规则

颜色标签

是

高/中/低

createTime

原模块

YYYY-MM-DD HH:mm:ss

是

排序、筛选

dueTime

原模块或计算

YYYY-MM-DD HH:mm

是

SLA预警