Files

83 lines
5.9 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.
# 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 alipay` | ✅ 编译通过 | 产物 `dist/alipay`;`project.alipay.json` 的 AppID 待填 |
| `taro build --type h5` | ✅ 编译通过 | 用于本地预览,不作为交付产物 |
| 微信真机 / 抖音真机 | 未验证 | 需先配 B3 域名白名单与 B4 上传 Token |