gongxiangp2/docs/素材库筛选与下拉控件验收-2026-10-07.md

3.6 KiB
Raw Permalink Blame History

素材库筛选与下拉控件验收

日期:2026-10-07。状态:代码修改与本地验证完成,尚未提交 Git 或部署。

修改范围

  • 素材卡片预览区建立独立层叠上下文,角标保留在卡片内;固定顶栏和“更多素材类型”菜单显示在角标上方。
  • 排查 app、components 的原生下拉框,将 27 个源文件内的 82 处控件接入 components/ui/Select.tsx;素材类型选择器也复用它。菜单统一主题、键盘操作、禁用选项、点击外部关闭及 GSAP 开合动画,并遵循减少动态效果偏好。
  • 隐藏的原生 select 继续负责表单值、change 回调、必填校验与 reset;可见按钮负责交互。现有专用搜索、人员和树形选择器保留业务交互。
  • 筛选区统一标签列、选项状态和分组间距;长列表可展开,收起时保留已选项;已选条件支持逐项清除。
  • 直播日期复用项目日历,统一为 YYYY-MM-DD,限制开始日期不能晚于结束日期;弹层随视口边界调整位置。
  • 修复直播平台、直播日期变化未触发列表请求,以及刷新未恢复这些条件的问题;补齐 URL 与页面状态缓存。

验证证据

  • npm run typecheck 通过。
  • 相关回归测试:34 组、309 项全部通过,涵盖上传字段及参数、编辑检测报告、筛选、知识库、考核与权限表单、键盘操作和必填校验。
  • git diff --check 通过。
  • 全项目原生下拉框复查:除共享组件内的隐藏表单字段,app、components 生产 TSX 中没有原生 <select>。
  • 实际项目页面在独立本地验收环境渲染,使用示例接口数据,未连接生产服务。桌面 1440×1000、手机 390×844 验证菜单主题、日期范围、完整日期文字、弹层边界、键盘方向键与 Esc、上传面板及角标层级;未发现横向溢出或浏览器控制台警告/错误。
  • 实际浏览器选择日期后,请求包含 liveDateFrom=2026-10-01&liveDateTo=2026-10-07;刷新页面后日期及请求参数仍保留。
  • 命中层级检查:卡片角标滚动进入顶栏范围时,顶栏在前;“更多素材类型”菜单与角标重叠时,菜单选项在前。
  • Impeccable polish 检查完成。扫描的字体提示涉及原有页面字号;唯一非 advisory 提示为 DataStatisticsTab.tsx 既有紫色图表渐变,已核对 HEAD 中存在,本次仅替换其下拉框,保留既有图表语义。

本地验收截图

  • tmp/material-ui-qa/desktop-filter.jpg
  • tmp/material-ui-qa/mobile-filter.jpg
  • tmp/material-ui-qa/desktop-type-menu.jpg
  • tmp/material-ui-qa/desktop-header-layer.jpg

tmp/material-ui-qa 为忽略的临时验收目录;验收服务器已停止。验证使用本地示例数据,不代表已完成生产登录后的验收。原有任务详情图片来源修复的未提交代码未纳入本次前端修改。

发布前复核

  • 合入远端 4653a5639286b30df63aa879fff2e56cc18d1755 的业绩转化统计功能,保留其行为,仅替换趋势指标下拉控件。
  • 34 组、310 项相关回归测试通过;Prisma Client 校验及类型检查通过。
  • 重新从当前源码生成隔离预览,核对桌面 1440×1000 与手机 390×844 的日期范围和日历边界。手机日历位于视口内,无页面横向溢出,浏览器无警告或错误。
  • 本次提交仅包含界面修复、对应测试和本验收记录;历史来源映射代码、运维文档及直播切片交接稿仍保留为未提交工作。
  • 发布仍需以精确提交 SHA 通过标准部署脚本完成,并以公网健康接口返回的 deploymentCommit 确认结果。