范围
中断事件日志(energy:disruptions:v1)是一个状态机历史记录,记录与 energy:pipelines:gas:v1、energy:pipelines:oil:v1 和 energy:storage-facilities:v1 中策展资产相关的停电、制裁、维护窗口、天气事件和商业里程碑。
第 1 版发布一个策展的种子集,包含与同一登记表中资产相关联的显著历史和持续事件(Nord Stream 1/2 破坏、Druzhba 制裁、CPC 不可抗力、TurkStream 维护、ESPO 无人机袭击、Arctic LNG 2 OFAC 列名等)。该日志目前仅由人工策展;自动化的状态转换分类器已规划但尚未上线。
数据形状
每个事件都是一行,以稳定 id 为键:什么算作中断
事件日志覆盖状态转换,而非日常吞吐噪声:- 破坏:明确的物理袭击(Nord Stream 2022、ESPO 泵站 2025)。
- 制裁:监管机构列名或运营商被指定,迫使商业停运(Arctic LNG 2 OFAC 列名、Druzhba 北线政策停运)。
- 维护:已发布的开始/结束时间表的运营商维护窗口。
- 机械:非计划故障、不可抗力(CPC 浮筒损坏)。
- 天气:飓风/风暴导致的关停(Sabine Pass 飓风 Beryl)。
- 商业:实质性商业变化(Power of Siberia 容量爬坡)。
- 战争:战争驱动的运营变化(CPC、Yamal-Belarus)。
日志如何保持新鲜
- 策展:事件日志由
scripts/seed-energy-disruptions.mjs按周 cron 刷新,读取scripts/data/energy-disruptions.json中手工撰写的 JSON。当新状态转换在各个资产的证据包中浮现时,由编辑审阅并添加行。请参阅/corrections了解计划中的审计界面形状,它将在自动分类器落地时跟踪未来的自动化状态转换条目(如果/当落地的话)。 - 衰减:持续事件(
endAt为 null)且lastEvidenceUpdate超过 30 天的,在面板抽屉中降级为”证据过时”处理;它们不会自动解决。
证据来源纪律
每个事件至少携带一个带有可公开验证 URL 的来源。regulator 和 operator 来源在分类器置信度权重方面优先于 press。classifierConfidence 字段是面向下游消费者的质量提示;它不门控显示——所有策展事件都会渲染。
公开 API
ListEnergyDisruptions—GET /api/supply-chain/v1/list-energy-disruptions,支持可选的assetId/assetType/ongoingOnly查询切面。返回最新优先的事件。- 免费层。网关缓存层:
medium。 - 面板抽屉(
PipelineStatusPanel、StorageFacilityMapPanel)在抽屉打开时惰性调用此 RPC,作用域限定于资产 id。
分类器版本 + 自动修订日志
每个事件都使用classifierVersion 进行版本化。当规则变更(新增原因枚举、新事件类型、收紧置信度阈值)时,版本号递增并重新派生事件。先前的分类器版本仍可通过行上的 classifierVersion 字段读取——没有静默重写。
变更计划在 /corrections 自动记录,每条记录包含 {field, previousValue, newValue, trigger, sourcesUsed, classifierVersion}——这是设计好的审计界面。事件日志本身是面向前方的;一旦分类器上线,修订日志将是日志如何演化的历史。
