82 lines
5.8 KiB
Markdown
82 lines
5.8 KiB
Markdown
# taroapp_escort 迁移清单(对照 `phase1-native-baseline`)
|
||
|
||
> 原生基线:`ui/wxapp_escort` @ `aeafe21`(标签 `phase1-native-baseline`)。
|
||
> 每页三项:WXML→TSX、JS→TS、WXSS→SCSS(`rpx` 数值直搬,规则见 `doc/taro-plan.md` §6 / D6)。
|
||
|
||
## 1. 页面
|
||
|
||
| # | 原生路径 | Taro 文件 | 状态 | 差异 / 备注 |
|
||
| --- | --- | --- | --- | --- |
|
||
| 1 | pages/home/index | `src/pages/home/index.tsx` | ✅ 完成 | 原 `navigationStyle: custom` 改为默认导航(计划 §9.2),`.topbar` 上距 120→24rpx |
|
||
| 2 | pages/escort/itemlist | `src/pages/escort/itemlist.tsx` | ✅ 完成 | — |
|
||
| 3 | pages/escort/itemdetail | `src/pages/escort/itemdetail.tsx` | ✅ 完成 | 下单表单/弹窗全量迁移;未用的 `departments` 常量已删 |
|
||
| 4 | pages/health/profilelist | `src/pages/health/profilelist.tsx` | ✅ 完成 | 下拉刷新 / 双击删除确认保留 |
|
||
| 5 | pages/health/profileedit | `src/pages/health/profileedit.tsx` | ✅ 完成 | 未保存拦截:微信原生;其他端降级为页内提示 |
|
||
| 6 | pages/mine/mine | `src/pages/mine/mine.tsx` | ✅ 完成 | 默认导航,`.header-card` 上距 176→32rpx;登录按平台分支(见 §3) |
|
||
| 7 | pages/mine/profileedit | `src/pages/mine/profileedit.tsx` | ✅ 完成 | 同上未保存拦截降级 |
|
||
| 8 | pages/mine/about | `src/pages/mine/about.tsx` | ✅ 完成 | — |
|
||
| 9 | pages/mine/contact | `src/pages/mine/contact.tsx` | ✅ 完成 | `showMenuByLongpress` 保留 |
|
||
| 10 | pages/mine/business | `src/pages/mine/business.tsx` | ✅ 完成 | `?section=` 锚点定位用 `pageScrollTo({selector})` |
|
||
| 11 | pages/escort/recordlist | `src/pages/escort/recordlist.tsx` | ✅ 完成 | 左右滑动切档 + 下拉刷新 + 触底加载保留 |
|
||
| 12 | pages/escort/recorddetail | `src/pages/escort/recorddetail.tsx` | ✅ 完成 | 三个弹窗(医院/备注/取消)全量迁移 |
|
||
| 13 | pages/escort/agreement | `src/pages/escort/agreement.tsx` | ✅ 完成 | 协议数据仍由 `GET /health/agreement` 下发 |
|
||
| 14 | pages/escort/guide | `src/pages/escort/guide.tsx` | ✅ 完成 | 静态文案与原生逐字一致 |
|
||
| 15 | pages/ai/aichat | `src/pages/ai/aichat.tsx` | ✅ 完成 | TDesign `chat-markdown` 换自研 `Markdown`;socket 契约 §6.4 未变 |
|
||
|
||
未迁移:原生 `pages/attendant/` 为空遗留目录(计划 §7)。
|
||
|
||
## 2. 底座
|
||
|
||
| 原生 | Taro | 说明 |
|
||
| --- | --- | --- |
|
||
| `app.js` | `src/app.tsx` + `src/utils/app.ts` | `onLaunch/onShow` → `useLaunch/useDidShow`;`globalData` 变为模块单例(`utils/globalData.ts`),字段名不变 |
|
||
| `app.json` | `src/app.config.ts` | 页面清单一致;tabBar 微信 `custom: true`(页内自绘),抖音/支付宝走原生 tabBar |
|
||
| `app.wxss` | `src/app.scss` | 色板令牌整块搬入,`page, body` 双端可读 |
|
||
| `custom-tab-bar/*` | `src/components/TabBar` | 样式逐字搬入,选中态由页面传 `selected` |
|
||
| `utils/request.js` | `src/utils/request.ts` | 基址 / `appId: 'wxapp-escort'` / 401 重试契约不变 |
|
||
| `utils/api.js` | `src/utils/api.ts` | 路径逐条一致 |
|
||
| `utils/chatmsg.js` | `src/utils/chatmsg.ts` | 心跳 30s / 重连 3 次 / 解析失败回调不变 |
|
||
| `utils/date|order|privacy|form.js` | `src/utils/*.ts` | 行为一致;`form` 增加能力探测返回值 |
|
||
| — | `src/utils/platform.ts` | 新增:平台判断、登录开关、登录未开放提示、TabBar 开关 |
|
||
| TDesign `t-icon` | `src/components/Icon` | 用 `assets/fonts/t.woff` base64 内嵌 + 按名映射字形(29 个) |
|
||
| TDesign `t-loading` | `src/components/Loading` | 纯 CSS 转圈 |
|
||
| TDesign `t-chat-markdown` | `src/components/Markdown` | 自研轻量解析:标题/段落/列表/代码块/引用/表格/分隔线/加粗/行内码 |
|
||
| `images/*` | `src/images/*` | `project config copy` 拷到产物根,页面沿用 `/images/x.png` |
|
||
|
||
## 3. 平台差异与未决项
|
||
|
||
| 能力 | 微信 `weapp` | 抖音 `tt` | 支付宝 `alipay`(构建目标预留) |
|
||
| --- | --- | --- | --- |
|
||
| 构建 | ✅ 验证通过 | ✅ 验证通过 | ⚪ 仅编译,未真机验证 |
|
||
| 登录 / 手机号 | ✅ 原生流程 | ⛔ 占位(B1/B2 未就绪) | ⛔ 占位 |
|
||
| 自定义 tabBar | ✅ 页内自绘(`custom: true`) | 原生 tabBar(D4 降级,待真机复核) | 原生 tabBar |
|
||
| 未保存拦截 | ✅ `enableAlertBeforeUnload` | 能力探测,缺失则页内提示 | 同抖音 |
|
||
| 更新管理器 | ✅ | 能力探测,缺失则跳过 | 同抖音 |
|
||
| 分享 | `useShareAppMessage` | 由平台决定是否支持 | 同抖音 |
|
||
|
||
阻塞项(未解决前对应功能不可用):`doc/taro-plan.md` §9.1 B1–B5。
|
||
支付仍为线下客服流程,无线上支付入口(与原生一致)。
|
||
|
||
## 4. 后续平台(不在本次交付)
|
||
|
||
- **支付宝 IoT 小程序**:与普通 `alipay` 不是同一容器,API / 白名单需按 IoT 文档单独适配,未验证前不宣称支持。
|
||
- **Android / iOS 原生 App**:本仓 Taro 产物是小程序包,不能直接产出原生 App;需另起 Taro RN 工程或原生团队开发。
|
||
|
||
## 5. 双端构建命令
|
||
|
||
```sh
|
||
npm run build:weapp # → dist/weapp
|
||
npm run build:tt # → dist/tt
|
||
npm run build:h5 # → dist/h5(仅本地预览用)
|
||
```
|
||
|
||
## 6. 验证记录
|
||
|
||
| 项 | 结果 | 说明 |
|
||
| --- | --- | --- |
|
||
| `npx tsc --noEmit` | ✅ 0 error | `tsconfig` 开启 `skipLibCheck`(Taro 自带 d.ts 在严格模式下自身报错,与本项目代码无关) |
|
||
| `taro build --type weapp` | ✅ 编译通过 | 产物 `dist/weapp`;`images/` 10 张齐全;`app-origin.wxss` 含内嵌字体 |
|
||
| `taro build --type tt` | ✅ 编译通过 | 产物 `dist/tt`;`tabBar.custom=false`(原生 tabBar) |
|
||
| `taro build --type h5` | ✅ 编译通过 | 用于本地预览,不作为交付产物 |
|
||
| 微信真机 / 抖音真机 | 未验证 | 需先配 B3 域名白名单与 B4 上传 Token |
|