Files
persionalBrand/docs/taro-migration-delivery.md

40 lines
3.3 KiB
Markdown
Raw Permalink 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.
# 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 视觉验收。