Skip to content

docs(permissions),feat(setup-nav): standalone explain/matrix/delegated-admin pages, last "Roles" label → Positions, objectui pin bump - #2759

Merged
os-zhuang merged 2 commits into
mainfrom
docs/permissions-standalone-pages
Jul 10, 2026
Merged

docs(permissions),feat(setup-nav): standalone explain/matrix/delegated-admin pages, last "Roles" label → Positions, objectui pin bump#2759
os-zhuang merged 2 commits into
mainfrom
docs/permissions-standalone-pages

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Follow-ups to the ADR-0090 zoo/fix series (#2739, #2745), rounding out the remaining suggestions.

Standalone permission docs

The three P3/P4 capabilities previously folded into authorization.mdx get dedicated, runbook-grade pages (structural — the summaries stay in place and now link out):

  • permissions/explain.mdx — decision anatomy (layers, verdicts, contributor attribution with a real showcase example), service + GET/POST /api/v1/security/explain usage, the D12 caller-authorization rule, and what the engine powers.
  • permissions/access-matrix.mdx — opt-in via committed access-matrix.json, the REAL drift-failure output (captured live: "'showcase_member_default' gains access to 'showcase_private_note' (create, read, edit)"), snapshot format, and how the gate composes with the D7 linter and explain.
  • permissions/delegated-administration.mdxadminScope field reference, the nine runtime gate rules in one table (each proven end-to-end by showcase-permission-zoo.dogfood.test.ts), the assignment BU anchor, and the explain tie-in.

meta.json gains the three pages; apps/docs production build green.

The last "Roles" in platform UI copy (ADR-0090 D3)

plugin-security's Setup nav contribution renamed nav_roles/"Roles" → nav_positions/"Positions", with the four platform-objects translation bundles following (岗位 / ポジション / Posiciones). This was the label the Setup sidebar still showed next to the (already-renamed) 岗位 object page.

objectui pin bump → 397dcad73eaf

Picks up two ADR-0090 UI deliverables that landed in objectui: the Studio Access-pillar "why can this user access?" explain panel (D6, objectui#2375) and the suggested audience-binding install prompt (D5/D9, objectui#2376). Portal metadata has no profiles consumer in objectui (verified) — nothing to migrate there.

Verification

  • Full suite 126/126 turbo tasks green; platform-objects + plugin-security suites pass with the nav rename.
  • Vendored console rebuilt at the new pin (build-console.sh, bundle canary ✓) and browser-verified on a fresh --ui --seed-admin boot:
    • Setup sidebar 访问控制 shows 岗位 (was 角色); the positions grid lists all 13 (7 showcase incl. client_portal_user + built-ins + everyone/guest).
    • Studio → 权限 renders the 权限矩阵 with all 8 zoo sets and per-object OWD + Ext (externalSharingModel) badges.
    • The 解释访问权限 panel round-trips the new REST endpoint: allowed banner, principal card (positions/permission sets), per-layer verdicts with contributor attribution.

Related: #2696 (explain tracking), ADR-0090 D3/D5/D6/D9/D12.

🤖 Generated with Claude Code

…d-admin pages + the last "Roles" label + objectui pin bump
Docs: the three ADR-0090 P3/P4 capabilities folded into authorization.mdx
get standalone, runbook-grade pages — explain.mdx (service + REST contract,
layer vocabulary, D12 caller authorization), access-matrix.mdx (opt-in,
real drift-failure output, snapshot format, review workflow), and
delegated-administration.mdx (adminScope reference, the nine runtime gate
rules — each proven by the showcase permission-zoo dogfood — and the
assignment BU anchor). meta.json ordering + cross-links from the
summaries that remain in place.
Setup nav: the sys_position entry sheds the last "role" in platform UI
copy (ADR-0090 D3) — nav_roles/"Roles" → nav_positions/"Positions"
(岗位/ポジション/Posiciones across the four translation bundles).
.objectui-sha → 397dcad73eaf: picks up the Studio Access-pillar explain
panel ("why can this user access?", ADR-0090 D6, objectui#2375) and the
suggested audience-binding install prompt (D5/D9, objectui#2376).
Browser-verified against the rebuilt vendored console on a fresh boot:
Setup sidebar shows 岗位; the Access pillar's 权限矩阵 renders all 8 zoo
sets with per-object OWD + Ext dials; the 解释访问权限 panel returns the
full layered decision (allowed banner, principal card, per-layer verdicts
with contributor attribution) through the new REST endpoint.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercelBot commented Jul 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJul 10, 2026 9:25am

Request Review

…15f0bbe)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation tooling size/m labels Jul 10, 2026
@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

This PR changes 2 package(s): @objectstack/platform-objects, @objectstack/plugin-security.

12 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

  • content/docs/getting-started/cli.mdx(via @objectstack/plugin-security)
  • content/docs/permissions/access-recipes.mdx(via packages/plugins/plugin-security)
  • content/docs/permissions/authorization.mdx(via packages/plugins/plugin-security)
  • content/docs/permissions/explain.mdx(via @objectstack/plugin-security)
  • content/docs/permissions/permissions-matrix.mdx(via packages/plugins/plugin-security)
  • content/docs/permissions/sharing-rules.mdx(via @objectstack/plugin-security)
  • content/docs/plugins/index.mdx(via @objectstack/plugin-security)
  • content/docs/plugins/packages.mdx(via @objectstack/platform-objects, @objectstack/plugin-security)
  • content/docs/releases/implementation-status.mdx(via @objectstack/plugin-security)
  • content/docs/ui/dashboards.mdx(via @objectstack/plugin-security)
  • content/docs/ui/role-based-interfaces.mdx(via packages/plugins/plugin-security)
  • content/docs/ui/setup-app.mdx(via @objectstack/platform-objects)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.

@os-zhuang
os-zhuang merged commit d0531c4 into mainJul 10, 2026
16 checks passed
@os-zhuang
os-zhuang deleted the docs/permissions-standalone-pages branch July 10, 2026 09:30
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/mtooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang