灵感计划 §3④ + §4 D 枚举决策: - projects 表加 tone/ending_type/narrative_pov(Text nullable、无 CHECK,同 genre/structure; 迁移 e5f6a7b8c9d0 nullable 免 backfill)。 - ProjectCreateRequest/ProjectResponse + domain ProjectCreate/ProjectView 全链路透传(snake_case)。 - 完整 stable_core 链路:ProjectSpecView + SqlProjectSpecRepo.spec + _build_spec_section 渲染进 「作品蓝本」块——书级常量随书稳定,字节稳定守缓存前缀不变量 #9,绝不入 volatile。 - 前端 wizard.ts 三字段 + 预设数组 TONES/ENDING_TYPES/NARRATIVE_POVS + ProjectWizard 控件与确认页回显。 - 契约变更已 pnpm gen:api + memory/contracts.md 登记。
94 lines
3.2 KiB
TypeScript
94 lines
3.2 KiB
TypeScript
import type { ProjectCreateRequest } from "@/lib/api/types";
|
||
|
||
// 立项向导 5 步(UX §6.2)。表单状态用字符串/数组,提交时归一为 ProjectCreateRequest。
|
||
export interface WizardForm {
|
||
title: string;
|
||
genre: string;
|
||
logline: string;
|
||
sellingPoints: string[];
|
||
structure: string;
|
||
premise: string;
|
||
protagonist: string;
|
||
theme: string;
|
||
// 立项书级常量(灵感④):基调 / 结局取向 / 叙事视角。
|
||
tone: string;
|
||
endingType: string;
|
||
narrativePov: string;
|
||
}
|
||
|
||
export const WIZARD_STEPS = 5;
|
||
|
||
// 各步标题(与 WIZARD_STEPS 一一对应)。第 5 步为「确认/概览」:回显已填字段供复核后提交。
|
||
export const STEP_TITLES = [
|
||
"书名 + 题材",
|
||
"一句话故事 + 卖点 + 结构",
|
||
"立意 / 总纲",
|
||
"主角 / 金手指",
|
||
"确认与提交",
|
||
] as const;
|
||
|
||
export const emptyWizardForm: WizardForm = {
|
||
title: "",
|
||
genre: "",
|
||
logline: "",
|
||
sellingPoints: [],
|
||
structure: "",
|
||
premise: "",
|
||
protagonist: "",
|
||
theme: "",
|
||
tone: "",
|
||
endingType: "",
|
||
narrativePov: "",
|
||
};
|
||
|
||
export const GENRES = ["玄幻", "仙侠", "都市", "科幻", "历史", "悬疑"];
|
||
export const STRUCTURES = ["三幕", "故事圈", "雪花"];
|
||
export const SELLING_POINT_PRESETS = ["逆袭", "打脸", "系统流", "双男主", "群像"];
|
||
// 立项书级常量预设(灵感④ / D 枚举)——free text 单选,命不中预设可留空。
|
||
export const TONES = ["热血", "轻松", "沉重", "治愈", "暗黑", "爽文"];
|
||
export const ENDING_TYPES = ["HE", "BE", "开放", "正剧"];
|
||
export const NARRATIVE_POVS = ["第一人称", "第三人称限知", "第三人称全知", "多视角"];
|
||
|
||
// 每一步可否前进:仅第 1 步(书名)必填,其余可空着继续(草稿式立项)。
|
||
export function canAdvance(step: number, form: WizardForm): boolean {
|
||
if (step === 1) return form.title.trim().length > 0;
|
||
return true;
|
||
}
|
||
|
||
// 整个向导可否提交:书名必填。
|
||
export function canSubmit(form: WizardForm): boolean {
|
||
return form.title.trim().length > 0;
|
||
}
|
||
|
||
export function clampStep(step: number): number {
|
||
if (step < 1) return 1;
|
||
if (step > WIZARD_STEPS) return WIZARD_STEPS;
|
||
return step;
|
||
}
|
||
|
||
// 归一为后端请求体(snake_case,空值落 null/省略)。
|
||
export function toCreateRequest(form: WizardForm): ProjectCreateRequest {
|
||
const trim = (s: string): string | null => {
|
||
const v = s.trim();
|
||
return v.length > 0 ? v : null;
|
||
};
|
||
// 立意(premise)与主角/金手指(protagonist)是两个独立输入,但 M1 projects 表只有
|
||
// premise 一个字段 → 合并进 premise,二者各占一段,互不覆盖(QA H1:此前共用同一字段)。
|
||
const premise =
|
||
[trim(form.premise), form.protagonist.trim() ? `主角/金手指:${form.protagonist.trim()}` : null]
|
||
.filter((s): s is string => s !== null)
|
||
.join("\n\n") || null;
|
||
return {
|
||
title: form.title.trim(),
|
||
genre: trim(form.genre),
|
||
logline: trim(form.logline),
|
||
premise,
|
||
theme: trim(form.theme),
|
||
selling_points: form.sellingPoints,
|
||
structure: trim(form.structure),
|
||
tone: trim(form.tone),
|
||
ending_type: trim(form.endingType),
|
||
narrative_pov: trim(form.narrativePov),
|
||
};
|
||
}
|