Hooke / lls_program

问题描述：
- 用户报告活动页面 WebView 内容总是显示旧版本
- 即使后端 H5 页面已更新，小程序仍显示缓存内容

解决方案：
1. 添加 key 属性强制重新渲染
   - 给 web-view 组件添加 :key="webUrl"
   - URL 变化时强制销毁并重新创建 WebView

2. 添加时间戳参数破坏缓存
   - 在 URL 末尾添加 &_t=${timestamp} 参数
   - 确保每次请求的 URL 都不同，避免缓存命中
   - 即使没有位置参数也添加时间戳

3. 增强调试日志
   - 添加表情符号标记（✅ ❌ 🔗 📋）
   - 输出完整 URL 和长度信息
   - 便于排查缓存问题

测试建议：
- 清除小程序缓存后重新编译
- 查看控制台日志确认 URL 包含时间戳参数
- 验证每次进入页面 _t 值都不同

影响文件：
- src/pages/Activities/index.vue

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 在Activities页面添加activityId参数处理
- ActivitiesDetail页面跳转时传递activityId
- 在ActivitiesDetail和CheckinMap页面禁用mock数据（USE_MOCK_DATA=false）
- 完善活动ID在整个导航链路中的传递

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

**问题描述**：
点击分享海报按钮时提示"缺少活动ID"

**根本原因**：
1. ActivitiesDetail 页面跳转到海报页面时没有传递 activityId 参数
2. PosterCheckinDetail 页面调用 posterAPI 时没有传递 activity_id 参数

**修改内容**：

### src/pages/ActivitiesDetail/index.vue
- 修复 onSharePoster 函数，跳转时传递 activityId 参数
- 优化 useLoad 钩子，支持 id/activityId/activity_id 三种参数名
- 移除默认ID逻辑，改为友好提示并返回上一页

### src/pages/PosterCheckinDetail/index.vue
- 修改 onMounted 钩子，读取 URL 中的 activityId 参数
- 修改 fetchPosterDetail 函数，将 activityId 传递给 posterAPI

### src/pages/CheckinMap/index.vue
- 更新 LastEditTime

**测试建议**：
1. 打开活动详情页（确保URL有activityId参数）
2. 点击"分享海报"按钮
3. 应该能正常显示海报打卡页面

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- CheckinMap: 添加日期格式化函数，将 YYYY-MM-DD 转换为 YYYY.MM.DD 格式
- ActivitiesDetail: 添加 discount_title 字段支持，并在跳转时传递该参数
- Activities: 接收并处理 discount_title 参数，构建完整的活动 URL

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 修复 detail/list 接口字段拼写错误：tittle → title
- 修复 PosterCheckinDetail 页面 API 导入错误
- 添加 cover 字段空值处理，使用默认封面图
- 同步更新 API 文档和 Mock 数据

影响文件:
- src/pages/ActivitiesDetail/index.vue
- src/pages/CheckinMap/index.vue
- src/pages/PosterCheckinDetail/index.vue
- src/utils/mockData.js
- src/api/map_activity.js
- docs/api-specs/map_activity/detail.md
- docs/api-specs/map_activity/list.md

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

- 修改 onSharePoster 跳转到 PosterCheckin（老页面）
- ActivitiesCover 使用老 API，应该跳转到使用老 API 的海报页面
- ActivitiesDetail 继续跳转到 PosterCheckinDetail（新页面）

- 在 app.config.js 中注册 PosterCheckinDetail 页面
- 修改 ActivitiesCover 分享海报逻辑跳转到新页面
- 修改 ActivitiesDetail 分享海报逻辑跳转到新页面
- 还原 PosterCheckin 到旧接口（map.js）

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 基于 PosterCheckin 创建新页面
- 完全使用 map_activity.js 新接口（getPosterDetailAPI）
- 支持从活动页面分享海报跳转

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 还原到 commit 4ead53d3 版本
- 使用旧接口 getActivityStatusAPI（map.js）
- 修改便民地图跳转到 ActivitiesDetail
- 保持原有功能不受影响

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 在 app.config.js 中注册新页面
- 页面路径：pages/ActivitiesDetail/index

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 基于 ActivitiesCover 创建新页面
- 完全使用 map_activity.js 新接口（detailAPI）
- 支持从地图活动列表跳转
- 动态渲染积分规则

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 将 posterAPI 重命名为 getPosterDetailAPI，命名更清晰
- 修复 PosterCheckin 页面的 API 导入路径（@/api/map → @/api/map_activity）
- 更新 CHANGELOG 记录海报接口联调功能

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 集成 detailAPI 获取活动详情数据
- 添加数据转换函数 transformApiDataToActivityData
- 移除单独的 fetchActivityStatus，统一通过 fetchActivityDetail 获取
- 积分规则改为动态渲染（v-for）
- 支持开发环境使用 mock 数据测试
- 创建测试指南文档

影响文件:
- src/pages/ActivitiesCover/index.vue
- docs/ActivitiesCover-测试指南.md
- .gitignore (添加 .tmp/ 目录)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

主要修改：
- 修复 mockData.js 的语法错误（移除孤立的 return 语句）
- 修复 generateApiFromOpenAPI.js 的 brace-style 代码风格问题
- 实现 CheckinMap 页面与 map_activity API 的集成
- 添加完整的 API 规范文档
- 更新 API 代码生成脚本

技术细节：
- 清理 mockData.js 中遗留的孤立代码片段
- 移除未使用的函数参数以消除警告
- 修复 ESLint brace-style 规则错误（9处）
- 完善 map_activity API 接口定义
- 添加 API Mock 数据支持开发环境测试

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 使用 git rm --cached 移除文件跟踪
- 本地文件保留，但不再提交到版本控制

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 更新 .gitignore 以忽略子目录中的 CLAUDE.md
- 避免提交 MCP memory 自动生成的文件

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 更新底部导航标签文案
- 更新页面标题栏文本
- 更新文件描述注释

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 创建打卡地图列表页面，展示6个打卡活动
- 修改底部导航栏，将"乐在重阳"改为"打卡地图"
- 实现海报式卡片布局（一行两个）
- 卡片包含封面图、标题、活动日期、进入按钮
- 点击按钮跳转到活动封面页，并传递活动参数
- 在 app.config.js 中注册新页面

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- 创建完整的文档体系（8 个核心文档）
  - CHANGELOG.md - 项目变更日志
  - PROJECT-STATUS.md - 项目状态报告
  - DEVELOPMENT-GUIDE.md - 开发指南
  - CODING-STANDARDS.md - 代码规范
  - GIT-WORKFLOW.md - Git 工作流规范
  - api-integration-log.md - API 集成日志
  - lessons-learned.md - 经验教训总结
  - INITIALIZATION-SUMMARY.md - 初始化总结

- 配置测试框架
  - Vitest + @vue/test-utils + jsdom
  - 测试环境设置（Mock Taro API、wx API）
  - 添加测试示例文件

- 配置代码质量工具
  - ESLint 完善配置
  - Prettier 格式化配置
  - Husky Git Hooks
  - lint-staged 暂存文件检查

- 优化项目配置
  - 更新 package.json（测试脚本、lint-staged）
  - 优化 .gitignore
  - 创建主文档 CLAUDE.md

详细信息和后续步骤请查看 docs/INITIALIZATION-SUMMARY.md

添加 .claude/ 目录到 .gitignore 文件，避免将 Claude 相关文件提交到版本库

将 CLAUDE.md 文件添加到 .gitignore 中，避免将其纳入版本控制。

- 禁用enhanced和bounces属性以改善滚动体验
- 添加外部滚动监听判断防止重复触发
- 增加滚动到底部的延迟触发防止快速翻页
- 将文本显示行数从2行改为3行

- 将随机偏移改为按行数规律排列（奇数行靠左，偶数行靠右）
- 增加extraPlaceholder属性控制占位数量
- 在FamilyRank页面添加底部提示文本
- 调整RankingCard组件高度和占位配置

- 新增 ScrollableFamilyList 组件用于展示家庭信息
- 替换原有 NativeDanmuComponent 实现
- 优化支持页面的布局和样式
- 添加家庭数据获取和处理逻辑

在导航到加入组织页面后，添加延迟恢复默认选中状态的逻辑

优化弹幕显示区域，避免内容被遮挡

增强弹幕组件的循环逻辑，确保在没有数据时自动重新获取
调整弹幕轨道数量和容器高度以优化显示效果

在查看更多操作后延迟500毫秒重置activeTab为默认值'shanghai'，确保UI状态一致性

改进弹幕宽度测量功能，增加重试机制和更保守的默认值计算
优化动画启动时机，确保宽度测量完成后再开始

- 移除弹幕淡出效果，保持不透明度始终为1
- 引入弹幕宽度测量和动态时长计算，确保速度一致
- 使用常量替换魔法数值，提高代码可维护性
- 优化弹幕位置计算和碰撞检测逻辑

重构弹幕组件实现无缝循环播放，避免弹幕突然消失
添加预加载功能使弹幕在页面加载时就开始滚动
优化弹幕间距控制和淡出效果

重构顺序弹幕发送逻辑，改为根据可用轨道数量同时填充弹幕
移除弹幕点击时的Toast提示以简化交互

重构弹幕组件逻辑，移除mock数据改用API获取真实弹幕数据
优化弹幕动画逻辑和轨道管理，提高弹幕显示效果
调整弹幕样式和间距，增强用户体验

- 新增 NativeDanmuComponent 原生弹幕组件，支持多轨道弹幕展示
- 在家庭排行榜页面集成弹幕功能，展示助力榜内容
- 调整排行榜卡片布局和样式，优化助力码按钮位置
- 添加弹幕点击和悬停事件处理逻辑

修改排行榜卡片和家庭排行页面的显示逻辑，当activeTab为'support'时不显示排名内容
将"助力榜"更名为"助力墙"以更准确描述功能

移除随机生成的家庭数，改为使用接口返回的真实数据
将数字滚动组件的位数固定为5位
在家庭参与排名文本前添加"+"符号

- 使用更平滑的缓动函数 easeOutQuart 替代 easeOutCubic
- 减少不必要的值更新，只在变化明显时更新
- 添加硬件加速优化（translateZ(0)）
- 移除CSS transition，完全由JS控制动画
- 添加文本渲染优化属性