feat: 收口多品牌与模板构建基础

This commit is contained in:
que01 committed 2026-09-25 02:55:46 +08:00
1 parent 0425a1c672
commit 77224ea51f
317 files changed
+11290 -1158

No files matched your search

@@ -0,0 +1,27 @@
# 林境模板包基础 Epic
## 目标
将林境作为当前唯一正式视觉模板包,保留个人、餐饮、门窗行业模板作为数据与能力声明。移除当前没有独立 renderer、仅复用林境页面的伪视觉模板,建立可扩展的模板包契约和版本快照基础。
## 范围
- `template.json` 风格的模板包契约类型与校验;
- 林境模板包元数据、页面入口、能力依赖和 fixture;
- 视觉模板目录只暴露林境模板;
- 所有品牌视觉默认值和发布快照统一使用林境;
- Admin、API、Miniapp fixture 和文档同步。
## 不在本 Epic
- 新增餐饮专属视觉模板;
- 运行时下载 WXML/WXSS/JS;
- 媒体上传服务;
- 多模板构建服务。
## 设计边界
- 行业模板决定业务数据、字段和 capability,不决定视觉代码;
- 林境模板包只消费统一 Runtime Workspace,不读取数据库;
- 后台不能展示没有独立 renderer 的视觉模板;
- 模板包和品牌发布版本都必须保留精确版本。
@@ -0,0 +1,17 @@
# 进度
- 任务:林境模板包基础
- 形态:epic
- 进度:3/3
- 当前:模板包可执行边界已完成;林境是唯一正式视觉模板包,个人、餐饮、门窗继续作为行业数据模板。
- 真相文件:`SUBTASKS.csv`
## 阶段执行记录
已完成阶段 `1 模板包契约与林境声明`:共享 config 新增 `TemplatePackageManifest`、模板包 registry、入口声明和校验函数,林境包固定为 `linjing-editorial@1.0.0`。
已完成阶段 `2 统一唯一视觉模板`:移除 `minimal-neutral` 视觉目录和默认回退;API、Admin、seed、发布快照和模板目录只暴露林境视觉模板。个人、餐饮、门窗仍由行业模板、业务数据和 capability 区分。
已完成阶段 `3 全量回归与扩展文档`:`pnpm validate:templates` 校验模板包 `1/1`,`format:check`、全仓 `typecheck`、API integration `37/37`、Admin build、Miniapp fixture、visual fixture 和 `git diff --check` 通过。新增模板流程记录在 `tasks/contract/README.md` 和 `tasks/regression/README.md`。
约束:未来新增视觉模板必须提供独立编译期 renderer、manifest、fixture、API 兼容性和构建验证;不得只复制林境 manifest 后注册为新模板。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,模板包契约与林境声明,single-full,,DONE,tasks/contract,共享类型提供模板包元数据和运行时入口声明,林境包可校验,pnpm typecheck && pnpm validate:templates,新增 TemplatePackageManifest、registry 和文件级校验器
2,统一唯一视觉模板,single-full,1,DONE,tasks/linjing-package,API、Admin、seed 和发布默认值只使用林境视觉模板,pnpm --filter @personal-brand/api test:integration,移除 minimal-neutral 目录和默认回退;个人/餐饮/门窗保留为行业模板
3,全量回归与扩展文档,single-full,1;2,DONE,tasks/regression,fixture、构建、格式、类型和集成测试通过并记录新增模板流程,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build,模板校验 1/1;API 37/37;Admin、Miniapp fixture、visual fixture 和格式检查通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 模板包契约与林境声明 single-full DONE tasks/contract 共享类型提供模板包元数据和运行时入口声明,林境包可校验 pnpm typecheck && pnpm validate:templates 新增 TemplatePackageManifest、registry 和文件级校验器
3 2 统一唯一视觉模板 single-full 1 DONE tasks/linjing-package API、Admin、seed 和发布默认值只使用林境视觉模板 pnpm --filter @personal-brand/api test:integration 移除 minimal-neutral 目录和默认回退;个人/餐饮/门窗保留为行业模板
4 3 全量回归与扩展文档 single-full 1;2 DONE tasks/regression fixture、构建、格式、类型和集成测试通过并记录新增模板流程 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build 模板校验 1/1;API 37/37;Admin、Miniapp fixture、visual fixture 和格式检查通过
@@ -0,0 +1,3 @@
# 模板包契约
当前正式视觉模板包为 `linjing-editorial@1.0.0`,元数据位于 `templates/linjing-editorial/template.json`。未来新增视觉模板必须提供独立的编译期页面 renderer,不得只复制林境 manifest 或复用林境 renderer 后伪装成新模板。
@@ -0,0 +1,3 @@
# 扩展门禁
新增视觉模板前必须同时提交:模板包声明、页面入口、Runtime Workspace 适配说明、品牌/行业兼容性、运行时 fixture、视觉 fixture、Admin 目录展示、API 集成测试和生产构建结果。