跳到内容
Lenso
简体中文
Esc
导航打开⌘J预览
本页内容

Runtime Story

通过回执绑定的 Story Module Surface 跟踪一条业务流程。

Runtime Story 是一条相关业务流程的 Operator-readable Record。在当前产品模型 中,Story 由精确 lenso/platform-story Module Release 贡献,并由其 console_ui_esm Surface 在 Console 内渲染。

Story 不是顶级 Console Workspace、应用总分,也不是浏览器直连 Host 管理路由 的捷径。

组合所有权

Support Desk 产品验收通过仓库内的 Capability Pack 选择 lenso/platform-story。Runner 构建匹配的 Console Artifact,再把精确 Module Release Digest、UI Artifact Digest、Contract Digest 与 Surface Grant 放入已连接 的 lenso.system.v2 拓扑。

只有这些身份与已连接应用回执一致时,Console 才会加载 Story Surface。UI Build、Module Release 或 Business API Contract 发生变化后,需要重新生成匹配的 组合与连接。

浏览器边界

Story Surface 使用注入的 Typed Host API,并通过同源 Surface Gateway 调用生成 客户端:

Story console_ui_esm Surface
  -> generated client
  -> Console Surface Gateway
  -> declared Story Business API

每个请求中,Console Service 都会重新校验:

  • 已认证 Console Actor;
  • 精确已连接 System;
  • Module 与 Module Release Identity;
  • UI Artifact 与 Contract Digest;
  • Surface Grant 允许的 Operation ID;
  • 目标 Module 授权。

Service Bearer Token 留在服务端。浏览器不会获得 Service Credential,也不会 获得任意访问记录的通用 Endpoint。

Story 显示什么

Story 按稳定 Correlation 与 Causation Identity 对记录分组。Surface 可以展示:

  • 业务标题与直接状态;
  • Policy 允许的发起 Actor 与 Tenant Context;
  • 相关 Module、Service、Event、Function 与 Workflow Node;
  • 因果 Edge 与按时间排序的 Activity;
  • 直接 Failure 细节,而不创建第二套应用总分。

技术日志与 Trace 仍由其运行时持有。Story 连接业务流程,但不会取代这些工具, 也不会重新定义 Service 所有权。

创作建议

Module Author 应当:

  • 保持 Business Operation ID 与 Capability Name 稳定;
  • 为面向用户的 Operation 提供清晰 Display Name;
  • 传播 Actor、Tenant、Correlation、Causation、Deadline 与 Trace Context;
  • 使用声明的 Event、Function 或 Workflow 承载后续工作;
  • 不在 Story Record 中写入 Secret、Token 或敏感 Payload。

Provider Tier 仍由 Host 持有,可使用 Rust 或 TypeScript。Autonomous Service 持有其 Rust Runtime 与 Store,并通过 Direct HTTP/gRPC、Event Contract 或 Durable Workflow 传播同样受限的 Context。参见 Service Capability Tiers

连接状态与运行状态

Story Module 与 Surface 的 Connection Projection 可以是 connectedunavailableincompatibleunmanaged,并带有直接原因。Workload Operational State 是独立维度。

Console 或 Story Surface 不可用时,只影响该视图;已建立的业务执行仍在所属 Host 或 Autonomous Service 中继续。Console 不会成为 Data Plane 依赖。

产品级验收

lenso-examples 运行产品级黑盒路径:

pnpm acceptance:support-desk

真实浏览器无需手工启用即可加载 Support Ticket 与 Story Surface,通过 Surface Gateway 执行 Ticket Operation,并校验精确 Receipt、Actor、Tenant、Contract 与 Operation Identity 在整个流程中保持绑定。

System 连接与 Surface 加载参见 Lenso Console;Artifact 创作参见 Module Console UI

最后更新于 2026年8月13日

这个页面有帮助吗?