Files
persionalBrand/docs/adr/0019-taro-template-runtime.md

24 lines
1.8 KiB
Markdown

# 0019 Taro 模板双端运行时
## Context
原生 WXML/WXSS 难以在浏览器预览,自建转换器需要重复实现组件、事件和 API。客户提供的 React 原型应通过统一页面源码输出 Web 与微信小程序。
## Decision
新增 apps/taro,使用固定版本 Taro 4.3、React 18 与 Vite 4 编译器,支持 H5 和 weapp。React 18 是 Taro 当前官方插件 peer contract,独立于 Admin React 19。复用 Public Workspace 类型和模板 package manifest、图片与视觉槽位,不建立第二套后台或数据库,不维护手写 WXML 解释器。
页面实现按模板放入 package/taro,通用请求、登录、表单和记录在 apps/taro 中。模板选项在构建时校验,manifest 驱动 tab 名称和路由。H5 仅访问已发布数据;微信登录使用 Taro.login,H5 无微信身份时明确不能提交,不创建假用户或模拟成功。API 地址和品牌来自构建环境,允许 H5 以查询参数选择品牌,令牌按品牌隔离。
## Alternatives
kbone 适合 Web 运行于小程序,但引入 DOM 适配成本;uni-app 需要 Vue 重写现有 React 原型;自建模拟器持续承担不必要的兼容责任。
## Consequences
一次迁移页面和构建链路,后续同一份 React/CSS 输出两端。原生微信能力和排版仍需微信环境验收,H5 不被称作原生模拟器。TDesign 原生组件不直接用于 H5,基础表单改用 Taro 双端组件。
## Migration Plan
在 feat/taro-template-preview 和独立 worktree 完成两模板全部页面及双端构建,旧原生模板和编译器继续可用。用户确认前不切换当前分支、不替换当前 API、不改数据库、不覆盖旧 dist 产物。迁移分支以独立 preview 端口提供验收。确认后再决定默认构建切换,旧实现作为回滚基线。