refactor: 拆分模板配置契约与注册逻辑

This commit is contained in:
que01 committed 2026-10-12 03:26:43 +08:00
1 parent 7e1dd543fb
commit d0902d6568
12 files changed
+1025 -945

No files matched your search

+48
View File
@@ -0,0 +1,48 @@
# 0023. 代码结构与重构标准
## Context
项目已进入多模板、多品牌和完整编辑发布阶段。Admin 页面、API Client、Config 包和部分 API Controller 出现超过 500 行甚至 900 行的文件。页面组件内同时存在查询、mutation、表单同步、预览映射和业务校验;API Client 将所有资源类型和方法集中在单个文件;Config 包将契约、注册表、示例内容和查询函数混在一个索引中。这种结构已经开始增加回归风险、review 成本和模板扩展成本。
项目已有交付清单要求接口授权、集成测试、数据迁移、UI 状态和生产构建一起验证。但缺少专门的代码结构标准,无法在功能继续增长前约束模块边界。
## Decision
建立 `docs/code-standards.md` 作为前后端共享结构标准,并按技术边界补充专门规则:
- Admin React 页面由页面组件、hooks、纯函数领域工具、feature 组件和 shared components 组成;页面组件不承载完整 API 调用和多领域状态。
- API Controller 只处理路由、DTO、状态码、响应形状和传输入口;授权、Prisma、模板安装、快照组装和工作流推进进入 Service 或领域模块。
- API Client 按资源拆分类型和方法模块,`index.ts` 只做聚合导出和 Client 组装。
- Config 与模板包按 manifest、runtime、admin 契约、示例内容、注册表和查询函数拆分。
- 超过 500 行的文件必须给出拆分计划;超过 800 行应拆分。
- 结构重构优先保持外部行为不变,授权测试、品牌隔离测试、API Client 测试和生产构建必须保留并通过。
重构在专用分支完成,必须经过相关包测试、全仓 lint、typecheck、Admin 或相关应用生产构建后合并。
## Alternatives
1. 继续只在功能交付清单中约束行为:不能阻止模块继续膨胀,review 成本和冲突风险会继续上升。
2. 引入统一组件框架或后端 CQRS 框架:改动范围过大,会打断当前产品主线,且对现有热点没有直接收益。
3. 只按行数机械拆分:会生成缺少领域含义的小文件,降低可读性。
## Consequences
### Positive
- Admin 编辑器、工作台、业务和信任内容可以复用同一种状态与表单边界。
- API 授权和持久化边界更容易测试。
- API Client 和 Config 契约变更的影响面更清晰。
- 模板新增与多品牌扩展不再依赖膨胀的单一索引。
### Negative
- 短期内会出现更多文件,需要依赖明确的领域命名。
- 旧代码迁移需要多轮完成,不能一次替换所有结构。
## Migration Plan
1. 在 `refactor/code-standards` 分支先落地标准。
2. 优先重构当前热点:品牌编辑器、工作台、API Client、Config 包和 Admin Workspace Controller。
3. 每轮重构保持公共导出、endpoint、请求响应和授权行为兼容。
4. 后续新增文件直接按标准执行;旧文件在改动该领域时逐步迁移。
5. 分支通过全部相关测试和生产构建后合并回 `main`。
+124
View File
@@ -0,0 +1,124 @@
import type { BrandTemplateKey } from "./template-keys.js";
import type { CapabilityKey } from "./template-keys.js";
import type { VisualTemplateKey } from "./template-keys.js";
export type BrandTemplateModuleType = "identity" | "trust" | "offering" | "inquiry" | "contact";
export interface BrandTemplateModuleDefinition {
key: string;
type: BrandTemplateModuleType;
title: string;
required: boolean;
}
export interface BrandTemplateFieldDefinition {
scope: string;
key: string;
label: string;
type: string;
required: boolean;
}
export interface BrandTemplateDefinition {
key: BrandTemplateKey;
version: string;
name: string;
description: string;
serviceCategories: string[];
trustContentTypes: string[];
modules: BrandTemplateModuleDefinition[];
fields: BrandTemplateFieldDefinition[];
capabilities: CapabilityKey[];
}
export interface VisualTemplateDefinition {
key: VisualTemplateKey;
version: string;
name: string;
description: string;
supportedIndustryTemplates: readonly BrandTemplateKey[];
variants: Record<string, string>;
theme: { colors: Record<string, string>; radius: Record<string, string> };
layout?: { home: string[]; offerings: string[]; detail: string[]; profile: string[] };
}
export type VisualPageKey =
"home" | "offerings" | "detail" | "inquiry" | "success" | "records" | "profile";
export type VisualModuleType =
| "brand-identity"
| "hero"
| "trust"
| "offering-list"
| "offering-detail"
| "inquiry-form"
| "success-summary"
| "records-list"
| "contact";
export interface VisualTokenSet {
colors: Record<string, string>;
spacing: Record<string, string>;
typography: Record<string, string>;
radius: Record<string, string>;
shadows?: Record<string, string>;
}
export interface VisualAssetSlot {
key: string;
label: string;
required: boolean;
kind: "image" | "icon" | "logo" | "texture";
aspectRatio?: string;
fallback?: string;
}
export interface VisualDataSlot {
key: string;
source: "brand" | "trust" | "offering" | "inquiry" | "records" | "profile";
required: boolean;
description: string;
}
export interface VisualModuleDefinition {
key: string;
type: VisualModuleType;
variant: string;
required: boolean;
dataSlots?: string[];
assetSlots?: string[];
capability?: CapabilityKey;
}
export interface VisualPageDefinition {
key: VisualPageKey;
title: string;
renderer?: string;
modules: VisualModuleDefinition[];
}
export interface VisualTemplateManifest {
schemaVersion: "1.0";
key: VisualTemplateKey;
version: string;
name: string;
description: string;
supportedIndustryTemplates: BrandTemplateKey[];
brandFirst: true;
tokens: VisualTokenSet;
pages: VisualPageDefinition[];
assets: VisualAssetSlot[];
dataSlots: VisualDataSlot[];
capabilities: CapabilityKey[];
}
export interface TemplatePackage {
manifest: VisualTemplateManifest;
industryTemplateKey: BrandTemplateKey;
content: Record<string, unknown>;
forms: Record<string, unknown>[];
capabilityConfig: Record<string, unknown>;
fixtures: {
runtime: Record<string, unknown>;
visual: Record<string, unknown>;
};
}
+139
View File
@@ -0,0 +1,139 @@
import type { BrandTemplateKey } from "./template-keys.js";
import type { BrandTemplateDefinition } from "./brand-contracts.js";
export const brandTemplates = {
personal: {
key: "personal",
version: "1.0.0",
name: "个人品牌",
description: "围绕定位、信任、作品与合作建立个人品牌。",
serviceCategories: ["consulting", "collaboration", "custom"],
trustContentTypes: [
"profile",
"experience",
"credential",
"portfolio",
"process",
"testimonial",
],
modules: [
{ key: "identity", type: "identity", title: "品牌身份", required: true },
{ key: "trust", type: "trust", title: "信任内容", required: true },
{ key: "offerings", type: "offering", title: "业务提供项", required: true },
{ key: "inquiry", type: "inquiry", title: "联系与咨询", required: true },
{ key: "contact", type: "contact", title: "品牌表达", required: true },
],
fields: [
{ scope: "profile", key: "name", label: "品牌名称", type: "text", required: true },
{ scope: "profile", key: "tagline", label: "一句话定位", type: "text", required: true },
{ scope: "profile", key: "audience", label: "服务对象", type: "textarea", required: true },
{
scope: "profile",
key: "valueProposition",
label: "提供的价值",
type: "textarea",
required: true,
},
{
scope: "profile",
key: "trustProof",
label: "信任证明入口",
type: "textarea",
required: true,
},
],
capabilities: ["offerings", "inquiry"],
},
food: {
key: "food",
version: "1.0.0",
name: "餐饮模板",
description: "适用于餐饮服务与套餐预约的行业模板。",
serviceCategories: ["food-package", "private-chef", "custom"],
trustContentTypes: [
"profile",
"experience",
"credential",
"portfolio",
"process",
"testimonial",
],
modules: [
{ key: "identity", type: "identity", title: "品牌身份", required: true },
{ key: "trust", type: "trust", title: "信任内容", required: true },
{ key: "offerings", type: "offering", title: "菜单与服务", required: true },
{ key: "inquiry", type: "inquiry", title: "预约与咨询", required: true },
{ key: "contact", type: "contact", title: "品牌表达", required: true },
],
fields: [
{ scope: "profile", key: "name", label: "品牌名称", type: "text", required: true },
{ scope: "profile", key: "tagline", label: "一句话定位", type: "text", required: true },
{ scope: "profile", key: "audience", label: "服务对象", type: "textarea", required: true },
{
scope: "profile",
key: "valueProposition",
label: "提供的价值",
type: "textarea",
required: true,
},
{
scope: "profile",
key: "trustProof",
label: "信任证明入口",
type: "textarea",
required: true,
},
],
capabilities: ["offerings", "inquiry", "booking"],
},
doors: {
key: "doors",
version: "1.0.0",
name: "高端门窗模板",
description: "适用于别墅门、院门、室内门与定制门窗服务的行业模板。",
serviceCategories: ["entrance-door", "garden-door", "interior-door", "custom"],
trustContentTypes: [
"profile",
"experience",
"credential",
"portfolio",
"process",
"testimonial",
],
modules: [
{ key: "identity", type: "identity", title: "品牌身份", required: true },
{ key: "trust", type: "trust", title: "工艺与信任", required: true },
{ key: "offerings", type: "offering", title: "门窗系列", required: true },
{ key: "inquiry", type: "inquiry", title: "设计咨询", required: true },
{ key: "contact", type: "contact", title: "品牌表达", required: true },
],
fields: [
{ scope: "profile", key: "name", label: "品牌名称", type: "text", required: true },
{ scope: "profile", key: "tagline", label: "一句话定位", type: "text", required: true },
{ scope: "profile", key: "audience", label: "服务对象", type: "textarea", required: true },
{
scope: "profile",
key: "valueProposition",
label: "提供的价值",
type: "textarea",
required: true,
},
{
scope: "profile",
key: "trustProof",
label: "信任证明入口",
type: "textarea",
required: true,
},
],
capabilities: ["offerings", "inquiry"],
},
} satisfies Record<BrandTemplateKey, BrandTemplateDefinition>;
export function isBrandTemplateKey(value: string): value is BrandTemplateKey {
return Object.prototype.hasOwnProperty.call(brandTemplates, value);
}
export function getBrandTemplate(key: string): BrandTemplateDefinition | undefined {
return isBrandTemplateKey(key) ? brandTemplates[key] : undefined;
}
@@ -0,0 +1,57 @@
import type { CapabilityKey } from "./template-keys.js";
export interface WorkflowDefinition {
key: string;
version: string;
initialState: string;
transitions: Record<string, readonly string[]>;
}
export interface CapabilityDefinition {
key: CapabilityKey;
version: string;
workflowKey?: string;
}
export const workflowRegistry = {
"booking.basic": {
key: "booking.basic",
version: "1.0.0",
initialState: "received",
transitions: {
received: ["contacting", "cancelled"],
contacting: ["confirmed", "cancelled"],
confirmed: ["completed", "cancelled"],
completed: [],
cancelled: [],
},
},
} as const satisfies Record<string, WorkflowDefinition>;
export const capabilityRegistry = {
offerings: { key: "offerings", version: "1.0.0" },
inquiry: { key: "inquiry", version: "1.0.0" },
booking: { key: "booking", version: "1.0.0", workflowKey: "booking.basic" },
"quote-request": { key: "quote-request", version: "1.0.0" },
} as const satisfies Record<CapabilityKey, CapabilityDefinition>;
export const capabilityPlugins = {
inquiry: {
key: "inquiry",
version: "1.0.0",
displayName: "通用咨询",
purpose: "inquiry",
requiredModules: ["inquiry", "records", "success-summary"],
apiContract: "/customer/inquiry-submissions",
configSchema: "capability.inquiry.v1",
},
"quote-request": {
key: "quote-request",
version: "1.0.0",
displayName: "报价咨询",
purpose: "quote-request",
requiredModules: ["inquiry", "records", "success-summary"],
apiContract: "/customer/inquiry-submissions",
configSchema: "capability.quote-request.v1",
},
} as const;
+11 -945
View File
@@ -1,946 +1,12 @@
export * from "./brand-contracts.js";
export * from "./brand-templates.js";
export * from "./capability-contracts.js";
export * from "./template-keys.js";
export * from "./template-packages.js";
export * from "./template-package-manifest.js";
export * from "./template-sample-content.js";
export * from "./visual-manifests.js";
export * from "./visual-templates.js";
export * from "./workflow.js";
export const configPackageName = "personal-brand-config";
import { generatedTemplatePackageRegistry } from "./generated-template-packages.js";
export type BrandTemplateKey = "personal" | "food" | "doors";
export type VisualTemplateKey = "linjing-editorial" | "acheng-campus-food";
export type CapabilityKey = "offerings" | "inquiry" | "booking" | "quote-request";
export interface WorkflowDefinition {
key: string;
version: string;
initialState: string;
transitions: Record<string, readonly string[]>;
}
export interface CapabilityDefinition {
key: CapabilityKey;
version: string;
workflowKey?: string;
}
export const workflowRegistry = {
"booking.basic": {
key: "booking.basic",
version: "1.0.0",
initialState: "received",
transitions: {
received: ["contacting", "cancelled"],
contacting: ["confirmed", "cancelled"],
confirmed: ["completed", "cancelled"],
completed: [],
cancelled: [],
},
},
} as const satisfies Record<string, WorkflowDefinition>;
export const capabilityRegistry = {
offerings: { key: "offerings", version: "1.0.0" },
inquiry: { key: "inquiry", version: "1.0.0" },
booking: { key: "booking", version: "1.0.0", workflowKey: "booking.basic" },
"quote-request": { key: "quote-request", version: "1.0.0" },
} as const satisfies Record<CapabilityKey, CapabilityDefinition>;
export const capabilityPlugins = {
inquiry: {
key: "inquiry",
version: "1.0.0",
displayName: "通用咨询",
purpose: "inquiry",
requiredModules: ["inquiry", "records", "success-summary"],
apiContract: "/customer/inquiry-submissions",
configSchema: "capability.inquiry.v1",
},
"quote-request": {
key: "quote-request",
version: "1.0.0",
displayName: "报价咨询",
purpose: "quote-request",
requiredModules: ["inquiry", "records", "success-summary"],
apiContract: "/customer/inquiry-submissions",
configSchema: "capability.quote-request.v1",
},
} as const;
export type BrandTemplateModuleType = "identity" | "trust" | "offering" | "inquiry" | "contact";
export interface BrandTemplateModuleDefinition {
key: string;
type: BrandTemplateModuleType;
title: string;
required: boolean;
}
export interface BrandTemplateFieldDefinition {
scope: string;
key: string;
label: string;
type: string;
required: boolean;
}
export interface BrandTemplateDefinition {
key: BrandTemplateKey;
version: string;
name: string;
description: string;
serviceCategories: string[];
trustContentTypes: string[];
modules: BrandTemplateModuleDefinition[];
fields: BrandTemplateFieldDefinition[];
capabilities: CapabilityKey[];
}
export interface VisualTemplateDefinition {
key: VisualTemplateKey;
version: string;
name: string;
description: string;
supportedIndustryTemplates: readonly BrandTemplateKey[];
variants: Record<string, string>;
theme: { colors: Record<string, string>; radius: Record<string, string> };
layout?: { home: string[]; offerings: string[]; detail: string[]; profile: string[] };
}
export type VisualPageKey =
"home" | "offerings" | "detail" | "inquiry" | "success" | "records" | "profile";
export type VisualModuleType =
| "brand-identity"
| "hero"
| "trust"
| "offering-list"
| "offering-detail"
| "inquiry-form"
| "success-summary"
| "records-list"
| "contact";
export interface VisualTokenSet {
colors: Record<string, string>;
spacing: Record<string, string>;
typography: Record<string, string>;
radius: Record<string, string>;
shadows?: Record<string, string>;
}
export interface VisualAssetSlot {
key: string;
label: string;
required: boolean;
kind: "image" | "icon" | "logo" | "texture";
aspectRatio?: string;
fallback?: string;
}
export interface VisualDataSlot {
key: string;
source: "brand" | "trust" | "offering" | "inquiry" | "records" | "profile";
required: boolean;
description: string;
}
export interface VisualModuleDefinition {
key: string;
type: VisualModuleType;
variant: string;
required: boolean;
dataSlots?: string[];
assetSlots?: string[];
capability?: CapabilityKey;
}
export interface VisualPageDefinition {
key: VisualPageKey;
title: string;
renderer?: string;
modules: VisualModuleDefinition[];
}
export interface VisualTemplateManifest {
schemaVersion: "1.0";
key: VisualTemplateKey;
version: string;
name: string;
description: string;
supportedIndustryTemplates: BrandTemplateKey[];
brandFirst: true;
tokens: VisualTokenSet;
pages: VisualPageDefinition[];
assets: VisualAssetSlot[];
dataSlots: VisualDataSlot[];
capabilities: CapabilityKey[];
}
export interface TemplatePackage {
manifest: VisualTemplateManifest;
industryTemplateKey: BrandTemplateKey;
content: Record<string, unknown>;
forms: Record<string, unknown>[];
capabilityConfig: Record<string, unknown>;
fixtures: {
runtime: Record<string, unknown>;
visual: Record<string, unknown>;
};
}
export interface TemplatePackageManifest {
packageKey: string;
version: string;
displayName: string;
visualTemplateKey: VisualTemplateKey;
runtimeContract: "1.0";
supportedIndustryTemplates: readonly BrandTemplateKey[];
entrypoints: Readonly<Record<string, string>>;
requiredCapabilities: readonly CapabilityKey[];
defaultBrandSlug: string;
navigation: readonly {
key: string;
label: string;
page: string;
iconPath?: string;
selectedIconPath?: string;
}[];
renderers: Readonly<Record<string, string>>;
runtimeOwnedPages: readonly string[];
dataSlots: readonly {
key: string;
source: string;
required: boolean;
description: string;
}[];
templateFields?: readonly {
key: string;
page?: string;
binding?: string;
label: string;
help?: string;
input: string;
itemFields?: readonly { key: string; label: string; input?: string; required?: boolean }[];
itemValueKey?: string;
required?: boolean;
maxLength?: number;
placeholder?: string;
options?: readonly { value: string; label: string }[];
}[];
assetSlots: readonly {
key: string;
binding: string;
target: "brand" | "offering" | "trust";
label: string;
help: string;
required: boolean;
}[];
admin: {
sections: readonly {
key: string;
title: string;
description: string;
page: string;
target: "brand" | "offering" | "trust" | "inquiry";
previewTargets?: readonly {
key: string;
label: string;
composite?: boolean;
children?: readonly string[];
}[];
fields: readonly {
key: string;
binding: string;
label: string;
input: string;
help?: string;
required?: boolean;
itemFields?: readonly { key: string; label: string; input?: string; required?: boolean }[];
itemValueKey?: string;
maxLength?: number;
placeholder?: string;
options?: readonly { value: string; label: string }[];
previewTarget?: string;
}[];
}[];
};
trustContentTypes?: readonly {
type: string;
label: string;
adminFields: {
title: string;
summary: string;
content: string;
summaryHelp?: string;
summaryPlaceholder?: string;
};
help?: string;
placeholder?: string;
required?: boolean;
maxPublishedItems?: number;
hideStandardFields?: readonly ("summary" | "content")[];
configFields?: readonly {
key: string;
binding: string;
label: string;
input: string;
itemFields?: readonly { key: string; label: string; input?: string; required?: boolean }[];
itemValueKey?: string;
required?: boolean;
}[];
}[];
sampleContent?: Partial<Record<BrandTemplateKey, TemplateSampleContent>>;
}
export const templatePackageRegistry: readonly TemplatePackageManifest[] =
generatedTemplatePackageRegistry;
export function getTemplatePackageManifest(key: string): TemplatePackageManifest | undefined {
return templatePackageRegistry.find((item) => item.packageKey === key);
}
export function getTemplatePackageManifestForVisualKey(
visualTemplateKey: string,
): TemplatePackageManifest | undefined {
return templatePackageRegistry.find((item) => item.visualTemplateKey === visualTemplateKey);
}
export function validateTemplatePackageManifest(manifest: TemplatePackageManifest): string[] {
const errors: string[] = [];
if (!manifest.packageKey.trim()) errors.push("packageKey is required");
if (!manifest.version.trim()) errors.push("version is required");
if (manifest.runtimeContract !== "1.0") errors.push("unsupported runtimeContract");
if (!manifest.supportedIndustryTemplates.length)
errors.push("supportedIndustryTemplates must not be empty");
for (const page of [
"home",
"offerings",
"detail",
"inquiry",
"success",
"records",
"profile",
] as const) {
if (!manifest.entrypoints[page]?.trim()) errors.push(`entrypoints.${page} is required`);
}
return errors;
}
export interface TemplateSampleContent {
templateKey: BrandTemplateKey;
inquiryFormName: string;
offerings: Array<{
kind: "service" | "product" | "package" | "subscription";
name: string;
summary: string;
categoryKey: string;
}>;
trustContent: Array<{
type: string;
title: string;
content: string;
summary?: string;
config?: Record<string, unknown>;
}>;
fields: Array<{
key: string;
label: string;
type: string;
required: boolean;
options?: Array<{ label: string; value: string }>;
}>;
capabilityKey: string;
}
const doorsSampleContent: TemplateSampleContent = {
templateKey: "doors",
inquiryFormName: "门系统咨询表单",
offerings: [
{
kind: "product",
name: "序章·入户门",
summary: "为别墅入口定制的整樘门系统",
categoryKey: "entrance-door",
},
{
kind: "product",
name: "庭院·边界门",
summary: "连接建筑与庭院的定制门",
categoryKey: "garden-door",
},
{
kind: "product",
name: "室内·静谧门",
summary: "统一室内空间秩序的户内门",
categoryKey: "interior-door",
},
{
kind: "service",
name: "一对一门系统设计咨询",
summary: "从现场到方案的完整设计沟通",
categoryKey: "custom",
},
],
trustContent: [
{ type: "credential", title: "主理人的门作观", content: "示例内容,待品牌主理人完善。" },
{ type: "case", title: "别墅门系统案例", content: "示例内容,待品牌主理人完善。" },
{ type: "process", title: "从测量到交付", content: "示例内容,待品牌主理人完善。" },
{ type: "credential", title: "材料与工艺标准", content: "示例内容,待品牌主理人完善。" },
],
fields: [
{ key: "projectType", label: "项目类型", type: "select", required: false },
{ key: "projectStage", label: "项目阶段", type: "select", required: false },
{ key: "siteDescription", label: "项目概况", type: "textarea", required: false },
{ key: "phone", label: "联系方式", type: "phone", required: true },
],
capabilityKey: "doors",
};
const foodSampleContent: TemplateSampleContent = {
templateKey: "food",
inquiryFormName: "餐品预订与定制表单",
offerings: [
{
kind: "package",
name: "示例·今日套餐",
summary: "现做家常套餐示例内容。",
categoryKey: "set-meal",
},
{
kind: "service",
name: "示例·聚餐定制",
summary: "按人数和口味沟通定制餐品。",
categoryKey: "private-chef",
},
],
trustContent: [
{ type: "credential", title: "关于主理人", content: "示例内容,待品牌主理人完善。" },
{ type: "process", title: "从预订到取餐", content: "示例内容,待品牌主理人完善。" },
],
fields: [
{ key: "date", label: "用餐日期", type: "date", required: true },
{ key: "number", label: "用餐人数", type: "number", required: true },
{ key: "phone", label: "联系方式", type: "phone", required: true },
],
capabilityKey: "booking",
};
const personalSampleContent: TemplateSampleContent = {
templateKey: "personal",
inquiryFormName: "合作咨询表单",
offerings: [
{
kind: "service",
name: "示例·品牌定位咨询",
summary: "梳理品牌定位与下一步行动。",
categoryKey: "consulting",
},
{
kind: "service",
name: "示例·长期顾问支持",
summary: "围绕表达和转化提供持续支持。",
categoryKey: "advisory",
},
],
trustContent: [
{ type: "credential", title: "关于主理人", content: "示例内容,待品牌主理人完善。" },
{ type: "process", title: "合作方法", content: "示例内容,待品牌主理人完善。" },
],
fields: [
{ key: "name", label: "您的称呼", type: "text", required: true },
{ key: "phone", label: "联系方式", type: "phone", required: true },
{ key: "remark", label: "合作需求", type: "textarea", required: true },
],
capabilityKey: "inquiry",
};
export const templateSampleContent: Record<BrandTemplateKey, TemplateSampleContent> = {
personal: personalSampleContent,
food: foodSampleContent,
doors: doorsSampleContent,
};
export function getTemplateSampleContent(templateKey: string): TemplateSampleContent | undefined {
const packageSample = templatePackageRegistry.find((item) =>
item.supportedIndustryTemplates.includes(templateKey as BrandTemplateKey),
)?.sampleContent?.[templateKey as BrandTemplateKey];
return packageSample ?? templateSampleContent[templateKey as keyof typeof templateSampleContent];
}
const linjingEditorialManifest: VisualTemplateManifest = {
schemaVersion: "1.0",
key: "linjing-editorial",
version: "1.0.0",
name: "林境建筑画册",
description: "以个人品牌信任为主线、以高端项目作品为表达重点的编辑式视觉模板。",
supportedIndustryTemplates: ["personal", "doors"],
brandFirst: true,
tokens: {
colors: {
background: "#F7F5F1",
surface: "#FFFFFF",
foreground: "#252525",
muted: "#77736C",
accent: "#8A6846",
dark: "#202221",
},
spacing: { page: "32rpx", section: "56rpx", module: "24rpx" },
typography: { display: "56rpx", heading: "36rpx", body: "28rpx", caption: "22rpx" },
radius: { card: "16rpx", button: "999rpx", media: "12rpx" },
shadows: { card: "0 8rpx 32rpx rgba(32,34,33,0.08)" },
},
assets: [
{ key: "brand.logo", label: "品牌标志", required: false, kind: "logo" },
{
key: "home.hero",
label: "首页首屏图",
required: true,
kind: "image",
aspectRatio: "16:9",
},
{
key: "offering.cover",
label: "业务提供项封面",
required: true,
kind: "image",
aspectRatio: "1:1",
},
{
key: "profile.portrait",
label: "主理人肖像",
required: false,
kind: "image",
aspectRatio: "1:1",
},
{ key: "brand.texture", label: "品牌底纹", required: false, kind: "texture" },
],
dataSlots: [
{
key: "brand.identity",
source: "brand",
required: true,
description: "品牌名、定位和主理人身份",
},
{ key: "brand.hero", source: "brand", required: true, description: "品牌首屏表达和行动入口" },
{ key: "trust.proof", source: "trust", required: true, description: "经历、资质、案例和方法" },
{
key: "offerings.list",
source: "offering",
required: true,
description: "可展示的业务提供项",
},
{
key: "offering.detail",
source: "offering",
required: true,
description: "单个提供项的详情内容",
},
{ key: "inquiry.form", source: "inquiry", required: true, description: "品牌咨询或预约表单" },
{
key: "records.items",
source: "records",
required: true,
description: "用户提交后的跟进记录",
},
{
key: "profile.contact",
source: "profile",
required: true,
description: "联系方式和合作预期",
},
],
pages: [
{
key: "home",
title: "首页",
renderer: "linjing-home",
modules: [
{
key: "identity",
type: "brand-identity",
variant: "editorial-card",
required: true,
dataSlots: ["brand.identity"],
assetSlots: ["brand.logo"],
},
{
key: "hero",
type: "hero",
variant: "architectural",
required: true,
dataSlots: ["brand.hero"],
assetSlots: ["home.hero"],
},
{
key: "proof",
type: "trust",
variant: "proof-strip",
required: true,
dataSlots: ["trust.proof"],
},
{
key: "offerings",
type: "offering-list",
variant: "editorial-list",
required: true,
dataSlots: ["offerings.list"],
assetSlots: ["offering.cover"],
capability: "offerings",
},
{
key: "contact",
type: "contact",
variant: "quiet-footer",
required: true,
dataSlots: ["profile.contact"],
},
],
},
{
key: "offerings",
title: "业务提供项",
renderer: "linjing-offerings",
modules: [
{
key: "offerings",
type: "offering-list",
variant: "editorial-grid",
required: true,
dataSlots: ["offerings.list"],
assetSlots: ["offering.cover"],
capability: "offerings",
},
],
},
{
key: "detail",
title: "提供项详情",
renderer: "linjing-offering-detail",
modules: [
{
key: "detail",
type: "offering-detail",
variant: "project-case",
required: true,
dataSlots: ["offering.detail"],
assetSlots: ["offering.cover"],
capability: "offerings",
},
],
},
{
key: "inquiry",
title: "咨询与预约",
renderer: "linjing-inquiry",
modules: [
{
key: "inquiry",
type: "inquiry-form",
variant: "editorial-form",
required: true,
dataSlots: ["inquiry.form"],
capability: "inquiry",
},
],
},
{
key: "success",
title: "提交成功",
renderer: "linjing-success",
modules: [
{
key: "success",
type: "success-summary",
variant: "editorial-confirmation",
required: true,
dataSlots: ["brand.identity"],
},
],
},
{
key: "records",
title: "我的记录",
renderer: "linjing-records",
modules: [
{
key: "records",
type: "records-list",
variant: "timeline",
required: true,
dataSlots: ["records.items"],
},
],
},
{
key: "profile",
title: "主理人与我",
renderer: "linjing-profile",
modules: [
{
key: "identity",
type: "brand-identity",
variant: "profile-editorial",
required: true,
dataSlots: ["brand.identity"],
assetSlots: ["profile.portrait"],
},
{
key: "contact",
type: "contact",
variant: "contact-sheet",
required: true,
dataSlots: ["profile.contact"],
},
],
},
],
capabilities: ["offerings", "inquiry"],
};
export const visualTemplateManifests: Record<VisualTemplateKey, VisualTemplateManifest> = {
"linjing-editorial": linjingEditorialManifest,
"acheng-campus-food": {
...linjingEditorialManifest,
key: "acheng-campus-food",
version: "1.0.0",
name: "阿成校园餐",
description: "面向校园餐饮摊贩的菜单、出摊动态和团体预订视觉模板。",
supportedIndustryTemplates: ["food"],
tokens: {
...linjingEditorialManifest.tokens,
colors: {
background: "#FFF8F0",
surface: "#FFFFFF",
foreground: "#29231F",
muted: "#7A6A60",
accent: "#E87532",
dark: "#3B2118",
},
radius: { card: "24rpx", button: "999rpx", media: "20rpx" },
},
pages: linjingEditorialManifest.pages.map((pageDefinition) => {
const renderer =
pageDefinition.key === "home"
? "acheng-home"
: pageDefinition.key === "offerings"
? "acheng-offerings"
: pageDefinition.key === "profile"
? "acheng-profile"
: pageDefinition.renderer;
return renderer ? { ...pageDefinition, renderer } : pageDefinition;
}),
capabilities: ["offerings", "inquiry", "booking"],
},
};
export function getVisualTemplateManifest(key: string): VisualTemplateManifest | undefined {
return visualTemplateManifests[key as VisualTemplateKey];
}
export function isVisualTemplateCompatible(
visualTemplate: VisualTemplateDefinition | VisualTemplateManifest,
industryTemplateKey: string,
): boolean {
return visualTemplate.supportedIndustryTemplates.includes(
industryTemplateKey as BrandTemplateKey,
);
}
export const visualTemplates: Record<VisualTemplateKey, VisualTemplateDefinition> = {
"linjing-editorial": {
key: "linjing-editorial",
version: "1.0.0",
name: "林境建筑画册",
description: "适合高端定制、建筑作品和项目型个人品牌。",
supportedIndustryTemplates: ["personal", "doors"],
variants: { hero: "architectural", offeringList: "editorial", detail: "project-case" },
theme: {
colors: { background: "#F7F5F1", foreground: "#252525", accent: "#8A6846", dark: "#202221" },
radius: { card: "16rpx" },
},
layout: {
home: ["founder-card", "brand-hero", "trust-proof", "trust-manifesto", "offering-list"],
offerings: ["offering-list"],
detail: ["offering-detail"],
profile: ["profile"],
},
},
"acheng-campus-food": {
key: "acheng-campus-food",
version: "1.0.0",
name: "阿成校园餐",
description: "适合校园餐饮、套餐预订和团体定制的暖橙菜单视觉。",
supportedIndustryTemplates: ["food"],
variants: { hero: "stall-board", offeringList: "menu-card", detail: "dish-detail" },
theme: {
colors: { background: "#FFF8F0", foreground: "#29231F", accent: "#E87532", dark: "#3B2118" },
radius: { card: "24rpx" },
},
layout: {
home: ["founder-card", "brand-hero", "trust-proof", "offering-list"],
offerings: ["offering-list"],
detail: ["offering-detail"],
profile: ["profile"],
},
},
};
export function listVisualTemplateKeys(): VisualTemplateKey[] {
return Object.keys(visualTemplates) as VisualTemplateKey[];
}
export function getVisualTemplate(key: string): VisualTemplateDefinition | undefined {
return visualTemplates[key as VisualTemplateKey];
}
export function getDefaultVisualTemplateKey(industryTemplateKey: string): VisualTemplateKey {
return (
listVisualTemplateKeys().find((key) =>
visualTemplates[key].supportedIndustryTemplates.includes(
industryTemplateKey as BrandTemplateKey,
),
) ?? "linjing-editorial"
);
}
export function canTransitionWorkflow(workflowKey: string, from: string, to: string): boolean {
const workflow = workflowRegistry[workflowKey as keyof typeof workflowRegistry] as
WorkflowDefinition | undefined;
return workflow ? from === to || workflow.transitions[from]?.includes(to) === true : false;
}
export function resolveCapabilities(keys: readonly CapabilityKey[]): CapabilityDefinition[] {
return keys.map((key) => capabilityRegistry[key]);
}
export const brandTemplates = {
personal: {
key: "personal",
version: "1.0.0",
name: "个人品牌",
description: "围绕定位、信任、作品与合作建立个人品牌。",
serviceCategories: ["consulting", "collaboration", "custom"],
trustContentTypes: [
"profile",
"experience",
"credential",
"portfolio",
"process",
"testimonial",
],
modules: [
{ key: "identity", type: "identity", title: "品牌身份", required: true },
{ key: "trust", type: "trust", title: "信任内容", required: true },
{ key: "offerings", type: "offering", title: "业务提供项", required: true },
{ key: "inquiry", type: "inquiry", title: "联系与咨询", required: true },
{ key: "contact", type: "contact", title: "品牌表达", required: true },
],
fields: [
{ scope: "profile", key: "name", label: "品牌名称", type: "text", required: true },
{ scope: "profile", key: "tagline", label: "一句话定位", type: "text", required: true },
{ scope: "profile", key: "audience", label: "服务对象", type: "textarea", required: true },
{
scope: "profile",
key: "valueProposition",
label: "提供的价值",
type: "textarea",
required: true,
},
{
scope: "profile",
key: "trustProof",
label: "信任证明入口",
type: "textarea",
required: true,
},
],
capabilities: ["offerings", "inquiry"],
},
food: {
key: "food",
version: "1.0.0",
name: "餐饮模板",
description: "适用于餐饮服务与套餐预约的行业模板。",
serviceCategories: ["food-package", "private-chef", "custom"],
trustContentTypes: [
"profile",
"experience",
"credential",
"portfolio",
"process",
"testimonial",
],
modules: [
{ key: "identity", type: "identity", title: "品牌身份", required: true },
{ key: "trust", type: "trust", title: "信任内容", required: true },
{ key: "offerings", type: "offering", title: "菜单与服务", required: true },
{ key: "inquiry", type: "inquiry", title: "预约与咨询", required: true },
{ key: "contact", type: "contact", title: "品牌表达", required: true },
],
fields: [
{ scope: "profile", key: "name", label: "品牌名称", type: "text", required: true },
{ scope: "profile", key: "tagline", label: "一句话定位", type: "text", required: true },
{ scope: "profile", key: "audience", label: "服务对象", type: "textarea", required: true },
{
scope: "profile",
key: "valueProposition",
label: "提供的价值",
type: "textarea",
required: true,
},
{
scope: "profile",
key: "trustProof",
label: "信任证明入口",
type: "textarea",
required: true,
},
],
capabilities: ["offerings", "inquiry", "booking"],
},
doors: {
key: "doors",
version: "1.0.0",
name: "高端门窗模板",
description: "适用于别墅门、院门、室内门与定制门窗服务的行业模板。",
serviceCategories: ["entrance-door", "garden-door", "interior-door", "custom"],
trustContentTypes: [
"profile",
"experience",
"credential",
"portfolio",
"process",
"testimonial",
],
modules: [
{ key: "identity", type: "identity", title: "品牌身份", required: true },
{ key: "trust", type: "trust", title: "工艺与信任", required: true },
{ key: "offerings", type: "offering", title: "门窗系列", required: true },
{ key: "inquiry", type: "inquiry", title: "设计咨询", required: true },
{ key: "contact", type: "contact", title: "品牌表达", required: true },
],
fields: [
{ scope: "profile", key: "name", label: "品牌名称", type: "text", required: true },
{ scope: "profile", key: "tagline", label: "一句话定位", type: "text", required: true },
{ scope: "profile", key: "audience", label: "服务对象", type: "textarea", required: true },
{
scope: "profile",
key: "valueProposition",
label: "提供的价值",
type: "textarea",
required: true,
},
{
scope: "profile",
key: "trustProof",
label: "信任证明入口",
type: "textarea",
required: true,
},
],
capabilities: ["offerings", "inquiry"],
},
} satisfies Record<BrandTemplateKey, BrandTemplateDefinition>;
export function isBrandTemplateKey(value: string): value is BrandTemplateKey {
return Object.prototype.hasOwnProperty.call(brandTemplates, value);
}
export function getBrandTemplate(key: string): BrandTemplateDefinition | undefined {
return isBrandTemplateKey(key) ? brandTemplates[key] : undefined;
}
+3
View File
@@ -0,0 +1,3 @@
export type BrandTemplateKey = "personal" | "food" | "doors";
export type VisualTemplateKey = "linjing-editorial" | "acheng-campus-food";
export type CapabilityKey = "offerings" | "inquiry" | "booking" | "quote-request";
@@ -0,0 +1,108 @@
import type { BrandTemplateKey } from "./template-keys.js";
import type { CapabilityKey } from "./template-keys.js";
import type { VisualTemplateKey } from "./template-keys.js";
import type { TemplateSampleContent } from "./template-sample-content.js";
export interface TemplatePackageManifest {
packageKey: string;
version: string;
displayName: string;
visualTemplateKey: VisualTemplateKey;
runtimeContract: "1.0";
supportedIndustryTemplates: readonly BrandTemplateKey[];
entrypoints: Readonly<Record<string, string>>;
requiredCapabilities: readonly CapabilityKey[];
defaultBrandSlug: string;
navigation: readonly {
key: string;
label: string;
page: string;
iconPath?: string;
selectedIconPath?: string;
}[];
renderers: Readonly<Record<string, string>>;
runtimeOwnedPages: readonly string[];
dataSlots: readonly {
key: string;
source: string;
required: boolean;
description: string;
}[];
templateFields?: readonly {
key: string;
page?: string;
binding?: string;
label: string;
help?: string;
input: string;
itemFields?: readonly { key: string; label: string; input?: string; required?: boolean }[];
itemValueKey?: string;
required?: boolean;
maxLength?: number;
placeholder?: string;
options?: readonly { value: string; label: string }[];
}[];
assetSlots: readonly {
key: string;
binding: string;
target: "brand" | "offering" | "trust";
label: string;
help: string;
required: boolean;
}[];
admin: {
sections: readonly {
key: string;
title: string;
description: string;
page: string;
target: "brand" | "offering" | "trust" | "inquiry";
previewTargets?: readonly {
key: string;
label: string;
composite?: boolean;
children?: readonly string[];
}[];
fields: readonly {
key: string;
binding: string;
label: string;
input: string;
help?: string;
required?: boolean;
itemFields?: readonly { key: string; label: string; input?: string; required?: boolean }[];
itemValueKey?: string;
maxLength?: number;
placeholder?: string;
options?: readonly { value: string; label: string }[];
previewTarget?: string;
}[];
}[];
};
trustContentTypes?: readonly {
type: string;
label: string;
adminFields: {
title: string;
summary: string;
content: string;
summaryHelp?: string;
summaryPlaceholder?: string;
};
help?: string;
placeholder?: string;
required?: boolean;
maxPublishedItems?: number;
hideStandardFields?: readonly ("summary" | "content")[];
configFields?: readonly {
key: string;
binding: string;
label: string;
input: string;
itemFields?: readonly { key: string; label: string; input?: string; required?: boolean }[];
itemValueKey?: string;
required?: boolean;
}[];
}[];
sampleContent?: Partial<Record<BrandTemplateKey, TemplateSampleContent>>;
}
+36
View File
@@ -0,0 +1,36 @@
import { generatedTemplatePackageRegistry } from "./generated-template-packages.js";
import type { TemplatePackageManifest } from "./template-package-manifest.js";
export const templatePackageRegistry: readonly TemplatePackageManifest[] =
generatedTemplatePackageRegistry;
export function getTemplatePackageManifest(key: string): TemplatePackageManifest | undefined {
return templatePackageRegistry.find((item) => item.packageKey === key);
}
export function getTemplatePackageManifestForVisualKey(
visualTemplateKey: string,
): TemplatePackageManifest | undefined {
return templatePackageRegistry.find((item) => item.visualTemplateKey === visualTemplateKey);
}
export function validateTemplatePackageManifest(manifest: TemplatePackageManifest): string[] {
const errors: string[] = [];
if (!manifest.packageKey.trim()) errors.push("packageKey is required");
if (!manifest.version.trim()) errors.push("version is required");
if (manifest.runtimeContract !== "1.0") errors.push("unsupported runtimeContract");
if (!manifest.supportedIndustryTemplates.length)
errors.push("supportedIndustryTemplates must not be empty");
for (const page of [
"home",
"offerings",
"detail",
"inquiry",
"success",
"records",
"profile",
] as const) {
if (!manifest.entrypoints[page]?.trim()) errors.push(`entrypoints.${page} is required`);
}
return errors;
}
@@ -0,0 +1,143 @@
import type { BrandTemplateKey } from "./template-keys.js";
import { templatePackageRegistry } from "./template-packages.js";
export interface TemplateSampleContent {
templateKey: BrandTemplateKey;
inquiryFormName: string;
offerings: Array<{
kind: "service" | "product" | "package" | "subscription";
name: string;
summary: string;
categoryKey: string;
}>;
trustContent: Array<{
type: string;
title: string;
content: string;
summary?: string;
config?: Record<string, unknown>;
}>;
fields: Array<{
key: string;
label: string;
type: string;
required: boolean;
options?: Array<{ label: string; value: string }>;
}>;
capabilityKey: string;
}
const doorsSampleContent: TemplateSampleContent = {
templateKey: "doors",
inquiryFormName: "门系统咨询表单",
offerings: [
{
kind: "product",
name: "序章·入户门",
summary: "为别墅入口定制的整樘门系统",
categoryKey: "entrance-door",
},
{
kind: "product",
name: "庭院·边界门",
summary: "连接建筑与庭院的定制门",
categoryKey: "garden-door",
},
{
kind: "product",
name: "室内·静谧门",
summary: "统一室内空间秩序的户内门",
categoryKey: "interior-door",
},
{
kind: "service",
name: "一对一门系统设计咨询",
summary: "从现场到方案的完整设计沟通",
categoryKey: "custom",
},
],
trustContent: [
{ type: "credential", title: "主理人的门作观", content: "示例内容,待品牌主理人完善。" },
{ type: "case", title: "别墅门系统案例", content: "示例内容,待品牌主理人完善。" },
{ type: "process", title: "从测量到交付", content: "示例内容,待品牌主理人完善。" },
{ type: "credential", title: "材料与工艺标准", content: "示例内容,待品牌主理人完善。" },
],
fields: [
{ key: "projectType", label: "项目类型", type: "select", required: false },
{ key: "projectStage", label: "项目阶段", type: "select", required: false },
{ key: "siteDescription", label: "项目概况", type: "textarea", required: false },
{ key: "phone", label: "联系方式", type: "phone", required: true },
],
capabilityKey: "doors",
};
const foodSampleContent: TemplateSampleContent = {
templateKey: "food",
inquiryFormName: "餐品预订与定制表单",
offerings: [
{
kind: "package",
name: "示例·今日套餐",
summary: "现做家常套餐示例内容。",
categoryKey: "set-meal",
},
{
kind: "service",
name: "示例·聚餐定制",
summary: "按人数和口味沟通定制餐品。",
categoryKey: "private-chef",
},
],
trustContent: [
{ type: "credential", title: "关于主理人", content: "示例内容,待品牌主理人完善。" },
{ type: "process", title: "从预订到取餐", content: "示例内容,待品牌主理人完善。" },
],
fields: [
{ key: "date", label: "用餐日期", type: "date", required: true },
{ key: "number", label: "用餐人数", type: "number", required: true },
{ key: "phone", label: "联系方式", type: "phone", required: true },
],
capabilityKey: "booking",
};
const personalSampleContent: TemplateSampleContent = {
templateKey: "personal",
inquiryFormName: "合作咨询表单",
offerings: [
{
kind: "service",
name: "示例·品牌定位咨询",
summary: "梳理品牌定位与下一步行动。",
categoryKey: "consulting",
},
{
kind: "service",
name: "示例·长期顾问支持",
summary: "围绕表达和转化提供持续支持。",
categoryKey: "advisory",
},
],
trustContent: [
{ type: "credential", title: "关于主理人", content: "示例内容,待品牌主理人完善。" },
{ type: "process", title: "合作方法", content: "示例内容,待品牌主理人完善。" },
],
fields: [
{ key: "name", label: "您的称呼", type: "text", required: true },
{ key: "phone", label: "联系方式", type: "phone", required: true },
{ key: "remark", label: "合作需求", type: "textarea", required: true },
],
capabilityKey: "inquiry",
};
export const templateSampleContent: Record<BrandTemplateKey, TemplateSampleContent> = {
personal: personalSampleContent,
food: foodSampleContent,
doors: doorsSampleContent,
};
export function getTemplateSampleContent(templateKey: string): TemplateSampleContent | undefined {
const packageSample = templatePackageRegistry.find((item) =>
item.supportedIndustryTemplates.includes(templateKey as BrandTemplateKey),
)?.sampleContent?.[templateKey as BrandTemplateKey];
return packageSample ?? templateSampleContent[templateKey as keyof typeof templateSampleContent];
}
+282
View File
@@ -0,0 +1,282 @@
import type { BrandTemplateKey } from "./template-keys.js";
import type { VisualTemplateKey } from "./template-keys.js";
import type { VisualTemplateDefinition, VisualTemplateManifest } from "./brand-contracts.js";
const linjingEditorialManifest: VisualTemplateManifest = {
schemaVersion: "1.0",
key: "linjing-editorial",
version: "1.0.0",
name: "林境建筑画册",
description: "以个人品牌信任为主线、以高端项目作品为表达重点的编辑式视觉模板。",
supportedIndustryTemplates: ["personal", "doors"],
brandFirst: true,
tokens: {
colors: {
background: "#F7F5F1",
surface: "#FFFFFF",
foreground: "#252525",
muted: "#77736C",
accent: "#8A6846",
dark: "#202221",
},
spacing: { page: "32rpx", section: "56rpx", module: "24rpx" },
typography: { display: "56rpx", heading: "36rpx", body: "28rpx", caption: "22rpx" },
radius: { card: "16rpx", button: "999rpx", media: "12rpx" },
shadows: { card: "0 8rpx 32rpx rgba(32,34,33,0.08)" },
},
assets: [
{ key: "brand.logo", label: "品牌标志", required: false, kind: "logo" },
{
key: "home.hero",
label: "首页首屏图",
required: true,
kind: "image",
aspectRatio: "16:9",
},
{
key: "offering.cover",
label: "业务提供项封面",
required: true,
kind: "image",
aspectRatio: "1:1",
},
{
key: "profile.portrait",
label: "主理人肖像",
required: false,
kind: "image",
aspectRatio: "1:1",
},
{ key: "brand.texture", label: "品牌底纹", required: false, kind: "texture" },
],
dataSlots: [
{
key: "brand.identity",
source: "brand",
required: true,
description: "品牌名、定位和主理人身份",
},
{ key: "brand.hero", source: "brand", required: true, description: "品牌首屏表达和行动入口" },
{ key: "trust.proof", source: "trust", required: true, description: "经历、资质、案例和方法" },
{
key: "offerings.list",
source: "offering",
required: true,
description: "可展示的业务提供项",
},
{
key: "offering.detail",
source: "offering",
required: true,
description: "单个提供项的详情内容",
},
{ key: "inquiry.form", source: "inquiry", required: true, description: "品牌咨询或预约表单" },
{
key: "records.items",
source: "records",
required: true,
description: "用户提交后的跟进记录",
},
{
key: "profile.contact",
source: "profile",
required: true,
description: "联系方式和合作预期",
},
],
pages: [
{
key: "home",
title: "首页",
renderer: "linjing-home",
modules: [
{
key: "identity",
type: "brand-identity",
variant: "editorial-card",
required: true,
dataSlots: ["brand.identity"],
assetSlots: ["brand.logo"],
},
{
key: "hero",
type: "hero",
variant: "architectural",
required: true,
dataSlots: ["brand.hero"],
assetSlots: ["home.hero"],
},
{
key: "proof",
type: "trust",
variant: "proof-strip",
required: true,
dataSlots: ["trust.proof"],
},
{
key: "offerings",
type: "offering-list",
variant: "editorial-list",
required: true,
dataSlots: ["offerings.list"],
assetSlots: ["offering.cover"],
capability: "offerings",
},
{
key: "contact",
type: "contact",
variant: "quiet-footer",
required: true,
dataSlots: ["profile.contact"],
},
],
},
{
key: "offerings",
title: "业务提供项",
renderer: "linjing-offerings",
modules: [
{
key: "offerings",
type: "offering-list",
variant: "editorial-grid",
required: true,
dataSlots: ["offerings.list"],
assetSlots: ["offering.cover"],
capability: "offerings",
},
],
},
{
key: "detail",
title: "提供项详情",
renderer: "linjing-offering-detail",
modules: [
{
key: "detail",
type: "offering-detail",
variant: "project-case",
required: true,
dataSlots: ["offering.detail"],
assetSlots: ["offering.cover"],
capability: "offerings",
},
],
},
{
key: "inquiry",
title: "咨询与预约",
renderer: "linjing-inquiry",
modules: [
{
key: "inquiry",
type: "inquiry-form",
variant: "editorial-form",
required: true,
dataSlots: ["inquiry.form"],
capability: "inquiry",
},
],
},
{
key: "success",
title: "提交成功",
renderer: "linjing-success",
modules: [
{
key: "success",
type: "success-summary",
variant: "editorial-confirmation",
required: true,
dataSlots: ["brand.identity"],
},
],
},
{
key: "records",
title: "我的记录",
renderer: "linjing-records",
modules: [
{
key: "records",
type: "records-list",
variant: "timeline",
required: true,
dataSlots: ["records.items"],
},
],
},
{
key: "profile",
title: "主理人与我",
renderer: "linjing-profile",
modules: [
{
key: "identity",
type: "brand-identity",
variant: "profile-editorial",
required: true,
dataSlots: ["brand.identity"],
assetSlots: ["profile.portrait"],
},
{
key: "contact",
type: "contact",
variant: "contact-sheet",
required: true,
dataSlots: ["profile.contact"],
},
],
},
],
capabilities: ["offerings", "inquiry"],
};
export const visualTemplateManifests: Record<VisualTemplateKey, VisualTemplateManifest> = {
"linjing-editorial": linjingEditorialManifest,
"acheng-campus-food": {
...linjingEditorialManifest,
key: "acheng-campus-food",
version: "1.0.0",
name: "阿成校园餐",
description: "面向校园餐饮摊贩的菜单、出摊动态和团体预订视觉模板。",
supportedIndustryTemplates: ["food"],
tokens: {
...linjingEditorialManifest.tokens,
colors: {
background: "#FFF8F0",
surface: "#FFFFFF",
foreground: "#29231F",
muted: "#7A6A60",
accent: "#E87532",
dark: "#3B2118",
},
radius: { card: "24rpx", button: "999rpx", media: "20rpx" },
},
pages: linjingEditorialManifest.pages.map((pageDefinition) => {
const renderer =
pageDefinition.key === "home"
? "acheng-home"
: pageDefinition.key === "offerings"
? "acheng-offerings"
: pageDefinition.key === "profile"
? "acheng-profile"
: pageDefinition.renderer;
return renderer ? { ...pageDefinition, renderer } : pageDefinition;
}),
capabilities: ["offerings", "inquiry", "booking"],
},
};
export function getVisualTemplateManifest(key: string): VisualTemplateManifest | undefined {
return visualTemplateManifests[key as VisualTemplateKey];
}
export function isVisualTemplateCompatible(
visualTemplate: VisualTemplateDefinition | VisualTemplateManifest,
industryTemplateKey: string,
): boolean {
return visualTemplate.supportedIndustryTemplates.includes(
industryTemplateKey as BrandTemplateKey,
);
}
+60
View File
@@ -0,0 +1,60 @@
import type { BrandTemplateKey } from "./template-keys.js";
import type { VisualTemplateKey } from "./template-keys.js";
import type { VisualTemplateDefinition } from "./brand-contracts.js";
export const visualTemplates: Record<VisualTemplateKey, VisualTemplateDefinition> = {
"linjing-editorial": {
key: "linjing-editorial",
version: "1.0.0",
name: "林境建筑画册",
description: "适合高端定制、建筑作品和项目型个人品牌。",
supportedIndustryTemplates: ["personal", "doors"],
variants: { hero: "architectural", offeringList: "editorial", detail: "project-case" },
theme: {
colors: { background: "#F7F5F1", foreground: "#252525", accent: "#8A6846", dark: "#202221" },
radius: { card: "16rpx" },
},
layout: {
home: ["founder-card", "brand-hero", "trust-proof", "trust-manifesto", "offering-list"],
offerings: ["offering-list"],
detail: ["offering-detail"],
profile: ["profile"],
},
},
"acheng-campus-food": {
key: "acheng-campus-food",
version: "1.0.0",
name: "阿成校园餐",
description: "适合校园餐饮、套餐预订和团体定制的暖橙菜单视觉。",
supportedIndustryTemplates: ["food"],
variants: { hero: "stall-board", offeringList: "menu-card", detail: "dish-detail" },
theme: {
colors: { background: "#FFF8F0", foreground: "#29231F", accent: "#E87532", dark: "#3B2118" },
radius: { card: "24rpx" },
},
layout: {
home: ["founder-card", "brand-hero", "trust-proof", "offering-list"],
offerings: ["offering-list"],
detail: ["offering-detail"],
profile: ["profile"],
},
},
};
export function listVisualTemplateKeys(): VisualTemplateKey[] {
return Object.keys(visualTemplates) as VisualTemplateKey[];
}
export function getVisualTemplate(key: string): VisualTemplateDefinition | undefined {
return visualTemplates[key as VisualTemplateKey];
}
export function getDefaultVisualTemplateKey(industryTemplateKey: string): VisualTemplateKey {
return (
listVisualTemplateKeys().find((key) =>
visualTemplates[key].supportedIndustryTemplates.includes(
industryTemplateKey as BrandTemplateKey,
),
) ?? "linjing-editorial"
);
}
+14
View File
@@ -0,0 +1,14 @@
import type { WorkflowDefinition } from "./capability-contracts.js";
import type { CapabilityDefinition } from "./capability-contracts.js";
import { capabilityRegistry, workflowRegistry } from "./capability-contracts.js";
import type { CapabilityKey } from "./template-keys.js";
export function canTransitionWorkflow(workflowKey: string, from: string, to: string): boolean {
const workflow = workflowRegistry[workflowKey as keyof typeof workflowRegistry] as
WorkflowDefinition | undefined;
return workflow ? from === to || workflow.transitions[from]?.includes(to) === true : false;
}
export function resolveCapabilities(keys: readonly CapabilityKey[]): CapabilityDefinition[] {
return keys.map((key) => capabilityRegistry[key]);
}