角色与需求

本文整合旧的角色分析、功能需求和非功能需求，形成一个更适合产品阅读的摘要。

核心角色

角色	核心职责	MVP 优先支持
巡检员	执行巡检、记录现场信息、提交样本与异常	任务查看、状态更新、样本录入、异常上报
分析员	接收样本、录入结果、查看分析状态	收样、检索、结果录入、分析任务监控
管理员	维护运行边界与核心配置	角色与访问控制、字典配置、审计与全局摘要

MVP 功能范围

1. 巡检任务

• 查看任务列表与详情
• 推进 assigned -> in_progress -> submitted
• 记录现场备注、样本与异常

2. 样本管理

• 新建样本
• 查看样本列表与详情
• 关联巡检任务
• 上传主图并展示自动建议

3. 样本结果

• 录入结构化结果
• 查看结果历史
• 为后续复核流保留扩展空间

4. 异常处理

• 创建异常
• 查看异常列表
• 推进 open -> resolved

5. 分析任务

• 创建分析任务
• 跟踪生命周期状态
• 处理 queued / running / succeeded / failed / cancelled
• 保留失败历史并重试

6. 首页摘要

• 待处理样本数
• 今日巡检任务数
• 未解决异常数
• 排队中的分析任务数

非功能优先级

易用性

• 保持核心工作台易操作
• 能用结构化表单和显式动作的地方尽量减少自由文本

性能与容量

• 列表、详情、摘要接口在日常使用下保持稳定
• 长耗时分析任务不阻塞同步请求链路

可靠性与恢复性

• 普通失败不能导致核心数据丢失
• 异步任务要保留失败历史和重试语义

安全性

• 落实角色访问控制
• 为敏感操作保留审计轨迹
• 统一输入校验

可维护性

• 保持 Laravel、SPA 前端、analysis-worker、MariaDB、Redis、Nginx、Compose 的清晰边界
• 避免过早引入微服务和复杂编排

当前阶段明确不纳入范围

• 离线同步与冲突解决
• GPS / 北斗围栏
• 视频型媒体流水线
• 复杂实时设备遥测
• 模型版本管理与灰度
• 深度第三方平台集成

优先级结论

当前阶段应优先确保：

1. 核心流程可跑通
2. 数据流转可追踪
3. 状态流转可审计
4. 部署方式简单稳定