Hooke / mlaj

- 统一附件列表字段结构，将meta_id和file_type合并到files数组中
- 为getCheckinTeacherListAPI接口补充返回数据结构说明
- 同步更新teacher.js中getStudentUploadListAPI的注释

在视频封面缺失时，播放器区域显示为透明背景，导致视觉不一致。为 VideoPlayer 组件添加黑色背景，并在 StudyDetailPage 中动态设置封面容器的背景色：有封面时透明，无封面时黑色。同时优化 useVideoPlayer 配置逻辑，避免传递空的 poster 属性。

- 添加隐藏的预渲染节点，避免动态计算容器宽度导致的封面空白
- 在iOS微信环境中使用html2canvas替代html-to-image以解决兼容性问题
- 优化封面图片加载逻辑，添加原图兜底策略
- 调整样式和监听逻辑，确保数据变化时能正确触发重新生成

当评价内容为空时，调用 showToast 提示用户输入，改善用户体验。

- 将选中日期时的按钮文本从“选中 YYYY-MM-DD”简化为“更改日期”，提升简洁性
- 为按钮添加日历图标，并通过动态类名在选中和未选中状态间切换颜色
- 使用 flex 布局优化图标与文本的对齐，并添加状态颜色过渡效果

新增 useScrollRestoration 组合式函数，用于在打卡列表页面实现滚动位置恢复
当用户从打卡详情页返回时，自动恢复到之前的滚动位置，支持锚点定位和日历高度补偿
添加对应的单元测试，覆盖等待条件、超时处理和条件恢复等场景

在日历头部隐藏时，切换按钮仍会显示导致布局异常。通过添加 v-if 条件判断，仅在头部未隐藏时显示切换按钮，避免视觉错乱。

清理注册、课程详情和忘记密码页面中的注释标记，使代码注释更简洁

- 新增业务系统架构章节，涵盖用户认证、课程系统、打卡作业、活动、召回等核心模块
- 补充核心技术栈与实现细节，包括状态管理、文件处理、路由权限等
- 完善目录结构说明，清晰展示项目组织方式
- 更新功能更新记录，记录近期重要变更与优化点

更新多个视图文件的头注释信息，包括日期、最后编辑者和描述

添加重试次数限制判断条件canRetry
移除自动重试逻辑改为手动触发
优化错误提示UI样式和间距
添加重试后的错误状态检查定时器

添加任务详情准备状态检查，优化完成状态判断逻辑

- 使用模板统一管理课程详情显示逻辑
- 添加空状态提示组件替代注释掉的代码
- 移除不必要的条件渲染和注释

在日历组件中添加清空选中日期的功能，并优化日期切换按钮的显示样式和文本
当有选中日期时显示具体日期，无选中日期时显示"切换日期"
添加清空按钮用于快速清除当前选中状态

移除冗余的空状态组件，根据内容动态显示分隔线

当课程没有特色、亮点或学习目标时，才显示"暂无详情"。修复了原本逻辑中空状态和详情可能同时显示的问题

在课程详情页跳转至学习页时传递课程ID，并在学习页中监听课程ID变化时同步滚动位置

实现从课程详情页返回时恢复滚动位置的功能
添加数据属性标记课程目录项
新增滚动状态存储和恢复相关方法

将原ui目录下的组件按功能分类移动到新的子目录中：
- 将GradientHeader、ConfirmDialog等基础组件移至common目录
- 将CourseCard、LiveStreamCard等课程相关组件移至courses目录
- 将FrostedGlass等视觉特效组件移至effects目录
- 将VideoPlayer、AudioPlayer等媒体组件移至media目录
- 将CheckInDialog等打卡相关组件移至checkin目录
- 更新所有引用路径以匹配新的目录结构

为TaskCascaderFilter、AddTargetDialog、CheckInList等组件添加详细的JSDoc注释
将LiveStreamCard组件的英文注释转换为中文
完善postCountModel组件的类型检查和空值处理
为CheckinDetailPage的关键方法添加详细说明

为AppLayout、CourseCard等组件和useShare、useTracking等工具函数添加了详细的JSDoc注释，包括功能描述、参数说明和返回值类型。这些注释将提升代码可读性和维护性，帮助开发者快速理解组件和函数的用途及使用方法。

新增的注释涵盖了组件props、methods、events等关键部分，并遵循了统一的文档格式标准。对于复杂逻辑的函数，添加了详细的实现说明和使用示例。

这些文档更新不会影响现有功能，但会显著改善开发体验和代码可维护性。

添加关于Vue 3 TypeScript开发、Volar工具链、性能优化和测试相关的13个最佳实践文档，涵盖模板类型检查、CSS模块、路由参数类型等核心场景

- 新增vue-tsc严格模板检查规则
- 添加CSS模块严格类型验证指南
- 补充Volar 3.0迁移问题解决方案
- 包含Pinia测试和SSR HMR调试实践
- 添加defineModel和withDefaults的TypeScript处理方案
- 补充模块解析和自动导入冲突解决建议

- 添加业务系统架构详细说明，包括用户认证、课程系统、打卡作业系统等模块
- 记录近期功能更新，包括教师端功能、登录逻辑优化、课程详情页改进等
- 完善目录结构说明和技术栈实现细节

添加对 .flac, .ogg, .wma, .m4a 格式的支持，以兼容更多音频文件类型

style(checkin): 优化打卡卡片图片布局

修改学习课程页面底部间距从30vh增加到80vh以提供更多空间
重构打卡卡片图片布局，使用固定宽高比和更合理的间距

修复初始化时日期选择逻辑错误，优化日期参数传递方式
添加状态变量跟踪用户是否主动选择日期
确保页面刷新和导航时正确加载数据

在CollapsibleCalendar和taskHomePage组件中，将硬编码的附件类型映射逻辑替换为统一的工具函数normalizeAttachmentTypeConfig，提高代码复用性和可维护性

实现附件类型配置的归一化处理，支持多种后端格式
添加文件大小限制映射和计算逻辑
更新上传组件以显示动态限制大小
添加相关测试用例

在任务打卡成功时，将选中项的 is_gray 和 is_finish 状态设置为 true，以正确反映任务完成状态

将task_list和timeout_task_list的初始化及数据处理逻辑移到课程数据加载成功后执行，确保数据正确性

将多处重复的打卡任务列表字段映射逻辑提取为工具函数 normalizeCheckinTaskItems
统一处理字段映射逻辑，避免散落在各页面导致维护困难

为课程页面中的任务数据添加is_finish和checkin_subtask_id字段，用于跟踪任务完成状态和关联打卡子任务

在打卡详情页中，根据任务类型动态显示附件类型标签为必选或可选
在打卡目标列表组件中，为必填项添加红色星号标识