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

vercel Bot commented Jul 10, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jul 10, 2026 9:25am

Request Review

…15f0bbe)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions github-actions Bot 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 main Jul 10, 2026
16 checks passed
@os-zhuang
os-zhuang deleted the docs/permissions-standalone-pages branch July 10, 2026 09:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/m tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant