Documentation

EdgeOS 2026 P3 TODO

P3 阶段的目标、范围与重点任务清单。

EdgeOS 2026 P3 TODO

阶段定位

P3 阶段建立在现有“消息总线 / 节点注册 / 子设备同步 / 点位监控 / 双向控制”能力之上，目标是把 EdgeOS 从“采集与接入平台”推进到“业务运营层 + 群控编排层”。

本阶段只交付两部分：

前端高仿真静态页面
可执行的业务扩展规划文档

本阶段不包含：

真实后端接口接入
权限体系改造
审计落库
真实调度执行

信息架构

一级导航

采集运行
- 系统总览
- 消息总线
- 节点管理
- 设备控制
- 告警管理
- 系统设置
业务扩展
- 业务中心
  - 储能管理
  - 电源BMS
  - 充电管理
  - 能耗监测
  - 账务台账
群控编排
- 群控管理
  - 节点调度
  - 场景联动
  - 函数执行
  - 脚本编排

路由清单

/business-center
/business-center/energy-storage
/business-center/power-bms
/business-center/charging
/business-center/energy-monitoring
/business-center/ledger
/group-control
/group-control/node-scheduling
/group-control/scenario-linkage
/group-control/function-execution
/group-control/script-orchestration

UI 设计原则

所有 P3 页面继续遵循 docs/样式规范.md，并补充以下约束：

每个页面必须展示 Latency / Loss / Quality
每个页面至少包含：
- 顶部页面摘要区
- KPI 区
- 主监控区
- 表格或列表区
- 侧边日志或详情区
所有高风险动作只展示静态外观，不连接真实执行
群控相关页面必须展示审计位，字段固定为：
- user
- action
- target
- timestamp
- result

11 页页面清单

1. 业务中心总览

页面职责：展示业务域整体经营情况
核心区域：业务 KPI、站点分布、收益与能耗趋势、业务告警摘要
关键字段：收益、站点数、工单数、累计充放电量
控制分级：L2/L3/L5 演示
静态数据：五大业务域总览表、趋势占位、业务动作审计

2. 储能管理

页面职责：站级 SOC/SOH、功率与调峰策略总览
核心区域：储能站点清单、调峰趋势、工单告警
关键字段：SOC、SOH、功率、策略状态、工单
控制分级：L2/L3/L4 演示
静态数据：站点表、策略时间线、工单摘要

3. 电源BMS

页面职责：电芯簇健康、温差压差、均衡状态与寿命风险
核心区域：簇健康矩阵、均衡路径、异常侧栏
关键字段：温差、压差、均衡状态、寿命指数
控制分级：L2/L3/L5 演示
静态数据：簇表、均衡日志、风险告警

4. 充电管理

页面职责：充电枪位、订单会话、排队与负载分配
核心区域：会话面板、排队压力、异常订单
关键字段：占用枪位、排队数、负载、会话状态
控制分级：L2/L3/L4 演示
静态数据：站点会话表、队列趋势、异常订单日志

5. 能耗监测

页面职责：分站点 / 分回路能流与能耗质量监测
核心区域：峰谷趋势、回路质量、损耗热点
关键字段：能耗、Quality、Latency、Loss、损耗
控制分级：L2/L3/L5 演示
静态数据：回路表、异常波动时间线、策略建议位

6. 账务台账

页面职责：账单、开票、结算与异常条目统一查看
核心区域：台账状态表、财务异常、结算日志
关键字段：金额、开票状态、结算状态、Quality、异常状态
控制分级：L2/L3/L5 演示
静态数据：账单表、开票日志、复核审计

7. 群控管理总览

页面职责：群控编排层全局驾驶舱
核心区域：节点、任务、场景、函数、脚本整体态势
关键字段：在线节点、调度任务、成功率、失败次数
控制分级：L3/L4/L5 演示
静态数据：四大能力域面板、执行时间线、风险摘要

8. 节点调度

页面职责：资源池、队列、策略、失败重派
核心区域：节点容量队列表、资源热力、调度事件
关键字段：CPU、内存、队列、策略、失败重派
控制分级：L3/L4/L5 演示
静态数据：调度表、迁移时间线、调度审计

9. 场景联动

页面职责：事件-条件-动作链路展示
核心区域：规则链、联动命中、执行日志
关键字段：事件、条件、动作、Quality、规则状态
控制分级：L2/L3/L5 演示
静态数据：规则表、ECA 流程图、联动日志

10. 函数执行

页面职责：函数目录、输入输出、耗时与失败追踪
核心区域：函数目录表、吞吐趋势、失败追踪
关键字段：输入、输出、耗时、Quality、状态
控制分级：L2/L3/L5 演示
静态数据：函数目录、预热日志、执行审计

11. 脚本编排

页面职责：工作流、版本、审批、DAG 与运行日志
核心区域：工作流表、审批流、编排日志
关键字段：版本、审批、DAG、Quality、状态
控制分级：L3/L4/L5 演示
静态数据：工作流表、审批日志、编排审计

实施拆分

1. 导航与路由

侧边栏升级为一级分组 + 二级菜单
一级菜单保留独立总览页
Header 补齐面包屑与标题映射

2. Mock 与类型

新增 ui/src/mock/p3/
新增 P3 类型定义，统一页面 DTO
页面禁止散落写死业务数据

3. 组件

BusinessKpiStrip
HealthMetricCard
QualityTrendCard
DispatchQueueTable
ScenarioFlowBoard
ExecutionTimeline
LedgerStatusTable

4. 页面

使用统一静态页面壳子承载 11 页数据
所有页面支持亮色 / 暗色主题
所有页面保留风险动作预览区与审计位

5. 验收

路由可进入
导航激活态正确
面包屑正确
全部页面展示 Latency / Loss / Quality
不依赖真实 API

技术实现路径

前端接入路径

在 ui/src/lib/navigation.ts 维护一级导航与二级子菜单定义
在 ui/src/router/index.ts 中为业务中心与群控管理分别挂载独立页面组件
在 ui/src/mock/p3/index.ts 中统一维护页面静态 DTO
在 ui/src/views/business 与 ui/src/views/group-control 中按模块拆分专属页面
通过 ui/src/composables/useP3Page.ts 从 mock 数据读取页面所需静态信息
使用 ui/src/components/p3 中的业务组件完成页面拼装

页面差异化实现策略

总览页：突出导航入口与业务态势
储能页：突出站级调峰与电量面板
BMS 页：突出矩阵诊断与风险聚类
充电页：突出会话、排队与枪位板
能耗页：突出趋势观察栏与异常回路
台账页：突出财务工作台与导出动作
群控总览：突出指挥面与能力域入口
节点调度：突出容量与队列
场景联动：突出 ECA 规则链
函数执行：突出运行时目录与样例输入输出
脚本编排：突出 DAG、审批与执行工位

依赖关系

数据依赖

所有 P3 页面依赖 ui/src/mock/p3/index.ts
页面静态结构依赖 ui/src/types/p3.ts
页面取数依赖 ui/src/composables/useP3Page.ts

组件依赖

KPI 相关页面依赖 BusinessKpiStrip
状态带依赖 P3StatusStrip
告警/日志依赖 P3EventFeed
高风险操作演示依赖 P3ActionCenter
审计展示依赖 P3AuditTable
趋势图依赖 QualityTrendCard
表格依赖 DispatchQueueTable / LedgerStatusTable
结构流依赖 ScenarioFlowBoard / ExecutionTimeline

视觉依赖

全局主题变量依赖 ui/src/assets/css/globals.css
Header / Sidebar 依赖现有 layout 体系
所有页面遵循 docs/样式规范.md

后续对接点

真实业务 API
权限与角色控制
审计日志落库
调度执行回执
账单导入与对账状态同步
图表组件替换为真实趋势图

当前实现说明

当前仓库已完成：

P3 文档落地
导航结构扩展
11 个高仿真静态页面接入
mock 数据统一收口
风险动作静态确认区与审计位展示

下一阶段建议优先对接：

业务中心的真实站点数据接口
群控管理的任务 / 规则 / 工作流执行回执
账务台账与审计日志的后端持久化