Skip to content

docs(workspace-access-center): full WAC v1 reference (8 pages + 12 screenshots)#73

Draft
MichaelUray wants to merge 2 commits into
hcengineering:mainfrom
MichaelUray:feat/wac-section
Draft

docs(workspace-access-center): full WAC v1 reference (8 pages + 12 screenshots)#73
MichaelUray wants to merge 2 commits into
hcengineering:mainfrom
MichaelUray:feat/wac-section

Conversation

@MichaelUray

Copy link
Copy Markdown

Summary

Adds the user-facing Workspace Access Center (WAC) documentation as a new top-level section under WORKSPACE SETTINGS in the docs sidebar. Mirrors the convention used by the Admin Panel docs (#71) and Mention-grants docs (#72).

Pages added

  1. Overview — what WAC is, who can use it, how to open, 5-tab tour
  2. People — All / By role / Inactive (90d+) / Granted access / Pending invites; bulk-bar; PersonDrawer; last-Owner protection
  3. Resources — Spaces by SpaceType; bulk-bar (preview-gated Add/Remove); SpaceDrawer; View hierarchy modal; v2 placeholders (Chat/Office/Guest links)
  4. My Access — My role / Spaces I'm in / Spaces I own / Granted to me / Granted by me; preview-gated self-service Leave + Decline
  5. Audit — action dropdown filter; From/To date-range; actor substring search; Owner-only CSV export with DSGVO confirmation; 365-day retention
  6. Guest Settings (Owner-only) — per-application guest permissions; allowReadOnlyGuests / allowGuestSignUp toggles
  7. Legacy routes — sidebar consolidation (Workspace Members / Guests / Global Space Admins hidden); deep-links still resolve; "Admin panel" → "Global Admin Panel" rename
  8. Preview featuresWAC_PREVIEW_FEATURES env-var; 6 preview backends currently 501-stubbed; how operators opt-in for dev/test

Screenshots

12 screenshots captured on a sample workspace. All names except "Michael Uray" anonymized via DOM-patch immediately before capture (verified via accessibility snapshot — no real-user names leak through).

Out of scope

  • Real-backend wiring for the 6 preview features (those land in upstream feature PRs).
  • Engineering-internal architecture docs — those live in the platform repo READMEs.

Companion PRs

WAC code itself ships as a stack on hcengineering/platform (forthcoming). This docs PR is intentionally Draft until at least the WAC v1 foundation PR is merged upstream, so the docs land together with the feature.


Author note (DSGVO): All screenshots show synthetic demo data. No real customer or contributor names visible.

Adds an 8-page user-facing Workspace Access Center (WAC) section to the
workspace settings documentation, with 9 anonymized screenshots captured
from a self-hosted v0.7.423 dev instance.

Pages:

- overview.mdx       — what WAC is, who can use it, how to open it,
                       quick tour of the five tabs and audit banner.
- people.mdx         — All / By role / Inactive (90d+) / Granted access /
                       Pending invites sub-tabs, columns, sorting,
                       bulk-actions bar with last-Owner protection, and
                       the per-person drawer with role picker plus
                       effective-permissions drill-down.
- resources.mdx      — All / Private / Public / Archived / Auto-join
                       sub-tabs, search box, bulk actions
                       (Archive / Make private / Transfer ownership),
                       View hierarchy modal, Space drawer, and the v2
                       capability-matrix placeholders (Chat / Office /
                       Guest-Links).
- my-access.mdx      — self-service view: My role, Spaces I'm in,
                       Spaces I own, Granted to me, Granted by me.
                       Honest note that Leave/Decline is preview-gated.
- audit.mdx          — action filter, From/To date range, actor filter,
                       canonical action names, Owner-only CSV export
                       with DSGVO confirmation, and 365-day retention.
- guest-settings.mdx — Owner-only per-application permission editor for
                       Guest and Anonymous guest roles, with per-app
                       Auto-join spaces pickers, allowReadOnlyGuests /
                       allowGuestSignUp toggles, and GuestCommunication
                       allowedCards.
- legacy-routes.mdx  — Settings IA consolidation: legacy sidebar entries
                       (Workspace Members, Guests, Global Space Admins)
                       are hidden; the deep-link URLs (/setting/owners,
                       /setting/guestPermissions, /setting/allSpaces)
                       still work. Admin panel renamed to Global Admin
                       Panel for disambiguation.
- preview-features.mdx — WAC_PREVIEW_FEATURES env var, the six preview
                         features (Leave, Decline, grant management,
                         effective-permissions resolver, bulk-bar preset
                         chips, Presets tab), and how preview status is
                         shown in the UI.

Screenshots are captured live, scrubbed of all real names and workspace
identifiers via DOM patch before capture, and stored under
src/assets/screenshots/huly/wac/.

Sidebar registration in astro.config.mjs adds a collapsed
"Workspace Access Center" section under WORKSPACE SETTINGS.

Build verified locally with `npm run build` — all 8 pages indexed
(86 -> 94 pages total) without warnings.

Signed-off-by: Michael Uray <michaeluray@users.noreply.github.com>
…enshots

Signed-off-by: Michael Uray <michaeluray@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant