Hooke / jls-weapp

这三个文件属于本地开发辅助文档，不再纳入版本控制。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

新增小程序环境版本检测逻辑，区分生产与非生产环境。新增状态文本格式化函数，生产环境下展示更友好的用户提示。重构状态文本赋值流程统一使用格式化函数，补充缺失的Taro导入语句。

导出配置中的CLIENT_ID常量，补充微信支付API的参数说明，并在支付调用时传入该参数

启用页面分享配置，自定义分享标题优先使用首页内容标题或默认值「觉林寺」，使用首个顶部横幅图片作为分享封面，并为分享路径添加分享标记

删除独立地图导览页面及路由配置，更新首页mock数据直接指向外部H5链接，同步更新文档调整相关说明。

优化标签栏布局间距，统一左右侧边内边距

新增`src/utils/assetUrl.js`工具文件，封装CDN图片版本化处理逻辑
在全局App启动及支付确认页预加载图片版本配置，缓存版本信息到本地
替换支付确认页内硬编码的CDN图片地址，改用工具生成带版本的URL
更新README.md与AGENTS.md文档，说明缓存更新流程与开发约定

补充以下细节：
1. 将 paySuccessRedirect.js 加入公共工具层高频文件列表
2. 完善支付确认页的支付成功跳转逻辑描述，明确跳转至接口返回的用户WebView或首页
3. 提示优先复用 paySuccessRedirect 工具，避免各页面重复编写跳转判断逻辑

提取支付成功跳转逻辑为独立工具函数，整合至支付确认页面；添加跳转防重复机制与对应状态文案，处理未找到我的菜单、链接为空及请求失败等异常场景。

1. 修改AppTabbar.vue的点击事件处理，仅对首页按钮使用Taro.redirectTo，其他按钮使用Taro.navigateTo以保留页面栈
2. 调整底部导航栏的面板和内容布局样式
3. 更新README和AGENTS.md文档，说明新的导航约定及修改原因

新增底部导航激活色默认常量与颜色格式化工具函数，在tabbar状态仓库中添加激活色状态并根据接口配置动态更新对应值，更新示例配置文件添加示例颜色，同时优化组件样式：调整容器高度、字体大小与间距，使用动态激活色替代硬编码值，移除冗余的激活态样式类

重命名并重新整理了原TODO.md为项目进度文档，拆分了项目当前阶段、已完成任务、联调中任务等分类；修正了src/api/index.js中首页接口的注释内容，更新client_id相关说明为当前已使用正式默认值的实际情况，并将对应待办标记为已完成。

将首页重复的横幅数据标准化处理逻辑提取为独立复用函数，统一对图片和跳转地址进行修剪操作；更新图标字体源文件地址并新增faxun图标类

- 更新README与AGENTS.md中的支付链路说明，补充公共参数f、client_id由请求层统一补齐的提示
- 修正src/api/index.js中getWechatPayParamsAPI的JSDoc注释，更新描述与参数说明
- 修正地图引导页的硬编码URL，添加tabbar预览与mock相关参数
- 明确区分主支付链路与历史支付链路，补充使用注意事项与参数混用提示

- 更新生产和本地Mock环境的API基础URL为 https://juelin.onwall.cn
- 重构tabbar工具函数，将默认回退导航项改为仅包含首页的项，并更新所有相关引用

重构 tabbar 配置处理以适配新的后端 API 端点 `/srv/?a=app_menu`，该端点返回对象结构而非数组。
新增 `normalizeTabbarPayload` 函数统一处理数组、对象及嵌套数据结构，增强数据兼容性。
优化 tabbar 组件支持水平滚动，当项目超过 4 个时自动启用滚动布局并添加滚动提示动画。
标准化 tabbar 键名映射，统一处理 `message`、`application`、`mine` 等旧键名到新键名 `news`、`list`、`user`。
改进页面 URL 生成逻辑，非首页项目优先使用 webview 预览链接。

将重复的 'futian_wxamp' 和 '358209' 字符串提取为模块级常量 F 和 CLIENT_ID，
避免硬编码，便于未来统一修改。

使用环境变量或配置来设置client_id，避免在代码中硬编码。
这使得应用更易于在不同环境中部署。

修复后端会话刷新时缺少 client_id 参数的问题，确保认证流程正确执行

- 移除HOME_CONTENT接口的f=customize参数
- 统一正式环境和Mock环境的f和client_id参数
- 删除config.js中关于f参数的过时注释

将图标组件替换为字体图标，以提供更灵活的图标定制能力。更新了标签栏配置、工具函数和组件逻辑，使其支持从配置中读取字体图标类名，并回退到默认图标。同时移除了对 @nutui/icons-vue-taro 的硬编码依赖。

- 移除资讯页原有的原生列表/详情逻辑，改为与“应用/我的”一致的 WebView 容器
- 在 tabbar 配置和 mock 数据中为资讯项添加 webview_url 和 webview_title
- 更新项目文档，说明资讯链路已统一为 WebView 承接，旧版原生资讯页转为参考链路

- 更新首页 API 地址及 mock 处理器，对齐 Apifox 接口规范
- 重构首页页面，消费 `volunteer_top_banner`、`volunteer_bottom_banner`、`volunteer_home_icon` 字段
- 为顶部 banner 添加 Swiper 轮播支持，单图保持现状，多图自动切换
- 在 mock 环境下添加状态提示，便于后续真实数据联调
- 调整全局配置，移除默认 `f` 参数，改为各接口单独传递
- 更新组件类型声明，引入 NutUI Swiper 组件
- 同步更新 TODO 清单，标记已完成项并细化后续任务

将原支付功能联调任务拆分为支付确认页联调（第6项）和支付功能联调（第7项），以更精确地跟踪开发进度。

记录当前版本未实现与待联调的核心功能，包括首页数据、底部导航、资讯列表、WebView地址、授权及支付流程，以便团队同步开发进度与后续联调重点。

补充项目功能概览，详细说明各核心模块职责与交互关系，重点描述首页分发、底部导航、资讯链路、支付流程和授权机制。更新项目结构说明，明确各目录的实际用途而非模板化描述。细化构建调试、Mock使用、授权支付链路约定等章节，确保文档与当前实现保持一致。

- 创建支付确认页面组件，包含金额展示和微信支付功能
- 在应用配置中注册新页面路由
- 集成微信小程序支付逻辑，支持订单号参数传递

- 新增应用页和我的备份页，支持 WebView 模式
- 重构我的页面为 WebView 承接页，移除静态 UI
- 新增底部导航配置 API、Mock 数据及 Pinia 状态管理
- 重构 AppTabbar 组件以使用动态配置，支持图标映射和页面路由
- 在应用启动时预加载导航配置，优化用户体验
- 将“消息”统一更名为“资讯”，更新相关页面文案

- 引入 Font Awesome 4.7.0 CSS 文件以扩展图标库
- 更新导航项图标配置，将“地图导览”图标从自定义字体替换为 Font Awesome 图标
- 重构 Vue 组件中的图标渲染逻辑，新增 `getIconClass` 函数动态判断图标类型并应用对应 CSS 类
- 调整相关样式类名以保持一致性

- 新增首页内容 API 接口及 mock 数据
- 重构首页 UI，移除静态占位内容，改为动态渲染 banner、导航和图文链接
- 添加点击跳转逻辑，支持页面内跳转和 WebView 打开外部链接

- 添加iconfont样式文件，包含丰富的图标字体定义
- 在首页概览卡片标题行中添加演示图标，展示图标使用方式
- 调整卡片标题布局为flex布局以容纳图标和文字

更新项目配置文件和文档中的 appid，以适配新的微信小程序环境

修复URL中activityId参数前的多余&符号，并补充缺失的_t参数值，同时添加activeTab参数以正确初始化页面标签页

清理未使用的 NutTabbar 和 NutTabbarItem 组件类型定义。
删除 AppTabbar 中用于 H5 环境跳转小程序的复杂逻辑，简化页面导航。
移除已不再使用的 miniProgram.js 工具文件。
更新地图引导页面的 URL 参数。

- 新增 miniProgram.js 工具模块，提供 H5 环境下检测微信小程序 webview 及页面跳转能力
- 重构 AppTabbar 组件，替换 NutUI Tabbar 为自定义实现，优化视觉样式
- 在 H5 环境下优先尝试使用小程序桥接跳转页面，增强多端体验一致性

新增通用webview预览工具函数和组件，支持动态URL和标题参数传递。移除未使用的NutUI组件类型声明，在首页添加模拟webview测试入口，并优化测试中心描述文案。

- 新增webview.js工具模块，包含URL构建和参数解析函数
- 重构webview-preview页面，支持动态URL和错误状态处理
- 在首页添加模拟webview测试入口，便于验证承载能力
- 移除components.d.ts中未使用的NutUI组件类型声明
- 优化pay-test页面，使用工具函数构建webview预览URL