用明确契约接入学习事件

连接器将平台事件映射成版本化 GDP 事件。租户、身份、幂等、签名、来源血缘、权限和删除都属于接口契约。

接入协议

标准事件入口，统一治理边界

xAPI、Caliper、Webhook 和 OAuth 用于适配来源系统；AlphaEDU 对外保持稳定的连接器与事件契约。 LTI 1.3、OneRoster、W3C VC、Open Badges、CLR、联盟链适配器与 AEDU 贡献事件属于公开标准与治理契约。

当前协议 01

学习活动词汇

映射为版本化 GDP 事件

xAPI

注册连接器

事件模型

最小事件信封

原始内容保留在受控来源边界。进入成长链路的是经过范围控制、身份映射和版本标记的学习事件。

eventId稳定的幂等键

tenantRef不透明的机构或平台边界

userRef已映射的学习者身份，不包含浏览器访问令牌

occurredAt带时区的来源事件时间

activity类型化学习动作

evidenceRefs由来源系统持有的证据引用

mappingVersion版本化 GDP 映射契约

事件示例

{
  "eventId": "evt_01J...",
  "tenantRef": "tenant_opaque",
  "userRef": "learner_opaque",
  "occurredAt": "2026-07-26T09:30:00Z",
  "activity": "learning.activity.completed",
  "evidenceRefs": ["source:activity/4821"],
  "mappingVersion": "gdp-event/1"
}

运行要求

失败必须可恢复，重复必须无副作用

连接器健康、限流、错误码和删除结果进入管理后台；事件以幂等键去重，并通过租户与身份映射隔离。AI 草稿与人类确认发生在接入之后，授权决定其用途。