From 3ce84af39c2677c91fba9e5a069a7ed0cc2b378e Mon Sep 17 00:00:00 2001
From: kang <kangdeng28@gmail.com>
Date: Thu, 21 May 2026 16:33:22 +0800
Subject: [PATCH] =?UTF-8?q?refactor:=20=E6=9B=B4=E6=96=B0=E9=85=8D?=
 =?UTF-8?q?=E7=BD=AE=E6=A8=A1=E5=9D=97=E7=9A=84=E6=A0=B7=E5=BC=8F=E4=B8=8E?=
 =?UTF-8?q?=E5=B8=83=E5=B1=80=EF=BC=8C=E4=BC=98=E5=8C=96=E7=BB=84=E4=BB=B6?=
 =?UTF-8?q?=E7=BB=93=E6=9E=84=EF=BC=8C=E5=A2=9E=E5=BC=BA=E5=8F=AF=E8=AF=BB?=
 =?UTF-8?q?=E6=80=A7=E4=B8=8E=E4=B8=80=E8=87=B4=E6=80=A7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/modules/config/config-chip-group.tsx      |  43 +++++
 src/modules/config/config-context-banner.tsx  |  39 ++++
 src/modules/config/config-doc-page.tsx        |  75 ++++++++
 src/modules/config/config-readonly-value.tsx  |   2 +-
 src/modules/config/config-section.tsx         |  34 ++++
 src/modules/config/config-status-badge.tsx    |  13 +-
 src/modules/config/config-subnav.tsx          |  11 +-
 src/modules/config/config-version-actions.tsx |  27 +--
 .../config/config-version-switcher.tsx        |  48 ++---
 src/modules/config/config-workspace-shell.tsx |   6 +-
 .../config/doc/odds-config-doc-screen.tsx     | 180 ++++++++----------
 .../config/doc/play-config-doc-screen.tsx     | 177 +++++++++--------
 .../config/doc/rebate-config-doc-screen.tsx   | 115 +++++------
 .../config/doc/risk-cap-doc-screen.tsx        | 139 +++++++-------
 .../config/doc/wallet-config-doc-screen.tsx   |   9 +-
 15 files changed, 541 insertions(+), 377 deletions(-)
 create mode 100644 src/modules/config/config-chip-group.tsx
 create mode 100644 src/modules/config/config-context-banner.tsx
 create mode 100644 src/modules/config/config-doc-page.tsx
 create mode 100644 src/modules/config/config-section.tsx

diff --git a/src/modules/config/config-chip-group.tsx b/src/modules/config/config-chip-group.tsx
new file mode 100644
index 0000000..9373722
--- /dev/null
+++ b/src/modules/config/config-chip-group.tsx
@@ -0,0 +1,43 @@
+"use client";
+
+import type { ReactNode } from "react";
+
+import { Button } from "@/components/ui/button";
+import { cn } from "@/lib/utils";
+
+type ConfigChipGroupProps = {
+  label?: string;
+  children: ReactNode;
+  className?: string;
+};
+
+export function ConfigChipGroup({ label, children, className }: ConfigChipGroupProps) {
+  return (
+    <div className={cn("space-y-2.5", className)}>
+      {label ? <p className="text-sm font-medium text-foreground">{label}</p> : null}
+      <div className="flex flex-wrap gap-2">{children}</div>
+    </div>
+  );
+}
+
+type ConfigChipProps = {
+  active: boolean;
+  onClick: () => void;
+  children: ReactNode;
+  disabled?: boolean;
+};
+
+export function ConfigChip({ active, onClick, children, disabled }: ConfigChipProps) {
+  return (
+    <Button
+      type="button"
+      variant={active ? "default" : "outline"}
+      size="sm"
+      disabled={disabled}
+      className={cn("h-9 rounded-full px-4 text-sm font-medium", active && "shadow-sm")}
+      onClick={onClick}
+    >
+      {children}
+    </Button>
+  );
+}
diff --git a/src/modules/config/config-context-banner.tsx b/src/modules/config/config-context-banner.tsx
new file mode 100644
index 0000000..90def19
--- /dev/null
+++ b/src/modules/config/config-context-banner.tsx
@@ -0,0 +1,39 @@
+import type { ReactNode } from "react";
+
+import { cn } from "@/lib/utils";
+
+type ConfigContextBannerProps = {
+  children: ReactNode;
+  className?: string;
+  /** Highlights read-only or draft-only hints. */
+  emphasis?: boolean;
+};
+
+export function ConfigContextBanner({
+  children,
+  className,
+  emphasis = false,
+}: ConfigContextBannerProps) {
+  return (
+    <div
+      className={cn(
+        "rounded-lg border px-4 py-3 text-sm leading-relaxed",
+        emphasis
+          ? "border-primary/25 bg-accent/80 text-foreground"
+          : "border-border/60 bg-muted/40 text-muted-foreground",
+        className,
+      )}
+      role="status"
+    >
+      {children}
+    </div>
+  );
+}
+
+export function ConfigContextEmphasis({ children, className }: { children: ReactNode; className?: string }) {
+  return (
+    <span className={cn("font-medium text-primary", className)}>
+      {children}
+    </span>
+  );
+}
diff --git a/src/modules/config/config-doc-page.tsx b/src/modules/config/config-doc-page.tsx
new file mode 100644
index 0000000..3878249
--- /dev/null
+++ b/src/modules/config/config-doc-page.tsx
@@ -0,0 +1,75 @@
+"use client";
+
+import type { ReactNode } from "react";
+
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
+import { cn } from "@/lib/utils";
+
+type ConfigDocPageProps = {
+  title: string;
+  titleSuffix?: ReactNode;
+  description?: string;
+  /** Category / play-type chips etc., rendered above the version toolbar. */
+  filters?: ReactNode;
+  toolbar?: ReactNode;
+  context?: ReactNode;
+  children: ReactNode;
+  className?: string;
+  contentClassName?: string;
+};
+
+export function ConfigDocToolbar({
+  switcher,
+  actions,
+  className,
+}: {
+  switcher: ReactNode;
+  actions: ReactNode;
+  className?: string;
+}) {
+  return (
+    <div
+      className={cn(
+        "rounded-xl border border-border/60 bg-secondary/50 p-4 shadow-sm",
+        className,
+      )}
+    >
+      <div className="flex flex-col gap-4 lg:flex-row lg:items-center lg:justify-between">
+        <div className="min-w-0 flex-1">{switcher}</div>
+        <div className="flex shrink-0 flex-wrap items-center justify-end gap-2">{actions}</div>
+      </div>
+    </div>
+  );
+}
+
+export function ConfigDocPage({
+  title,
+  titleSuffix,
+  description,
+  filters,
+  toolbar,
+  context,
+  children,
+  className,
+  contentClassName,
+}: ConfigDocPageProps) {
+  return (
+    <Card className={className}>
+      <CardHeader className="border-b border-border/60 pb-4">
+        <CardTitle className="text-lg">
+          {title}
+          {titleSuffix ? (
+            <span className="ml-2 font-normal text-muted-foreground">{titleSuffix}</span>
+          ) : null}
+        </CardTitle>
+        {description ? <CardDescription className="text-base">{description}</CardDescription> : null}
+      </CardHeader>
+      <CardContent className={cn("space-y-6 pt-6", contentClassName)}>
+        {filters}
+        {toolbar}
+        {context}
+        {children}
+      </CardContent>
+    </Card>
+  );
+}
diff --git a/src/modules/config/config-readonly-value.tsx b/src/modules/config/config-readonly-value.tsx
index 078eeff..6a01d9d 100644
--- a/src/modules/config/config-readonly-value.tsx
+++ b/src/modules/config/config-readonly-value.tsx
@@ -16,7 +16,7 @@ export function ConfigReadonlyValue({
   return (
     <span
       className={cn(
-        "inline-flex min-h-8 w-full items-center rounded-md border border-transparent bg-slate-50 px-2.5 text-sm text-slate-800",
+        "inline-flex min-h-9 w-full items-center rounded-md border border-border/60 bg-muted/60 px-3 text-sm text-foreground",
         mono && "font-mono tabular-nums",
         className,
       )}
diff --git a/src/modules/config/config-section.tsx b/src/modules/config/config-section.tsx
new file mode 100644
index 0000000..2879628
--- /dev/null
+++ b/src/modules/config/config-section.tsx
@@ -0,0 +1,34 @@
+import type { ReactNode } from "react";
+
+import { cn } from "@/lib/utils";
+
+type ConfigSectionProps = {
+  title: string;
+  description?: string;
+  actions?: ReactNode;
+  children: ReactNode;
+  className?: string;
+};
+
+export function ConfigSection({
+  title,
+  description,
+  actions,
+  children,
+  className,
+}: ConfigSectionProps) {
+  return (
+    <section className={cn("space-y-4", className)}>
+      <div className="flex flex-wrap items-start justify-between gap-3 border-b border-border/60 pb-3">
+        <div className="min-w-0 space-y-1">
+          <h3 className="text-base font-semibold text-foreground">{title}</h3>
+          {description ? (
+            <p className="text-sm text-muted-foreground">{description}</p>
+          ) : null}
+        </div>
+        {actions ? <div className="flex shrink-0 flex-wrap items-center gap-2">{actions}</div> : null}
+      </div>
+      {children}
+    </section>
+  );
+}
diff --git a/src/modules/config/config-status-badge.tsx b/src/modules/config/config-status-badge.tsx
index f81fe41..2300606 100644
--- a/src/modules/config/config-status-badge.tsx
+++ b/src/modules/config/config-status-badge.tsx
@@ -1,15 +1,20 @@
 import { useTranslation } from "react-i18next";
 import { Badge } from "@/components/ui/badge";
+import { cn } from "@/lib/utils";
 
 export function ConfigStatusBadge({ status }: { status: string }) {
   const { t } = useTranslation("config");
   const label = t(`versionStatus.${status}`, { defaultValue: status });
   const className =
     status === "active"
-      ? "border-emerald-500/20 bg-emerald-500/12 text-emerald-700 dark:text-emerald-300"
+      ? "border-primary/30 bg-primary/10 text-primary"
       : status === "draft"
-        ? "border-amber-500/20 bg-amber-500/12 text-amber-700 dark:text-amber-300"
-        : "border-slate-300 bg-slate-100 text-slate-600 dark:border-slate-700 dark:bg-slate-800/80 dark:text-slate-300";
+        ? "border-border bg-secondary text-secondary-foreground"
+        : "border-border/80 bg-muted text-muted-foreground";
 
-  return <Badge variant="outline" className={`font-normal tabular-nums ${className}`}>{label}</Badge>;
+  return (
+    <Badge variant="outline" className={cn("font-medium tabular-nums", className)}>
+      {label}
+    </Badge>
+  );
 }
diff --git a/src/modules/config/config-subnav.tsx b/src/modules/config/config-subnav.tsx
index 15343c4..3a65c51 100644
--- a/src/modules/config/config-subnav.tsx
+++ b/src/modules/config/config-subnav.tsx
@@ -13,7 +13,10 @@ export function ConfigSubNav() {
   const links = CONFIG_NAV_GROUPS.flatMap((group) => group.items);
 
   return (
-    <nav className="flex w-full flex-wrap items-end gap-1 border-b border-border/60 px-1" aria-label={t("nav.aria")}>
+    <nav
+      className="flex w-full flex-wrap gap-1 rounded-xl border border-border/60 bg-muted/40 p-1.5"
+      aria-label={t("nav.aria")}
+    >
       {links.map(({ href, key }) => {
         const active = pathname === href || pathname.startsWith(`${href}/`);
         return (
@@ -21,10 +24,10 @@ export function ConfigSubNav() {
             key={href}
             href={href}
             className={cn(
-              "border-b-2 px-4 py-3 text-sm font-medium transition-colors",
+              "rounded-lg px-4 py-2.5 text-sm font-medium transition-colors",
               active
-                ? "border-primary text-primary"
-                : "border-transparent text-muted-foreground hover:border-border/80 hover:text-foreground",
+                ? "bg-card text-primary shadow-sm"
+                : "text-muted-foreground hover:bg-card/60 hover:text-foreground",
             )}
           >
             {t(`nav.items.${key}`)}
diff --git a/src/modules/config/config-version-actions.tsx b/src/modules/config/config-version-actions.tsx
index 6f4719a..9b6eb67 100644
--- a/src/modules/config/config-version-actions.tsx
+++ b/src/modules/config/config-version-actions.tsx
@@ -36,23 +36,12 @@ export function ConfigVersionActions({
   const resolvedPublishLabel = publishLabel ?? t("versionActions.publishCurrent");
 
   return (
-    <div className={cn("flex flex-wrap items-center gap-2 lg:justify-end", className)}>
-      <Button
-        type="button"
-        variant="outline"
-        className="border-slate-300 bg-white text-slate-700 hover:bg-slate-50 hover:text-slate-950"
-        disabled={loadingList}
-        onClick={onRefresh}
-      >
+    <div className={cn("flex flex-wrap items-center gap-2", className)}>
+      <Button type="button" variant="outline" disabled={loadingList} onClick={onRefresh}>
         <RefreshCw className={loadingList ? "size-4 animate-spin" : "size-4"} aria-hidden />
         {loadingList ? t("versionActions.refreshing") : t("versionActions.refresh")}
       </Button>
-      <Button
-        type="button"
-        className="bg-slate-950 text-white hover:bg-slate-800"
-        disabled={saving}
-        onClick={onNewDraft}
-      >
+      <Button type="button" disabled={saving} onClick={onNewDraft}>
         <Plus className="size-4" aria-hidden />
         {t("versionActions.newDraft")}
       </Button>
@@ -60,20 +49,14 @@ export function ConfigVersionActions({
         <>
           <Button
             type="button"
-            variant="outline"
-            className="border-amber-300 bg-amber-50 text-amber-900 hover:bg-amber-100 hover:text-amber-950"
+            variant="secondary"
             disabled={draftActionBusy}
             onClick={onSaveDraft}
           >
             <Save className="size-4" aria-hidden />
             {t("versionActions.saveDraft")}
           </Button>
-          <Button
-            type="button"
-            className="bg-emerald-600 text-white hover:bg-emerald-700"
-            disabled={draftActionBusy}
-            onClick={onPublish}
-          >
+          <Button type="button" disabled={draftActionBusy} onClick={onPublish}>
             <Rocket className="size-4" aria-hidden />
             {resolvedPublishLabel}
           </Button>
diff --git a/src/modules/config/config-version-switcher.tsx b/src/modules/config/config-version-switcher.tsx
index d1ae810..40d12fb 100644
--- a/src/modules/config/config-version-switcher.tsx
+++ b/src/modules/config/config-version-switcher.tsx
@@ -141,7 +141,7 @@ export function ConfigVersionSwitcher({
           variant="outline"
           disabled={loading || sortedVersions.length === 0}
           onClick={() => setSheetOpen(true)}
-          className="shrink-0 border-slate-300 bg-white text-slate-800 hover:bg-slate-50 hover:text-slate-950"
+          className="shrink-0"
         >
           <Layers className="size-4" aria-hidden />
           {t("versionSwitcher.switch", { ns: "config" })}
@@ -151,24 +151,24 @@ export function ConfigVersionSwitcher({
       <Sheet open={sheetOpen} onOpenChange={setSheetOpen}>
         <SheetContent
           side="right"
-          className="flex flex-col overflow-hidden border-l bg-slate-50 p-0 shadow-xl sm:max-w-[430px]"
+          className="flex flex-col overflow-hidden border-l bg-background p-0 shadow-xl sm:max-w-[430px]"
         >
-          <div className="border-b bg-white px-5 pb-4 pt-5">
+          <div className="border-b border-border/60 bg-card px-5 pb-4 pt-5">
             <SheetHeader className="space-y-2 text-left">
-              <SheetTitle className="text-[17px] font-semibold tracking-tight text-slate-950">
+              <SheetTitle className="text-base font-semibold tracking-tight text-foreground">
                 {resolvedSheetTitle}
               </SheetTitle>
-              <SheetDescription className="max-w-[320px] text-[13px] leading-5 text-slate-500">
+              <SheetDescription className="max-w-[320px] text-sm leading-relaxed text-muted-foreground">
                 {resolvedSheetDescription}
               </SheetDescription>
             </SheetHeader>
           </div>
-          <div className="border-b bg-white px-4 py-3">
+          <div className="border-b border-border/60 bg-card px-4 py-3">
             <div className="flex flex-wrap gap-2">
               {statusCounts.map((s) => (
                 <div
                   key={s.status}
-                  className="inline-flex items-center gap-2 rounded-full border border-border/60 bg-background px-3 py-1.5 text-xs text-muted-foreground"
+                  className="inline-flex items-center gap-2 rounded-full border border-border/60 bg-muted/50 px-3 py-1.5 text-sm text-muted-foreground"
                 >
                   <span className="font-medium text-foreground/80">{s.label}</span>
                   <span className="font-mono tabular-nums">{s.count}</span>
@@ -178,7 +178,7 @@ export function ConfigVersionSwitcher({
           </div>
           <div className="flex-1 overflow-auto px-4 py-4">
             {sortedVersions.length === 0 ? (
-              <div className="rounded-2xl border border-dashed border-border/60 bg-white/70 p-5 text-center text-sm text-muted-foreground">
+              <div className="rounded-2xl border border-dashed border-border/60 bg-muted/30 p-5 text-center text-sm text-muted-foreground">
                 {t("versionSwitcher.empty", { ns: "config" })}
               </div>
             ) : (
@@ -193,17 +193,17 @@ export function ConfigVersionSwitcher({
                       <div className="flex items-center gap-2.5">
                         <div
                           className={cn(
-                            "size-2.5 rounded-full shadow-[0_0_0_4px_rgba(148,163,184,0.12)]",
-                            status === "draft" && "bg-amber-400 shadow-amber-100",
-                            status === "active" && "bg-emerald-500 shadow-emerald-100",
-                            status === "archived" && "bg-slate-400 shadow-slate-100",
+                            "size-2.5 rounded-full",
+                            status === "draft" && "bg-muted-foreground",
+                            status === "active" && "bg-primary",
+                            status === "archived" && "bg-border",
                           )}
                         />
-                        <p className="text-[15px] font-semibold text-foreground">
+                        <p className="text-base font-semibold text-foreground">
                           {t(`versionStatus.${status}`, { ns: "config" })}
                         </p>
                       </div>
-                      <p className="rounded-full bg-muted/50 px-2 py-0.5 text-xs font-medium tabular-nums text-muted-foreground">
+                      <p className="rounded-full bg-muted px-2 py-0.5 text-sm font-medium tabular-nums text-muted-foreground">
                         {t("versionSwitcher.count", { ns: "config", count: rows.length })}
                       </p>
                     </div>
@@ -220,10 +220,10 @@ export function ConfigVersionSwitcher({
                           >
                             <div
                               className={cn(
-                                "mt-1 h-auto w-1 shrink-0 rounded-full bg-slate-200",
-                                v.status === "draft" && "bg-amber-300",
-                                v.status === "active" && "bg-emerald-400",
-                                v.status === "archived" && "bg-slate-300",
+                                "mt-1 h-auto w-1 shrink-0 rounded-full bg-border",
+                                v.status === "draft" && "bg-muted-foreground/60",
+                                v.status === "active" && "bg-primary",
+                                v.status === "archived" && "bg-muted-foreground/30",
                               )}
                             />
                             <div className="min-w-0 flex-1 space-y-2">
@@ -234,11 +234,11 @@ export function ConfigVersionSwitcher({
                                       v{v.version_no}
                                     </span>
                                     <ConfigStatusBadge status={v.status} />
-                                    <span className="rounded-full bg-muted px-2 py-0.5 text-xs font-medium tabular-nums text-muted-foreground">
+                                    <span className="rounded-full bg-muted px-2 py-0.5 text-sm font-medium tabular-nums text-muted-foreground">
                                       #{v.id}
                                     </span>
                                   </div>
-                                  <p className="line-clamp-2 text-[13px] leading-5 text-muted-foreground">
+                                  <p className="line-clamp-2 text-sm leading-relaxed text-muted-foreground">
                                     {t("versionSwitcher.effectiveAt", {
                                       ns: "config",
                                       value: v.effective_at ? formatDt(v.effective_at) : "—",
@@ -252,7 +252,7 @@ export function ConfigVersionSwitcher({
                                   </p>
                                 </div>
                                 {isCurrent ? (
-                                  <span className="shrink-0 rounded-full bg-foreground px-2.5 py-1 text-xs font-medium text-background">
+                                  <span className="shrink-0 rounded-full bg-primary px-2.5 py-1 text-sm font-medium text-primary-foreground">
                                     {t("versionSwitcher.current", { ns: "config" })}
                                   </span>
                                 ) : null}
@@ -263,7 +263,7 @@ export function ConfigVersionSwitcher({
                                   variant={isCurrent ? "secondary" : "outline"}
                                   size="sm"
                                   className={cn(
-                                    "h-8 rounded-full px-3 text-xs",
+                                    "h-9 rounded-full px-3 text-sm",
                                     isCurrent && "bg-muted text-muted-foreground hover:bg-muted",
                                   )}
                                   onClick={() => switchTo(v.id)}
@@ -277,7 +277,7 @@ export function ConfigVersionSwitcher({
                                     type="button"
                                     variant="ghost"
                                     size="sm"
-                                    className="rounded-full text-xs text-muted-foreground hover:bg-muted hover:text-foreground"
+                                    className="rounded-full text-sm text-muted-foreground hover:bg-muted hover:text-foreground"
                                     disabled={rollbackBusy}
                                     onClick={() => {
                                       onRollbackVersion(v);
@@ -292,7 +292,7 @@ export function ConfigVersionSwitcher({
                                     type="button"
                                     variant="ghost"
                                     size="sm"
-                                    className="rounded-full text-xs text-rose-600 hover:bg-rose-50 hover:text-rose-700"
+                                    className="rounded-full text-sm text-destructive hover:bg-destructive/10 hover:text-destructive"
                                     disabled={deletingId === v.id}
                                     onClick={() => setDeleteTarget(v)}
                                   >
diff --git a/src/modules/config/config-workspace-shell.tsx b/src/modules/config/config-workspace-shell.tsx
index 65082f3..2d688fe 100644
--- a/src/modules/config/config-workspace-shell.tsx
+++ b/src/modules/config/config-workspace-shell.tsx
@@ -6,11 +6,11 @@ import { ConfigSubNav } from "@/modules/config/config-subnav";
 
 export function ConfigWorkspaceShell({ children }: { children: ReactNode }) {
   return (
-    <div className="mx-auto flex w-full max-w-[1680px] flex-col gap-6 px-4 py-5 sm:px-6 lg:px-8 lg:py-6">
-      <div className="sticky top-14 z-20 bg-background/95 backdrop-blur supports-[backdrop-filter]:bg-background/80">
+    <div className="mx-auto flex w-full max-w-[1680px] flex-col gap-5 px-4 py-5 sm:px-6 lg:px-8 lg:py-6">
+      <div className="sticky top-14 z-20 -mx-1 bg-background/95 px-1 pb-1 backdrop-blur supports-[backdrop-filter]:bg-background/80">
         <ConfigSubNav />
       </div>
-      <div className="min-w-0">{children}</div>
+      <div className="min-w-0 space-y-5">{children}</div>
     </div>
   );
 }
diff --git a/src/modules/config/doc/odds-config-doc-screen.tsx b/src/modules/config/doc/odds-config-doc-screen.tsx
index 59c33f6..b87141f 100644
--- a/src/modules/config/doc/odds-config-doc-screen.tsx
+++ b/src/modules/config/doc/odds-config-doc-screen.tsx
@@ -15,7 +15,9 @@ import {
   putOddsItems,
 } from "@/api/admin-config";
 import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { ConfigChip, ConfigChipGroup } from "@/modules/config/config-chip-group";
+import { ConfigContextBanner, ConfigContextEmphasis } from "@/modules/config/config-context-banner";
+import { ConfigDocPage, ConfigDocToolbar } from "@/modules/config/config-doc-page";
 import {
   Dialog,
   DialogContent,
@@ -29,7 +31,6 @@ import { Label } from "@/components/ui/label";
 import { ConfigReadonlyValue } from "@/modules/config/config-readonly-value";
 import { ConfigVersionActions } from "@/modules/config/config-version-actions";
 import { ConfigVersionSwitcher } from "@/modules/config/config-version-switcher";
-import { cn } from "@/lib/utils";
 import { useAdminDateTimeFormatter } from "@/hooks/use-admin-datetime-formatter";
 import { LotteryApiBizError } from "@/types/api/errors";
 import type {
@@ -395,105 +396,90 @@ export function OddsConfigDocScreen() {
   ];
 
   return (
-    <Card>
-      <CardHeader className="space-y-1">
-        <CardTitle className="text-lg">{t("nav.items.odds", { ns: "config" })}</CardTitle>
-      </CardHeader>
-      <CardContent className="space-y-6">
-        <div className="flex flex-wrap gap-2">
-          <span className="text-base text-muted-foreground self-center mr-2">{t("odds.category", { ns: "config" })}</span>
-          {catTabs.map((t) => (
-            <Button
-              key={t.id}
-              type="button"
-              variant={catTab === t.id ? "default" : "outline"}
-              size="xs"
-              className={cn(
-                "h-7 rounded-full px-3 text-xs font-medium",
-                catTab === t.id ? "shadow-sm" : "bg-white text-slate-900",
-              )}
-              onClick={() => setCatTab(t.id)}
-            >
-              {t.label}
-            </Button>
-          ))}
-        </div>
-
-        <div className="space-y-2 min-h-[96px]">
-          <p className="text-base text-muted-foreground">{t("odds.playType", { ns: "config" })}</p>
-          <div className="flex flex-wrap gap-2 min-h-[44px]">
+    <ConfigDocPage
+      title={t("nav.items.odds", { ns: "config" })}
+      filters={
+        <div className="space-y-4 rounded-xl border border-border/60 bg-card p-4">
+          <ConfigChipGroup label={t("odds.category", { ns: "config" })}>
+            {catTabs.map((tab) => (
+              <ConfigChip
+                key={tab.id}
+                active={catTab === tab.id}
+                onClick={() => setCatTab(tab.id)}
+              >
+                {tab.label}
+              </ConfigChip>
+            ))}
+          </ConfigChipGroup>
+          <ConfigChipGroup label={t("odds.playType", { ns: "config" })}>
             {filteredTypes.length === 0 ? (
-              <span className="text-base text-muted-foreground">{t("odds.noPlayTypes", { ns: "config" })}</span>
+              <span className="text-sm text-muted-foreground">{t("odds.noPlayTypes", { ns: "config" })}</span>
             ) : (
-              filteredTypes.map((t) => (
-                <Button
-                  key={t.play_code}
-                  type="button"
-                  variant={resolvedPlayCode === t.play_code ? "secondary" : "outline"}
-                  className={cn(
-                    "h-8 rounded-full border-slate-300 px-4 text-sm font-medium",
-                    resolvedPlayCode === t.play_code
-                      ? "border-slate-950 bg-slate-950 text-white shadow-sm hover:bg-slate-900"
-                      : "bg-white text-slate-900 hover:border-slate-400 hover:bg-slate-50",
-                  )}
-                  onClick={() => setPlayCode(t.play_code)}
+              filteredTypes.map((type) => (
+                <ConfigChip
+                  key={type.play_code}
+                  active={resolvedPlayCode === type.play_code}
+                  onClick={() => setPlayCode(type.play_code)}
                 >
-                  {t.display_name_zh ?? t.play_code}
-                </Button>
+                  {type.display_name_zh ?? type.play_code}
+                </ConfigChip>
               ))
             )}
-          </div>
+          </ConfigChipGroup>
         </div>
-
-        <div className="flex flex-col gap-3 lg:flex-row lg:items-end lg:justify-between">
-          <ConfigVersionSwitcher
-            versions={list}
-            selectedId={selectedId}
-            onSelectedIdChange={setSelectedId}
-            loading={loadingList}
-            sheetTitle={`${t("nav.items.odds", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
-            sheetDescription={t("odds.sheetDescription", { ns: "config" })}
-            onDeleteVersion={handleDeleteVersion}
-            onRollbackVersion={requestRollback}
-            rollbackBusy={saving}
-            className="lg:flex-1"
-          />
-
-          <ConfigVersionActions
-            isDraft={isDraft}
-            loadingList={loadingList}
-            loadingDetail={loadingDetail}
-            saving={saving}
-            onRefresh={() => void refreshList()}
-            onNewDraft={() => void handleNewDraft()}
-            onSaveDraft={() => void handleSave()}
-            onPublish={() => void requestPublishConfirm()}
-          />
-        </div>
-
-        {detail ? (
-          <div className="space-y-1 text-sm">
-            <p className="text-muted-foreground">
-              {t("odds.activeVersionPrefix", { ns: "config" })}
-              {activeHead ? (
-                <>
-                  v{activeHead.version_no}
-                  {activeHead.effective_at ? ` · ${formatDt(activeHead.effective_at)}` : ""}
-                </>
-              ) : (
-                "—"
-              )}
-              {!isDraft ? (
-                <span className="text-amber-600 dark:text-amber-400">
-                  {" "}
-                  - {t("odds.readOnlyHint", { ns: "config" })}
-                </span>
-              ) : null}
-            </p>
-          </div>
-        ) : null}
-
-        {error ? <p className="text-sm text-destructive">{error}</p> : null}
+      }
+      toolbar={
+        <ConfigDocToolbar
+          switcher={
+            <ConfigVersionSwitcher
+              versions={list}
+              selectedId={selectedId}
+              onSelectedIdChange={setSelectedId}
+              loading={loadingList}
+              sheetTitle={`${t("nav.items.odds", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
+              sheetDescription={t("odds.sheetDescription", { ns: "config" })}
+              onDeleteVersion={handleDeleteVersion}
+              onRollbackVersion={requestRollback}
+              rollbackBusy={saving}
+            />
+          }
+          actions={
+            <ConfigVersionActions
+              isDraft={isDraft}
+              loadingList={loadingList}
+              loadingDetail={loadingDetail}
+              saving={saving}
+              onRefresh={() => void refreshList()}
+              onNewDraft={() => void handleNewDraft()}
+              onSaveDraft={() => void handleSave()}
+              onPublish={() => void requestPublishConfirm()}
+            />
+          }
+        />
+      }
+      context={
+        detail ? (
+          <ConfigContextBanner emphasis={!isDraft}>
+            {t("odds.activeVersionPrefix", { ns: "config" })}
+            {activeHead ? (
+              <>
+                v{activeHead.version_no}
+                {activeHead.effective_at ? ` · ${formatDt(activeHead.effective_at)}` : ""}
+              </>
+            ) : (
+              "—"
+            )}
+            {!isDraft ? (
+              <>
+                {" "}
+                — <ConfigContextEmphasis>{t("odds.readOnlyHint", { ns: "config" })}</ConfigContextEmphasis>
+              </>
+            ) : null}
+          </ConfigContextBanner>
+        ) : null
+      }
+    >
+      {error ? <p className="text-sm text-destructive">{error}</p> : null}
 
         {loadingDetail || loadingTypes ? (
           <div className="flex min-h-[420px] items-center">
@@ -566,8 +552,6 @@ export function OddsConfigDocScreen() {
           </div>
         ) : null}
 
-      </CardContent>
-
       <Dialog open={rollbackOpen} onOpenChange={setRollbackOpen}>
         <DialogContent showCloseButton className="sm:max-w-md">
           <DialogHeader>
@@ -628,6 +612,6 @@ export function OddsConfigDocScreen() {
           </DialogFooter>
         </DialogContent>
       </Dialog>
-    </Card>
+    </ConfigDocPage>
   );
 }
diff --git a/src/modules/config/doc/play-config-doc-screen.tsx b/src/modules/config/doc/play-config-doc-screen.tsx
index 10d8d30..0971e4b 100644
--- a/src/modules/config/doc/play-config-doc-screen.tsx
+++ b/src/modules/config/doc/play-config-doc-screen.tsx
@@ -14,7 +14,10 @@ import {
   putPlayConfigItems,
 } from "@/api/admin-config";
 import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { ConfigChipGroup } from "@/modules/config/config-chip-group";
+import { ConfigContextBanner, ConfigContextEmphasis } from "@/modules/config/config-context-banner";
+import { ConfigDocPage, ConfigDocToolbar } from "@/modules/config/config-doc-page";
+import { ConfigSection } from "@/modules/config/config-section";
 import { Checkbox } from "@/components/ui/checkbox";
 import {
   Dialog,
@@ -375,36 +378,37 @@ export function PlayConfigDocScreen() {
   }
 
   return (
-    <Card>
-      <CardHeader className="space-y-1">
-        <CardTitle className="text-lg">{t("nav.items.plays", { ns: "config" })}</CardTitle>
-      </CardHeader>
-      <CardContent className="space-y-4">
-        <div className="flex flex-col gap-3 lg:flex-row lg:items-end lg:justify-between">
-          <ConfigVersionSwitcher
-            versions={list}
-            selectedId={selectedId}
-            onSelectedIdChange={setSelectedId}
-            loading={loadingList}
-            sheetTitle={`${t("nav.items.plays", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
-            onDeleteVersion={handleDeleteVersion}
-            className="lg:flex-1"
-          />
-
-          <ConfigVersionActions
-            isDraft={isDraft}
-            loadingList={loadingList}
-            loadingDetail={loadingDetail}
-            saving={saving}
-            onRefresh={() => void refreshList()}
-            onNewDraft={() => void handleNewDraft()}
-            onSaveDraft={() => void handleSaveDraft()}
-            onPublish={() => void handlePublish()}
-          />
-        </div>
-
-        {detail ? (
-          <p className="text-sm text-muted-foreground">
+    <ConfigDocPage
+      title={t("nav.items.plays", { ns: "config" })}
+      toolbar={
+        <ConfigDocToolbar
+          switcher={
+            <ConfigVersionSwitcher
+              versions={list}
+              selectedId={selectedId}
+              onSelectedIdChange={setSelectedId}
+              loading={loadingList}
+              sheetTitle={`${t("nav.items.plays", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
+              onDeleteVersion={handleDeleteVersion}
+            />
+          }
+          actions={
+            <ConfigVersionActions
+              isDraft={isDraft}
+              loadingList={loadingList}
+              loadingDetail={loadingDetail}
+              saving={saving}
+              onRefresh={() => void refreshList()}
+              onNewDraft={() => void handleNewDraft()}
+              onSaveDraft={() => void handleSaveDraft()}
+              onPublish={() => void handlePublish()}
+            />
+          }
+        />
+      }
+      context={
+        detail ? (
+          <ConfigContextBanner emphasis={!isDraft}>
             {activeHead ? (
               <>
                 {t("play.activeVersion", { ns: "config", version: activeHead.version_no })}
@@ -412,65 +416,61 @@ export function PlayConfigDocScreen() {
               </>
             ) : null}
             {!isDraft ? (
-              <span className="text-amber-600 dark:text-amber-400">
+              <>
                 {activeHead ? " — " : ""}
-                {t("play.readOnlyHint", { ns: "config" })}
-              </span>
+                <ConfigContextEmphasis>{t("play.readOnlyHint", { ns: "config" })}</ConfigContextEmphasis>
+              </>
             ) : null}
-          </p>
-        ) : null}
-
-        {detail ? (
-          <div className="space-y-3">
-            <div className="flex flex-wrap items-center justify-between gap-2">
-              <p className="text-sm font-medium">{t("play.batchSwitchesTitle", { ns: "config" })}</p>
-              {!isDraft ? (
-                <span className="text-xs text-amber-600 dark:text-amber-400">
-                  {t("play.readOnlyDraftHint", { ns: "config" })}
-                </span>
-              ) : null}
-            </div>
-            <div className="flex flex-wrap gap-2">
-              {batchSwitchStates.map((group) => (
-                <div
-                  key={group.key}
-                  className="flex items-center gap-2 rounded-xl border border-border/60 bg-background/70 px-3 py-2"
-                >
-                  <div className="min-w-[92px]">
-                    <p className="text-sm font-medium">{group.label}</p>
-                    <p className="text-xs text-muted-foreground">
-                      {group.total > 0
-                        ? t("play.batchEnabledCount", {
-                            ns: "config",
-                            enabledCount: group.enabledCount,
-                            total: group.total,
-                          })
-                        : t("play.noPlayTypes", { ns: "config" })}
-                    </p>
-                  </div>
-                  <Button
-                    type="button"
-                    size="sm"
-                    variant={group.allEnabled ? "secondary" : "outline"}
-                    disabled={!isDraft || saving || group.total === 0}
-                    onClick={() => applyBatchSwitch(group, !group.allEnabled)}
-                  >
-                    {group.allEnabled
-                      ? t("play.actions.disable", { ns: "config" })
-                      : t("play.actions.enable", { ns: "config" })}
-                  </Button>
+          </ConfigContextBanner>
+        ) : null
+      }
+    >
+      {detail ? (
+        <ConfigSection
+          title={t("play.batchSwitchesTitle", { ns: "config" })}
+          description={!isDraft ? t("play.readOnlyDraftHint", { ns: "config" }) : undefined}
+        >
+          <ConfigChipGroup>
+            {batchSwitchStates.map((group) => (
+              <div
+                key={group.key}
+                className="flex items-center gap-3 rounded-xl border border-border/60 bg-card px-4 py-3"
+              >
+                <div className="min-w-[100px]">
+                  <p className="text-sm font-medium text-foreground">{group.label}</p>
+                  <p className="text-sm text-muted-foreground">
+                    {group.total > 0
+                      ? t("play.batchEnabledCount", {
+                          ns: "config",
+                          enabledCount: group.enabledCount,
+                          total: group.total,
+                        })
+                      : t("play.noPlayTypes", { ns: "config" })}
+                  </p>
                 </div>
-              ))}
-            </div>
-          </div>
-        ) : null}
+                <Button
+                  type="button"
+                  size="sm"
+                  variant={group.allEnabled ? "secondary" : "outline"}
+                  disabled={!isDraft || saving || group.total === 0}
+                  onClick={() => applyBatchSwitch(group, !group.allEnabled)}
+                >
+                  {group.allEnabled
+                    ? t("play.actions.disable", { ns: "config" })
+                    : t("play.actions.enable", { ns: "config" })}
+                </Button>
+              </div>
+            ))}
+          </ConfigChipGroup>
+        </ConfigSection>
+      ) : null}
 
-        {error ? <p className="text-sm text-destructive">{error}</p> : null}
+      {error ? <p className="text-sm text-destructive">{error}</p> : null}
 
-        {loadingDetail ? (
-          <p className="text-sm text-muted-foreground">{t("states.loading", { ns: "common" })}</p>
-        ) : (
-          <Table>
+      {loadingDetail ? (
+        <p className="text-sm text-muted-foreground">{t("states.loading", { ns: "common" })}</p>
+      ) : (
+        <Table>
               <TableHeader>
                 <TableRow>
                   <TableHead className="text-center">{t("play.table.playCode", { ns: "config" })}</TableHead>
@@ -601,9 +601,8 @@ export function PlayConfigDocScreen() {
                   </TableRow>
                 ))}
               </TableBody>
-          </Table>
-        )}
-      </CardContent>
+        </Table>
+      )}
 
       <Dialog open={ruleDialogOpen} onOpenChange={setRuleDialogOpen}>
         <DialogContent showCloseButton className="sm:max-w-lg">
@@ -632,6 +631,6 @@ export function PlayConfigDocScreen() {
           </DialogFooter>
         </DialogContent>
       </Dialog>
-    </Card>
+    </ConfigDocPage>
   );
 }
diff --git a/src/modules/config/doc/rebate-config-doc-screen.tsx b/src/modules/config/doc/rebate-config-doc-screen.tsx
index d05833b..e941324 100644
--- a/src/modules/config/doc/rebate-config-doc-screen.tsx
+++ b/src/modules/config/doc/rebate-config-doc-screen.tsx
@@ -14,7 +14,8 @@ import {
   publishOddsVersion,
   putOddsItems,
 } from "@/api/admin-config";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { ConfigContextBanner, ConfigContextEmphasis } from "@/modules/config/config-context-banner";
+import { ConfigDocPage, ConfigDocToolbar } from "@/modules/config/config-doc-page";
 import { Checkbox } from "@/components/ui/checkbox";
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
@@ -266,55 +267,60 @@ export function RebateConfigDocScreen() {
   }
 
   return (
-    <Card>
-      <CardHeader className="space-y-1">
-        <CardTitle className="text-lg">{t("nav.items.rebate", { ns: "config" })}</CardTitle>
-      </CardHeader>
-      <CardContent className="space-y-6">
-        <div className="flex flex-wrap items-center gap-3">
-          <ConfigVersionSwitcher
-            versions={listRows}
-            selectedId={selectedId}
-            onSelectedIdChange={setSelectedId}
-            loading={loading}
-            sheetTitle={`${t("nav.items.rebate", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
-            sheetDescription={t("rebate.sheetDescription", { ns: "config" })}
-            onDeleteVersion={handleDeleteVersion}
-            className="w-auto min-w-0"
-          />
-
-          <ConfigVersionActions
-            isDraft={isDraft}
-            loadingList={loading}
-            loadingDetail={loadingDetail}
-            saving={saving}
-            publishLabel={t("rebate.publishLabel", { ns: "config" })}
-            onRefresh={() => void refreshList()}
-            onNewDraft={() => void handleNewDraft()}
-            onSaveDraft={() => void handleSave()}
-            onPublish={() => void handlePublish()}
-          />
-
-          {detail ? (
-            <p className="text-sm text-muted-foreground">
-              {t("rebate.editingVersion", {
-                ns: "config",
-                version: detail.version_no,
-                status:
-                  detail.status === "draft"
-                    ? t("versionStatus.draft", { ns: "config" })
-                    : detail.status === "active"
-                      ? t("versionStatus.active", { ns: "config" })
-                      : t("versionStatus.archived", { ns: "config" }),
-              })}
-              {!isDraft ? (
-                <span className="text-amber-600 dark:text-amber-400"> - {t("rebate.readOnlyHint", { ns: "config" })}</span>
-              ) : null}
-            </p>
-          ) : null}
-        </div>
-
-        <div className="grid gap-4 sm:grid-cols-3">
+    <ConfigDocPage
+      title={t("nav.items.rebate", { ns: "config" })}
+      toolbar={
+        <ConfigDocToolbar
+          switcher={
+            <ConfigVersionSwitcher
+              versions={listRows}
+              selectedId={selectedId}
+              onSelectedIdChange={setSelectedId}
+              loading={loading}
+              sheetTitle={`${t("nav.items.rebate", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
+              sheetDescription={t("rebate.sheetDescription", { ns: "config" })}
+              onDeleteVersion={handleDeleteVersion}
+            />
+          }
+          actions={
+            <ConfigVersionActions
+              isDraft={isDraft}
+              loadingList={loading}
+              loadingDetail={loadingDetail}
+              saving={saving}
+              publishLabel={t("rebate.publishLabel", { ns: "config" })}
+              onRefresh={() => void refreshList()}
+              onNewDraft={() => void handleNewDraft()}
+              onSaveDraft={() => void handleSave()}
+              onPublish={() => void handlePublish()}
+            />
+          }
+        />
+      }
+      context={
+        detail ? (
+          <ConfigContextBanner emphasis={!isDraft}>
+            {t("rebate.editingVersion", {
+              ns: "config",
+              version: detail.version_no,
+              status:
+                detail.status === "draft"
+                  ? t("versionStatus.draft", { ns: "config" })
+                  : detail.status === "active"
+                    ? t("versionStatus.active", { ns: "config" })
+                    : t("versionStatus.archived", { ns: "config" }),
+            })}
+            {!isDraft ? (
+              <>
+                {" "}
+                — <ConfigContextEmphasis>{t("rebate.readOnlyHint", { ns: "config" })}</ConfigContextEmphasis>
+              </>
+            ) : null}
+          </ConfigContextBanner>
+        ) : null
+      }
+    >
+      <div className="grid gap-5 sm:grid-cols-3">
           <div className="grid gap-2">
             <Label>{t("rebate.fields.d2", { ns: "config" })}</Label>
             {isDraft ? (
@@ -387,10 +393,9 @@ export function RebateConfigDocScreen() {
           </span>
         </div>
 
-        {loading || loadingDetail ? (
-          <p className="text-sm text-muted-foreground">{t("states.loading", { ns: "common" })}</p>
-        ) : null}
-      </CardContent>
-    </Card>
+      {loading || loadingDetail ? (
+        <p className="text-sm text-muted-foreground">{t("states.loading", { ns: "common" })}</p>
+      ) : null}
+    </ConfigDocPage>
   );
 }
diff --git a/src/modules/config/doc/risk-cap-doc-screen.tsx b/src/modules/config/doc/risk-cap-doc-screen.tsx
index b784299..2684755 100644
--- a/src/modules/config/doc/risk-cap-doc-screen.tsx
+++ b/src/modules/config/doc/risk-cap-doc-screen.tsx
@@ -14,7 +14,9 @@ import {
   putRiskCapItems,
 } from "@/api/admin-config";
 import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { ConfigContextBanner, ConfigContextEmphasis } from "@/modules/config/config-context-banner";
+import { ConfigDocPage, ConfigDocToolbar } from "@/modules/config/config-doc-page";
+import { ConfigSection } from "@/modules/config/config-section";
 import {
   Dialog,
   DialogContent,
@@ -327,55 +329,53 @@ export function RiskCapDocScreen() {
   }
 
   return (
-    <Card>
-      <CardHeader className="space-y-1">
-        <CardTitle className="text-lg">
-          {t("nav.items.risk-cap", { ns: "config" })}
-          {detail ? (
-            <span className="text-muted-foreground font-normal">
-              {" "}
-              · v{detail.version_no}
-            </span>
-          ) : null}
-        </CardTitle>
-      </CardHeader>
-      <CardContent className="space-y-8">
-        <div className="flex flex-wrap items-center gap-3">
-          <ConfigVersionSwitcher
-            versions={list}
-            selectedId={selectedId}
-            onSelectedIdChange={setSelectedId}
-            loading={loadingList}
-            sheetTitle={`${t("nav.items.risk-cap", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
-            onDeleteVersion={handleDeleteVersion}
-            className="w-auto min-w-0"
-          />
+    <ConfigDocPage
+      title={t("nav.items.risk-cap", { ns: "config" })}
+      titleSuffix={detail ? `· v${detail.version_no}` : undefined}
+      toolbar={
+        <ConfigDocToolbar
+          switcher={
+            <ConfigVersionSwitcher
+              versions={list}
+              selectedId={selectedId}
+              onSelectedIdChange={setSelectedId}
+              loading={loadingList}
+              sheetTitle={`${t("nav.items.risk-cap", { ns: "config" })} ${t("versionSwitcher.sheetTitle", { ns: "config" })}`}
+              onDeleteVersion={handleDeleteVersion}
+            />
+          }
+          actions={
+            <ConfigVersionActions
+              isDraft={isDraft}
+              loadingList={loadingList}
+              loadingDetail={loadingDetail}
+              saving={saving}
+              onRefresh={() => void refreshList()}
+              onNewDraft={() => void handleNewDraft()}
+              onSaveDraft={() => void handleSave()}
+              onPublish={() => void handlePublish()}
+            />
+          }
+        />
+      }
+      context={
+        detail ? (
+          <ConfigContextBanner emphasis={!isDraft}>
+            {t("riskCap.effectiveAt", { ns: "config", value: detail.effective_at ? formatDt(detail.effective_at) : "—" })}
+            {!isDraft ? (
+              <>
+                {" "}
+                — <ConfigContextEmphasis>{t("riskCap.readOnlyHint", { ns: "config" })}</ConfigContextEmphasis>
+              </>
+            ) : null}
+          </ConfigContextBanner>
+        ) : null
+      }
+      contentClassName="space-y-8"
+    >
+      {error ? <p className="text-sm text-destructive">{error}</p> : null}
 
-          <ConfigVersionActions
-            isDraft={isDraft}
-            loadingList={loadingList}
-            loadingDetail={loadingDetail}
-            saving={saving}
-            onRefresh={() => void refreshList()}
-            onNewDraft={() => void handleNewDraft()}
-            onSaveDraft={() => void handleSave()}
-            onPublish={() => void handlePublish()}
-          />
-
-          {detail ? (
-            <p className="text-sm text-muted-foreground">
-              {t("riskCap.effectiveAt", { ns: "config", value: detail.effective_at ? formatDt(detail.effective_at) : "—" })}
-              {!isDraft ? (
-                <span className="text-amber-600 dark:text-amber-400"> - {t("riskCap.readOnlyHint", { ns: "config" })}</span>
-              ) : null}
-            </p>
-          ) : null}
-        </div>
-
-        {error ? <p className="text-sm text-destructive">{error}</p> : null}
-
-        <section className="space-y-3">
-          <h3 className="text-sm font-medium">{t("riskCap.defaultCap.title", { ns: "config" })}</h3>
+      <ConfigSection title={t("riskCap.defaultCap.title", { ns: "config" })}>
           <div className="flex flex-wrap items-end gap-2">
             <div className="grid gap-1">
               <Label htmlFor="default-cap">{t("riskCap.defaultCap.fieldLabel", { ns: "config" })}</Label>
@@ -401,22 +401,23 @@ export function RiskCapDocScreen() {
               </Button>
             ) : null}
           </div>
-        </section>
+      </ConfigSection>
 
-        <section className="space-y-3">
-          <div className="flex flex-wrap items-center justify-between gap-2">
-            <h3 className="text-sm font-medium">{t("riskCap.specialCaps.title", { ns: "config" })}</h3>
-            {isDraft ? (
-              <Button
-                type="button"
-                variant="outline"
-                disabled={saving}
-                onClick={() => setDraftRows((prev) => [...prev, newRow()])}
-              >
-                {t("riskCap.actions.addSpecialCap", { ns: "config" })}
-              </Button>
-            ) : null}
-          </div>
+      <ConfigSection
+        title={t("riskCap.specialCaps.title", { ns: "config" })}
+        actions={
+          isDraft ? (
+            <Button
+              type="button"
+              variant="outline"
+              disabled={saving}
+              onClick={() => setDraftRows((prev) => [...prev, newRow()])}
+            >
+              {t("riskCap.actions.addSpecialCap", { ns: "config" })}
+            </Button>
+          ) : null
+        }
+      >
           {loadingDetail ? (
             <p className="text-sm text-muted-foreground">{t("riskCap.loadingDetails", { ns: "config" })}</p>
           ) : specialRows.length === 0 ? (
@@ -494,10 +495,9 @@ export function RiskCapDocScreen() {
               </TableBody>
             </Table>
           )}
-        </section>
+      </ConfigSection>
 
-        <section className="space-y-3">
-          <h3 className="text-sm font-medium">{t("riskCap.occupancy.title", { ns: "config" })}</h3>
+      <ConfigSection title={t("riskCap.occupancy.title", { ns: "config" })}>
           <div className="flex flex-wrap gap-3 items-end">
             <div className="grid gap-1">
               <Label htmlFor="occ-search">{t("riskCap.occupancy.searchLabel", { ns: "config" })}</Label>
@@ -548,8 +548,7 @@ export function RiskCapDocScreen() {
                 ))}
               </TableBody>
             </Table>
-        </section>
-      </CardContent>
+      </ConfigSection>
 
       <Dialog open={syncOpen} onOpenChange={setSyncOpen}>
         <DialogContent showCloseButton className="sm:max-w-md">
@@ -569,6 +568,6 @@ export function RiskCapDocScreen() {
           </DialogFooter>
         </DialogContent>
       </Dialog>
-    </Card>
+    </ConfigDocPage>
   );
 }
diff --git a/src/modules/config/doc/wallet-config-doc-screen.tsx b/src/modules/config/doc/wallet-config-doc-screen.tsx
index e71a272..526d3c4 100644
--- a/src/modules/config/doc/wallet-config-doc-screen.tsx
+++ b/src/modules/config/doc/wallet-config-doc-screen.tsx
@@ -9,7 +9,7 @@ import {
   updateAdminSetting,
 } from "@/api/admin-settings";
 import { Button } from "@/components/ui/button";
-import { Card, CardContent, CardHeader, CardTitle } from "@/components/ui/card";
+import { ConfigDocPage } from "@/modules/config/config-doc-page";
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
 import { LotteryApiBizError } from "@/types/api/errors";
@@ -193,11 +193,6 @@ export function WalletConfigDocScreen({ embedded = false }: WalletConfigDocScree
   }
 
   return (
-    <Card>
-      <CardHeader>
-        <CardTitle>{t("wallet.title", { ns: "config" })}</CardTitle>
-      </CardHeader>
-      <CardContent className="space-y-6">{content}</CardContent>
-    </Card>
+    <ConfigDocPage title={t("wallet.title", { ns: "config" })}>{content}</ConfigDocPage>
   );
 }