Skip to content

Commit ece8730

Browse files
docs(permissions): isSystem 行为全集权威表 —— 按普查而非回忆构建 (#6782) (#6891)
新增 `content/docs/permissions/system-context.mdx`,作为 `ExecutionContext.isSystem` 的唯一权威页:全仓普查 1179 处 `isSystem`,分类后得到 **80 处真正改变行为的读取点、 横跨 18 个包**,逐行给出 file:line 锚点,并按「作者得到什么 / 失去什么」而非「代码在哪」 描述每一行。 内容分五个车道(授权与作用域 / 写入管线与完整性 / sharing / 审批·报表·附件·评论·知识 / action·元数据面·provenance),另加两节同等重要的内容: - **`isSystem` 不做什么**:不抑制触发器(那是 `skipTriggers`)、不跳过状态机、 不跳过校验规则、不保留 `updated_at`(那是 `preserveAudit`)、不豁免 last-admin 闸门、 不可由客户端设置 —— 每条都带锚点。 - **已知粗糙处**:5 条,明确记录而不抹平(详见 PR 说明)。 同时按裁决(#4707,2026-08-06)把「⛔ 不拆分该 flag」写入表内作为已知决定。 ⛔ 无行为变更;未碰 `docs/adr/**` 与 `content/docs/releases/`。 Claude-Session: https://claude.ai/code/session_01F8q5J1MQyocgtNspb15fSn Co-authored-by: Claude <noreply@anthropic.com>
1 parent 916af17 commit ece8730

5 files changed

Lines changed: 273 additions & 1 deletion

File tree

‎.claude/workflows/docs-accuracy-audit.js‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,7 @@ const ALL_HANDWRITTEN = [
158158
"content/docs/permissions/rls.mdx",
159159
"content/docs/permissions/sharing-rules.mdx",
160160
"content/docs/permissions/sso.mdx",
161+
"content/docs/permissions/system-context.mdx",
161162
"content/docs/plugins/adding-a-metadata-type.mdx",
162163
"content/docs/plugins/anatomy.mdx",
163164
"content/docs/plugins/development.mdx",

‎content/docs/permissions/authorization.mdx‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -233,7 +233,9 @@ one of two doors, each writing only what it owns:
233233
**overlay** — the record projects the effective body while the package keeps
234234
owning the row, and "delete" resets to the shipped declaration. System /
235235
boot writes carry `isSystem` and bypass it, so the seeder and materializer
236-
are never self-blocked.
236+
are never self-blocked. That bypass is not local to this gate — the full set
237+
of behaviours the flag changes is catalogued in
238+
[System Context (`isSystem`)](/docs/permissions/system-context).
237239

238240
## Lifecycle coverage (five stages)
239241

‎content/docs/permissions/meta.json‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,7 @@
66
"authentication",
77
"sso",
88
"authorization",
9+
"system-context",
910
"profiles",
1011
"permission-sets",
1112
"positions",

0 commit comments

Comments
 (0)