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,