docs: 更新项目进度文档与首页接口注释,确认client_id正式值
重命名并重新整理了原TODO.md为项目进度文档,拆分了项目当前阶段、已完成任务、联调中任务等分类;修正了src/api/index.js中首页接口的注释内容,更新client_id相关说明为当前已使用正式默认值的实际情况,并将对应待办标记为已完成。
Showing
2 changed files
with
61 additions
and
16 deletions
| 1 | -# TODO 清单 | 1 | +# 项目进度 |
| 2 | 2 | ||
| 3 | -## 首页与内容接口 | 3 | +## 当前阶段判断 |
| 4 | + | ||
| 5 | +当前项目已经不是“页面还没搭起来”的阶段,而是“主链路代码基本齐了,正在等真实接口和真机联调收口”的阶段。 | ||
| 6 | + | ||
| 7 | +可以先把现状理解成两部分: | ||
| 8 | + | ||
| 9 | +- 已完成:首页、底部导航、资讯 WebView 承接、授权基础骨架、支付确认页、支付桥页,这些代码结构都已经落地。 | ||
| 10 | +- 未完成:真实接口值、正式配置项、授权闭环验证、支付闭环验证、历史演示链路是否下线,这些还需要继续联调和确认。 | ||
| 11 | + | ||
| 12 | +## 已完成 | ||
| 13 | + | ||
| 14 | +### 首页与内容接口 | ||
| 4 | 15 | ||
| 5 | - [x] 首页页面已按 Apifox“首页”接口结构改造,当前消费 `volunteer_top_banner`、`volunteer_bottom_banner`、`volunteer_home_icon` 三组字段。 | 16 | - [x] 首页页面已按 Apifox“首页”接口结构改造,当前消费 `volunteer_top_banner`、`volunteer_bottom_banner`、`volunteer_home_icon` 三组字段。 |
| 6 | - [x] 首页 mock 已按真实接口字段结构补齐,当前图片和图标先复用现有页面假数据,避免真实接口到位后再次大范围改页面。 | 17 | - [x] 首页 mock 已按真实接口字段结构补齐,当前图片和图标先复用现有页面假数据,避免真实接口到位后再次大范围改页面。 |
| 7 | - [x] 首页页面已增加“当前为 mock 接口结构”的状态提示,后续真实接口出数后可直接去掉该提示。 | 18 | - [x] 首页页面已增加“当前为 mock 接口结构”的状态提示,后续真实接口出数后可直接去掉该提示。 |
| 8 | -- [ ] 首页真实接口还没有返回业务数据,后续需要把 mock 环境切到真实返回值联调。 | 19 | +- [x] 首页顶部 banner 已兼容“单图保持现状,多图自动切 Swiper 轮播”的展示方式,后续只需要继续确认真实返回到底是一组还是多组。 |
| 9 | -- [ ] 首页接口正式 `client_id` 还未确认,当前继续沿用全局默认请求参数,待后端给出正式值后补配置。 | ||
| 10 | -- [ ] 继续确认 `volunteer_top_banner` 实际返回是一组还是多组;当前页面已兼容“单图保持现状,多图自动切 Swiper 轮播”。 | ||
| 11 | -- [ ] 确认首页接口里的 `title`、`color` 后续是否启用;当前已保留字段但页面暂未消费。 | ||
| 12 | 20 | ||
| 13 | -## 底部导航与 WebView | 21 | +### 底部导航与 WebView |
| 14 | 22 | ||
| 15 | -- [ ] 底部导航栏还需要联调真实配置接口,继续确认各 tab 的标题、显隐、跳转页和 WebView 地址。 | 23 | +- [x] 底部导航已改成配置驱动模式,不再是页面里写死的静态 tab。 |
| 16 | -- [ ] “应用”和“我的”页面还缺 2 个可用 WebView URL,提供后再完成联调。 | 24 | +- [x] 首页、资讯、应用、我的这条导航骨架已经串起来,非首页 tab 已按 WebView 容器模式承接。 |
| 25 | +- [x] 底部导航已兼容 icon class、显隐控制,以及大于 4 个 tab 时的横向滚动展示。 | ||
| 17 | 26 | ||
| 18 | -## 资讯链路 | 27 | +### 资讯链路 |
| 19 | 28 | ||
| 20 | - [x] 资讯 tab 已调整为和“应用 / 我的”一致的 WebView 承接模式,当前地址由底部导航配置统一控制。 | 29 | - [x] 资讯 tab 已调整为和“应用 / 我的”一致的 WebView 承接模式,当前地址由底部导航配置统一控制。 |
| 30 | +- [x] `message-detail` 与 `src/api/message.js` 已从“当前线上资讯主入口”降级为旧版原生列表/详情演示参考链路。 | ||
| 31 | + | ||
| 32 | +### 授权与支付 | ||
| 33 | + | ||
| 34 | +- [x] 应用启动阶段已接入静默授权尝试、失败跳授权页、成功后保留来源页回跳的基础骨架。 | ||
| 35 | +- [x] 支付主链路已切到 `order_id -> useWechatMiniPay -> /srv/?a=pay` 这条共享能力链路。 | ||
| 36 | +- [x] `pay-confirm` 已作为正式确认支付页落地,负责展示金额并触发支付。 | ||
| 37 | +- [x] `pay-bridge` 已作为 H5 / WebView 发起小程序支付的桥页落地,负责自动授权、拉起支付、展示结果并返回上一页。 | ||
| 38 | + | ||
| 39 | +## 联调中 / 待确认 | ||
| 40 | + | ||
| 41 | +### 首页与内容接口 | ||
| 42 | + | ||
| 43 | +- [ ] 首页真实接口还没有返回稳定业务数据,需要继续用真实环境联调返回值。 | ||
| 44 | +- [x] 首页接口使用的全局默认请求参数里的 `client_id` 已确认就是正式值,当前无需再为首页单独补配。 | ||
| 45 | +- [ ] 继续确认 `volunteer_top_banner` 实际返回是一组还是多组;虽然页面已经兼容两种情况,但还没有拿真实数据拍板。 | ||
| 46 | +- [ ] 确认首页接口里的 `title`、`color` 后续是否启用;当前已保留字段,但页面暂未消费。 | ||
| 47 | + | ||
| 48 | +### 底部导航与 WebView | ||
| 49 | + | ||
| 50 | +- [ ] 底部导航栏还需要联调真实配置接口,继续确认各 tab 的标题、显隐、跳转页和 WebView 地址。 | ||
| 51 | +- [ ] “应用”和“我的”页面还缺 2 个可用 WebView URL,提供后再完成联调。 | ||
| 21 | - [ ] 资讯 tab 还需要联调真实配置接口,继续确认标题、显隐和 WebView 地址是否正确。 | 52 | - [ ] 资讯 tab 还需要联调真实配置接口,继续确认标题、显隐和 WebView 地址是否正确。 |
| 22 | -- [ ] 旧版 `message-detail` 与 `src/api/message.js` 原生列表/详情演示链路后续再决定是继续保留为参考页,还是统一下线清理。 | ||
| 23 | 53 | ||
| 24 | -## 授权与支付 | 54 | +### 授权 |
| 55 | + | ||
| 56 | +- [ ] 授权功能还没有完整联调,需要确认“未授权进入页面 -> 自动或手动授权 -> 成功回跳原页面”这条闭环是否正常。 | ||
| 57 | +- [ ] 还需要确认静默授权失败时,跳授权页、防重复跳转、授权成功回来源页这几个分支在微信开发者工具或真机里是否都正常。 | ||
| 58 | + | ||
| 59 | +### 支付 | ||
| 60 | + | ||
| 61 | +- [ ] 支付确认页还没有完整联调,需要确认页面入参、金额展示、点击支付和状态提示是否正常。 | ||
| 62 | +- [ ] 支付功能还没有完整联调,需要确认支付参数获取、小程序拉起支付、支付结果返回和回跳流程是否正常。 | ||
| 63 | +- [ ] H5 / WebView 发起支付这条桥接链路,还需要重点验证“授权状态检查 -> 拉起支付 -> 成功 / 取消 / 失败 -> 返回上一页”是否完整闭环。 | ||
| 64 | + | ||
| 65 | +## 后续决策项 | ||
| 66 | + | ||
| 67 | +- [ ] 旧版 `message-detail` 与 `src/api/message.js` 原生列表/详情演示链路,后续再决定是继续保留为参考页,还是统一下线清理。 | ||
| 68 | + | ||
| 69 | +## 下一步最值得优先推进的事情 | ||
| 25 | 70 | ||
| 26 | -- [ ] 授权功能还没有完整联调,需要确认静默授权、授权失败跳转、授权成功回跳这条链路是否正常。 | 71 | +- [ ] 先拿到底部导航真实配置,补齐“应用 / 我的”两个 WebView 地址。 |
| 27 | -- [ ] 支付确认页还没有联调,需要确认页面入参、金额展示、点击支付和状态提示是否正常。 | 72 | +- [ ] 再用真实环境把首页接口返回值、授权回跳、支付确认、支付桥页各走一遍。 |
| 28 | -- [ ] 支付功能还没有联调,需要确认支付参数获取、小程序拉起支付、支付结果返回和回跳流程是否正常。 | 73 | +- [ ] 联调稳定后,再回头清理 mock 提示、历史演示链路和未启用字段。 | ... | ... |
| ... | @@ -15,7 +15,7 @@ const Api = { | ... | @@ -15,7 +15,7 @@ const Api = { |
| 15 | /** | 15 | /** |
| 16 | * @description 获取首页内容 | 16 | * @description 获取首页内容 |
| 17 | * - 当前先按 Apifox 首页接口结构联调 | 17 | * - 当前先按 Apifox 首页接口结构联调 |
| 18 | - * - client_id 继续走全局默认参数,正式值待后端确认 | 18 | + * - client_id 直接走请求层全局默认参数,该默认值已作为正式值使用 |
| 19 | */ | 19 | */ |
| 20 | export const getHomeContentAPI = () => fn(fetch.get(Api.HOME_CONTENT)) | 20 | export const getHomeContentAPI = () => fn(fetch.get(Api.HOME_CONTENT)) |
| 21 | 21 | ... | ... |
-
Please register or login to post a comment