04 — Information Architecture (Organizations Module)

• 1. Navigation placement
• 2. Screen hierarchy (self surface)
• 3. Screen hierarchy (platform surface)
• 4. Modal hierarchy (per 00-shared/05 §5)
• 5. Screen relationships
• 6. Routes & deep links
• 7. Nested nav & state survival
• 8. Quick actions, FABs, context menus
• 9. Global search integration

Module IA within the global shell (00-shared/05). The module owns two surfaces: the tenant self surface (Org Admin, /organization) and the platform surface (Super Admin, /admin/tenants). Routes are (planned) — the client repo does not exist; they follow go_router conventions from 00-shared/11 §6.

1. Navigation placement

• Both surfaces hidden and unroutable for everyone else (00-shared/05 §1).
• Tenants surface lives under a separate "Platform" group so tenant admins never see it.

2. Screen hierarchy (self surface)

/organization ──────────────── Org Overview (tab shell)
 ├── /organization/edit ────── Org Edit (full-screen form, >3 fields → page not sheet)
 ├── /organization/branding ── Branding (page w/ live preview)
 ├── /organization/settings ── Settings tabs (TabBar: General | Attendance | Academic | Grading | Notification | Theme)
 │                              └─ each tab = inline form (≤3-5 fields) — save per tab or one global save (see §5)
 ├── /organization/feature-flags ── Feature flags list (switch rows grouped by module)
 └── /organization/members ──── Invite admin (form + members list) — cross-module (users + rbac)
      └─ /organization/delete ──── (dialog, not route)

3. Screen hierarchy (platform surface)

/admin/tenants ─────────────── Tenants list (master)
 ├── /admin/tenants/:id ────── Tenant detail (master-detail right pane on ≥840 dp; push on phone)
 │    ├── edit → /admin/tenants/:id/edit (reuses Org Edit screen, id from route)
 │    ├── settings / branding / feature-flags (reuse self screens with :id)
 │    └── delete (typed-confirm dialog)
 └── /admin/tenants/new ────── Tenant create (wizard-lite: single full-screen form)

4. Modal hierarchy (per 00-shared/05 §5)

Destructive rules (00-shared/05 §5): organization.delete needs typed confirm (type the org name); suspend needs a plain confirm dialog with consequence copy.

5. Screen relationships

• Overview → Edit → back to Overview (refresh). Overview → Branding → back (refresh).
• Overview → Settings tabs: each tab fetches the same org doc (GET :id/settings); one global "Save all" submits the merged full settings object (full-replace — organizations.service.ts:134).
• Overview → Feature flags: fetches GET :id/feature-flags (map) merged with standalone GET /feature-flags (catalog: labels/descriptions/module).
• Master-detail on tablet/desktop for /admin/tenants (00-shared/05 §3); push-on-top on phone; breadcrumbs on desktop at depth ≥2 (00-shared/05 §3).

6. Routes & deep links

Deep links:

• studylyon://organization/settings — admin push to a setting ((forward-looking) push; route itself real).
• studylyon://admin/tenants/:id — support link to a tenant ((forward-looking)).

7. Nested nav & state survival

• Settings tabs use StatefulShellBranch/TabBarView keep-alive (00-shared/03 AppTabs) so switching tabs preserves unsaved edits; switching bottom-nav destinations preserves tab state (00-shared/05 §3).
• Feature-flags grouping by module field (feature-flag.schema.ts:21-22) with collapsible sections (AnimatedSize, 00-shared/08 §4).

8. Quick actions, FABs, context menus

• No FAB on self-surface overview (editing is toolbar-driven); the single FAB in this module is the optional "Invite admin" on members (AppFAB with heroTag unique per screen, 00-shared/03 §D).

9. Global search integration

• Tenants list: q filters name/slug regex case-insensitive (organizations.service.ts:78-83), debounced 300 ms (AppSearchBar).
• Platform admins can reach a tenant via global search only if the search backend indexes organizations (planned).