Kris
b88c0ae29e
新增完整的 channels 限界上下文模块，包含契约层、领域核心层、应用服务、管道编排、插件体系、基础设施组合根等全层级代码，新增飞书与微信 iLink 渠道插件基础结构，补充各类 DTO、端口协议与领域服务实现。
69 lines
1.8 KiB
Python
69 lines
1.8 KiB
Python
"""分阶段 ACK DTO。
|
||
|
||
定义分阶段 ACK（FR-24）的枚举与不可变值对象，包括 ACK 策略、ACK 阶段
|
||
与 ACK 决策。所有枚举继承 ``str, Enum`` 以支持 JSON 序列化，DTO 均为
|
||
``dataclass(frozen=True)``，仅依赖标准库，用于入站消息的分阶段 ACK
|
||
决策与幂等控制。
|
||
"""
|
||
|
||
from __future__ import annotations
|
||
|
||
from dataclasses import dataclass
|
||
from enum import StrEnum
|
||
|
||
|
||
class AckPolicy(StrEnum):
|
||
"""ACK 策略。
|
||
|
||
标识入站消息的 ACK 时机，用于控制 ACK 与消息处理流程的耦合关系。
|
||
继承 ``str, Enum`` 以支持 JSON 序列化与字符串比较。
|
||
|
||
取值：
|
||
AFTER_RECORD: 消息记录后 ACK。
|
||
AFTER_AGENT_DISPATCH: Agent 分发后 ACK。
|
||
AFTER_PERSIST: 持久化投递后 ACK。
|
||
MANUAL: 手动 ACK。
|
||
"""
|
||
|
||
AFTER_RECORD = "after_record"
|
||
AFTER_AGENT_DISPATCH = "after_agent_dispatch"
|
||
AFTER_PERSIST = "after_persist"
|
||
MANUAL = "manual"
|
||
|
||
|
||
class AckStage(StrEnum):
|
||
"""ACK 阶段。
|
||
|
||
标识 ACK 决策所属的处理阶段，用于分阶段 ACK 的状态机推进。继承
|
||
``str, Enum`` 以支持 JSON 序列化与字符串比较。
|
||
|
||
取值：
|
||
RECORD: 记录阶段。
|
||
DISPATCH: 分发阶段。
|
||
PERSIST: 持久化阶段。
|
||
MANUAL: 手动阶段。
|
||
"""
|
||
|
||
RECORD = "record"
|
||
DISPATCH = "dispatch"
|
||
PERSIST = "persist"
|
||
MANUAL = "manual"
|
||
|
||
|
||
@dataclass(frozen=True)
|
||
class AckDecision:
|
||
"""ACK 决策。
|
||
|
||
描述一次 ACK 决策的结果，包括决策动作、所属阶段与幂等键，用于
|
||
分阶段 ACK 的决策传递与幂等控制。
|
||
|
||
字段：
|
||
decision: 决策动作（ack | nack | retry）。
|
||
stage: ACK 阶段。
|
||
idempotency_key: 幂等键（可选）。
|
||
"""
|
||
|
||
decision: str
|
||
stage: AckStage
|
||
idempotency_key: str | None = None
|