业务流程 — 谁在何时做什么
本文档整理的是组织如何运营平台。重点不是界面操作，而是角色与顺序。
与教程不同
教程是「一个人初次尝试一次」，而本文是「多人持续运营」。已标出职责分工和交接发生的节点。
角色只有三种
| 角色 | 界面显示 | 职责 |
|---|---|---|
| ADMIN | 系统管理员 | 账户·安全·设备主数据·系统设置全部 |
| API | API 开发者 | 外部系统集成。通过令牌调用 API |
| USER | 普通用户 | 以查询为主。无更改权限 |
MANAGER 是「无法分配」的角色
不同角色看到的菜单不同 → 登录与界面结构。
生命周期 — 三个阶段
按角色泳道看整体如下。箭头跨越泳道的地方就是交接点。
1. 导入·调试 — 仅一次，但务必做好
| 顺序 | 事项 | 负责人 | 产出物 |
|---|---|---|---|
| 1 | 安装 | 建设 | 平台启动 → 安装 |
| 2 | 全部更换默认密码 | 建设 | 交接文档 → 修改初始密码 |
| 3 | 确定 ID 规则 | 建设 + 现场 | 命名规范书 → 域名 ID 规则 |
| 4 | 注册站点 → 设备 → 标签 | 建设 | 设备主数据 |
| 5 | Edge 连接·采集验证 | 建设 | 界面上出现数值 |
| 6 | 设置报警阈值 | 现场 | 报警定义 → 报警管理 |
| 7 | 发放账户·分配角色 | ADMIN | 用户列表 → 用户管理 |
| 8 | 验收检查 | 现场 | 验收确认书 |
跳过第 3 步将难以回退
ID 会直接嵌入界面、API、报告等各处。仓促制定的 ID 会长期存在。 在开始注册之前，请先将规则文档化。
2. 正常运行 — 周期性工作
| 周期 | 事项 | 负责人 |
|---|---|---|
| 每日 | 报警确认·处理，检查采集中断 | 现场 |
| 每周 | 检查磁盘·资源趋势 → 监控 | ADMIN |
| 每月 | 备份恢复演练，账户清理 | ADMIN |
| 每季度 | 更换密码 → 凭据轮换 | ADMIN |
备份不是「做备份」而是「能恢复」
只做了备份但从未尝试恢复，这是最常见的失败模式。尤其是存储有三个副本时更易如此 → 数据库模型。
3. 变更·扩展 — 设备增加或变更时
| 事项 | 步骤 |
|---|---|
| 新增设备 | 主数据注册 → 标签 → 采集确认 → 报警 |
| 更改标签含义 | 首先确认不会与现有数据和单位混淆 |
| 新增集成 | 发放 API 账户 → 令牌 → IP 限制 → API 手册 |
请勿重用标签
更改在用标签的含义，会导致历史数据和新数据以相同名称混合。报告无法区分它们。请创建新标签。
交接点 — 此处常出问题
| 交接 | 应移交的内容 |
|---|---|
| 建设 → 现场 | 账户列表、更改后密码的存放位置、ID 规范书、验收确认书 |
| 现场 → 系统管理员 | 故障时的联系途径、诊断 tarball 的生成方法(./doctor.sh) |
| 负责人更换 | 以上全部 + 最近的变更记录 |
请勿将密码值直接写进交接文档
只写明存放在哪里。密码值通过单独的秘密管理方式传递。
常见问题点
| 症状 | 常见原因 |
|---|---|
| 「不知道是谁改的」 | 多人共用账户——请为每个人创建独立账户 |
| 「报警太多，没人看」 | 阈值在导入时设置后再未调整。请每季度重新校准 |
| 「数据从某时开始缺失」 | 未每日检查采集中断。请将其纳入每日巡检 |
| 「接手后不知道密码」 | 交接文档中未记录保管位置 |