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

+28 -1
View File
@@ -31,6 +31,8 @@ import {
capabilityPlugins,
getBrandTemplate,
getTemplateSampleContent,
getTemplatePackageManifestForVisualKey,
getDefaultVisualTemplateKey,
resolveCapabilities,
} from "@personal-brand/config";
import { TemplateWorkspaceService } from "./template-workspace.service.js";
@@ -167,7 +169,32 @@ class AdminWorkspaceController {
this.prisma.offering.findMany({ where: { brandId }, orderBy: { sortOrder: "asc" } }),
this.prisma.inquiryForm.findMany({ where: { brandId }, orderBy: { updatedAt: "desc" } }),
]);
return { brand, installations, modules, fields, offerings, forms };
const config = this.jsonObject(brand?.config);
const templateKey =
typeof config.visualTemplateKey === "string"
? config.visualTemplateKey
: getDefaultVisualTemplateKey(brand?.templateKey ?? "personal");
const manifest = getTemplatePackageManifestForVisualKey(templateKey);
return {
brand,
installations,
modules,
fields,
offerings,
forms,
templateContent: manifest
? {
displayName: manifest.displayName,
admin: manifest.admin,
assetSlots: manifest.assetSlots,
}
: null,
};
}
private jsonObject(value: unknown): Record<string, unknown> {
return value && typeof value === "object" && !Array.isArray(value)
? (value as Record<string, unknown>)
: {};
}
@Post("install")
async install(
+107 -7
View File
@@ -10,6 +10,7 @@ import {
getVisualTemplate,
isVisualTemplateCompatible,
getDefaultVisualTemplateKey,
getTemplatePackageManifestForVisualKey,
} from "@personal-brand/config";
import { PrismaService } from "./prisma.service.js";
import { BrandReleaseService } from "./brand-release.service.js";
@@ -44,7 +45,13 @@ export class BrandReleaseApiService {
database: Prisma.TransactionClient = this.prisma,
): Promise<{
ready: boolean;
checks: Array<{ key: string; label: string; passed: boolean }>;
checks: Array<{
key: string;
label: string;
passed: boolean;
help?: string;
destination?: string;
}>;
}> {
const brand = await database.brandProfile.findUnique({
where: { id: brandId },
@@ -61,8 +68,12 @@ export class BrandReleaseApiService {
? config.visualTemplateKey
: getDefaultVisualTemplateKey(brand?.templateKey ?? "personal");
const visual = getVisualTemplate(visualKey);
const packageManifest = getTemplatePackageManifestForVisualKey(visualKey);
const [offerings, forms, trust] = await Promise.all([
database.offering.findMany({ where: { brandId, isEnabled: true }, select: { id: true } }),
database.offering.findMany({
where: { brandId, isEnabled: true },
select: { id: true, name: true, coverUrl: true, config: true },
}),
database.inquiryForm.findMany({
where: { brandId, isEnabled: true },
select: { offeringId: true, fieldsSnapshot: true },
@@ -77,26 +88,115 @@ export class BrandReleaseApiService {
form.fieldsSnapshot.length > 0 &&
validateFieldSnapshot(form.fieldsSnapshot).length === 0,
);
const checks = [
{ key: "brand", label: "请先完善品牌名称", passed: Boolean(brand?.name.trim()) },
const checks: Array<{
key: string;
label: string;
passed: boolean;
help?: string;
destination?: string;
}> = [
{
key: "brand",
label: "请先完善品牌名称",
passed: Boolean(brand?.name.trim()),
destination: "/admin/brand",
},
{
key: "positioning",
label: "请先完善品牌定位和介绍",
passed: Boolean(brand?.tagline?.trim() && brand.description?.trim()),
destination: "/admin/brand",
},
{ key: "template", label: "当前行业模板不存在", passed: Boolean(template) },
{
key: "visual",
label: "当前视觉模板不适配行业模板",
passed: Boolean(visual && template && isVisualTemplateCompatible(visual, template.key)),
destination: "/admin/publication",
},
{
key: "offerings",
label: "至少需要一项已启用的业务提供项",
passed: offerings.length > 0,
destination: "/admin/services",
},
{
key: "forms",
label: "至少需要一个可用的咨询表单",
passed: usableForms.length > 0,
destination: "/admin/workspace",
},
{
key: "trust",
label: "至少需要一条已发布的信任内容",
passed: trust > 0,
destination: "/admin/trust",
},
{ key: "offerings", label: "至少需要一项已启用的业务提供项", passed: offerings.length > 0 },
{ key: "forms", label: "至少需要一个可用的咨询表单", passed: usableForms.length > 0 },
{ key: "trust", label: "至少需要一条已发布的信任内容", passed: trust > 0 },
];
const brandRecord = { ...this.jsonObject(brand), config };
for (const section of packageManifest?.admin.sections ?? []) {
for (const field of section.fields) {
if (field.required !== true) continue;
const present = this.resolveBinding(field.binding, {
brand: brandRecord,
offerings,
});
checks.push({
key: `content:${section.key}:${field.key}`,
label: present
? `${section.title}:${field.label}`
: `请补充「${section.title}」中的「${field.label}」`,
passed: present,
help: section.description,
destination:
section.target === "offering"
? "/admin/services"
: section.target === "trust"
? "/admin/trust"
: section.target === "inquiry"
? "/admin/workspace"
: "/admin/brand",
});
}
}
for (const slot of packageManifest?.assetSlots ?? []) {
if (slot.required !== true) continue;
const present =
slot.target === "offering"
? offerings.length > 0 && offerings.every((item) => Boolean(item.coverUrl?.trim()))
: slot.target === "brand"
? this.resolveBinding(slot.binding, { brand: brandRecord, offerings })
: trust > 0;
checks.push({
key: `asset:${String(slot.key)}`,
label: present ? `已添加${String(slot.label)}` : `请添加${String(slot.label)}`,
passed: present,
help: String(slot.help),
destination: slot.target === "offering" ? "/admin/services" : "/admin/brand",
});
}
return { ready: checks.every((check) => check.passed), checks };
}
private resolveBinding(
binding: string,
context: {
brand: Record<string, unknown>;
offerings: Array<{ id: string; name: string; coverUrl: string | null; config: unknown }>;
},
): boolean {
const segments = binding.split(".");
let value: unknown;
if (segments[0] === "brand") value = context.brand;
else if (segments[0] === "offering") value = context.offerings[0];
else return false;
for (const segment of segments.slice(1)) {
if (!value || typeof value !== "object" || Array.isArray(value)) return false;
value = (value as Record<string, unknown>)[segment];
}
return typeof value === "string" ? value.trim().length > 0 : Boolean(value);
}
async publish(brandId: string, actorId: string, note?: string): Promise<unknown> {
return this.withVersionRetry(() =>
this.prisma.$transaction(
+3
View File
@@ -5,6 +5,7 @@ import {
getVisualTemplate,
getVisualTemplateManifest,
getDefaultVisualTemplateKey,
getTemplatePackageManifestForVisualKey,
} from "@personal-brand/config";
import { PrismaService } from "./prisma.service.js";
@@ -15,6 +16,7 @@ export interface BrandReleaseSnapshot {
templateDefinition?: ReturnType<typeof getBrandTemplate> | null;
visualTemplateDefinition?: ReturnType<typeof getVisualTemplate> | null;
visualTemplateManifest?: ReturnType<typeof getVisualTemplateManifest> | null;
templatePackageManifest?: ReturnType<typeof getTemplatePackageManifestForVisualKey> | null;
brand: Record<string, unknown> | null;
installation: Record<string, unknown> | null;
modules: unknown[];
@@ -61,6 +63,7 @@ export async function buildBrandReleaseSnapshot(
templateDefinition: getBrandTemplate(templateKey) ?? null,
visualTemplateDefinition: getVisualTemplate(visualKey) ?? null,
visualTemplateManifest: getVisualTemplateManifest(visualKey) ?? null,
templatePackageManifest: getTemplatePackageManifestForVisualKey(visualKey) ?? null,
brand: brand ? jsonObject(brand) : null,
installation: installation ? jsonObject(installation) : null,
modules: modules.map((item) => jsonObject(item)),
@@ -10,6 +10,7 @@ import {
resolveCapabilities,
capabilityPlugins,
getDefaultVisualTemplateKey,
getTemplatePackageManifestForVisualKey,
} from "@personal-brand/config";
import type {
RuntimeInquiryField,
@@ -120,6 +121,9 @@ export class PublicWorkspaceController {
releaseSnapshot.visualTemplateDefinition ?? getVisualTemplate(visualTemplateKey);
const visualTemplateManifest =
releaseSnapshot.visualTemplateManifest ?? getVisualTemplateManifest(visualTemplateKey);
const templatePackageManifest =
releaseSnapshot.templatePackageManifest ??
getTemplatePackageManifestForVisualKey(visualTemplateKey);
const runtimeBrand = {
...brandData,
...brandConfig,
@@ -177,6 +181,20 @@ export class PublicWorkspaceController {
schemaKey: typeof config.schemaKey === "string" ? config.schemaKey : "offering.default",
schemaVersion: typeof config.schemaVersion === "string" ? config.schemaVersion : "1.0.0",
presentation: {
...Object.fromEntries(
Object.entries(config).filter(
([key]) =>
![
"schemaKey",
"schemaVersion",
"details",
"sections",
"media",
"presentation",
].includes(key),
),
),
...this.jsonObject(config.presentation),
categoryKey: typeof config.categoryKey === "string" ? config.categoryKey : "custom",
categoryLabel:
typeof config.categoryLabel === "string" ? config.categoryLabel : "业务提供项",
@@ -266,11 +284,15 @@ export class PublicWorkspaceController {
},
brand: runtimeBrand,
navigation: {
tabs: [
{ key: "home", label: "首页", page: "pages/index/index" },
{ key: "offerings", label: "案例与体系", page: "pages/services/index" },
{ key: "profile", label: "主理人与我", page: "pages/bookings/index" },
],
tabs:
templatePackageManifest?.navigation.map((tab) => ({
key: tab.key,
label: tab.label,
page:
templatePackageManifest.entrypoints[
tab.page as keyof typeof templatePackageManifest.entrypoints
] ?? tab.page,
})) ?? [],
},
modules: runtimeModules,
offerings: runtimeOfferings,
+116 -16
View File
@@ -77,6 +77,70 @@ test("admin release lifecycle is authorized, brand-scoped, and versioned", async
});
}
const originalBrand = await prisma.brandProfile.findUniqueOrThrow({ where: { id: brandId } });
const originalConfig = originalBrand.config;
const originalOffering = await prisma.offering.findFirstOrThrow({ where: { brandId } });
await prisma.brandProfile.update({
where: { id: brandId },
data: {
config: {
...(originalConfig && typeof originalConfig === "object" ? originalConfig : {}),
heroImage: "",
founder: "",
},
},
});
const missingBrandContent = JSON.parse(
(
await request("/admin/releases/readiness", {
headers: { authorization: `Bearer ${adminToken}` },
})
).body,
);
assert.equal(missingBrandContent.ready, false);
assert.equal(
missingBrandContent.checks.find((check) => check.key === "asset:brand.stallHero")?.passed,
false,
);
assert.equal(
missingBrandContent.checks.find((check) => check.key === "content:identity:founder")
?.destination,
"/admin/brand",
);
assert.match(
missingBrandContent.checks.find((check) => check.key === "asset:brand.stallHero")?.help,
/真实摊位/,
);
assert.equal(
(
await request("/admin/releases/publish", {
method: "POST",
headers: { authorization: `Bearer ${adminToken}` },
payload: {},
})
).statusCode,
400,
);
await prisma.brandProfile.update({
where: { id: brandId },
data: { config: originalConfig },
});
await prisma.offering.update({ where: { id: originalOffering.id }, data: { coverUrl: null } });
const missingOfferingImage = JSON.parse(
(
await request("/admin/releases/readiness", {
headers: { authorization: `Bearer ${adminToken}` },
})
).body,
);
assert.equal(missingOfferingImage.ready, false);
assert.equal(
missingOfferingImage.checks.find((check) => check.key === "asset:offering.cover")?.passed,
false,
);
await prisma.offering.update({
where: { id: originalOffering.id },
data: { coverUrl: originalOffering.coverUrl },
});
await prisma.brandProfile.update({ where: { id: brandId }, data: { tagline: "" } });
const incomplete = await request("/admin/releases/readiness", {
headers: { authorization: `Bearer ${adminToken}` },
@@ -319,6 +383,8 @@ test("seeded public workspaces keep personal, food, and doors brands isolated",
assert.equal(workspace.template.key, item.templateKey);
assert.ok(workspace.visualTemplate?.key);
assert.ok(workspace.visualTemplateManifest?.pages?.length > 0);
assert.equal(workspace.navigation.tabs.length, item.templateKey === "food" ? 5 : 3);
assert.equal("templatePackageManifest" in workspace, false);
assert.equal(workspace.brand.founder, item.founder);
assert.ok(workspace.trustContent.length > 0);
assert.ok(workspace.trustPresentation);
@@ -333,6 +399,10 @@ test("seeded public workspaces keep personal, food, and doors brands isolated",
offering.presentation?.categoryLabel === item.categoryLabel,
),
);
if (item.templateKey === "doors") {
assert.ok(workspace.offerings.some((offering) => offering.presentation.series));
assert.ok(workspace.offerings.some((offering) => offering.presentation.hardware));
}
return workspace;
}),
);
@@ -683,6 +753,10 @@ test("admin can install a template and public workspace exposes enabled configur
const token = JSON.parse(login.body).token;
const before = await request("/admin/workspace");
assert.equal(before.statusCode, 401);
const customerAccess = await request("/admin/workspace", {
headers: { authorization: `Bearer ${customerToken}` },
});
assert.equal(customerAccess.statusCode, 403);
const installed = await request("/admin/workspace/install", {
method: "POST",
headers: { authorization: `Bearer ${token}` },
@@ -726,6 +800,14 @@ test("admin can install a template and public workspace exposes enabled configur
assert.equal(workspace.statusCode, 200);
assert.equal(JSON.parse(workspace.body).installations.length, 1);
assert.equal(JSON.parse(workspace.body).fields.length, 5);
const templateContent = JSON.parse(workspace.body).templateContent;
assert.equal(templateContent.displayName, "阿成校园餐");
assert.ok(templateContent.admin.sections.some((section) => section.title === "首页出摊信息"));
assert.ok(
templateContent.admin.sections
.flatMap((section) => section.fields)
.some((field) => field.binding === "brand.config.heroImage"),
);
const publicWorkspace = await request("/public/workspace");
assert.equal(publicWorkspace.statusCode, 200);
const workspaceBody = JSON.parse(publicWorkspace.body);
@@ -733,6 +815,7 @@ test("admin can install a template and public workspace exposes enabled configur
assert.equal(workspaceBody.template.key, "food");
assert.ok(workspaceBody.modules.length > 0);
assert.equal(workspaceBody.modules.length, workspaceBody.runtimeModules.length);
assert.equal("templateContent" in workspaceBody, false);
assert.equal(workspaceBody.runtimeModules[0].schemaVersion, "1.0");
assert.ok(workspaceBody.inquiryForm);
const conflict = await request("/admin/workspace/install", {
@@ -1276,22 +1359,35 @@ test("brand switching isolates admin configuration, offerings, and public worksp
assert.equal(switched.statusCode, 201);
const doorsToken = JSON.parse(switched.body).token;
const [defaultConfig, doorsConfig, defaultOfferings, doorsOfferings, doorsWorkspace] =
await Promise.all([
request("/admin/config/brand", {
headers: { authorization: `Bearer ${defaultToken}` },
}),
request("/admin/config/brand", {
headers: { authorization: `Bearer ${doorsToken}` },
}),
request("/admin/workspace/offerings", {
headers: { authorization: `Bearer ${defaultToken}` },
}),
request("/admin/workspace/offerings", {
headers: { authorization: `Bearer ${doorsToken}` },
}),
request("/public/workspace?brandSlug=linjing-doors"),
]);
const [
defaultConfig,
doorsConfig,
defaultOfferings,
doorsOfferings,
defaultAdminWorkspace,
doorsAdminWorkspace,
doorsWorkspace,
] = await Promise.all([
request("/admin/config/brand", {
headers: { authorization: `Bearer ${defaultToken}` },
}),
request("/admin/config/brand", {
headers: { authorization: `Bearer ${doorsToken}` },
}),
request("/admin/workspace/offerings", {
headers: { authorization: `Bearer ${defaultToken}` },
}),
request("/admin/workspace/offerings", {
headers: { authorization: `Bearer ${doorsToken}` },
}),
request("/admin/workspace", {
headers: { authorization: `Bearer ${defaultToken}` },
}),
request("/admin/workspace", {
headers: { authorization: `Bearer ${doorsToken}` },
}),
request("/public/workspace?brandSlug=linjing-doors"),
]);
assert.equal(defaultConfig.statusCode, 200);
assert.equal(doorsConfig.statusCode, 200);
assert.equal(JSON.parse(defaultConfig.body).id, brandId);
@@ -1305,6 +1401,10 @@ test("brand switching isolates admin configuration, offerings, and public worksp
assert.equal(doorsWorkspace.statusCode, 200);
assert.equal(JSON.parse(doorsWorkspace.body).brand.id, doorsBrand.id);
assert.equal(JSON.parse(doorsWorkspace.body).template.key, "doors");
assert.equal(defaultAdminWorkspace.statusCode, 200);
assert.equal(doorsAdminWorkspace.statusCode, 200);
assert.equal(JSON.parse(defaultAdminWorkspace.body).templateContent.displayName, "阿成校园餐");
assert.equal(JSON.parse(doorsAdminWorkspace.body).templateContent.displayName, "林境建筑画册");
});
test("disabled brand membership blocks existing admin token", async () => {