飞书只读 Snapshot Schema 准备台

为飞书只读通讯录 snapshot 准备三张承载表的 schema candidate；当前不写库、不拉取员工明细、不反写飞书。

为什么停在 snapshot schema gate

token、scope、readonly service 证据已具备，但 DB 缺少 feishu_readonly_snapshot_runs、feishu_user_snapshots、feishu_department_snapshots 三张表，所以不能进入 snapshot refresh dry-run。

schema prep only不执行 migration不写库不拉取飞书员工明细不反写飞书

三张 snapshot 表分别做什么

feishu_readonly_snapshot_runs记录只读 refresh 批次、counts-only readiness、token metadata 与 audit/rollback
feishu_department_snapshots承载飞书部门只读镜像，后续进入部门 staging 与 departments
feishu_user_snapshots承载飞书用户只读镜像，后续进入 employees、permission_subjects、feishu_user_mappings

数据分层边界

snapshot 是只读原始镜像 / metadata / counts / sanitized payload carrier；staging 是映射审核层；master data 是 HRMS 正式主数据层；permission_subject 是权限主体层。

查看 schema contract

本步不是导入员工

这一步只是 schema 准备，不拉取飞书员工明细，不写库，不刷新 snapshot，不反写飞书。下一步如果批准，才进入 schema apply；schema apply 后才能进入 snapshot refresh dry-run。

候选 SQL 与回滚方案

查看 migration candidate 查看 rollback candidate 查看 apply checklist

Next Gate

当前 next_gate：FEISHU_READONLY_SNAPSHOT_SCHEMA_APPLY_GATE；下一条任务：HRMS_FEISHU_READONLY_SNAPSHOT_SCHEMA_APPLY_PACK_Z3。

查看 next gate