---
title: "Observable States"
type: concept
tags: [workflow, observability, system-modeling]
last_updated: 2026-04-25
---

## Definition
可观察状态——每个工作流状态（快乐路径中的每一步 + 每个失败模式）必须同时从四个视角描述系统当前状态，确保客户、运维、数据库和日志各方都能准确感知系统发生了什么。

## Four Dimensions（四维度）

| 维度 | 描述 | 示例 |
|------|------|------|
| **Customer View** | 当前客户在 UI 上看到什么 | 加载中 / "处理中..." / 空白 / 错误提示 |
| **Operator View** | 运维/管理员在管理面板看到什么 | 实体处于"处理中"状态 / 任务步骤显示 "step_3_running" |
| **Database View** | 数据库中数据当前状态 | `job.status = "running"`, `job.current_step = "step_1"` |
| **Log View** | 系统日志当前记录了什么 | `[order-service] step 1 started entity_id=abc123` |

## Why Four Dimensions?
单一视角不足以支撑调试和运维：
- **只有 Customer View**：运维无法知道后台发生了什么
- **只有 Database View**：客户不知道自己看到了什么
- **只有 Log View**：没有结构化数据支撑告警和审计
- **只有 Operator View**：缺乏原始数据记录

四个维度必须同步更新、互相印证，构成完整的可观测性闭环。

## Source
- [[specialized-workflow-architect]]（Workflow Architect Agent）