fix: 统一小程序按钮契约并补齐模板图标

This commit is contained in:
que01 committed 2026-10-13 11:12:53 +08:00
1 parent 07629a4596
commit 3330b536dc
9 files changed
+118 -10

No files matched your search

+17 -1
View File
@@ -22,7 +22,6 @@
## 模板与配置包
- 执行 pnpm template:doctor 并遵循 [模板完成度规则](template-completion-rules.md),诊断未解决项和未验证项不能视为完成;
- 模板声明必须真正驱动安装和升级,不能只增加类型而保留 Controller 硬编码;
- 每个页面上的品牌事实、信任资料、业务详情和可编辑文案都必须来自 Runtime 数据,并在同一页面声明对应 Admin editor binding;`pnpm validate:templates` 的逐页 renderer / editor 契约测试通过后才能判定模板完成;
- 每种模板信任内容必须声明实际展示页面,逐页测试要同时验证“声明的类型有 renderer 消费”和“renderer 使用的类型已声明”;
@@ -34,6 +33,23 @@
- 回滚必须明确是恢复配置基线还是删除新增数据,并在接口文案和测试中保持一致;
- 模板新增能力不得侵入个人品牌核心模型。
## Taro 模板双端验收
- 构建任意 Taro 模板小程序时使用真实发布参数,并保留命令证据:
`TEMPLATE_KEY=<template-key> API_BASE_URL=<production-api> WEAPP_APP_ID=<appid> pnpm --filter @personal-brand/taro build:weapp`;
- 小程序和 H5 必须分别构建并归档到 `apps/taro/dist/<templateKey>/weapp` 与 `apps/taro/dist/<templateKey>/h5`;产物契约测试通过;
- 产物检查必须覆盖:`project.config.json` 的 AppID、请求内嵌的 `API_BASE_URL`、`/media/` 相对地址补全结果、`common.wxss` 中的按钮规则;
- 涉及 `Button`、`Input`、`Textarea`、`Picker` 等原生控件时,源码和产物都要核对;禁止只依据 H5 预览判定小程序样式;
- 按页面角色检查视觉点,不按模板名称写专用清单,并记录截图或说明未改动原因:
- 首页:媒体加载、横向间距、标签换行、整卡点击;
- 列表页:卡片宽度、媒体高度、空态和点击目标;
- 详情页:主行动按钮全宽、默认高度 88rpx、文字垂直居中,安全区不被遮挡,底部说明不被遮盖;
- 个人页:紧凑行动按钮高度由模板令牌定义、文字垂直居中、拨号/复制可点;
- 表单页:提交按钮全宽、88rpx 高、文字垂直居中,错误和重试可见;
- 微信真机:request/media 域名、登录、拨号、复制、滚动和底部安全区;
- 模板自定义尺寸必须通过共享 CSS 变量声明,不把 `46rpx`、`88rpx` 这类值散落在多个模板里;
- 产物级断言只能证明配置和规则存在,不能替代真实数据驱动的页面截图;最终视觉证据必须来自微信开发者工具或真机。
## 后台 UI
- 覆盖 loading、empty、error、retry、success 和 mutation failure 状态;
+17
View File
@@ -67,3 +67,20 @@ templateFields 按各自 page 分组;预览同步 templateData。列表审计
Runtime 合并标准品牌列和模板 config 时,标准列是共享品牌事实的权威值。同名旧 config 不得覆盖标准列;标准列主动清空为 null 时,旧 slogan、phone、wechat、studioAddress 等别名也不能恢复旧内容。回归须注入冲突值及清空值,验证草稿和公开投影一致,不依赖清洗数据库掩盖优先级错误。
画布点选测试必须点击实际区域内部的叶子内容,并验证目标和记录 ID;侧栏定位通过不能代替画布可点击。应避开圆角透明角落,不能用强制点击或 dispatchEvent 掩盖真实命中问题。
## Taro 小程序视觉一致性
Taro 小程序构建默认会把 CSS 中的 HTML 标签选择器重写为 `.h5-<tag>`,但 React `<Button />` 渲染的是微信原生 `<button>`,不会自动获得 `.h5-button`。本项目关闭小程序 `htmltransform`,保证 `button` 选择器直接命中微信原生 `<button>`;新增共享组件样式时不得再依赖 `.h5-<tag>`。
共享 reset 必须让微信 `<button>` 与 Taro H5 的 `taro-button-core` 一致:默认 flex、全宽、`min-height:var(--taro-button-height)`、文字居中,并重置 `appearance`、间距、边框和背景。局部按钮通过 `--taro-button-height` 或结构化 class 调整;模板样式不得复制基础尺寸,也不得重新声明整套居中规则。
## Taro 双端验收清单
小程序视觉回归按页面角色和原生控件执行,不按模板名写专用清单。平台新增或修改原生控件时,先更新共享 reset、令牌和产物契约测试,再让所有模板自动受益。每个模板变更至少记录一次:
1. 使用生产参数构建 `weapp` 和 `h5`,保留命令、产物路径和 `project.config.json` 中的 AppID。
2. 产物断言:`API_BASE_URL`、`/media/` 补全、`button` 选择器未被改写为 `.h5-button`、共享 reset 存在。
3. 页面证据:首页媒体、列表卡片、详情主行动按钮、个人页紧凑行动按钮、表单提交按钮、错误与空态。
4. 原生控件必查:显示类型、宽度、高度令牌、文字垂直居中、点击命中、安全区和底部遮挡。
5. 真机必查:request/media 合法域名、登录、拨号、复制、滚动、字体缩放和 iPhone 底部安全区。
6. 修复方式先查共享 reset、令牌和 Taro 运行时,再改模板局部样式;同类问题必须补产物契约测试或视觉清单项,不允许只改单个模板的单个按钮。