8.5 KiB
8.5 KiB
需求定义文档（续）
3.2 模块功能概述
| 模块名称 | 功能概述 |
|---|---|
| 用户与认证模块 | 负责用户身份验证和权限控制，提供注册、登录、密码重置等功能，确保系统安全性。 |
| 反馈管理模块 | 处理公众提交的环境问题反馈，包括提交、审核、状态追踪和查询统计等功能。 |
| 任务管理模块 | 将审核通过的反馈转化为工作任务，管理任务的分配、执行和完成全流程。 |
| 网格与地图模块 | 提供地理空间的网格化管理，支持路径规划和地图可视化，辅助任务执行。 |
| 决策支持模块 | 通过数据分析和可视化，为管理层提供决策支持，帮助优化资源配置和治理策略。 |
| 系统管理模块 | 提供系统配置、用户管理、权限设置等基础功能，保障系统正常运行。 |
| 文件服务模块 | 处理系统中的文件上传、存储和访问，支持反馈和任务的附件管理。 |
| 日志审计模块 | 记录系统操作日志，支持安全审计和问题追溯，确保系统运行的可追溯性。 |
4. 整体业务流程
下图描述了从公众发现问题、上报、到平台内部流转、处理、并最终反馈结果的完整闭环业务流程：
flowchart TD
%% 定义样式
classDef public fill:#d4f1f9,stroke:#05a8e5,color:#333
classDef platform fill:#ffe6cc,stroke:#f7a128,color:#333
classDef worker fill:#d5e8d4,stroke:#82b366,color:#333
classDef supervisor fill:#e1d5e7,stroke:#9673a6,color:#333
classDef decision fill:#f8cecc,stroke:#b85450,color:#333
classDef start_end fill:#f5f5f5,stroke:#666666,color:#333,stroke-width:2px
%% 流程开始
A([开始]) --> B["[公众端] 发现环境问题"]
B --> C["[公众端] 提交反馈<br>(标题/描述/图片/位置)"]
%% 平台接收与AI处理
C --> D["[平台] 接收反馈<br>生成唯一事件ID"]
D --> E{"[平台] AI自动审核<br>分析内容/分类"}
%% AI审核分支
E -- "明显无效" --> F1["[平台] 标记为AI_REJECTED"]
F1 --> F2["[平台] 通知提交者"]
F2 --> Z1([结束])
E -- "需人工确认" --> G["[主管] 查看反馈详情<br>进行人工审核"]
%% 主管审核分支
G --> H{"[主管] 审核决定"}
H -- "驳回" --> I1["[主管] 填写驳回理由"]
I1 --> I2["[平台] 更新状态为REJECTED"]
I2 --> I3["[平台] 通知提交者"]
I3 --> Z2([结束])
%% 审核通过，创建任务
H -- "通过" --> J1["[主管] 确认反馈有效"]
J1 --> J2["[平台] 自动创建结构化任务"]
J2 --> J3["[平台] 更新反馈状态为PROCESSED"]
%% 任务分配
J3 --> K1{"[主管] 选择分配方式"}
K1 -- "手动分配" --> K2["[主管] 选择特定网格员"]
K1 -- "智能推荐" --> K3["[平台] 运行分配算法<br>考虑位置/负载/专长"]
K3 --> K4["[平台] 推荐最佳人选"]
K4 --> K2
K2 --> K5["[平台] 创建任务分配记录<br>更新任务状态为ASSIGNED"]
K5 --> K6["[平台] 通知网格员"]
%% 网格员处理
K6 --> L1["[网格员] 接收任务通知"]
L1 --> L2{"[网格员] 接受任务?"}
L2 -- "拒绝" --> K1
L2 -- "接受" --> L3["[网格员] 更新任务状态为IN_PROGRESS"]
L3 --> L4["[网格员] 查看任务详情<br>获取路径规划"]
L4 --> L5["[网格员] 前往现场处理"]
L5 --> L6["[网格员] 记录处理过程<br>上传证明材料"]
L6 --> L7["[网格员] 提交处理结果<br>更新状态为SUBMITTED"]
%% 主管审核结果
L7 --> M1["[主管] 审核处理结果"]
M1 --> M2{"[主管] 结果是否合格?"}
M2 -- "不合格" --> M3["[主管] 填写原因<br>要求重新处理"]
M3 --> L4
%% 完成流程
M2 -- "合格" --> N1["[主管] 确认任务完成"]
N1 --> N2["[平台] 更新任务状态为APPROVED"]
N2 --> N3["[平台] 更新反馈状态为CLOSED"]
N3 --> N4["[平台] 通知反馈提交者"]
N4 --> N5["[平台] 更新统计数据"]
N5 --> O["[决策层] 查看数据看板<br>分析环境趋势"]
O --> Z3([结束])
%% 为节点添加类别
class A,Z1,Z2,Z3 start_end
class B,C,F2,I3,N4 public
class D,E,F1,I2,J2,J3,K3,K4,K5,K6,N2,N3,N5 platform
class G,H,I1,J1,K1,K2,M1,M2,M3,N1 supervisor
class L1,L2,L3,L4,L5,L6,L7 worker
class O decision
5. 功能需求详细描述
5.1 用户与认证模块需求
| 需求ID | 需求名称 | 需求描述 | 优先级 |
|---|---|---|---|
| AUTH-01 | 用户注册 | 系统应允许新用户通过提供基本信息（姓名、手机号、邮箱、密码等）进行注册，并验证信息的有效性和唯一性。 | 高 |
| AUTH-02 | 用户登录 | 系统应支持用户通过邮箱/手机号和密码进行身份验证，登录成功后生成安全令牌用于后续请求。 | 高 |
| AUTH-03 | 密码重置 | 系统应提供安全的密码重置机制，包括通过邮箱或手机验证码验证身份。 | 中 |
| AUTH-04 | 权限控制 | 系统应基于用户角色（公众用户、网格员、主管、管理员、决策者）实施访问控制，确保用户只能访问其权限范围内的功能和数据。 | 高 |
| AUTH-05 | 会话管理 | 系统应维护和管理用户会话状态，包括会话创建、验证和超时处理。 | 中 |
| AUTH-06 | 个人资料管理 | 系统应允许用户查看和更新其个人资料，包括基本信息、联系方式和偏好设置。 | 低 |
| AUTH-07 | 安全日志 | 系统应记录所有关键安全事件（登录尝试、权限变更等），支持安全审计。 | 中 |
用户与认证流程图：
graph TD
A[用户访问系统] --> B{是否已登录?}
B -- 否 --> C{是否有账号?}
B -- 是 --> D[访问系统功能]
C -- 否 --> E[注册新账号]
C -- 是 --> F[登录系统]
E --> G[填写注册信息]
G --> H[验证邮箱/手机]
H --> I[创建用户账号]
I --> F
F --> J{认证是否成功?}
J -- 否 --> K{是否忘记密码?}
J -- 是 --> L[生成安全令牌]
K -- 是 --> M[密码重置流程]
K -- 否 --> F
M --> N[验证身份]
N --> O[设置新密码]
O --> F
L --> P[加载用户权限]
P --> D
D --> Q[系统记录操作日志]
R[用户请求退出] --> S[清除会话信息]
S --> T[返回登录页面]
5.2 反馈管理模块需求
| 需求ID | 需求名称 | 需求描述 | 优先级 |
|---|---|---|---|
| FEED-01 | 反馈提交 | 系统应允许公众用户提交环境问题反馈，包括问题描述、位置标记、污染类型分类和图片上传。 | 高 |
| FEED-02 | AI内容审核 | 系统应自动分析反馈内容，识别垃圾信息、重复提交，并进行初步分类和紧急程度评估。 | 中 |
| FEED-03 | 人工审核 | 系统应提供主管审核反馈的工作台，支持查看详情、批准或驳回反馈。 | 高 |
| FEED-04 | 状态追踪 | 系统应记录和展示反馈的全生命周期状态变更，允许用户查询处理进度。 | 高 |
| FEED-05 | 反馈查询 | 系统应支持按多种条件（状态、时间、区域、类型等）查询和筛选反馈列表。 | 中 |
| FEED-06 | 反馈统计 | 系统应生成反馈数据的统计分析，包括数量分布、处理效率等指标。 | 低 |
| FEED-07 | 通知提醒 | 系统应在反馈状态变更时通知相关用户，保持信息透明。 | 中 |
反馈管理流程图：
graph TD
A[公众用户发现环境问题] --> B[打开反馈提交界面]
B --> C[填写问题描述]
C --> D[选择污染类型]
D --> E[评估严重程度]
E --> F[标记地理位置]
F --> G[上传现场照片]
G --> H[提交反馈]
H --> I[系统生成唯一事件ID]
I --> J[AI自动审核内容]
J --> K{AI审核结果}
K -- 明显无效 --> L[标记为AI_REJECTED]
K -- 需人工确认 --> M[进入主管审核队列]
L --> N[通知用户反馈被拒绝]
M --> O[主管查看反馈详情]
O --> P{审核决定}
P -- 驳回 --> Q[填写驳回理由]
P -- 通过 --> R[标记为有效反馈]
Q --> S[更新状态为REJECTED]
S --> T[通知用户反馈被驳回]
R --> U[创建关联任务]
U --> V[更新状态为PROCESSED]
W[用户查询反馈状态] --> X[系统展示处理进度]
Y[管理员查看统计数据] --> Z[系统生成反馈分析报表]