Files
persionalBrand/docs/atelier-template-acceptance.md
T

78 lines
9.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 独立工坊宣传模板验收记录
日期:2026-10-15。模板:`atelier-solopreneur@1.0.0`。
## 已实现
- 独立模板包、真实 manifest、Taro 页面与原生模板入口,三项导航:首页、服务、我的。
- 首页(含主理人身份卡)、服务、我的、案例详情、意向表单、成功页、咨询记录;咨询表单为内页。
- 浅灰与深蓝视觉;文案、列表子字段、主理人、联系方式、案例和信任内容均有后台配置入口。主理人身份卡只在首页维护,咨询记录入口只在“我的”页维护。
- 包内示例显式导入,不新增全局 seed、不更改已有品牌与两套模板包。
- 当前视觉模板决定示例来源;已有配置和启用表单保留;案例封面来自包内资源。
- 咨询表单 chips 为共享 Inquiry 的可选样式,不改默认模板行为;校验失败保留输入,不伪造成功。
- Taro TabBar 从模板 miniapp/app.json 读取配色;缺少 AppID 时使用开发用 touristappid。
## 自动验证通过
| 检查 | 结果与证据 |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `pnpm template:doctor` | 三套模板 staticStatus=pass;新模板无 blocker、无未登记 review;completionStatus 仍为 unverified |
| `pnpm template:check` | 三套包契约、10 项编译器测试、三套原生 fixture 校验通过 |
| API integration | 50 项通过;上传相关另 2 项通过;隔离 schema 自动创建与清理 |
| 新模板真实持久化 | 测试读取真实 manifest,对所有独立品牌 binding 和案例 binding 注入独特值,检查数据库重载与 Runtime 投影 |
| 授权 | 示例预览 / 导入覆盖未登录、无效凭证、客户角色与管理员成功路径 |
| 导入 | 选中本包的 5 字段表单、7 项交付列表、包内封面;保留旧配置;重复导入拒绝 |
| 发布 | 未发布时公开为空;发布后可读;修改草稿不污染公开快照;再发布生效 |
| 咨询 | 缺必填项失败;真实提交成功落库;品牌隔离通过 |
| Taro | typecheck、lint、产物契约与运行时测试通过 |
| Admin | 生产构建通过;已接入自动发现的模板 renderer |
| 格式 | `pnpm format:check` 与 `git diff --check` 通过 |
| 开发构建 | H5 / weapp 构建及产物遮蔽通过;weapp AppID 为 touristappid |
| H5 视觉和交互 | 使用上述隔离数据库导出的已发布 Runtime,四个主要页面检查 375 / 390 / 430 宽度;无横向溢出;FAQ 展开、必填校验通过 |
| 区域命中 | 实际叶子内容点击命中:首页 9 个、服务 8 个、咨询 6 个声明区域;不是 Admin 全操作验收 |
测试源:`apps/api/test/http.integration.test.js` 的 `atelier template imports selected package and preserves draft publication isolation`。
本地证据保存在 `.codex-tasks/atelier-template/raw/`:数据库导出的 Runtime、执行日志、模板诊断、浏览器脚本与截图。Runtime 为临时隔离测试品牌数据,不包含客户数据或令牌。截图中的“保留已有品牌说明”为测试保留旧内容的预期结果。
## 全量 lint 遗留阻塞
API 全量 lint 有 13 项既有错误,涉及 admin-membership.guard 的 any、控制器未使用导入和旧上传测试类型;Admin 全量 lint 有 7 项既有错误,涉及 Dashboard 的 any、编辑器与 PublicationPage 的未使用变量。此次没有扩大这些修改范围。跟进归属为平台维护者,合并前需清理;完整日志为 raw/atelier-api-lint.log 和 raw/atelier-admin-lint.log。本次新模板、Taro、修改的 API 服务和配置文件定向 lint 已通过。
## 未验证及限制
- 尚未在真实 Admin 登录会话中逐字段完成“点击、编辑、保存、重载、发布”的全操作回归。API 全字段持久化和 H5 区域命中是分别验证,不能等同完整 Admin 验收。
- 成功页、记录页、详情页及所有空态 / 错误 / 能力禁用分支尚未完成全套浏览器截图验收。
- H5 截图对照已覆盖主要页面结构;字体使用中文系统字体与衬线 fallback,不依赖 Google Fonts,图标与示例图片不是 Stitch 外链资源的逐像素复制。
- 原生编译器 fixture 只证明入口和结构,尚无微信开发者工具或真机视觉证据。
- 尚无正式 AppID / 生产 API 配置。合法域名、微信登录、剪贴板、字体缩放、底部安全区、提审与真机必须在正式配置后验证。
- 已补建本地独立宣传品牌 `atelier-studio`,并为 `admin` 建立 owner 成员关系及 personal 安装台账。已按管理员明确要求导入模板样例,未创建公开发布或上传微信;管理员刷新后从顶部品牌列表切换即可预览。旧品牌行业与配置保留。
## 切换入口遗漏修复
初版只验证隔离测试品牌的最终配置,没有覆盖实际可用品牌和安装入口。开发库原本仅有 food / doors 品牌,新模板限定 personal,故下拉列表不显示;另有旧版 Runtime manifest 注册遗漏,正常安装被拒绝。现在新增包从包声明与视觉定义投影安装 manifest,旧模板 manifest 保持原结果;集成测试增加目录中每个视觉均有安装 manifest,并对真实 atelier 品牌执行选择、安装和后续持久化验证。显式创建脚本见模板 README,不接入全局 seed。
因此当前状态是“模板代码与自动验证通过,可进入人工预览验收”,不宣称全部交互验收或正式上线完成。
## 后台画布错误模板修复
实际运行的 3000 Vite 服务仅发现阿成与林境两个 renderer,工坊进入备用 iframe;备用预览又错误使用编译期模板键。已刷新运行中模块,并修正备用预览按 Runtime 配置选择 renderer,未知模板不回落,同时避免多模板 H5 使用未配置的原生 tabBar。
真实数据库浏览器回归已验证:工坊选择与重载、阿成 → 林境 → 工坊的后台画布切换、备用 iframe 使用真实工坊草稿。未导入样例、未发布;截图位于 `.codex-tasks/atelier-switch/editor-preview.png` 与 `iframe-preview.png`。Taro 测试、类型检查、完整后台预览构建、格式检查及 template doctor 通过;这些证据不替代上述尚未完成的全字段和真机验收。
## 本地样例导入
按用户明确授权,通过现有管理员样例导入接口为 `atelier-studio` 导入 2 条示例服务 / 案例、1 条信任内容、5 个咨询字段及 1 张咨询表单,并补齐模板默认配置。浏览器在实际 3000 后台重载后,确认首页价值定位、差异化卡片、试点案例、服务群体及咨询行动文案正常显示。其他品牌配置保持原值,未创建发布版本。
图片补充回归:运行中的图片资源 glob 同样遗漏新增工坊包,导致两张案例图使用未解析的 `/assets/cases/` 地址。刷新资源模块后,在实际后台验证 `campus.jpg` 自然尺寸为 1000 × 667、`editorial.jpg` 为 1000 × 750,均加载成功。
## 详情内容与信息卡片修复
初始样例仅包含案例名称、摘要和封面,且导入服务未支持样例 offering 的详情配置,导致详情页空标题与内部类别键值。现从模板包补齐两条案例的合作方式、场景、背景、思路、交付要点和能力构成;导入器保存可选 priceText/config,类别使用已有 portfolio 声明。通过管理员 API 仅补齐本地工坊样例的缺失配置,其他品牌案例与发布版本未变。隔离数据库集成测试 50 + 2 项通过,新增断言覆盖真实草稿 Runtime 的完整详情。
信息卡片原先嵌套 Text 被共享 display:block 规则断行,标签与冒号分离。改为 flex 行、固定标签列和可换行内容列,类别及关键词单独分组。真实后台验证两条案例切换、图片自然尺寸与 320 / 375 宽度下标签顶端对齐、无溢出;截图为 `.codex-tasks/atelier-switch/detail-facts-320.png` 与 `detail-facts-375.png`。该回归证明后台 H5 显示,不替代微信真机验收。
## 小程序配置复用
按用户明确要求,本地 `atelier-studio` 复用 `linjing-doors` 的 AppID、API 地址、构建配置与加密上传凭据;保留工坊自身的 personal 行业及 atelier 模板选择,不复制林境品牌内容或发布记录。凭据仅保存在数据库,不写入源码、提交或日志。服务部署与微信上传、提审、发布是不同操作,本次不自动上传微信。