Compare commits

...
2 Commits
Author SHA1 Message Date
que01 577c4d4d8e Merge pull request 'refactor: 抽取业务预览投影规则并补充单测' (#17) from refactor/offering-preview-projection into main
CI / Browser smoke (push) Has been skipped
CI / Static checks (push) Successful in 50s
CI / API integration (push) Successful in 1m9s
CI / Production build (push) Successful in 1m20s
Reviewed-on: #17
2026-10-29 07:18:44 +00:00
que01 45a5e4d666 refactor: 抽取业务预览投影规则并补充单测
CI / Browser smoke (pull_request) Successful in 47s
CI / Static checks (pull_request) Successful in 1m0s
CI / API integration (pull_request) Successful in 1m7s
CI / Production build (pull_request) Successful in 1m24s
2026-10-29 15:09:53 +08:00
5 changed files with 206 additions and 52 deletions

No files matched your search

@@ -1,7 +1,7 @@
{
"schemaVersion": 1,
"scope": "模板完成证据登记,保留命令、日志与产物哈希",
"generatedAt": "2026-10-29T06:24:26.667Z",
"generatedAt": "2026-10-29T07:09:56.748Z",
"templates": {
"acheng-campus-food": {
"real-manifest-interaction": {
@@ -256,5 +256,5 @@
}
}
},
"sourceTreeHash": "5d81aec11fe39aa90095a7855b1cef41d7d48efc92aa19f7c9fd9a2c0b872b11"
"sourceTreeHash": "6c984c7a56aeef55ed6af2b9f95ec5a8fb2073405b14846fdc79e056c8fe2a65"
}
@@ -0,0 +1,63 @@
import type { RuntimeOffering } from "@personal-brand/api-client";
type RuntimePresentation = RuntimeOffering["presentation"];
function isFilledString(value: unknown): value is string {
return typeof value === "string" && value.trim() !== "";
}
/**
* 把表单草稿投影到单条 Runtime Offering 上。
* 该函数是 buildOfferingPreviewWorkspace 的核心合并规则:
* - name/coverUrl 等展示字段为空时保留原值,避免输入中间态清空预览;
* - summary/priceText 允许清空为空字符串;
* - presentation 由原值、模板 config、config.presentation 与事实字段逐层合并;
* - detailHero 优先于 coverUrl,两者都为空时保留原 heroImage。
*/
export function projectOfferingPreviewFields(options: {
item: Pick<RuntimeOffering, "name" | "summary" | "priceText" | "coverUrl" | "presentation">;
config: Record<string, unknown>;
formValues: Record<string, unknown>;
}): {
name: string;
summary: string;
priceText: string | null;
coverUrl: string | null;
presentation: RuntimePresentation;
} {
const { item, config, formValues } = options;
const nestedPresentation =
config.presentation && typeof config.presentation === "object"
? (config.presentation as Record<string, unknown>)
: {};
const configDetails =
config.details && typeof config.details === "object"
? (config.details as Record<string, unknown>)
: {};
const presentation: RuntimePresentation = {
...item.presentation,
...config,
...nestedPresentation,
...(typeof config.area === "string" ? { area: config.area } : {}),
...(typeof config.series === "string" ? { series: config.series } : {}),
...(typeof config.spaceType === "string" ? { spaceType: config.spaceType } : {}),
heroImage: isFilledString(config.detailHero)
? config.detailHero
: isFilledString(formValues.coverUrl)
? formValues.coverUrl
: (item.coverUrl ?? null),
details: {
...item.presentation.details,
...configDetails,
},
};
return {
name: isFilledString(formValues.name) ? formValues.name : item.name,
summary: typeof formValues.summary === "string" ? formValues.summary : item.summary,
priceText: typeof formValues.priceText === "string" ? formValues.priceText : item.priceText,
coverUrl: isFilledString(formValues.coverUrl) ? formValues.coverUrl : item.coverUrl,
presentation,
};
}
@@ -7,6 +7,7 @@ import type {
TemplateAdminField,
} from "@personal-brand/api-client";
import { applyPresentationValues } from "../../lib/presentation/presentation-bindings.js";
import { projectOfferingPreviewFields } from "./offering-preview-projection.js";
export function previewFieldsByTarget(
sections: AdminTemplateContent["admin"]["sections"],
@@ -33,60 +34,11 @@ export function buildOfferingPreviewWorkspace(options: {
[{ key: "offering", fields: templateFields }],
formValues,
);
const offeringValues = {
name: formValues.name,
summary: formValues.summary,
description: formValues.description,
priceText: formValues.priceText,
coverUrl: formValues.coverUrl,
};
return {
...previewWorkspace,
offerings: previewWorkspace.offerings.map((item) =>
item.id === editingOffering.id
? {
...item,
name:
typeof offeringValues.name === "string" && offeringValues.name.trim()
? offeringValues.name
: item.name,
summary:
typeof offeringValues.summary === "string" ? offeringValues.summary : item.summary,
priceText:
typeof offeringValues.priceText === "string"
? offeringValues.priceText
: item.priceText,
coverUrl:
typeof offeringValues.coverUrl === "string" && offeringValues.coverUrl.trim()
? offeringValues.coverUrl
: item.coverUrl,
config,
presentation: {
...item.presentation,
...config,
...(config.presentation && typeof config.presentation === "object"
? (config.presentation as Record<string, unknown>)
: {}),
...(typeof config.area === "string" ? { area: config.area } : {}),
...(typeof config.series === "string" ? { series: config.series } : {}),
...(typeof config.spaceType === "string" ? { spaceType: config.spaceType } : {}),
heroImage:
typeof config.detailHero === "string"
? config.detailHero
: typeof offeringValues.coverUrl === "string" && offeringValues.coverUrl.trim()
? offeringValues.coverUrl
: (item.coverUrl ?? null),
details: {
...item.presentation.details,
...(config.details && typeof config.details === "object"
? {
...item.presentation.details,
...(config.details as Record<string, unknown>),
}
: {}),
},
},
}
? { ...item, ...projectOfferingPreviewFields({ item, config, formValues }) }
: item,
),
};
@@ -0,0 +1,138 @@
import assert from "node:assert/strict";
import test from "node:test";
import { projectOfferingPreviewFields } from "../src/features/services/offering-preview-projection.ts";
const baseItem = {
name: "原名称",
summary: "原简介",
priceText: "原价格",
coverUrl: "/media/original-cover.jpg",
presentation: {
categoryKey: "portfolio",
categoryLabel: "品牌视觉",
heroImage: "/media/original-hero.jpg",
keywords: ["原始"],
media: [],
details: {
background: "原始背景",
designConcept: "",
crafts: [],
materialsList: [],
},
},
};
test("filled name and coverUrl override originals", () => {
const result = projectOfferingPreviewFields({
item: baseItem,
config: {},
formValues: {
name: "新名称",
coverUrl: "/media/new-cover.jpg",
summary: "",
priceText: "",
},
});
assert.equal(result.name, "新名称");
assert.equal(result.coverUrl, "/media/new-cover.jpg");
// summary/priceText 空字符串应覆盖原值(允许清空)。
assert.equal(result.summary, "");
assert.equal(result.priceText, "");
});
test("empty name and coverUrl preserve originals", () => {
const result = projectOfferingPreviewFields({
item: baseItem,
config: {},
formValues: {
name: " ",
coverUrl: "",
summary: "新简介",
},
});
assert.equal(result.name, "原名称");
assert.equal(result.coverUrl, "/media/original-cover.jpg");
assert.equal(result.summary, "新简介");
});
test("presentation merges base config and nested presentation", () => {
const result = projectOfferingPreviewFields({
item: baseItem,
config: {
area: "杭州",
series: "品牌焕新",
spaceType: "线上与线下",
presentation: { categoryLabel: "新分类" },
keywords: ["新关键词"],
},
formValues: {},
});
assert.equal(result.presentation.area, "杭州");
assert.equal(result.presentation.series, "品牌焕新");
assert.equal(result.presentation.spaceType, "线上与线下");
assert.equal(result.presentation.categoryLabel, "新分类");
assert.deepEqual(result.presentation.keywords, ["新关键词"]);
// categoryKey 不被覆盖时保留原值。
assert.equal(result.presentation.categoryKey, "portfolio");
});
test("heroImage follows detailHero, then coverUrl, then original", () => {
const hero = projectOfferingPreviewFields({
item: baseItem,
config: { detailHero: "/media/detail-hero.jpg" },
formValues: { coverUrl: "/media/new-cover.jpg" },
});
assert.equal(hero.presentation.heroImage, "/media/detail-hero.jpg");
const fallbackCover = projectOfferingPreviewFields({
item: baseItem,
config: { detailHero: "" },
formValues: { coverUrl: "/media/new-cover.jpg" },
});
assert.equal(fallbackCover.presentation.heroImage, "/media/new-cover.jpg");
const fallbackOriginal = projectOfferingPreviewFields({
item: baseItem,
config: { detailHero: "" },
formValues: { coverUrl: "" },
});
assert.equal(fallbackOriginal.presentation.heroImage, "/media/original-cover.jpg");
});
test("details merge preserves originals and applies updates", () => {
const result = projectOfferingPreviewFields({
item: baseItem,
config: {
details: {
background: "更新后的背景",
designConcept: "新的设计理念",
crafts: ["新交付"],
materialsList: [{ name: "策略", spec: "定位" }],
},
},
formValues: {},
});
assert.equal(result.presentation.details.background, "更新后的背景");
assert.equal(result.presentation.details.designConcept, "新的设计理念");
assert.deepEqual(result.presentation.details.crafts, ["新交付"]);
assert.deepEqual(result.presentation.details.materialsList, [{ name: "策略", spec: "定位" }]);
});
test("non-object config.presentation and details are ignored safely", () => {
const result = projectOfferingPreviewFields({
item: baseItem,
config: {
presentation: "invalid",
details: 42,
},
formValues: {},
});
assert.deepEqual(result.presentation.keywords, ["原始"]);
assert.equal(result.presentation.details.background, "原始背景");
assert.deepEqual(result.presentation.details.crafts, []);
});
+1
View File
@@ -68,6 +68,7 @@ export type { PublicOffering, BookingStatus, BrandTemplateKey } from "@personal-
export type {
EditorPreviewFrameMessage,
EditorPreviewHostMessage,
RuntimeOffering,
RuntimeWorkspace,
} from "@personal-brand/types";
export { isTrustContentComplete } from "@personal-brand/types";