Skip to content

feat: establish platform administration foundation - #55

Merged
darwin67 merged 7 commits into
mainfrom
feat/rfd-1-administration-foundation
Aug 22, 2026
Merged

feat: establish platform administration foundation#55
darwin67 merged 7 commits into
mainfrom
feat/rfd-1-administration-foundation

Conversation

@darwin67

@darwin67 darwin67 commented Aug 22, 2026

Copy link
Copy Markdown
Member

Summary

  • resolve and publish RFD 1's platform administration security and lifecycle decisions
  • add constrained platform roles, account suspension state, and append-only platform audit events
  • add fresh context, Plug, and LiveView authorization for platform administrators
  • add audited grant, revoke, transfer, suspension, restoration, and platform-admin account deletion flows
  • serialize authority changes so concurrent operations cannot remove the final active administrator
  • serialize session, API, and magic-link token issuance with suspension
  • preserve constant-time password verification for missing and suspended accounts
  • add an idempotent release bootstrap command for initial access and emergency recovery

Scope

This PR intentionally provides the backend and authorization baseline only. It does not add admin routes, navigation, templates, or panel controls. Paginated admin queries and the initial panel will follow in smaller reviewable commits after this foundation lands.

Admin LiveViews will be placed in the existing authenticated :require_authenticated_user pipeline and live session because all panel routes require login. The platform-admin hook adds the separate installation-wide authorization boundary.

Review follow-ups

An Oracle review identified and this branch now covers:

  • token issuance racing suspension and surviving restoration
  • password-authentication timing differences for missing or suspended users
  • missing suspension/account-deletion concurrency coverage
  • missing tests using real organization owner and admin memberships

The token race regression failed against the original implementation before the locking fix.

Validation

  • mix precommit — 477 tests passed
  • deterministic session/API/magic-link issuance-versus-suspension regression
  • concurrent revocation, suspension, and account-deletion coverage
  • migration rollback and forward application
  • make check-rfds
  • shellcheck rel/overlays/bin/grant-platform-admin
  • sh -n rel/overlays/bin/grant-platform-admin

@github-actions github-actions Bot added the feat label Aug 22, 2026
@darwin67
darwin67 merged commit 806c2e7 into main Aug 22, 2026
17 checks passed
@darwin67
darwin67 deleted the feat/rfd-1-administration-foundation branch August 22, 2026 18:23
@chaba2-bot chaba2-bot Bot mentioned this pull request Aug 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant