3b6fca44a6
后端：
1.阶段 6 CP4/CP5 目录收口与共享边界纯化
- 将 backend 根目录收口为 services、client、gateway、cmd、shared 五个一级目录
- 收拢 bootstrap、inits、infra/kafka、infra/outbox、conv、respond、pkg、middleware，移除根目录旧实现与空目录
- 将 utils 下沉到 services/userauth/internal/auth，将 logic 下沉到 services/schedule/core/planning
- 将迁移期 runtime 桥接实现统一收拢到 services/runtime/{conv,dao,eventsvc,model}，删除 shared/legacy 与未再被 import 的旧 service 实现
- 将 gateway/shared/respond 收口为 HTTP/Gin 错误写回适配，shared/respond 仅保留共享错误语义与状态映射
- 将 HTTP IdempotencyMiddleware 与 RateLimitMiddleware 收口到 gateway/middleware
- 将 GormCachePlugin 下沉到 shared/infra/gormcache，将共享 RateLimiter 下沉到 shared/infra/ratelimit，将 agent token budget 下沉到 services/agent/shared
- 删除 InitEino 兼容壳，收缩 cmd/internal/coreinit 仅保留旧组合壳残留域初始化语义
- 更新微服务迁移计划与桌面 checklist，补齐 CP4/CP5 当前切流点、目录终态与验证结果
- 完成 go test ./...、git diff --check 与最终真实 smoke；health、register/login、task/create+get、schedule/today、task-class/list、memory/items、agent chat/meta/timeline/context-stats 全部 200，SSE 合并结果为 CP5_OK 且 [DONE] 只有 1 个
29 lines
1.2 KiB
Go
29 lines
1.2 KiB
Go
package kafka
|
||
|
||
import "encoding/json"
|
||
|
||
// Envelope 是 outbox 投递到 Kafka 的统一协议包。
|
||
//
|
||
// 协议边界：
|
||
// 1. 这是总线协议，不包含具体业务字段；
|
||
// 2. 路由只依赖 event_type，不再保留 biz_type 兼容字段；
|
||
// 3. payload 为原始业务 JSON，由业务 handler 决定如何反序列化。
|
||
type Envelope struct {
|
||
// OutboxID 是 outbox 状态机主键，用于消费者回写 consumed/retry/dead。
|
||
OutboxID int64 `json:"outbox_id"`
|
||
// EventID 是事件唯一标识（当前默认回退为 outbox_id 字符串）。
|
||
EventID string `json:"event_id,omitempty"`
|
||
|
||
// EventType 是唯一路由键（例如 chat.history.persist.requested）。
|
||
EventType string `json:"event_type"`
|
||
// EventVersion 是事件版本号（默认 v1）。
|
||
EventVersion string `json:"event_version,omitempty"`
|
||
// ServiceName 是事件归属服务；空值通常表示旧兼容消息或全量模式。
|
||
ServiceName string `json:"service_name,omitempty"`
|
||
// AggregateID 是聚合主键（例如 conversation_id），用于追踪同一业务对象事件流。
|
||
AggregateID string `json:"aggregate_id,omitempty"`
|
||
|
||
// Payload 是业务载荷 JSON。
|
||
Payload json.RawMessage `json:"payload"`
|
||
}
|