frontend phase 0: app shells, design system & data/contract patterns

Turn the starter into the Balinyaar foundation for the three actor
experiences and lock in the patterns later phases copy.

- Cleanup: remove toastDemo namespace, placeholder home page, and the two
  dead icons; fix BottomBar to use usePathname (locale-aware active tab).
- Three actor shells under (private-routes), no layout above [locale]:
  customer (customer) group with the 5-tab bottom nav; nurse (/nurse) and
  admin (/admin) on the shared sidebar engine. Role model via constants/roles
  + useActorRole (defaults to customer until roles land in f1-b2).
- services/{domain} reference (patients) with a mock behind a config seam,
  hierarchical query keys, deliberate staleTime, and mutation invalidation;
  shared ApiEnvelope/Paginated wire types + unwrap() in lib/api/types.
- Money (integer-safe IRR/Toman) + Shamsi-date utils; toEnglishDigits helper.
- Shared composites, each tested: OtpInput, PhoneNumberField, StepperHeader,
  StatusChip, PlaceholderScreen.
- i18n: seed nav/common/shell/patients in both locales; document namespace
  conventions. Update client/CLAUDE.md Project Structure + fix ColorSchemeScript
  doc drift. Add phase report, STATUS, and REQ-001 (envelope/casing/pagination).

Gate: npm run check + test:ci green (72 tests); build green with NEXT_PUBLIC_API_URL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

client/src/app/[locale]/(private-routes)/admin/layout.tsx

@@ -0,0 +1,11 @@
+'use client';
+import type { ReactNode } from 'react';
+import { AdminLayout } from '@/layout';
+
+/*
+ * Admin / backoffice route group (/admin/…) — desktop-oriented ops console (f15)
+ * with a persistent sidebar.
+ */
+export default function AdminRouteLayout({ children }: { children: ReactNode }) {
+  return <AdminLayout>{children}</AdminLayout>;
+}

client/src/app/[locale]/(private-routes)/admin/notifications/page.tsx

@@ -0,0 +1,8 @@
+import { getTranslations } from 'next-intl/server';
+import { PlaceholderScreen } from '@/components';
+
+export default async function AdminNotificationsPage() {
+  const t = await getTranslations('nav');
+  const tShell = await getTranslations('shell');
+  return <PlaceholderScreen icon="notifications" title={t('notifications')} description={tShell('placeholder_body')} />;
+}

client/src/app/[locale]/(private-routes)/admin/page.tsx

@@ -0,0 +1,8 @@
+import { getTranslations } from 'next-intl/server';
+import { PlaceholderScreen } from '@/components';
+
+export default async function AdminOverviewPage() {
+  const t = await getTranslations('nav');
+  const tShell = await getTranslations('shell');
+  return <PlaceholderScreen icon="admin" title={t('overview')} description={tShell('placeholder_body')} />;
+}

client/src/app/[locale]/(private-routes)/admin/users/page.tsx

@@ -0,0 +1,8 @@
+import { getTranslations } from 'next-intl/server';
+import { PlaceholderScreen } from '@/components';
+
+export default async function AdminUsersPage() {
+  const t = await getTranslations('nav');
+  const tShell = await getTranslations('shell');
+  return <PlaceholderScreen icon="users" title={t('users')} description={tShell('placeholder_body')} />;
+}