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

5.5 KiB
Raw Blame History

独立工坊宣传模板验收记录

日期: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 配置。合法域名、微信登录、剪贴板、字体缩放、底部安全区、提审与真机必须在正式配置后验证。
  • 未创建实际宣传品牌、未导入开发品牌数据、未上传或发布到微信。后续由管理员选择模板并显式导入样例。

因此当前状态是“模板代码与自动验证通过,可进入人工预览验收”,不宣称全部交互验收或正式上线完成。