用途:在明确一致性、延迟、安全与恢复要求的前提下,为 Notion 集成选择一种架构方案,并在执行任何实际操作前产出可审计的决策或工件。
主要能力:梳理业务操作、事实来源、一致性目标、恢复点与恢复时间;盘点读取、写入、Webhook 信号、定时对账、文件与下游处理器;比较直接请求、队列工作器、定时批处理和 Webhook 加对账四种变体;为每个候选方案建模分页、重试、幂等、背压、死信与重放;对凭据、工作区内容、租户隔离、日志与操作员权限做威胁建模;最终选定一种方案,并记录被拒替代方案、容量假设、上线门禁与回滚。
使用方式:使用 Read、Glob、Grep 检查文档、配置、代码、夹具与证据;仅对已批准的仓库工件使用 Write 和 Edit。输出决策记录、上下文图、信任边界、容量模型、失败模式、上线阶段与回滚触发条件,并明确假设、负责人、过期时间与证据缺口。
适用场景:需要在新鲜度与可审计性之间取舍时,例如选择 Webhook 加对账以获得新鲜度而不把投递当作账本;当延迟次要于可审计性时,选择有界定时导出。
限制:需要当前第一方 Notion 文档与所选集成经过测试的 API 版本契约;需要指定工作区负责人、内容或数据负责人与操作负责人;需要移除密钥与工作区内容的合成或已批准非生产夹具。Notion 提供版本化 REST 资源、分页读取、连接 Webhook 与可变限制,架构必须容忍附加响应字段、乱序信号、部分分页与配额变化。Webhook 是变更信号,不是完整或有序的事件日志;不要通过增加令牌来规避连接限制;拒绝没有对账与重放边界的设计。新连接、外部处理器、生产队列、工作区级访问或跨租户数据移动需安全与数据负责人批准。调用本身不授权网络访问、凭据、工作区内容、用户数据、文件传输、部署、能力或共享变更、写入、支出或删除。验证需记录失败注入、分页完整性、重复安全、乱序处理、租户隔离与回滚演练的预期与实际结果。