3.3 KiB
Taro 迁移分支验收
分支:feat/taro-template-preview。基线:f4061a2。主工作区保持 feat/template-runtime-platform,用户确认前不合并或切换。
已交付
- Taro 4.3 + React 18 共用 React/CSS 构建 Web 和微信小程序;Admin 的 React 19 独立保留。
- 餐饮:首页、餐品分类搜索、详情、出摊、主理人、咨询、成功、记录。视觉综合原 React 原型和当前小程序,数据使用同一份已发布 Public Workspace。
- 林境:首页、作品列表/详情、主理人、咨询、成功、记录。
- 模板自动发现 package 的 manifest 与 taro 实现,不新增全局 seed,不修改数据库。
- 真实表单选择、条件字段、选项 label/value、checkbox、必填校验、失败保留输入、微信登录、品牌隔离、401 清理及历史字段快照显示。
- 独立 H5 预览端口:餐饮 http://localhost:3002,林境 http://localhost:3003。
验证
- 两模板 H5/weapp 共 4 个 production build 通过,weapp 包含工程配置、页面与共用样式。
- Playwright 5/5:真实 API、图片容器宽度、日程/配送/流程槽位、主理人资质/案例/承诺、餐品搜索与详情到咨询、失败保留输入、错误重试、林境路由。
- 纯函数与产物契约 4/4;API integration 39/39 使用独立 schema;旧原生模板完整检查通过。
- 全量 typecheck 10/10、lint 8/8、格式检查、Admin production build 通过。
运行命令和输出路径见 Taro README。预览是 Taro 的真实 H5 构建,不使用 WXML 转 HTML 脚本。
验证边界
Web 未接入微信身份登录,没有已有会话时仅支持填写与校验,明确提示在微信小程序提交,不伪造成功。默认小程序 AppID 为 touristappid,正式登录需配置实际 AppID 和合法域名。未取得本机微信 IDE 原生截图,不能把 H5 验收称为真机或像素一致验收。
现有远程图片继续使用后台实际 URL;远端不可用时不会替换成虚构素材。Taro 官方依赖的 deprecation/punycode 提示由框架维护者后续升级跟进;Admin 既有 676 kB chunk 提示由前端维护者跟进拆包。当前构建与测试通过。
切换
先由用户浏览新分支预览并确认,之后才切换主工作区或合并。旧 template:dev 和原生产配置继续作为回滚基线。
Web 预览宽度
手机小于 430px 时使用屏幕宽度;更宽屏幕使用居中的 430px 内容区。预览外框使用真实 CSS 像素并锁定对应 rem 基准,避免被 Taro 设计稿单位转换二次缩放。底部导航和详情操作栏与内容区对齐。响应式浏览器测试覆盖 375、430、768、1280px;包括原有交互共 9 项通过。
餐饮控件与底部避让修复
H5 tab 页面统一预留导航避让与安全区空间,删除桌面 app 最小高度对导航容器高度的干扰。餐品分类按钮明确使用内容宽度,避免 H5 Button 默认满宽挤走其他分类。提交按钮明确高度、内边距及文字居中。浏览器检查覆盖手机与桌面滚动到底后的首页最后卡片、咨询记录入口、分类切换和提交校验;共 11 项通过。餐饮 H5、微信构建及格式、类型、lint 通过。微信构建结果不替代微信 IDE 视觉验收。