feat(admin): scaffold per-section dynamic routes (admin-shell + [section]/page.tsx)

Mirrors the v1.4 settings split for the v1.5 admin refactor. Adds the
shell, the slug constants, the dynamic-route page, and the client-only
renderer that picks the right section component for each slug. The
existing admin sections continue to live in src/components/admin/*.tsx;
this scaffolding wires them into per-route bundles.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Marc-André BombeckandClaude Opus 4.7 committed 2026-05-09 16:59:08 +02:00
1 parent af36da3bd1
commit d8b71b3848
4 files changed
+509

No files matched your search

+50
View File
@@ -0,0 +1,50 @@
import { notFound } from "next/navigation";
import { AdminShell } from "@/components/admin/admin-shell";
import { AdminSectionRenderer } from "./renderer";
import {
ADMIN_SECTION_SLUGS,
isAdminSectionSlug,
} from "@/components/admin/section-slugs";
/**
* Dynamic admin section route — mirrors the v1.4 settings split. Each of
* the `ADMIN_SECTION_SLUGS` is pre-rendered at build via
* `generateStaticParams()` so the URLs are statically known to Next.js,
* while `dynamicParams = false` tells the router to 404 (rather than
* attempting on-demand rendering) for any slug not in the list.
*
* The actual section components are mounted by the client-only
* `<AdminSectionRenderer>` because most of them use TanStack Query and
* the auth hook (server-rendered they'd just paint a loader). The shell,
* however, is server-rendered so the sidebar paints with no JS hydration
* lag.
*/
export const dynamicParams = false;
export function generateStaticParams() {
return ADMIN_SECTION_SLUGS.map((section) => ({ section }));
}
interface PageProps {
// Next.js 16 made route `params` an async Promise. We `await` it before use.
params: Promise<{ section: string }>;
}
export default async function AdminSectionPage({ params }: PageProps) {
const { section } = await params;
// Defence-in-depth — `dynamicParams = false` already 404s unknown slugs at
// routing time, but we re-check here so a hand-rolled override of the
// route config can never silently fall through to a typo'd slug.
if (!isAdminSectionSlug(section)) {
notFound();
}
return (
<AdminShell active={section}>
<AdminSectionRenderer slug={section} />
</AdminShell>
);
}
+175
View File
@@ -0,0 +1,175 @@
"use client";
/**
* Client-only renderer that picks the right admin section component for
* a given slug. Lives next to the route page so the shell can stay a
* server component while the auth-gated body remains a client component.
*
* This is the equivalent of `SECTION_COMPONENTS` in
* `src/app/settings/[section]/page.tsx`, lifted to a separate file so
* the route page can be a server component (Settings can keep
* `"use client"`-leaning components in its page because none of them
* read `useAuth()` to gate rendering).
*/
import type { JSX } from "react";
import { useAuth } from "@/hooks/use-auth";
import { useTranslations } from "@/lib/i18n/context";
import { ApiTokenOverviewSection } from "@/components/admin/api-token-overview-section";
import { BackupsSection } from "@/components/admin/backups-section";
import { DangerZoneSection } from "@/components/admin/danger-zone-section";
import { FeedbackInboxSection } from "@/components/admin/feedback-inbox-section";
import { GeneralSettingsSection } from "@/components/admin/general-settings-section";
import { IntegrationsGroupSection } from "@/components/admin/integrations-group-section";
import { LoginOverviewSection } from "@/components/admin/login-overview-section";
import { RemindersSection } from "@/components/admin/reminders-section";
import { ServicesSection } from "@/components/admin/services-section";
import { SystemStatusSection } from "@/components/admin/system-status-section";
import { UserManagementSection } from "@/components/admin/user-management-section";
import type { AdminSectionSlug } from "@/components/admin/section-slugs";
interface RendererProps {
slug: AdminSectionSlug;
}
export function AdminSectionRenderer({
slug,
}: RendererProps): JSX.Element | null {
const { user } = useAuth();
const { t } = useTranslations();
// The admin shell layout already gates non-admins via `<AuthShell>`,
// but the auth hook is async — return nothing on the first render so
// we don't flash sub-section UI to a non-admin who's about to get
// redirected to `/`.
if (!user || user.role !== "ADMIN") return null;
switch (slug) {
case "system-status":
return (
<SectionFrame
title={t("admin.section.system-status.title")}
subtitle={t("admin.section.system-status.subtitle")}
>
<SystemStatusSection />
</SectionFrame>
);
case "general":
return (
<SectionFrame
title={t("admin.section.general.title")}
subtitle={t("admin.section.general.subtitle")}
>
<GeneralSettingsSection />
</SectionFrame>
);
case "services":
return (
<SectionFrame
title={t("admin.section.services.title")}
subtitle={t("admin.section.services.subtitle")}
>
<ServicesSection />
</SectionFrame>
);
case "integrations":
return (
<SectionFrame
title={t("admin.section.integrations.title")}
subtitle={t("admin.section.integrations.subtitle")}
>
<IntegrationsGroupSection />
</SectionFrame>
);
case "feedback":
return (
<SectionFrame
title={t("admin.section.feedback.title")}
subtitle={t("admin.section.feedback.subtitle")}
>
<FeedbackInboxSection />
</SectionFrame>
);
case "reminders":
return (
<SectionFrame
title={t("admin.section.reminders.title")}
subtitle={t("admin.section.reminders.subtitle")}
>
<RemindersSection />
</SectionFrame>
);
case "users":
return (
<SectionFrame
title={t("admin.section.users.title")}
subtitle={t("admin.section.users.subtitle")}
>
<UserManagementSection currentUserId={user.id} />
</SectionFrame>
);
case "api-tokens":
return (
<SectionFrame
title={t("admin.section.api-tokens.title")}
subtitle={t("admin.section.api-tokens.subtitle")}
>
<ApiTokenOverviewSection />
</SectionFrame>
);
case "login-overview":
return (
<SectionFrame
title={t("admin.section.login-overview.title")}
subtitle={t("admin.section.login-overview.subtitle")}
>
<LoginOverviewSection />
</SectionFrame>
);
case "backups":
return (
<SectionFrame
title={t("admin.section.backups.title")}
subtitle={t("admin.section.backups.subtitle")}
>
<BackupsSection />
</SectionFrame>
);
case "danger-zone":
return (
<SectionFrame
title={t("admin.section.danger-zone.title")}
subtitle={t("admin.section.danger-zone.subtitle")}
>
<DangerZoneSection />
</SectionFrame>
);
default: {
// exhaustiveness guard — TS will flag a missing case here
const _exhaustive: never = slug;
void _exhaustive;
return null;
}
}
}
interface SectionFrameProps {
title: string;
subtitle?: string;
children: React.ReactNode;
}
function SectionFrame({ title, subtitle, children }: SectionFrameProps) {
return (
<div className="space-y-6">
<div>
<h1 className="text-2xl font-bold tracking-tight">{title}</h1>
{subtitle && (
<p className="text-muted-foreground text-sm">{subtitle}</p>
)}
</div>
{children}
</div>
);
}