模組 01 · 契約測試版

Activity

Activity 把產品事件轉成有序、可重建的時間軸，並提供可安全重試的 fan-out。

先走完一條完整路徑

最短的 Activity 接入路徑分成三步：

1. 理解資源與權責模型。
2. 由 host server 簽署 HTTP 請求。
3. 發佈貼文並讀取 actor 的首頁時間軸。

Activity 提供版本化的 /api/v1 HTTP 契約。請求使用 HMAC-SHA256 gateway 簽章，不使用終端使用者的 session token。公開操作介面列在 Activity HTTP 操作索引。

接下來的任務

• 理解分頁、排序、fan-out 與重建行為。
• 套用可見性，同時讓 business authorization 留在 host。
• 查閱完整的 REST 操作索引。
• 檢視測試版限制與已知缺口。

各介面的成熟度

介面	目前狀態
核心資源模型	契約測試版
HMAC gateway 身分驗證	契約測試版
/api/v1 HTTP 操作	契約測試版
受支援的 SDK	尚未提供
代管服務與生產環境 SLO	尚未提供

模組負責

• Event projection 與 timeline ordering
• Retry-safe fan-out
• 可重建的 timeline entry

Host 負責

• Business meaning 與 authorization
• Source-of-truth event
• 未明確委派給 Activity 的 ranking policy

目前限制

Webhook 傳遞、完整的內容管理狀態轉換、附件安全、受支援的 SDK、代管服務，以及下游正式採用都尚未建立。請勿把這些能力列入正式產品承諾。

開始：理解 Activity 核心概念。