Skip to main content

acosmi/shared/
operation.rs

1//! 跨域统一操作(operation projection)原语。端口自 `shared/operation.ts`。
2//!
3//! 相位说明:TS `operation.ts` 把 `ProviderRequestStatus` 定义为
4//! `compliance/provider/types.ts` 的 `ComplianceProviderRequestStatus` 的别名。
5//! 为避免 Rust 中 shared → compliance 的前向依赖(循环),**本 crate 把
6//! `ProviderRequestStatus` 的定义点放在 shared**,由 P6 `compliance::provider`
7//! 反向 `pub use ... as ComplianceProviderRequestStatus`(定义点与 TS 相反,名字保留两个)。
8
9use crate::macros::open_string_union;
10
11/// 统一操作关联键。贯通控制台 / API / MCP / CrabCode / scheduler 各来源。
12pub type OperationId = String;
13
14/// 幂等键。作用域 = tenant + principal/client + action + product。
15pub type IdempotencyKey = String;
16
17/// 幂等键 HTTP header 名 —— 全 SDK 写接口的单一真相源。
18pub const IDEMPOTENCY_KEY_HEADER: &str = "Idempotency-Key";
19
20open_string_union! {
21    /// 操作来源。开放联合 —— 平台侧 5 种固定值 + 合规域自定义来源。
22    OperationSource {
23        CONSOLE => "console",
24        API => "api",
25        SCHEDULER => "scheduler",
26        CRABCODE => "crabcode",
27        MCP => "mcp",
28    }
29}
30
31open_string_union! {
32    /// 操作状态机。开放联合,后端保留新增空间。
33    OperationStatus {
34        PENDING => "pending",
35        RUNNING => "running",
36        RETRYING => "retrying",
37        AWAITING_CALLBACK => "awaiting_callback",
38        AWAITING_VERIFY => "awaiting_verify",
39        SUCCEEDED => "succeeded",
40        FAILED => "failed",
41        CANCELED => "canceled",
42        UNKNOWN => "unknown",
43    }
44}
45
46open_string_union! {
47    /// 本地 verify 状态(与 provider 状态正交)。
48    VerifyStatus {
49        PENDING => "pending",
50        VERIFIED => "verified",
51        FAILED => "failed",
52        SKIPPED => "skipped",
53        UNKNOWN => "unknown",
54    }
55}
56
57open_string_union! {
58    /// Provider request 状态。定义点在 shared(见模块说明);
59    /// P6 compliance/provider 以 `ComplianceProviderRequestStatus` 复用同一类型。
60    ProviderRequestStatus {
61        PENDING => "PENDING",
62        SUCCESS => "SUCCESS",
63        FAILED => "FAILED",
64        UNKNOWN => "UNKNOWN",
65        RETRYING => "RETRYING",
66    }
67}