# 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](../apps/taro/README.md)。预览是 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 视觉验收。