docs(permissions): Administrator Guide — 面向客户系统管理员的 onboard 任务手册 - #2929
Merged
Conversation
…nual for tenant admins Adds content/docs/permissions/administrator-guide.mdx: an operations manual for customer system administrators, organized around onboarding a tenant (build the business-unit tree → add users → assign positions → verify with impersonation + explain), with the 90% rule (daily admin = assigning positions; capability ships built-in), quick paths, FAQ, and a where-is-everything cheat sheet. Registers the page in meta.json after index and links it from the module overview. Facts verified against the current runtime surface: sys_user actions (invite/create/import, ban/unban/unlock/set-password/impersonate), the sys_business_unit org-chart tree view, sys_user_position BU anchors and the D12 delegated-admin gate, the Studio permission matrix editor and Access Explain panel. Known rough edges are labeled in place (read-only tree presentation, scattered assignment entry points, self-service reset wiring — cloud#580). Rendering verified in the docs portal (Chromium): headings, tables, sidebar nav entry, and all cross-links/anchors resolve. Closes #2917 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DPYFwzYSsKjU12xSJtbAyB
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
github-actions
Bot
added
documentation
…role-word guard) ADR-0090 D3 reserves the word 'role'; the check:role-word CI guard flagged three new uses. Step 3 is now 'Assign positions' (heading, flow list, and quick-paths anchor updated to match). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DPYFwzYSsKjU12xSJtbAyB
os-zhuang
added
the
skip-changeset
Claude
os-zhuang
marked this pull request as ready for review
July 14, 2026 16:19
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #2917
做了什么
原 draft PR 的草稿在任何远程分支上都找不到（本地 git 环境损坏时丢失），按 issue 大纲在干净环境重建了全文，并逐条对照当前代码核实了事实。
content/docs/permissions/administrator-guide.mdx（英文 MDX，~210 行），以「onboard 一个租户」为主线：sys_user_position分配 + BU 锚点 + 权限集记录页 Assigned Users 直接授权）;meta.json在index后插入administrator-guide；index.mdx模块列表加入链接。事实核对（重建时逐一验证）
packages/platform-objects/src/identity/sys-user.object.ts的actions[]为准（invite_user / create_user / ban / unban / unlock_user / set_user_password / impersonate_user 均存在，临时密码一次性展示）；sys-business-unit.object.ts的org_charttree 视图为准（缩进展开树格，改挂靠走 Edit 选父节点，无拖拽）——如实标注为粗糙点；delegated-administration.mdxfrontmatter 垃圾 description 在当前 main 上已是干净的（见 6e2b8ae 之后的版本），本 PR 未改动该文件。验证
按 issue 要求在 docs 门户浏览器实测（非只读 MDX 推断）：
pnpm docs:dev+ Chromium 渲染/docs/permissions/administrator-guide—— H1/11 个 H2/5 张表格/侧边栏导航项均正常，页内全部站内链接与锚点（#admin-user-management、#access-depth--readscope--writescope-adr-0057-d1等）实测 200/存在，无页面 JS 错误。🤖 Generated with Claude Code
https://claude.ai/code/session_01DPYFwzYSsKjU12xSJtbAyB
Generated by Claude Code