feat: 让模板声明信任内容编辑语义
This commit is contained in:
1 parent
6d7fae95b3
commit
e3a4074d8e
12 files changed
+159
-13
No files matched your search
@@ -8,6 +8,8 @@
|
|||||||
- 阿成首页、出摊服务、主理人页面消费 `trustItems`;无对应类型时不渲染区块。
|
- 阿成首页、出摊服务、主理人页面消费 `trustItems`;无对应类型时不渲染区块。
|
||||||
- `AGENTS.md` 固化模板 package 与品牌数据库的边界,禁止用全局 seed 承载模板集合。
|
- `AGENTS.md` 固化模板 package 与品牌数据库的边界,禁止用全局 seed 承载模板集合。
|
||||||
- Admin 信任内容页面改用通用中文类型和逐行填写说明,不再出现餐饮专属管理术语;演示 seed 与模板 sampleContent 已移除旧 `profile/portfolio` 类型。
|
- Admin 信任内容页面改用通用中文类型和逐行填写说明,不再出现餐饮专属管理术语;演示 seed 与模板 sampleContent 已移除旧 `profile/portfolio` 类型。
|
||||||
|
- 模板 manifest 现在可以声明信任类型的行业化 label、help 和 placeholder;Admin 通过 workspace contract 消费这些声明,平台不再硬编码行业文案。
|
||||||
|
- 新增迁移,将历史 `profile/experience/portfolio/testimonial` 数据归一化到 `credential/case`。
|
||||||
|
|
||||||
## 验证
|
## 验证
|
||||||
|
|
||||||
@@ -15,3 +17,4 @@
|
|||||||
- miniapp fixture、visual fixture、template compiler:通过。
|
- miniapp fixture、visual fixture、template compiler:通过。
|
||||||
- typecheck、lint:通过。
|
- typecheck、lint:通过。
|
||||||
- Admin typecheck、production build、template catalog validation:通过。
|
- Admin typecheck、production build、template catalog validation:通过。
|
||||||
|
- API integration:37/37 通过,包含模板化信任类型声明和历史类型迁移。
|
||||||
@@ -51,6 +51,17 @@ const types = [
|
|||||||
help: "说明回复时间、交付承诺、售后方式或合作预期。",
|
help: "说明回复时间、交付承诺、售后方式或合作预期。",
|
||||||
},
|
},
|
||||||
];
|
];
|
||||||
|
type TrustTypeOption = {
|
||||||
|
type: string;
|
||||||
|
label: string;
|
||||||
|
help?: string;
|
||||||
|
placeholder?: string;
|
||||||
|
};
|
||||||
|
const fallbackTypes: TrustTypeOption[] = types.map(({ value, label, help }) => ({
|
||||||
|
type: value,
|
||||||
|
label,
|
||||||
|
help,
|
||||||
|
}));
|
||||||
|
|
||||||
export function TrustContentPage() {
|
export function TrustContentPage() {
|
||||||
const client = createApiClient();
|
const client = createApiClient();
|
||||||
@@ -58,10 +69,20 @@ export function TrustContentPage() {
|
|||||||
const [editing, setEditing] = useState<TrustContent | null>(null);
|
const [editing, setEditing] = useState<TrustContent | null>(null);
|
||||||
const [open, setOpen] = useState(false);
|
const [open, setOpen] = useState(false);
|
||||||
const [form] = Form.useForm<TrustContentInput>();
|
const [form] = Form.useForm<TrustContentInput>();
|
||||||
|
const selectedType = Form.useWatch("type", form);
|
||||||
const query = useQuery({
|
const query = useQuery({
|
||||||
queryKey: ["trust-content"],
|
queryKey: ["trust-content"],
|
||||||
queryFn: () => client.listAdminTrustContent(),
|
queryFn: () => client.listAdminTrustContent(),
|
||||||
});
|
});
|
||||||
|
const workspace = useQuery({
|
||||||
|
queryKey: ["admin-workspace-trust-types"],
|
||||||
|
queryFn: () => client.getAdminWorkspace(),
|
||||||
|
});
|
||||||
|
const availableTypes: TrustTypeOption[] = workspace.data?.templateContent?.trustContentTypes
|
||||||
|
?.length
|
||||||
|
? workspace.data.templateContent.trustContentTypes
|
||||||
|
: fallbackTypes;
|
||||||
|
const selectedTypeMeta = availableTypes.find((item) => item.type === selectedType);
|
||||||
const save = useMutation({
|
const save = useMutation({
|
||||||
mutationFn: (values: TrustContentInput) =>
|
mutationFn: (values: TrustContentInput) =>
|
||||||
editing
|
editing
|
||||||
@@ -99,7 +120,11 @@ export function TrustContentPage() {
|
|||||||
);
|
);
|
||||||
};
|
};
|
||||||
return (
|
return (
|
||||||
<QueryState loading={query.isLoading} error={query.error} onRetry={() => void query.refetch()}>
|
<QueryState
|
||||||
|
loading={query.isLoading || workspace.isLoading}
|
||||||
|
error={query.error || workspace.error}
|
||||||
|
onRetry={() => void Promise.all([query.refetch(), workspace.refetch()])}
|
||||||
|
>
|
||||||
<AdminPageHeader
|
<AdminPageHeader
|
||||||
title="信任内容"
|
title="信任内容"
|
||||||
description="用经历、案例、资历、流程和反馈,让访客知道为什么可以信任你。"
|
description="用经历、案例、资历、流程和反馈,让访客知道为什么可以信任你。"
|
||||||
@@ -171,7 +196,9 @@ export function TrustContentPage() {
|
|||||||
>
|
>
|
||||||
<Form form={form} layout="vertical" onFinish={(values) => save.mutate(values)}>
|
<Form form={form} layout="vertical" onFinish={(values) => save.mutate(values)}>
|
||||||
<Form.Item name="type" label="内容用途" rules={[{ required: true }]}>
|
<Form.Item name="type" label="内容用途" rules={[{ required: true }]}>
|
||||||
<Select options={types} />
|
<Select
|
||||||
|
options={availableTypes.map((item) => ({ value: item.type, label: item.label }))}
|
||||||
|
/>
|
||||||
</Form.Item>
|
</Form.Item>
|
||||||
<Form.Item name="title" label="标题" rules={[{ required: true }]}>
|
<Form.Item name="title" label="标题" rules={[{ required: true }]}>
|
||||||
<Input placeholder="例如:服务过 30+ 位独立创作者" />
|
<Input placeholder="例如:服务过 30+ 位独立创作者" />
|
||||||
@@ -182,14 +209,16 @@ export function TrustContentPage() {
|
|||||||
<Form.Item
|
<Form.Item
|
||||||
name="content"
|
name="content"
|
||||||
label="详细内容"
|
label="详细内容"
|
||||||
help="每行写一项,页面会按模板样式展示。不要填写 HTML 或代码。"
|
help={
|
||||||
|
selectedTypeMeta?.help ?? "每行写一项,页面会按模板样式展示。不要填写 HTML 或代码。"
|
||||||
|
}
|
||||||
rules={[{ required: true }]}
|
rules={[{ required: true }]}
|
||||||
>
|
>
|
||||||
<Input.TextArea
|
<Input.TextArea
|
||||||
rows={8}
|
rows={8}
|
||||||
showCount
|
showCount
|
||||||
maxLength={2000}
|
maxLength={2000}
|
||||||
placeholder="例如:\n周一至周五 17:00 - 22:30\n周末接受团体预约"
|
placeholder={selectedTypeMeta?.placeholder ?? "例如:\n第一项内容\n第二项内容"}
|
||||||
/>
|
/>
|
||||||
</Form.Item>
|
</Form.Item>
|
||||||
<Form.Item
|
<Form.Item
|
||||||
|
|||||||
@@ -250,14 +250,8 @@ export function WorkspacePage() {
|
|||||||
<Space direction="vertical" style={{ width: "100%" }}>
|
<Space direction="vertical" style={{ width: "100%" }}>
|
||||||
<Space wrap>
|
<Space wrap>
|
||||||
<Tag color="blue">Schema {runtimeQuery.data?.schemaVersion ?? "-"}</Tag>
|
<Tag color="blue">Schema {runtimeQuery.data?.schemaVersion ?? "-"}</Tag>
|
||||||
<Tag>模块 {runtimeQuery.data?.runtimeModules?.length ?? 0}</Tag>
|
<Tag>能力 {runtimeQuery.data?.capabilities?.length ?? 0}</Tag>
|
||||||
<Tag>能力 {runtimeQuery.data?.runtimeCapabilities?.length ?? 0}</Tag>
|
<Tag>公开业务 {runtimeQuery.data?.offerings?.length ?? 0}</Tag>
|
||||||
<Tag>
|
|
||||||
公开业务{" "}
|
|
||||||
{runtimeQuery.data?.runtimeOfferings?.length ??
|
|
||||||
runtimeQuery.data?.offerings?.length ??
|
|
||||||
0}
|
|
||||||
</Tag>
|
|
||||||
<Tag>插件 {runtimeQuery.data?.plugins?.length ?? 0}</Tag>
|
<Tag>插件 {runtimeQuery.data?.plugins?.length ?? 0}</Tag>
|
||||||
</Space>
|
</Space>
|
||||||
<Typography.Paragraph type="secondary" style={{ marginBottom: 0 }}>
|
<Typography.Paragraph type="secondary" style={{ marginBottom: 0 }}>
|
||||||
|
|||||||
@@ -0,0 +1,2 @@
|
|||||||
|
UPDATE "TrustContent" SET "type" = 'credential' WHERE "type" IN ('profile', 'experience');
|
||||||
|
UPDATE "TrustContent" SET "type" = 'case' WHERE "type" IN ('portfolio', 'testimonial');
|
||||||
@@ -184,6 +184,7 @@ class AdminWorkspaceController {
|
|||||||
displayName: manifest.displayName,
|
displayName: manifest.displayName,
|
||||||
admin: manifest.admin,
|
admin: manifest.admin,
|
||||||
assetSlots: manifest.assetSlots,
|
assetSlots: manifest.assetSlots,
|
||||||
|
trustContentTypes: manifest.trustContentTypes ?? [],
|
||||||
}
|
}
|
||||||
: null,
|
: null,
|
||||||
};
|
};
|
||||||
|
|||||||
@@ -826,6 +826,8 @@ test("admin can install a template and public workspace exposes enabled configur
|
|||||||
assert.equal(JSON.parse(workspace.body).fields.length, 5);
|
assert.equal(JSON.parse(workspace.body).fields.length, 5);
|
||||||
const templateContent = JSON.parse(workspace.body).templateContent;
|
const templateContent = JSON.parse(workspace.body).templateContent;
|
||||||
assert.equal(templateContent.displayName, "阿成校园餐");
|
assert.equal(templateContent.displayName, "阿成校园餐");
|
||||||
|
assert.ok(templateContent.trustContentTypes.some((item) => item.type === "schedule"));
|
||||||
|
assert.ok(templateContent.trustContentTypes.some((item) => item.label === "出摊与营业安排"));
|
||||||
assert.ok(templateContent.admin.sections.some((section) => section.title === "首页出摊信息"));
|
assert.ok(templateContent.admin.sections.some((section) => section.title === "首页出摊信息"));
|
||||||
assert.ok(
|
assert.ok(
|
||||||
templateContent.admin.sections
|
templateContent.admin.sections
|
||||||
|
|||||||
@@ -87,6 +87,7 @@ export interface TemplateAdminSection {
|
|||||||
export interface AdminTemplateContent {
|
export interface AdminTemplateContent {
|
||||||
displayName: string;
|
displayName: string;
|
||||||
admin: { sections: TemplateAdminSection[] };
|
admin: { sections: TemplateAdminSection[] };
|
||||||
|
trustContentTypes?: Array<{ type: string; label: string; help?: string; placeholder?: string }>;
|
||||||
assetSlots: Array<{
|
assetSlots: Array<{
|
||||||
key: string;
|
key: string;
|
||||||
binding: string;
|
binding: string;
|
||||||
|
|||||||
@@ -288,6 +288,41 @@ export const generatedTemplatePackageRegistry = [
|
|||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
"trustContentTypes": [
|
||||||
|
{
|
||||||
|
"type": "schedule",
|
||||||
|
"label": "出摊与营业安排",
|
||||||
|
"help": "说明固定出摊时间、临时营业安排或接受预订的时段。",
|
||||||
|
"placeholder": "例如:周一至周五 17:00 - 22:30"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "coverage",
|
||||||
|
"label": "取餐与配送范围",
|
||||||
|
"help": "说明服务地点、取餐方式和可配送范围。",
|
||||||
|
"placeholder": "例如:支持校内宿舍楼下配送"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "process",
|
||||||
|
"label": "定制餐品流程",
|
||||||
|
"help": "每行写一步,从提出需求到完成交付。",
|
||||||
|
"placeholder": "例如:提交需求\n确认菜单\n制作交付"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "credential",
|
||||||
|
"label": "食品安全与制作标准",
|
||||||
|
"help": "填写让顾客放心的资质、卫生或制作标准。"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "case",
|
||||||
|
"label": "客户案例与反馈",
|
||||||
|
"help": "填写代表性订单、活动案例或客户评价。"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "promise",
|
||||||
|
"label": "回复与服务承诺",
|
||||||
|
"help": "说明回复时间、退改规则或服务承诺。"
|
||||||
|
}
|
||||||
|
],
|
||||||
"sampleContent": {
|
"sampleContent": {
|
||||||
"food": {
|
"food": {
|
||||||
"templateKey": "food",
|
"templateKey": "food",
|
||||||
@@ -681,6 +716,39 @@ export const generatedTemplatePackageRegistry = [
|
|||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
"trustContentTypes": [
|
||||||
|
{
|
||||||
|
"type": "schedule",
|
||||||
|
"label": "服务与合作安排",
|
||||||
|
"help": "说明可预约时间、服务周期或项目排期。"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "coverage",
|
||||||
|
"label": "服务范围与适用对象",
|
||||||
|
"help": "说明服务地区、项目类型或合作边界。"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "process",
|
||||||
|
"label": "合作流程",
|
||||||
|
"help": "每行写一步,从初次沟通到交付完成。",
|
||||||
|
"placeholder": "例如:需求沟通\n方案确认\n落地交付"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "credential",
|
||||||
|
"label": "专业资历与方法",
|
||||||
|
"help": "填写经验、资质、专业标准或工作方法。"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "case",
|
||||||
|
"label": "项目案例与客户反馈",
|
||||||
|
"help": "填写代表性项目、成果或客户评价。"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"type": "promise",
|
||||||
|
"label": "合作预期与响应承诺",
|
||||||
|
"help": "说明回复时间、合作边界和后续跟进方式。"
|
||||||
|
}
|
||||||
|
],
|
||||||
"sampleContent": {
|
"sampleContent": {
|
||||||
"doors": {
|
"doors": {
|
||||||
"templateKey": "doors",
|
"templateKey": "doors",
|
||||||
@@ -912,4 +980,4 @@ export const generatedTemplatePackageRegistry = [
|
|||||||
}
|
}
|
||||||
];
|
];
|
||||||
export const generatedTemplatePackageRegistryHash =
|
export const generatedTemplatePackageRegistryHash =
|
||||||
"ebcac61077ff8d4097065555e86c651b93f99f91196b55b9503a13c6dcb9631a";
|
"afbd1045ccdc7eda85bd9707ce27083ba699899f115a26a3c60459a88a5e5148";
|
||||||
@@ -225,6 +225,12 @@ export interface TemplatePackageManifest {
|
|||||||
fields: readonly { key: string; binding: string; label: string; required?: boolean }[];
|
fields: readonly { key: string; binding: string; label: string; required?: boolean }[];
|
||||||
}[];
|
}[];
|
||||||
};
|
};
|
||||||
|
trustContentTypes?: readonly {
|
||||||
|
type: string;
|
||||||
|
label: string;
|
||||||
|
help?: string;
|
||||||
|
placeholder?: string;
|
||||||
|
}[];
|
||||||
sampleContent?: Partial<Record<BrandTemplateKey, TemplateSampleContent>>;
|
sampleContent?: Partial<Record<BrandTemplateKey, TemplateSampleContent>>;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -281,6 +281,14 @@
|
|||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
"trustContentTypes": [
|
||||||
|
{ "type": "schedule", "label": "出摊与营业安排", "help": "说明固定出摊时间、临时营业安排或接受预订的时段。", "placeholder": "例如:周一至周五 17:00 - 22:30" },
|
||||||
|
{ "type": "coverage", "label": "取餐与配送范围", "help": "说明服务地点、取餐方式和可配送范围。", "placeholder": "例如:支持校内宿舍楼下配送" },
|
||||||
|
{ "type": "process", "label": "定制餐品流程", "help": "每行写一步,从提出需求到完成交付。", "placeholder": "例如:提交需求\n确认菜单\n制作交付" },
|
||||||
|
{ "type": "credential", "label": "食品安全与制作标准", "help": "填写让顾客放心的资质、卫生或制作标准。" },
|
||||||
|
{ "type": "case", "label": "客户案例与反馈", "help": "填写代表性订单、活动案例或客户评价。" },
|
||||||
|
{ "type": "promise", "label": "回复与服务承诺", "help": "说明回复时间、退改规则或服务承诺。" }
|
||||||
|
],
|
||||||
"sampleContent": {
|
"sampleContent": {
|
||||||
"food": {
|
"food": {
|
||||||
"templateKey": "food",
|
"templateKey": "food",
|
||||||
|
|||||||
@@ -64,6 +64,13 @@ export type TemplateAdminManifest = {
|
|||||||
sections: TemplateAdminSection[];
|
sections: TemplateAdminSection[];
|
||||||
};
|
};
|
||||||
|
|
||||||
|
export type TemplateTrustContentType = {
|
||||||
|
type: "schedule" | "coverage" | "process" | "credential" | "case" | "promise" | (string & {});
|
||||||
|
label: string;
|
||||||
|
help?: string;
|
||||||
|
placeholder?: string;
|
||||||
|
};
|
||||||
|
|
||||||
export type TemplateSampleContent = {
|
export type TemplateSampleContent = {
|
||||||
templateKey: string;
|
templateKey: string;
|
||||||
offerings: Array<Record<string, unknown>>;
|
offerings: Array<Record<string, unknown>>;
|
||||||
@@ -96,6 +103,7 @@ export type TemplatePackageManifest = {
|
|||||||
dataSlots: TemplateDataSlot[];
|
dataSlots: TemplateDataSlot[];
|
||||||
assetSlots: TemplateAssetSlot[];
|
assetSlots: TemplateAssetSlot[];
|
||||||
admin: TemplateAdminManifest;
|
admin: TemplateAdminManifest;
|
||||||
|
trustContentTypes?: TemplateTrustContentType[];
|
||||||
sampleContent?: Record<string, TemplateSampleContent>;
|
sampleContent?: Record<string, TemplateSampleContent>;
|
||||||
};
|
};
|
||||||
|
|
||||||
@@ -125,6 +133,22 @@ export function validateTemplatePackageManifest(value: unknown): string[] {
|
|||||||
errors.push("data slot source is invalid");
|
errors.push("data slot source is invalid");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
if (manifest.trustContentTypes !== undefined) {
|
||||||
|
if (!Array.isArray(manifest.trustContentTypes))
|
||||||
|
errors.push("trustContentTypes must be an array");
|
||||||
|
else {
|
||||||
|
for (const [index, item] of manifest.trustContentTypes.entries()) {
|
||||||
|
if (!item || typeof item !== "object") {
|
||||||
|
errors.push(`trustContentTypes.${index} must be an object`);
|
||||||
|
continue;
|
||||||
|
}
|
||||||
|
if (typeof item.type !== "string" || !item.type.trim())
|
||||||
|
errors.push(`trustContentTypes.${index}.type is required`);
|
||||||
|
if (typeof item.label !== "string" || !item.label.trim())
|
||||||
|
errors.push(`trustContentTypes.${index}.label is required`);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
if (!Array.isArray(manifest.assetSlots)) errors.push("assetSlots must be an array");
|
if (!Array.isArray(manifest.assetSlots)) errors.push("assetSlots must be an array");
|
||||||
else {
|
else {
|
||||||
for (const slot of manifest.assetSlots) {
|
for (const slot of manifest.assetSlots) {
|
||||||
|
|||||||
@@ -269,6 +269,14 @@
|
|||||||
}
|
}
|
||||||
]
|
]
|
||||||
},
|
},
|
||||||
|
"trustContentTypes": [
|
||||||
|
{ "type": "schedule", "label": "服务与合作安排", "help": "说明可预约时间、服务周期或项目排期。" },
|
||||||
|
{ "type": "coverage", "label": "服务范围与适用对象", "help": "说明服务地区、项目类型或合作边界。" },
|
||||||
|
{ "type": "process", "label": "合作流程", "help": "每行写一步,从初次沟通到交付完成。", "placeholder": "例如:需求沟通\n方案确认\n落地交付" },
|
||||||
|
{ "type": "credential", "label": "专业资历与方法", "help": "填写经验、资质、专业标准或工作方法。" },
|
||||||
|
{ "type": "case", "label": "项目案例与客户反馈", "help": "填写代表性项目、成果或客户评价。" },
|
||||||
|
{ "type": "promise", "label": "合作预期与响应承诺", "help": "说明回复时间、合作边界和后续跟进方式。" }
|
||||||
|
],
|
||||||
"sampleContent": {
|
"sampleContent": {
|
||||||
"doors": {
|
"doors": {
|
||||||
"templateKey": "doors",
|
"templateKey": "doors",
|
||||||
|
|||||||
Reference in new issue
Block a user