Administration Hub

Administration Hub

Component File: src/features/admin/components/AdministrationHub.tsx Route / navigation: Base path `/administration` (PageView administration). Tool selection: Zustand `administrationTool` (AdministrationTool), mirrored to `/administration/{administrationTool}` (and `/administration/{administrationTool}/{recordId}` for deep links). Last Updated: March 20, 2026 Status: Current

Overview

The Administration Hub is the landing page for admin-facing configuration and operations tools.

Current runtime source of truth:

• src/features/admin/components/AdministrationHub.tsx
• src/components/PageRouter.tsx
• src/store/types.ts → AdministrationTool

Current Tool Cards

• groups-teams - people / team management entry point used by Administration
• donor-payment-management - donor billing and refund workflows
• fund-management - fund structure and visibility controls
• chart-of-accounts - account and bank-account administration
• waiver-management - admin waiver upload and compliance control center
• purpose-manager - organization purpose / tagging configuration
• payment-integrations - Stripe and billing setup
• global-alerts - popup announcements for users
• fiscal-year-close - year-end close, preview, post, and reversal workflow
• data-import - QuickBooks Online OAuth + import; Aplos placeholder. See 08-DATA-IMPORT.md

Access Model

Tool visibility is filtered by the same permission and tier rules used elsewhere in the app.

In practice:

• some tools are parent-org or admin-only
• some tools are visible but paywalled by tier
• data-import is a routed Administration tool; gated to plus tier and above (TOOL_MINIMUM_TIER)
• groups-teams follows the same invite policy as invite-user: any parent_org membership, or fund_user director with read_write

Current Routing Notes

• settings is no longer an Administration tool route in the current router
• groups-teams resolves through the Administration page, not the People hub
• global-alerts is a live Administration tool and should be documented as such

Mobile / desktop gating

Several administration tools use DesktopOnlyWarning (see §36 Desktop Gating in documentation/frontend/DEVELOPER-PLAYBOOK.md). The warning card is only md:hidden; all main UI for that screen must sit in a sibling <div className="hidden md:block …">. Otherwise iPhone/narrow layouts show both the “Desktop Required” message and the tool (Mar 20, 2026 feedback).

Intentionally not gated: Global Alerts — admins may create and manage announcements from a phone.

Related Docs

• documentation/pages/administration/02-SETTINGS.md
• documentation/pages/administration/05-DONOR-PAYMENT-MANAGEMENT.md
• documentation/pages/administration/06-GLOBAL-ALERTS.md
• documentation/pages/administration/07-FISCAL-YEAR-CLOSE.md
• documentation/pages/components/02-APP-SIDEBAR.md

Synced from IFMmvp-Frontend documentation: pages/administration/00-ADMINISTRATION-HUB.md