feat: expose workflow state events and persist signal transitions

2026-09-18 09:27:45 +08:00
parent 082898e705
commit a4d9900e2c
34 changed files with 1499 additions and 27 deletions
--- a/weave/instance/events.go
+++ b/weave/instance/events.go
@@ -0,0 +1,54 @@
+package instance
+
+import (
+	"context"
+	"encoding/json"
+	"time"
+
+	"git.yuntuo.hk/k2safe/orbit/internal/fault"
+	core "git.yuntuo.hk/k2safe/orbit/model"
+	"git.yuntuo.hk/k2safe/orbit/platform/auth"
+	"git.yuntuo.hk/k2safe/orbit/pulse/service"
+)
+
+// EventSummary 只表示已保存的事件，不把当前状态或当前激活反填到历史。
+type EventSummary struct {
+	ID                core.ID   `json:"id"`                        // ID 原不可变状态事件标识。
+	WorkflowID        core.ID   `json:"workflow_id"`               // WorkflowID 已核验授权的流程归属。
+	AggregateKind     string    `json:"aggregate_kind"`            // AggregateKind workflow、workflow_step或workflow_signal。
+	AggregateID       core.ID   `json:"aggregate_id"`              // AggregateID 产生事件的实例、步骤或信号身份。
+	AggregateRevision uint64    `json:"aggregate_revision,string"` // AggregateRevision 来源资源版本，各资源独立，不是全局序号。
+	Type              string    `json:"type"`                      // Type 原始事件类型，不按当前状态改写。
+	StateScope        string    `json:"state_scope"`               // StateScope WORKFLOW、STEP或SIGNAL，说明State记录的是哪类对象。
+	State             string    `json:"state"`                     // State 该事件保存的状态，不代表对象当前状态。
+	StepKey           string    `json:"step_key,omitempty"`        // StepKey 步骤事件的固定定义名称；其他事件省略。
+	OccurredAt        time.Time `json:"occurred_at"`               // OccurredAt 数据库事件记录时间，UTC微秒精度，不是外部业务发生时间或提交水位。
+}
+type EventPage struct {
+	WorkflowID core.ID        `json:"workflow_id"`           // WorkflowID 本页授权的实例身份。
+	Revision   uint64         `json:"revision,string"`       // Revision 本页读取时实例版本，不能作为信号或步骤事件的消费水位。
+	Items      []EventSummary `json:"items"`                 // Items 按记录时间和ID倒序的有界摘要，空列表为[]。
+	NextCursor string         `json:"next_cursor,omitempty"` // NextCursor 绑定实例与事件查询种类，不承诺跨页快照。
+}
+type EventDetail struct {
+	EventSummary
+	Payload json.RawMessage `json:"payload"` // Payload 原不可变事件元数据，最多64KiB；嵌套数字保留原文本，输入/结果另走资源详情。
+}
+
+// ListEvents 要求workflows:audit:read，并核对固定版本全部队列；不能按全局事件ID跨资源读取。
+func (s *Service) ListEvents(ctx context.Context, t auth.Token, id core.ID, in service.HistoryPageInput) (EventPage, error) {
+	if id.Validate() != nil {
+		return EventPage{}, fault.Invalid("invalid workflow id")
+	}
+	in, err := historyPage(in)
+	if err != nil {
+		return EventPage{}, err
+	}
+	return s.store.ListEvents(ctx, t, id, in)
+}
+func (s *Service) GetEvent(ctx context.Context, t auth.Token, id, event core.ID) (EventDetail, error) {
+	if id.Validate() != nil || event.Validate() != nil {
+		return EventDetail{}, fault.Invalid("invalid workflow event identity")
+	}
+	return s.store.GetEvent(ctx, t, id, event)
+}