feat: 完善模板驱动的品牌内容工作台

This commit is contained in:
que01 committed 2026-09-25 05:21:42 +08:00
1 parent 77224ea51f
commit dd55af8d73
46 files changed
+2204 -295

No files matched your search

+1
View File
@@ -13,6 +13,7 @@
"scripts": {
"build": "pnpm --filter @personal-brand/api-client build && vite build",
"dev": "pnpm --filter @personal-brand/api-client build && vite",
"test": "node --experimental-strip-types --test test/*.test.mjs",
"lint": "eslint .",
"typecheck": "tsc -p tsconfig.json --noEmit",
"clean": "rimraf dist"
+8 -45
View File
@@ -7,24 +7,20 @@ import { ImageUrlField } from "../../components/ImageUrlField.js";
import { MutationError, QueryState } from "../../components/QueryState.js";
import { PresentationEditor } from "./PresentationEditor.js";
function textValue(value: unknown): string {
return typeof value === "string" ? value : "";
}
export function BrandPage() {
const client = createApiClient();
const queryClient = useQueryClient();
const [form] = Form.useForm<BrandProfile>();
const brand = useQuery({ queryKey: ["admin-brand"], queryFn: () => client.getAdminBrand() });
const workspace = useQuery({
queryKey: ["admin-workspace"],
queryFn: () => client.getAdminWorkspace(),
});
const template = useQuery({
queryKey: ["template", brand.data?.templateKey],
queryFn: () => client.getPublicTemplate(brand.data!.templateKey),
enabled: Boolean(brand.data?.templateKey),
});
const runtime = useQuery({
queryKey: ["public-runtime-workspace"],
queryFn: () => client.getPublicWorkspace(),
});
const save = useMutation({
mutationFn: (values: Partial<BrandProfile>) => client.updateAdminBrand(values),
onSuccess: () => {
@@ -148,43 +144,10 @@ export function BrandPage() {
</Space>
</Form>
<PresentationEditor
initialValue={{
identity: {
founder: textValue(brand.data.config?.founder),
title: textValue(brand.data.config?.title),
slogan: textValue(brand.data.config?.slogan),
phone: textValue(brand.data.config?.phone),
wechat: textValue(brand.data.config?.wechat),
studioAddress: textValue(brand.data.config?.studioAddress),
},
...((brand.data.config?.visualPresentation as {
home?: Record<string, string>;
offerings?: Record<string, string>;
detail?: Record<string, string>;
profile?: Record<string, string>;
inquiry?: Record<string, string>;
success?: Record<string, string>;
records?: Record<string, string>;
}) ?? {}),
}}
runtimeValue={
runtime.data?.brand
? {
identity: {
founder: textValue(runtime.data.brand.config?.founder),
title: textValue(runtime.data.brand.config?.title),
slogan: textValue(runtime.data.brand.config?.slogan),
},
...((runtime.data.brand.config?.visualPresentation as {
home?: Record<string, string>;
inquiry?: Record<string, string>;
profile?: Record<string, string>;
}) ?? {}),
}
: undefined
}
runtimeLoading={runtime.isLoading}
runtimeError={runtime.error}
templateContent={workspace.data?.templateContent}
config={brand.data.config}
loading={workspace.isLoading}
error={workspace.error}
/>
</Col>
<Col xs={24} xl={9}>
@@ -1,189 +1,155 @@
import { Alert, Button, Card, Col, Form, Input, Row, Space, Typography, message } from "antd";
import {
Alert,
Button,
Card,
Col,
Form,
Input,
InputNumber,
Row,
Space,
Typography,
message,
} from "antd";
import { useMutation, useQueryClient } from "@tanstack/react-query";
import { useEffect } from "react";
import { useEffect, useMemo } from "react";
import type { AdminTemplateContent, TemplateAdminField } from "@personal-brand/api-client";
import { createApiClient } from "../../lib/api.js";
import { ImageUrlField } from "../../components/ImageUrlField.js";
import { MutationError } from "../../components/QueryState.js";
import {
applyPresentationValues,
presentationFieldName,
readPresentationValue,
type PresentationValues,
} from "./presentation-bindings.js";
interface PresentationEditorProps {
initialValue: PresentationFormValues;
runtimeValue?: PresentationFormValues | undefined;
runtimeLoading?: boolean | undefined;
runtimeError?: unknown;
templateContent: AdminTemplateContent | null | undefined;
config: Record<string, unknown> | null | undefined;
loading?: boolean;
error?: unknown;
}
type PresentationFormValues = {
identity?: Record<string, string>;
home?: Record<string, string>;
offerings?: Record<string, string>;
detail?: Record<string, string>;
profile?: Record<string, string>;
inquiry?: Record<string, string>;
success?: Record<string, string>;
records?: Record<string, string>;
};
function renderField(field: TemplateAdminField) {
if (field.input === "textarea")
return (
<Input.TextArea
rows={3}
maxLength={field.maxLength}
showCount={!!field.maxLength}
placeholder={field.placeholder}
/>
);
if (field.input === "image")
return <ImageUrlField {...(field.placeholder ? { placeholder: field.placeholder } : {})} />;
if (field.input === "number")
return <InputNumber style={{ width: "100%" }} placeholder={field.placeholder} />;
return (
<Input
type={field.input === "phone" ? "tel" : "text"}
maxLength={field.maxLength}
placeholder={field.placeholder}
/>
);
}
export function PresentationEditor({
initialValue,
runtimeValue,
runtimeLoading,
runtimeError,
templateContent,
config,
loading,
error,
}: PresentationEditorProps) {
const [form] = Form.useForm<PresentationFormValues>();
const [form] = Form.useForm<PresentationValues>();
const queryClient = useQueryClient();
const sections = templateContent?.admin.sections ?? [];
const initialValues = useMemo(() => {
const values: PresentationValues = {};
for (const section of sections) {
for (const field of section.fields) {
values[presentationFieldName(section.key, field.key)] = readPresentationValue(
config,
field.binding,
);
}
}
return values;
}, [config, sections]);
const save = useMutation({
mutationFn: (values: PresentationFormValues) =>
createApiClient().updateAdminBrandPresentation(values),
mutationFn: (values: PresentationValues) => {
const nextConfig = applyPresentationValues(config, sections, values);
return createApiClient().updateAdminBrand({ config: nextConfig });
},
onSuccess: () => {
message.success("页面表达已保存,小程序将使用最新内容");
message.success("页面内容已保存,小程序将使用最新内容");
void queryClient.invalidateQueries({ queryKey: ["admin-brand"] });
void queryClient.invalidateQueries({ queryKey: ["admin-workspace"] });
void queryClient.invalidateQueries({ queryKey: ["public-runtime-workspace"] });
void queryClient.invalidateQueries({ queryKey: ["publication-readiness"] });
},
});
useEffect(() => {
form.setFieldsValue(initialValue);
}, [form, initialValue]);
form.setFieldsValue(initialValues);
}, [form, initialValues]);
return (
<Card
title="小程序页面表达"
style={{ marginTop: 24 }}
extra={<Typography.Text type="secondary">普通用户配置</Typography.Text>}
>
<Card title="小程序页面内容" style={{ marginTop: 24 }}>
<Typography.Paragraph type="secondary">
这里的内容会显示在小程序中。只填写你希望访客看到的话,不需要理解模板或技术配置。
编辑访客在小程序中看到的文字和图片。不同模板会提供适合本行业的内容项目。
</Typography.Paragraph>
{runtimeLoading ? <Alert type="info" showIcon message="正在读取小程序当前内容" /> : null}
{runtimeError ? (
<Alert type="warning" showIcon message="小程序当前内容暂时无法读取,保存后可重新加载。" />
) : runtimeValue ? (
<Card size="small" title="小程序当前已生效内容" style={{ marginBottom: 16 }}>
<Typography.Text strong>
{runtimeValue.identity?.founder || "尚未设置主理人 / 老板姓名"}
</Typography.Text>
{runtimeValue.identity?.title ? (
<Typography.Text type="secondary"> · {runtimeValue.identity.title}</Typography.Text>
) : null}
<Typography.Paragraph strong>
{runtimeValue.home?.proofTitle || "尚未设置信任介绍标题"}
</Typography.Paragraph>
<Typography.Paragraph type="secondary">
{runtimeValue.inquiry?.subtitle || "尚未设置咨询说明"}
</Typography.Paragraph>
<Typography.Text type="secondary">
咨询按钮:{runtimeValue.inquiry?.submitLabel || "未设置"} · 记录入口:
{runtimeValue.profile?.recordsTitle || "未设置"}
</Typography.Text>
</Card>
{loading ? <Alert type="info" showIcon message="正在读取当前模板的编辑项目" /> : null}
{error ? (
<Alert type="warning" showIcon message="模板编辑项目读取失败,请刷新后重试。" />
) : null}
{!loading && !error && !templateContent ? (
<Alert type="warning" showIcon message="当前模板暂未提供可编辑的页面内容。" />
) : null}
{templateContent ? (
<>
<Typography.Title level={5}>{templateContent.displayName}</Typography.Title>
<Form
form={form}
layout="vertical"
initialValues={initialValues}
onFinish={(values) => save.mutate(values)}
>
{sections.map((section) => (
<Card
key={section.key}
size="small"
title={section.title}
style={{ marginBottom: 16 }}
>
<Typography.Paragraph type="secondary">{section.description}</Typography.Paragraph>
<Row gutter={16}>
{section.fields.map((field) => (
<Col key={field.key} xs={24} md={field.input === "textarea" ? 24 : 12}>
<Form.Item
name={presentationFieldName(section.key, field.key)}
label={field.label}
{...(field.help ? { help: field.help } : {})}
{...(field.required
? { rules: [{ required: true, message: `请填写${field.label}` }] }
: {})}
>
{renderField(field)}
</Form.Item>
</Col>
))}
</Row>
</Card>
))}
<Space direction="vertical" style={{ width: "100%" }}>
<MutationError error={save.error} />
<Button type="primary" htmlType="submit" loading={save.isPending}>
保存页面内容
</Button>
</Space>
</Form>
</>
) : null}
<Form
form={form}
layout="vertical"
initialValues={initialValue}
onFinish={(values) => save.mutate(values)}
>
<Card size="small" title="主理人信息" style={{ marginBottom: 16 }}>
<Typography.Paragraph type="secondary">
访客需要先知道是谁在提供服务。这里填写主理人或老板的公开信息。
</Typography.Paragraph>
<Row gutter={16}>
<Col xs={24} md={12}>
<Form.Item name={["identity", "founder"]} label="主理人 / 老板姓名">
<Input placeholder="例如:林然" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["identity", "title"]} label="身份或职位">
<Input placeholder="例如:品牌顾问 / 工作室主理人" />
</Form.Item>
</Col>
<Col xs={24}>
<Form.Item name={["identity", "slogan"]} label="主理人希望传达的一句话">
<Input placeholder="例如:认真做好每一次定制" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["identity", "phone"]} label="公开联系电话">
<Input placeholder="选填" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["identity", "wechat"]} label="公开微信号">
<Input placeholder="选填" />
</Form.Item>
</Col>
<Col xs={24}>
<Form.Item name={["identity", "studioAddress"]} label="工作地点或服务范围">
<Input placeholder="例如:杭州及周边地区 / 某某工作室" />
</Form.Item>
</Col>
</Row>
</Card>
<Card size="small" title="首页" style={{ marginBottom: 16 }}>
<Row gutter={16}>
<Col xs={24} md={12}>
<Form.Item name={["home", "founderBadge"]} label="主理人标签">
<Input placeholder="例如:亲自主理 / 10 年经验" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["home", "proofTitle"]} label="信任介绍标题">
<Input placeholder="例如:用经历和作品建立信任" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["home", "worksTitle"]} label="作品区域标题">
<Input placeholder="例如:精选作品" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["home", "flowTitle"]} label="合作流程标题">
<Input placeholder="例如:从沟通到交付" />
</Form.Item>
</Col>
</Row>
</Card>
<Card size="small" title="咨询页面" style={{ marginBottom: 16 }}>
<Form.Item name={["inquiry", "title"]} label="页面标题">
<Input placeholder="例如:告诉我你的需求" />
</Form.Item>
<Form.Item name={["inquiry", "subtitle"]} label="说明文字">
<Input.TextArea
rows={2}
showCount
maxLength={120}
placeholder="告诉访客提交后会发生什么。"
/>
</Form.Item>
<Form.Item name={["inquiry", "submitLabel"]} label="提交按钮文字">
<Input placeholder="例如:提交咨询" />
</Form.Item>
</Card>
<Card size="small" title="主理人与我" style={{ marginBottom: 16 }}>
<Row gutter={16}>
<Col xs={24} md={12}>
<Form.Item name={["profile", "recordsTitle"]} label="咨询记录入口标题">
<Input placeholder="例如:我的咨询记录" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["profile", "coverageTitle"]} label="服务范围标题">
<Input placeholder="例如:服务范围与合作方式" />
</Form.Item>
</Col>
<Col xs={24} md={12}>
<Form.Item name={["profile", "warrantyTitle"]} label="承诺标题">
<Input placeholder="例如:我的服务承诺" />
</Form.Item>
</Col>
</Row>
</Card>
<Space direction="vertical" style={{ width: "100%" }}>
<MutationError error={save.error} />
<Button type="primary" htmlType="submit" loading={save.isPending}>
保存页面表达
</Button>
</Space>
</Form>
</Card>
);
}
@@ -0,0 +1,74 @@
export type PresentationField = {
key: string;
binding: string;
};
export type PresentationSection = {
key: string;
fields: PresentationField[];
};
export type PresentationValues = Record<string, string | number | null | undefined>;
function asObject(value: unknown): Record<string, unknown> {
return value && typeof value === "object" && !Array.isArray(value)
? (value as Record<string, unknown>)
: {};
}
function safePath(binding: string): string[] | null {
if (!binding.startsWith("brand.config.")) return null;
const path = binding.slice("brand.config.".length).split(".");
if (path.some((part) => !part || ["__proto__", "prototype", "constructor"].includes(part)))
return null;
return path;
}
export function presentationFieldName(sectionKey: string, fieldKey: string): string {
return `${sectionKey}:${fieldKey}`;
}
export function readPresentationValue(
config: Record<string, unknown> | null | undefined,
binding: string,
): string | number | undefined {
const path = safePath(binding);
if (!path) return undefined;
let value: unknown = asObject(config);
for (const part of path) value = asObject(value)[part];
return typeof value === "string" || typeof value === "number" ? value : undefined;
}
function writePath(
source: Record<string, unknown>,
path: string[],
value: string | number | null | undefined,
): Record<string, unknown> {
const [head, ...tail] = path;
if (!head) return source;
if (!tail.length) return { ...source, [head]: value ?? "" };
return {
...source,
[head]: writePath(asObject(source[head]), tail, value),
};
}
export function applyPresentationValues(
config: Record<string, unknown> | null | undefined,
sections: PresentationSection[],
values: PresentationValues,
): Record<string, unknown> {
let nextConfig = { ...asObject(config) };
for (const section of sections) {
for (const field of section.fields) {
const path = safePath(field.binding);
if (!path) continue;
nextConfig = writePath(
nextConfig,
path,
values[presentationFieldName(section.key, field.key)],
);
}
}
return nextConfig;
}
@@ -281,10 +281,15 @@ export function PublicationPage({ canManageTemplate }: { canManageTemplate: bool
{check.passed ? "已完成" : "待完善"}
</Tag>
<Typography.Text>{check.label}</Typography.Text>
{check.help ? (
<Typography.Text type="secondary">{check.help}</Typography.Text>
) : null}
{!check.passed && (
<Button
type="link"
onClick={() => navigate(destinations[check.key] ?? "/admin/overview")}
onClick={() =>
navigate(check.destination ?? destinations[check.key] ?? "/admin/overview")
}
>
去处理
</Button>
@@ -0,0 +1,58 @@
import assert from "node:assert/strict";
import {
applyPresentationValues,
presentationFieldName,
readPresentationValue,
} from "../src/features/brand/presentation-bindings.ts";
const config = {
founder: "阿成",
visualPresentation: {
home: { worksTitle: "原标题", preserveMe: "保留" },
inquiry: { subtitle: "原说明" },
},
unrelatedSetting: true,
};
const sections = [
{
key: "home",
fields: [
{ key: "founder", binding: "brand.config.founder" },
{ key: "worksTitle", binding: "brand.config.visualPresentation.home.worksTitle" },
],
},
];
const next = applyPresentationValues(config, sections, {
[presentationFieldName("home", "founder")]: "阿成主理人",
[presentationFieldName("home", "worksTitle")]: "今日套餐",
});
assert.equal(readPresentationValue(next, "brand.config.founder"), "阿成主理人");
assert.equal(
readPresentationValue(next, "brand.config.visualPresentation.home.worksTitle"),
"今日套餐",
);
assert.equal(next.visualPresentation.home.preserveMe, "保留");
assert.equal(next.visualPresentation.inquiry.subtitle, "原说明");
assert.equal(next.unrelatedSetting, true);
assert.equal(config.founder, "阿成");
const unsafe = applyPresentationValues(
{ founder: "原主理人" },
[
{
key: "unsafe",
fields: [
{ key: "tenant", binding: "brand.id" },
{ key: "prototype", binding: "brand.config.__proto__.polluted" },
],
},
],
{
[presentationFieldName("unsafe", "tenant")]: "other-brand",
[presentationFieldName("unsafe", "prototype")]: "yes",
},
);
assert.deepEqual(unsafe, { founder: "原主理人" });
assert.equal({}.polluted, undefined);