@allbluecn/admin-app 0.1.0

package/src/routes/_nav/compliance/route.lazy.tsx

@@ -0,0 +1,184 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createLazyFileRoute } from '@tanstack/react-router'
+import { useQuery, useQueryClient } from '@tanstack/react-query'
+import { useServerFn } from '@tanstack/react-start'
+import { useTranslation } from 'react-i18next'
+import { toast } from 'sonner'
+import type React from 'react'
+import { listComplianceExportsFn, executeComplianceJobFn } from '@/server/serverFns/compliance'
+import { Badge } from '@/components/ui/badge'
+import { Button } from '@/components/ui/button'
+import { Loader2 } from 'lucide-react'
+
+export const Route = createLazyFileRoute('/_nav/compliance')({
+  pendingComponent: () => (
+    <div className="flex h-64 items-center justify-center">
+      <div className="size-8 animate-spin rounded-full border-2 border-primary border-t-transparent" />
+    </div>
+  ),
+  component: CompliancePage,
+})
+
+const QUERY_KEY = ['compliance-exports']
+
+function CompliancePage(): React.ReactElement {
+  const { t } = useTranslation('enterprise')
+  const queryClient = useQueryClient()
+
+  const { data } = useQuery({
+    queryKey: QUERY_KEY,
+    queryFn: () => listComplianceExportsFn({ data: { page: 1, pageSize: 20 } }),
+    staleTime: Infinity,
+  })
+
+  const items = data?.items ?? []
+  const total = data?.total ?? 0
+
+  const executeFn = useServerFn(executeComplianceJobFn)
+
+  const handleExecute = async (jobId: string) => {
+    try {
+      await executeFn({ data: { jobId } })
+      toast.success(t('compliance.export.toast.executed'))
+      await queryClient.invalidateQueries({ queryKey: QUERY_KEY })
+    } catch (err) {
+      toast.error(err instanceof Error ? err.message : t('compliance.export.toast.executeFailed'))
+    }
+  }
+
+  const isExpired = (job: { status: string; expiresAt: string | Date | null }) =>
+    job.status === 'completed' && job.expiresAt != null && new Date(job.expiresAt) < new Date()
+
+  const STATUS_KEYS: Record<string, string> = {
+    pending: 'pending',
+    processing: 'processing',
+    completed: 'completed',
+    failed: 'failed',
+    expired: 'expired',
+  }
+
+  const SCOPE_KEYS: Record<string, string> = {
+    user: 'user',
+    workspace: 'workspace',
+  }
+
+  const TYPE_KEYS: Record<string, string> = {
+    export: 'export',
+    delete: 'delete',
+  }
+
+  return (
+    <div className="space-y-4">
+      <div>
+        <h1 className="text-2xl font-bold">{t('compliance.export.title')}</h1>
+        <p className="text-sm text-muted-foreground mt-1">{t('compliance.export.subtitle', { count: total })}</p>
+      </div>
+
+      {items.length === 0 ? (
+        <div className="rounded-lg border border-border p-8 text-center text-muted-foreground">
+          {t('compliance.export.empty')}
+        </div>
+      ) : (
+        <div className="rounded-lg border border-border overflow-hidden">
+          <table className="w-full text-sm">
+            <thead>
+              <tr className="border-b border-border bg-muted/50">
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.type')}</th>
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.scope')}</th>
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.target')}</th>
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.status')}</th>
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.requester')}</th>
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.createdAt')}</th>
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.error')}</th>
+                <th className="p-3 text-left font-medium">{t('compliance.export.table.actions')}</th>
+              </tr>
+            </thead>
+            <tbody>
+              {items.map((item) => (
+                <tr key={item.id} className="border-b border-border last:border-0">
+                  <td className="p-3">
+                    <Badge>{t('compliance.export.type.' + (TYPE_KEYS[item.type] ?? item.type))}</Badge>
+                  </td>
+                  <td className="p-3">
+                    {t('compliance.export.scope.' + (SCOPE_KEYS[item.scope] ?? item.scope))}
+                  </td>
+                  <td className="p-3">{item.targetId.slice(0, 12)}</td>
+                  <td className="p-3">
+                    <span
+                      className={`inline-flex rounded-md px-2 py-0.5 text-xs ${
+                        item.status === 'completed'
+                          ? 'bg-green-500/10 text-green-600 dark:text-green-400'
+                          : item.status === 'failed'
+                            ? 'bg-destructive/10 text-destructive'
+                            : 'bg-muted text-muted-foreground'
+                      }`}
+                    >
+                      {t('compliance.export.status.' + (STATUS_KEYS[item.status] ?? item.status))}
+                    </span>
+                  </td>
+                  <td className="p-3">{item.requestedBy?.slice(0, 8) || '—'}</td>
+                  <td className="p-3">
+                    {new Date(item.createdAt).toLocaleDateString('zh-CN')}
+                  </td>
+                  <td className="p-3 text-muted-foreground truncate max-w-[150px]">
+                    {item.error || '—'}
+                  </td>
+                  <td className="p-3">
+                    <div className="flex gap-2">
+                      {item.status === 'pending' && (
+                        <Button
+                          variant="outline"
+                          size="sm"
+                          onClick={() => handleExecute(item.id)}
+                        >
+                          {t('compliance.export.actions.execute')}
+                        </Button>
+                      )}
+                      {item.status === 'processing' && (
+                        <span className="inline-flex items-center gap-1 text-xs text-muted-foreground">
+                          <Loader2 className="size-3 animate-spin" />
+                          {t('compliance.export.actions.processing')}
+                        </span>
+                      )}
+                      {item.status === 'completed' && !isExpired(item) && (
+                        <a
+                          href={`/api/compliance-download/${item.id}`}
+                          download={`allblue-export-${item.id}.json`}
+                        >
+                          <Button variant="outline" size="sm" asChild={false}>
+                            <span>{t('compliance.export.actions.download')}</span>
+                          </Button>
+                        </a>
+                      )}
+                      {isExpired(item) && (
+                        <span className="inline-flex items-center text-xs text-muted-foreground">
+                          {t('compliance.export.actions.expired')}
+                        </span>
+                      )}
+                    </div>
+                  </td>
+                </tr>
+              ))}
+            </tbody>
+          </table>
+        </div>
+      )}
+    </div>
+  )
+}

package/src/routes/_nav/compliance/route.tsx

@@ -0,0 +1,25 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createFileRoute } from '@tanstack/react-router'
+import { listComplianceExportsFn } from '@/server/serverFns/compliance'
+
+export const Route = createFileRoute('/_nav/compliance')({
+  loader: async () => {
+    return listComplianceExportsFn({ data: { page: 1, pageSize: 20 } })
+  },
+})

package/src/routes/_nav/components/route.lazy.tsx

@@ -0,0 +1,184 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { useState, useEffect } from 'react'
+import { createLazyFileRoute, useNavigate, useRouter } from '@tanstack/react-router'
+import { BUILTIN_COMPONENTS, registerComponents, unregisterComponent } from '@allbluecn/web-app/prototype'
+import { Plus, Search, Download } from 'lucide-react'
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import {
+  AlertDialog,
+  AlertDialogAction,
+  AlertDialogCancel,
+  AlertDialogContent,
+  AlertDialogDescription,
+  AlertDialogFooter,
+  AlertDialogHeader,
+  AlertDialogTitle,
+} from '@/components/ui/alert-dialog'
+import { cn } from '@/lib/utils'
+import { ComponentTable, type ComponentItem } from '@/components/component/component-table'
+import { ComponentFormDialog } from '@/components/component/component-form-dialog'
+import { ComponentImportDialog } from '@/components/component/component-import-dialog'
+import { deleteComponentFn } from '@/server/serverFns/components/mutations'
+import { toast } from '@/components/ui/sonner'
+
+const CATEGORY_TABS = [
+  { key: 'all', label: '全部' },
+  { key: '基础组件', label: '基础组件' },
+  { key: '内容区块', label: '内容区块' },
+  { key: '页面模版', label: '页面模版' },
+]
+
+export const Route = createLazyFileRoute('/_nav/components')({
+  pendingComponent: () => (
+    <div className="flex h-64 items-center justify-center">
+      <div className="size-8 animate-spin rounded-full border-2 border-primary border-t-transparent" />
+    </div>
+  ),
+  component: ComponentsPage,
+})
+
+function ComponentsPage() {
+  const { items, total } = Route.useLoaderData()
+  const { category, search: urlSearch } = Route.useSearch()
+  const navigate = useNavigate({ from: '/components' })
+  const router = useRouter()
+
+  useEffect(() => {
+    registerComponents(BUILTIN_COMPONENTS)
+    return () => { BUILTIN_COMPONENTS.forEach((c) => unregisterComponent(c.type)) }
+  }, [])
+
+  const [searchInput, setSearchInput] = useState(urlSearch ?? '')
+  const [createOpen, setCreateOpen] = useState(false)
+  const [editing, setEditing] = useState<ComponentItem | null>(null)
+  const [deleting, setDeleting] = useState<ComponentItem | null>(null)
+  const [importOpen, setImportOpen] = useState(false)
+
+  function updateSearch(patch: { category?: string; search?: string }) {
+    navigate({ search: (prev) => ({ ...prev, ...patch }) })
+  }
+
+  function handleSearchSubmit() {
+    const q = searchInput.trim()
+    updateSearch({ search: q || undefined })
+  }
+
+  async function handleDelete() {
+    if (!deleting) return
+    try {
+      await deleteComponentFn({ data: { id: deleting.id } })
+      toast.success('组件已删除')
+      setDeleting(null)
+      router.invalidate()
+    } catch (e) {
+      toast.error(e instanceof Error ? e.message : '删除失败')
+    }
+  }
+
+  return (
+    <div className="space-y-4 p-6">
+      <div className="flex items-center justify-between">
+        <div>
+          <h2 className="text-xl font-bold">组件管理</h2>
+          <p className="text-sm text-muted-foreground">共 {total} 个组件</p>
+        </div>
+        <div className="flex items-center gap-2">
+          <Button variant="outline" onClick={() => setImportOpen(true)}>
+            <Download className="mr-1 size-4" />
+            导入组件
+          </Button>
+          <Button onClick={() => setCreateOpen(true)}>
+            <Plus className="mr-1 size-4" />
+            新建组件
+          </Button>
+        </div>
+      </div>
+
+      <div className="flex items-center gap-2">
+        <div className="flex items-center gap-1">
+          {CATEGORY_TABS.map((tab) => (
+            <button
+              key={tab.key}
+              onClick={() => updateSearch({ category: tab.key === 'all' ? undefined : tab.key })}
+              className={cn(
+                'rounded-md px-3 py-1.5 text-sm transition-colors',
+                (category ?? 'all') === tab.key
+                  ? 'bg-primary text-primary-foreground'
+                  : 'text-muted-foreground hover:bg-muted',
+              )}
+            >
+              {tab.label}
+            </button>
+          ))}
+        </div>
+        <div className="relative ml-auto w-64">
+          <Search className="absolute left-2.5 top-1/2 size-4 -translate-y-1/2 text-muted-foreground" />
+          <Input
+            value={searchInput}
+            onChange={(e) => setSearchInput(e.target.value)}
+            onKeyDown={(e) => { if (e.key === 'Enter') handleSearchSubmit() }}
+            placeholder="搜索组件..."
+            className="pl-8"
+          />
+        </div>
+      </div>
+
+      <ComponentTable
+        items={items as unknown as ComponentItem[]}
+        onEdit={(item) => setEditing(item)}
+        onDelete={(item) => setDeleting(item)}
+      />
+
+      <ComponentFormDialog
+        open={createOpen}
+        onOpenChange={setCreateOpen}
+        component={null}
+        onSuccess={() => router.invalidate()}
+      />
+      <ComponentFormDialog
+        open={!!editing}
+        onOpenChange={(o) => !o && setEditing(null)}
+        component={editing}
+        onSuccess={() => router.invalidate()}
+      />
+
+      <ComponentImportDialog
+        open={importOpen}
+        onOpenChange={setImportOpen}
+        onSuccess={() => router.invalidate()}
+      />
+
+      <AlertDialog open={!!deleting} onOpenChange={(o) => !o && setDeleting(null)}>
+        <AlertDialogContent>
+          <AlertDialogHeader>
+            <AlertDialogTitle>删除组件「{deleting?.name}」？</AlertDialogTitle>
+            <AlertDialogDescription>
+              组件将被标记为已删除（软删除），不影响已使用该组件的原型页面。可在数据库中恢复。
+            </AlertDialogDescription>
+          </AlertDialogHeader>
+          <AlertDialogFooter>
+            <AlertDialogCancel>取消</AlertDialogCancel>
+            <AlertDialogAction onClick={handleDelete}>删除</AlertDialogAction>
+          </AlertDialogFooter>
+        </AlertDialogContent>
+      </AlertDialog>
+    </div>
+  )
+}

package/src/routes/_nav/components/route.tsx

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createFileRoute } from '@tanstack/react-router'
+import { z } from 'zod'
+import { listComponentsFn } from '@/server/serverFns/components/list'
+
+const componentSearchSchema = z.object({
+  search: z.string().optional(),
+  category: z.string().optional(),
+})
+
+export const Route = createFileRoute('/_nav/components')({
+  validateSearch: componentSearchSchema,
+  loaderDeps: ({ search }) => search,
+  loader: async ({ deps }) => {
+    return listComponentsFn({
+      data: {
+        page: 1,
+        pageSize: 50,
+        search: deps.search,
+        category: deps.category,
+      },
+    })
+  },
+})

package/src/routes/_nav/dashboard/route.lazy.tsx

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createLazyFileRoute } from '@tanstack/react-router'
+import { useTranslation } from 'react-i18next'
+
+export const Route = createLazyFileRoute('/_nav/dashboard')({
+  component: DashboardPage,
+})
+
+function DashboardPage() {
+  const { t } = useTranslation('common')
+  return (
+    <div className="p-6">
+      <h2 className="text-2xl font-bold">{t('dashboard.title')}</h2>
+      <p className="mt-2 text-muted-foreground">{t('dashboard.subtitle')}</p>
+    </div>
+  )
+}

package/src/routes/_nav/dashboard/route.tsx

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createFileRoute } from '@tanstack/react-router'
+
+export const Route = createFileRoute('/_nav/dashboard')({})

package/src/routes/_nav/dependencies/route.lazy.tsx

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { useState } from "react"
+import { useTranslation } from 'react-i18next'
+import { createLazyFileRoute } from "@tanstack/react-router"
+import { Boxes, Info } from "lucide-react"
+import type { ThirdPartyDependencyRow } from "@allbluecn/kernel"
+import { listDependenciesFn } from "@/server/serverFns/dependency/list"
+import { DependencyTable } from "@/components/dependency/dependency-table"
+import { PageHeader } from "@/components/common/page-header"
+
+export const Route = createLazyFileRoute("/_nav/dependencies")({
+  component: DependenciesPage,
+})
+
+function DependenciesPage() {
+  const { t } = useTranslation('common')
+  const ctx = Route.useRouteContext() as { dependencies?: ThirdPartyDependencyRow[] }
+  const [data, setData] = useState<ThirdPartyDependencyRow[]>(ctx.dependencies ?? [])
+
+  async function refetch() {
+    try {
+      const fresh = await listDependenciesFn({ data: { watchedOnly: false } })
+      setData(fresh)
+    } catch (e) {
+      console.error("[dependencies] refetch 失败", e)
+    }
+  }
+
+  return (
+    <div className="p-6 space-y-5">
+      <PageHeader
+        title={t('dependencies.title')}
+        description={t('dependencies.description')}
+        icon={Boxes}
+      />
+      <div className="flex items-start gap-2 rounded-md border border-blue-500/20 bg-blue-500/5 p-3 text-xs text-muted-foreground">
+        <Info className="mt-0.5 size-3.5 shrink-0 text-blue-500" />
+        <div>
+          {t('dependencies.hint.currentVersion')}
+          <code className="font-mono">apps/web</code>、
+          <code className="font-mono">apps/admin</code>、
+          <code className="font-mono">packages/*</code> {t('dependencies.hint.currentVersionSuffix')}
+          {t('dependencies.hint.latestVersion')}
+          {t('dependencies.hint.watchList')}
+        </div>
+      </div>
+      <DependencyTable data={data} onMutated={refetch} />
+    </div>
+  )
+}

package/src/routes/_nav/dependencies/route.tsx

@@ -0,0 +1,32 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createFileRoute } from "@tanstack/react-router"
+import { listDependenciesFn } from "@/server/serverFns/dependency/list"
+import type { ThirdPartyDependencyRow } from "@allbluecn/kernel"
+
+export const Route = createFileRoute("/_nav/dependencies")({
+  beforeLoad: async () => {
+    try {
+      const dependencies = await listDependenciesFn({ data: { watchedOnly: false } })
+      return { dependencies } satisfies { dependencies: ThirdPartyDependencyRow[] }
+    } catch (e) {
+      console.error("[admin/dependencies] 加载失败", e)
+      return { dependencies: [] as ThirdPartyDependencyRow[] }
+    }
+  },
+})

package/src/routes/_nav/developer-logs/route.lazy.tsx

@@ -0,0 +1,6 @@
+import { createLazyFileRoute } from '@tanstack/react-router'
+import { DeveloperLogPage } from '@/components/admin/developer-log'
+
+export const Route = createLazyFileRoute('/_nav/developer-logs')({
+  component: DeveloperLogPage,
+})

package/src/routes/_nav/developer-logs/route.tsx

@@ -0,0 +1,14 @@
+import { createFileRoute } from '@tanstack/react-router'
+import { listDeveloperLogsFn } from '@/server/serverFns/developer-logs'
+import type { DeveloperLogEntry } from '@allbluecn/kernel'
+
+export const Route = createFileRoute('/_nav/developer-logs')({
+  loader: async () => {
+    try {
+      const data = await listDeveloperLogsFn({ data: { page: 1, pageSize: 100 } })
+      return { entries: data.items, total: data.total }
+    } catch {
+      return { entries: [] as DeveloperLogEntry[], total: 0 }
+    }
+  },
+})

package/src/routes/_nav/docs/route.lazy.tsx

@@ -0,0 +1,30 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createLazyFileRoute } from '@tanstack/react-router'
+import { useTranslation } from 'react-i18next'
+import { FileText } from 'lucide-react'
+import { PlaceholderPage } from '@/components/common/placeholder-page'
+
+export const Route = createLazyFileRoute('/_nav/docs')({
+  component: DocsPage,
+})
+
+function DocsPage() {
+  const { t } = useTranslation('common')
+  return <PlaceholderPage title={t('docs.title')} icon={FileText} />
+}

package/src/routes/_nav/docs/route.tsx

@@ -0,0 +1,20 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { createFileRoute } from '@tanstack/react-router'
+
+export const Route = createFileRoute('/_nav/docs')({})