feat: 统一 Admin 后台设计语言

用中性灰底 + 单一强调色重做后台视觉,并集中到一套令牌:

- 新增 apps/admin/src/lib/theme.ts,通过 ConfigProvider 注入主题令牌
- 新增 apps/admin/src/styles/admin.css 与 AdminSection、MetricCard、StatusTag 组件
- 侧栏改白底浅色并补图标,顶栏改 56px 白底,内容区最大宽 1200px
- 全部页面接入状态标签,antd 原生彩色 Tag 与内联色值清零
- 登录与改密页、加载态骨架屏、错误提示条统一
- brand 页两个 Tab 统一为白卡片容器,消除双标题与宽度不一致

设计规范见 apps/admin/design.md。
This commit is contained in:
que01 committed 2026-10-14 10:54:05 +08:00
1 parent bb94d80e13
commit 2f26828f09
34 files changed
+2159 -922

No files matched your search

@@ -1,7 +1,9 @@
import { useEffect, useRef } from "react";
import { Alert, Button, Card, Collapse, Flex, Space, Tag, Tooltip, Typography, theme } from "antd";
import { LoadingOutlined } from "@ant-design/icons";
import { Button, Card, Collapse, Flex, Space, Tooltip, Typography } from "antd";
import type { MiniAppReleaseTask } from "@personal-brand/api-client";
import { ErrorNote } from "../../components/QueryState.js";
import { StatusTag } from "../../components/StatusTag.js";
import type { StatusTone } from "../../components/StatusTag.js";
type ReleaseStatus = MiniAppReleaseTask["status"];
@@ -13,18 +15,18 @@ function isStaleBuilding(task: MiniAppReleaseTask): boolean {
return !Number.isNaN(updatedAt) && Date.now() - updatedAt >= STALE_BUILDING_MS;
}
const statusView: Record<ReleaseStatus, { label: string; color: string; hint: string }> = {
built: { label: "待上传", color: "default", hint: "代码已构建,可上传到微信。" },
uploaded: { label: "已上传微信", color: "blue", hint: "请在微信后台上传体验版并提交审核。" },
const statusView: Record<ReleaseStatus, { label: string; tone: StatusTone; hint: string }> = {
built: { label: "待上传", tone: "neutral", hint: "代码已构建,可上传到微信。" },
uploaded: { label: "已上传微信", tone: "info", hint: "请在微信后台上传体验版并提交审核。" },
under_review: {
label: "审核中",
color: "processing",
tone: "warning",
hint: "等待微信审核结果,通过后回到本页标记。",
},
approved: { label: "审核通过", color: "cyan", hint: "审核已通过,确认无误后标记为已发布。" },
published: { label: "已发布", color: "green", hint: "该版本已发布,可继续编辑内容后再次上传。" },
rejected: { label: "已驳回", color: "volcano", hint: "微信驳回后需修改内容并重新构建上传。" },
failed: { label: "失败", color: "red", hint: "上次构建或上传失败,可直接重试。" },
approved: { label: "审核通过", tone: "success", hint: "审核已通过,确认无误后标记为已发布。" },
published: { label: "已发布", tone: "success", hint: "该版本已发布,可继续编辑内容后再次上传。" },
rejected: { label: "已驳回", tone: "error", hint: "微信驳回后需修改内容并重新构建上传。" },
failed: { label: "失败", tone: "error", hint: "上次构建或上传失败,可直接重试。" },
};
function formatTime(value: string): string {
@@ -50,7 +52,6 @@ export function MiniAppReleaseCard({
onUpload: () => void;
onStatusChange: (status: ReleaseStatus) => void;
}) {
const { token } = theme.useToken();
const logRef = useRef<HTMLPreElement>(null);
const logs = task.buildLogs ?? [];
const status = statusView[task.status];
@@ -104,72 +105,49 @@ export function MiniAppReleaseCard({
<Space direction="vertical" size={4}>
<Space wrap size={8} align="center">
<Typography.Text strong>品牌内容 v{task.version}</Typography.Text>
<Tag color={status.color}>{status.label}</Tag>
<StatusTag label={status.label} tone={status.tone} />
{building && (
<Tag icon={<LoadingOutlined />} color="orange">
{staleBuilding ? "构建已中断" : "构建中"}
</Tag>
<StatusTag tone="warning" label={staleBuilding ? "构建已中断" : "构建中"} />
)}
{task.weappUploadId && (
<Typography.Text type="secondary">微信版本 {task.weappUploadId}</Typography.Text>
)}
</Space>
<Typography.Text type="secondary" style={{ fontSize: 12 }}>
<span className="admin-text-xs">
{staleBuilding ? "超过 15 分钟没有新的构建输出,可能已中断;可直接重试。" : status.hint}
</Typography.Text>
</span>
<Tooltip title={`创建于 ${formatTime(task.createdAt)}`}>
<Typography.Text type="secondary" style={{ fontSize: 12 }}>
更新于 {formatTime(task.updatedAt)}
</Typography.Text>
<span className="admin-text-xs-quiet">更新于 {formatTime(task.updatedAt)}</span>
</Tooltip>
</Space>
{actions}
</Flex>
{task.error && <Alert type="error" showIcon message={task.error} style={{ marginTop: 12 }} />}
{task.error && (
<div className="admin-offset-top-md">
<ErrorNote error={new Error(task.error)} />
</div>
)}
{logs.length > 0 && (
<Collapse
ghost
size="small"
style={{ marginTop: 8 }}
className="admin-offset-top-sm"
{...(building || task.buildStatus === "failed" ? { defaultActiveKey: ["logs"] } : {})}
items={[
{
key: "logs",
label: (
<Typography.Text type="secondary" style={{ fontSize: 12 }}>
构建日志({logs.length} 行)
</Typography.Text>
),
label: <span className="admin-text-xs">构建日志({logs.length} 行)</span>,
children: (
<pre
ref={logRef}
style={{
margin: 0,
padding: 12,
maxHeight: 220,
overflow: "auto",
fontSize: 12,
lineHeight: 1.7,
borderRadius: token.borderRadius,
border: `1px solid ${token.colorBorderSecondary}`,
background: token.colorFillQuaternary,
}}
>
<pre ref={logRef} className="admin-log">
{logs.map((log, index) => (
<div
key={`${log.at}-${index}`}
style={{
color:
log.stream === "stderr" ? token.colorError : token.colorTextSecondary,
whiteSpace: "pre-wrap",
wordBreak: "break-all",
}}
className="admin-log__line"
data-stream={log.stream}
>
<Typography.Text type="secondary" style={{ fontSize: 12 }}>
{formatLogTime(log.at)}
</Typography.Text>
<span className="admin-log__time">{formatLogTime(log.at)}</span>
{" "}
{log.message}
</div>
@@ -4,7 +4,6 @@ import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
import {
Alert,
Button,
Card,
Divider,
Empty,
Input,
@@ -13,7 +12,6 @@ import {
Select,
Space,
Spin,
Tag,
Tabs,
Typography,
message,
@@ -21,7 +19,9 @@ import {
import type { BrandTemplateKey } from "@personal-brand/api-client";
import { createApiClient } from "../../lib/api.js";
import { AdminPageHeader } from "../../components/AdminPageHeader.js";
import { MutationError, QueryState } from "../../components/QueryState.js";
import { AdminSection } from "../../components/AdminSection.js";
import { ErrorNote, MutationError, QueryState } from "../../components/QueryState.js";
import { StatusTag, statusLabel } from "../../components/StatusTag.js";
import { MiniAppReleaseCard } from "./MiniAppReleaseCard.js";
const client = createApiClient();
@@ -268,17 +268,16 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
const contentTab = null;
const miniAppSettingsTab = (
<Space direction="vertical" size={24} style={{ width: "100%" }}>
<Card title="小程序上传配置">
<Typography.Paragraph type="secondary">
AppID 用于服务端调用微信官方上传工具;上传私钥保存前会使用 AES-256-GCM
加密。小程序产物目录由系统构建流程决定,不需要手动修改。
</Typography.Paragraph>
<div className="admin-stack admin-stack-lg">
<AdminSection
title="小程序上传配置"
description="AppID 用于服务端调用微信官方上传工具;上传私钥保存前会使用 AES-256-GCM 加密。"
>
{miniAppSettings.data?.buildError ? (
<Alert
type="warning"
showIcon
style={{ marginBottom: 12 }}
className="admin-offset-bottom"
message="小程序构建参数未就绪"
description={miniAppSettings.data.buildError}
/>
@@ -286,7 +285,7 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
<Alert
type="info"
showIcon
style={{ marginBottom: 12 }}
className="admin-offset-bottom"
message={`请求域名 ${miniAppSettings.data?.requestDomain ?? "未确认"}`}
description="该域名在构建时写入小程序包,必须与微信后台“开发设置 → 服务器域名 → request 合法域名”一致;不一致会导致小程序打开即加载失败。"
/>
@@ -337,7 +336,7 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
autoComplete="off"
spellCheck={false}
placeholder={"-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----"}
style={{ fontFamily: "monospace", fontSize: 12 }}
className="admin-code-input"
/>
</Form.Item>
<Space>
@@ -345,15 +344,15 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
保存上传配置
</Button>
{miniAppSettings.data?.hasStoredCredentials ? (
<Tag color="green">已加密保存上传凭据</Tag>
<StatusTag tone="success" label="已加密保存上传凭据" />
) : (
<Tag color="warning">未配置上传私钥</Tag>
<StatusTag tone="warning" label="未配置上传私钥" />
)}
</Space>
<MutationError error={saveMiniAppSettings.error} />
</Form>
</Card>
</Space>
</AdminSection>
</div>
);
return (
@@ -380,13 +379,15 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
]}
/>
{activeTab === "content" && (
<Space direction="vertical" size={24} style={{ width: "100%" }}>
<section>
<Typography.Title level={4}>1. 选择表达方式</Typography.Title>
<div className="admin-stack">
<AdminSection
title="选择表达方式"
description="行业模板决定内容结构,视觉模板决定小程序的排版风格。"
>
<Space wrap>
<Select
aria-label="行业模板"
style={{ width: 220 }}
className="admin-field-w-xl"
value={industryKey}
disabled={!canManageTemplate || Boolean(workspace.data?.installations.length)}
options={(catalog.data?.industries ?? []).map((item) => ({
@@ -397,7 +398,7 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
/>
<Select
aria-label="视觉模板"
style={{ width: 220 }}
className="admin-field-w-xl"
value={visualKey}
disabled={!canManageTemplate}
loading={selectVisual.isPending}
@@ -409,19 +410,20 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
)}
</Space>
{workspace.data?.installations.length ? (
<Typography.Paragraph type="secondary" style={{ marginTop: 8 }}>
<p className="admin-section-description admin-offset-top-sm">
当前品牌已安装主模板。模板版本与升级在高级设置中管理。
</Typography.Paragraph>
</p>
) : null}
<MutationError error={install.error || selectVisual.error} />
<Divider />
<Divider className="admin-divider" />
<Space wrap>
<Typography.Text>示例内容</Typography.Text>
{sample.isLoading && <Spin size="small" />}
{sample.data && (
<Tag color={sample.data.alreadyImported ? "green" : "blue"}>
{sample.data.alreadyImported ? "已导入" : "可导入"}
</Tag>
<StatusTag
tone={sample.data.alreadyImported ? "success" : "info"}
label={sample.data.alreadyImported ? "已导入" : "可导入"}
/>
)}
<Button
disabled={!canManageTemplate || !sample.data || sample.data.alreadyImported}
@@ -433,60 +435,106 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
{sample.isError && <Button onClick={() => void sample.refetch()}>重试</Button>}
</Space>
{sample.isError && (
<Alert
type="error"
message={sample.error instanceof Error ? sample.error.message : "示例内容加载失败"}
showIcon
style={{ marginTop: 8 }}
/>
<div className="admin-offset-top-sm">
<ErrorNote error={sample.error} onRetry={() => void sample.refetch()} />
</div>
)}
{sample.data && !sample.data.alreadyImported && (
<Typography.Paragraph type="secondary" style={{ marginTop: 8 }}>
<p className="admin-section-description admin-offset-top-sm">
将向草稿添加{" "}
{Object.entries(sample.data.counts)
.map(([key, count]) => `${key} ${count} 项`)
.join("、")}
;发布前请替换示例文案和图片。
</Typography.Paragraph>
</p>
)}
<MutationError error={importSample.error} />
</section>
</Space>
)}
{activeTab === "content" && (
<Space direction="vertical" size={24} style={{ width: "100%" }}>
<section>
<Typography.Title level={4}>3. 检查并发布</Typography.Title>
<Space wrap style={{ marginBottom: 12 }}>
<Tag color={currentRelease ? "green" : "default"}>
{currentRelease ? `已发布 v${currentRelease.version}` : "尚未发布"}
</Tag>
<Button onClick={() => void readiness.refetch()}>重新检查</Button>
</AdminSection>
<AdminSection
title="核对草稿内容"
description="此处核对的是待发布内容,不是小程序视觉预览。"
>
<ul className="admin-list">
<li className="admin-row">
<div className="admin-row-main">
<div className="admin-row-line">
<span className="admin-row-title">{brand.data?.name || "未命名品牌"}</span>
<span className="admin-row-meta">
{brand.data?.tagline || "尚未填写品牌定位"}
</span>
</div>
</div>
</li>
<li className="admin-row">
<div className="admin-row-main">
<div className="admin-row-line">
<span className="admin-row-title">已启用业务项</span>
<span className="admin-row-meta">
{draftOfferings.map((item) => item.name).join("、") || "无"}
</span>
</div>
</div>
</li>
<li className="admin-row">
<div className="admin-row-main">
<div className="admin-row-line">
<span className="admin-row-title">已启用咨询表单</span>
<span className="admin-row-meta">
{draftForms
.filter((item) => item.isEnabled)
.map((item) => item.name)
.join("、") || "无"}
</span>
</div>
</div>
</li>
</ul>
<Space wrap className="admin-offset-top">
<Button onClick={() => navigate("/admin/brand")}>编辑小程序页面</Button>
<Button onClick={() => navigate("/admin/services")}>编辑业务展示和详情</Button>
<Button onClick={() => navigate("/admin/trust")}>编辑信任证明</Button>
</Space>
<Space direction="vertical" style={{ width: "100%" }}>
</AdminSection>
<AdminSection
title="检查并发布"
extra={
<Space wrap>
<StatusTag
tone={currentRelease ? "success" : "neutral"}
label={currentRelease ? `已发布 v${currentRelease.version}` : "尚未发布"}
/>
<Button onClick={() => void readiness.refetch()}>重新检查</Button>
</Space>
}
>
<ul className="admin-list">
{(readiness.data?.checks ?? []).map((check) => (
<Space key={check.key}>
<Tag color={check.passed ? "success" : "warning"}>
{check.passed ? "已完成" : "待完善"}
</Tag>
<Typography.Text>{check.label}</Typography.Text>
{check.help ? (
<Typography.Text type="secondary">{check.help}</Typography.Text>
) : null}
{!check.passed && (
<li key={check.key} className="admin-row">
<div className="admin-row-main">
<div className="admin-row-line">
<StatusTag
tone={check.passed ? "success" : "warning"}
label={check.passed ? "已完成" : "待完善"}
/>
<span className="admin-row-title">{check.label}</span>
{check.help ? <span className="admin-row-meta">{check.help}</span> : null}
</div>
</div>
{!check.passed ? (
<Button
type="link"
size="small"
onClick={() =>
navigate(check.destination ?? destinations[check.key] ?? "/admin/overview")
}
>
去处理
</Button>
)}
</Space>
) : null}
</li>
))}
</Space>
<Space wrap style={{ marginTop: 16 }}>
</ul>
<Space wrap className="admin-offset-top">
<Button
type="primary"
disabled={!readiness.data?.ready}
@@ -501,85 +549,69 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
)}
</Space>
<MutationError error={publish.error || revoke.error} />
<Divider />
<Typography.Title level={5}>发布记录</Typography.Title>
<Divider className="admin-divider" />
<h3 className="admin-section-title">发布记录</h3>
{releases.data?.length ? (
<Space direction="vertical" style={{ width: "100%" }}>
<ul className="admin-list admin-offset-top-xs">
{releases.data.map((item) => (
<Space key={item.id} wrap>
<Typography.Text>v{item.version}</Typography.Text>
<Tag color={item.status === "published" ? "green" : "default"}>
{item.status}
</Tag>
<Typography.Text type="secondary">
{new Date(item.createdAt).toLocaleString("zh-CN")}
</Typography.Text>
{item.note && <Typography.Text>{item.note}</Typography.Text>}
{item.status === "superseded" && publishedHistory.length > 1 && (
<Button size="small" onClick={() => setRollbackVersion(item.version)}>
<li key={item.id} className="admin-row">
<div className="admin-row-main">
<div className="admin-row-line">
<span className="admin-row-title">v{item.version}</span>
<StatusTag
tone={item.status === "published" ? "success" : "neutral"}
label={statusLabel(item.status)}
/>
<span className="admin-row-meta">
{new Date(item.createdAt).toLocaleString("zh-CN")}
</span>
{item.note ? <span className="admin-row-meta">{item.note}</span> : null}
</div>
</div>
{item.status === "superseded" && publishedHistory.length > 1 ? (
<Button
type="link"
size="small"
onClick={() => setRollbackVersion(item.version)}
>
恢复此版本
</Button>
)}
</Space>
) : null}
</li>
))}
</Space>
</ul>
) : (
<Empty description="暂无发布记录" />
<Empty description="暂无发布记录" image={Empty.PRESENTED_IMAGE_SIMPLE} />
)}
<MutationError error={rollback.error} />
</section>
<section>
<Typography.Title level={4}>2. 核对草稿内容</Typography.Title>
<Typography.Paragraph type="secondary">
此处核对的是待发布内容,不是小程序视觉预览。
</Typography.Paragraph>
<Space direction="vertical" style={{ width: "100%" }}>
<Typography.Text strong>{brand.data?.name || "未命名品牌"}</Typography.Text>
<Typography.Text>{brand.data?.tagline || "尚未填写品牌定位"}</Typography.Text>
<Typography.Text>
已启用业务项:{draftOfferings.map((item) => item.name).join("、") || "无"}
</Typography.Text>
<Typography.Text>
已启用咨询表单:
{draftForms
.filter((item) => item.isEnabled)
.map((item) => item.name)
.join("、") || "无"}
</Typography.Text>
<Space wrap>
<Button onClick={() => navigate("/admin/brand")}>编辑小程序页面</Button>
<Button onClick={() => navigate("/admin/services")}>编辑业务展示和详情</Button>
<Button onClick={() => navigate("/admin/trust")}>编辑信任证明</Button>
</Space>
</Space>
</section>
</Space>
</AdminSection>
</div>
)}
{activeTab === "miniapp" && (
<Space direction="vertical" size={24} style={{ width: "100%" }}>
<section>
<Typography.Title level={4}>小程序代码发布</Typography.Title>
<Typography.Paragraph type="secondary">
使用微信官方 miniprogram-ci 上传代码;审核与发布状态需按微信平台结果人工确认。
</Typography.Paragraph>
<Space wrap style={{ marginBottom: 12 }}>
<Button
type="primary"
disabled={!currentRelease}
loading={uploadLatestMiniAppRelease.isPending}
onClick={() => uploadLatestMiniAppRelease.mutate()}
>
上传当前版本到微信
</Button>
{miniAppSettings.data?.hasStoredCredentials ? (
<Tag color="green">已配置上传凭据</Tag>
) : (
<Tag color="warning">未配置上传凭据</Tag>
)}
</Space>
<Divider />
<div className="admin-stack admin-stack-lg">
<AdminSection
title="小程序代码发布"
description="使用微信官方工具上传代码;审核与发布状态需按微信平台结果人工确认。"
extra={
<Space wrap>
<Button
type="primary"
disabled={!currentRelease}
loading={uploadLatestMiniAppRelease.isPending}
onClick={() => uploadLatestMiniAppRelease.mutate()}
>
上传当前版本到微信
</Button>
{miniAppSettings.data?.hasStoredCredentials ? (
<StatusTag tone="success" label="已配置上传凭据" />
) : (
<StatusTag tone="warning" label="未配置上传凭据" />
)}
</Space>
}
>
{miniAppReleases.data?.length ? (
<Space direction="vertical" size={12} style={{ width: "100%" }}>
<div className="admin-stack admin-stack-tight">
{miniAppReleases.data.map((task) => (
<MiniAppReleaseCard
key={task.id}
@@ -589,12 +621,12 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
onStatusChange={(status) => updateMiniAppStatus.mutate({ id: task.id, status })}
/>
))}
</Space>
</div>
) : (
<Empty description="暂无小程序发布任务" />
<Empty description="暂无小程序发布任务" image={Empty.PRESENTED_IMAGE_SIMPLE} />
)}
</section>
</Space>
</AdminSection>
</div>
)}
<Modal
title={confirmAction === "revoke" ? "确认撤回品牌" : "确认发布品牌"}
@@ -611,7 +643,7 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
message="撤回后,小程序将显示品牌尚未发布,新的咨询和预约会停止受理。"
/>
) : (
<Space direction="vertical" style={{ width: "100%" }}>
<div className="admin-stack">
<Typography.Text>当前草稿将成为品牌新的公开版本。</Typography.Text>
<Input
value={note}
@@ -619,7 +651,7 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
placeholder="发布备注(可选)"
maxLength={200}
/>
</Space>
</div>
)}
</Modal>
<Modal