78 lines
9.3 KiB
Markdown
78 lines
9.3 KiB
Markdown
# 独立工坊宣传模板验收记录
|
||
|
||
日期: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 模板选择,不复制林境品牌内容或发布记录。凭据仅保存在数据库,不写入源码、提交或日志。服务部署与微信上传、提审、发布是不同操作,本次不自动上传微信。
|