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

52 lines
5.5 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 配置。合法域名、微信登录、剪贴板、字体缩放、底部安全区、提审与真机必须在正式配置后验证。
- 未创建实际宣传品牌、未导入开发品牌数据、未上传或发布到微信。后续由管理员选择模板并显式导入样例。
因此当前状态是“模板代码与自动验证通过,可进入人工预览验收”,不宣称全部交互验收或正式上线完成。