zyc/UI-UX
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
UI-UX/CHANGELOG.md
iye 8b99c2f091
All checks were successful
Build and Deploy / build-and-deploy (push) Successful in 4m44s
Details
feat: 跨设备同步 + Logo v3 + 导航合并 + 窄屏适配 (v0.3.4) 
- useSyncMe: 登录后拉 /api/me 用 votedArtists 覆盖本地 store,登出清本地
- Providers: SyncMeBridge 接入 SessionProvider
- Logo v3 替换登录页/弹窗/Footer 的旧 <Logo> 组件
- Footer 删除 logo,简化为版权行
- Navigation 删除 mobile 第二行 NavLinks,合并到第一行
- NavLinks 统一布局,响应式 gap+字号(gap-5 sm:gap-8 / text-[13px] sm:text-sm)
- HeroVoteProgress 窄屏(< md)隐藏 12 格点,只留文字
- scripts/screenshot-narrow.mjs 验证脚本(可配宽高)

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-18 14:56:42 +08:00

11 KiB
Raw Permalink Blame History

CHANGELOG

CYBER STAR(虚拟明星 Top 12 出道选拔)更新日志。新条目写在最上面,旧条目往下沉。

版本号规则(SemVer · 0.x 开发期)

  • 0.X.0 → 重要功能、破坏性变更(如投票模型重构)
  • 0.x.Y → 修补、内容更新、UI 打磨
  • 1.0.0 → 正式上线 / 第一次面向公众活动

每次发版必须三件套同步:

  1. package.json 里的 version 字段
  2. 本文件加新条目(顶部)
  3. git tag v<x.y.z>(可选 push 到远程,触发 CI release 流程)

每个版本下方都写两块 commit 信息:

  • Tag: tag 实际打在哪条 commit(可点击直达 Gitea)
  • 核心 commit: 该版本最重要的功能/改动 commit hash
  • 完整 diff: 与上一个版本的 compare 链接

v0.3.4 · 2026-05-18 · 跨设备同步 + Logo v3 + 导航合并 + 窄屏适配

Commit 信息

改了什么(用户视角)

  • 跨设备投票状态自动对齐:A 设备投了 5 票,B 设备登录后立刻看到 5 票已投(原来只看 localStorage)
  • 登录页 / 登录弹窗 / Footer 替换为新版金属质感 logo(logo-v3.png),Footer 顺手去掉 logo 行
  • 导航栏窄屏不再"双行":"首页 / 排行榜 / 我的"合并到第一行,与右侧搜索/badge/auth 同行
  • 窄屏(< 768px)hero 右上角应援进度只显示文字,隐藏 12 格点 —— 让左侧 "TOP 12 · CYBER STAR" eyebrow 有空间不挤撞

技术点

  • src/hooks/useSyncMe.ts(新): 监听 session 变化 → 拉 /api/me → hydrateFromServer(votedArtists) 覆盖本地 store;登出清本地避免上一个用户残留
  • src/components/Providers.tsx: <SyncMeBridge/> 在 SessionProvider 内部启动 useSyncMe
  • src/components/Navigation.tsx: 删除 mobile 第二行 NavLinks,nav gap-4 sm:gap-8 响应式
  • src/components/NavLinks.tsx: 删除 mobile/desktop 双分支,统一用 gap-5 sm:gap-8 text-[13px] sm:text-sm
  • src/components/HeroVoteProgress.tsx: 12 格点容器加 hidden md:inline-flex,< 768px 隐藏
  • public/logo-v3.png(新): 金属质感 logo,替换原 <Logo> 组件

实测三种屏宽(脚本 scripts/screenshot-narrow.mjs)

屏宽 nav hero eyebrow hero progress 宽
1500px 单行 ✓ 不撞 ✓ 252(完整 12 点)
740px 单行 ✓ 不撞 ✓ 135(隐藏点)
360px 单行 ✓(NavLinks 140px 塞下) eyebrow 320px 太长仍占满 ⚠️ 135

风险 / 已知问题

  • 360px 极窄屏 hero eyebrow 自身已占 320px,即使 progress 缩到 135 仍会横向重叠。下次单独修(eyebrow 极窄屏可简化为 "TOP 12" 或 hidden sm:block)

v0.3.3 · 2026-05-15 · 修复:投票后票数 +1 和 Top12 排位要等 30s

Commit 信息

改了什么

  • 投票成功后,首页 Top12 + 排行榜立即拉新数据,不必等下次 30s 轮询
  • 服务端拒绝投票时(如其他设备已投过),本地立即回滚乐观更新 + 用 /api/me 重新对齐
  • 网络异常时回滚 + 报错,避免本地状态与服务端不一致

根因(诊断详见 v0.3.2 后的对话)

  • useRanking 30s 轮询拉服务端票数,merge 时取 max(serverVotes, storeVotes)
  • 用户投票后,storeVotes 立即 +1,但 serverVotes 还是 30s 前的旧值,且更大
  • max 永远取 server → 本地 +1 被压住 → 票数和排位最多延迟 30s 才更新

技术修复

  • useVoteAction 加 onVoteSuccess 回调,服务端 200 后立即触发
  • page.tsx + ranking/page.tsx 把 live.refresh 传进去
  • 顺手把 fire-and-forget 改成 await 服务端,失败时 rollbackVote + refetchMe(/api/me) 跨设备对齐
  • store 新增 rollbackVote(id) + hydrateFromServer(ids[]) 两个 action

体感对比

场景 本地 dev(打公网 RDS) 生产(同区 K3s + RDS)
改前 0~30 秒后才看到票数 +1 同上
改后 ~700-1000 ms(vote API 写完 + ranking refresh) ~150 ms

风险 / 已知问题

  • ArtistDetailContent 显示的 artist.votes 仍从 store 来,store 里这个字段是"本地用户投过几次"不是服务端真实票。详情页票数显示问题留下次单独修。

v0.3.2 · 2026-05-15 · 修复:首页 Top12 出道位空着,排行榜却有数据

Commit 信息

改了什么

  • 首页 Top12 出道位现在能显示真实票数(此前一直显示"Awaiting Votes")

根因

  • 首页 Top12Bar 之前只读前端 zustand store 的 artists,store 初始来自 mock-data(36 人全部 0 票),只有当前浏览器用户自己投票时才会更新
  • 排行榜 /ranking 走 /api/ranking 直接读 DB,所以有真实票数
  • 未登录访客访问首页 → store 全 0 票 → top12 = filter(votes > 0) 空 → 显示"Awaiting Votes"

技术修复

  • src/app/page.tsx 加 useRanking({ pollInterval: 30_000 }),30 秒轮询 /api/ranking
  • 用 useMemo 合并 storeArtists(本地乐观投票)+ API 票数(取 max),重新排序赋 rank
  • 与 /ranking 页面用同样的 merge 策略,保证两处票数视图一致

风险 / 已知问题

  • 首页和排行榜各自跑一个 useRanking 实例,会产生两个独立轮询请求。后续可以提到 layout 层共享,但当前 36 行查询很轻,先这样

v0.3.1 · 2026-05-15 · 13 号(虞浓)氛围图 2 替换

Commit 信息

  • Tag 打在: 本次 release commit(git log -1 看)
  • 完整 diff: v0.3.0...v0.3.1

改了什么

  • 13 号虞浓的氛围图 2 换成新版本(portraits/013-2.webp,1440×2560,153KB)

技术点

  • TOS cache version 7 → 8(src/lib/tos.ts),浏览器 + CDN 立即拿到新图,不必等 TTL
  • 转换脚本 _tmp_webp_convert/round3.mjs,sharp quality 82

v0.3.0 · 2026-05-15 · 投票模型大改:每日额度 → 终身 12 票

Commit 信息

  • Tag 打在: 93c3abe chore(release): v0.3.0 + 建立 CHANGELOG + 追溯版本号
  • 核心 commit: 10878dd feat(vote): 重构投票模型为终身 12 票 + 每艺人 1 票
  • 完整 diff: v0.2.2...v0.3.0

改了什么

  • 每个用户改为终身 12 票,每位艺人最多 1 票,投出不可撤销
  • 取消活动时间窗(不再限定结束日期)
  • Hero 右上角倒计时换成 "应援进度" 12 格点亮式条
  • 已投艺人卡片显示 ✓ 角标 + "已投票" 灰色按钮
  • /me 页改为终身额度叙事(QuotaCard / StatsGrid / MyFanSupport)
  • VoteModal 去掉 1/3/5/ALL 选择器,改"投出我的一票"单一确认

技术点

  • votes 表加 @@unique([userId, artistId]) 硬约束(已 apply 到生产 RDS)
  • /api/vote 重写:12 票上限校验 + P2002 转 ALREADY_VOTED + P2003 转 NOT_FOUND
  • /api/me 新增 votedArtists[] + voteQuota,替换旧 dailyQuota
  • 前端 store 改为 zustand persist + votedArtists[],localStorage key cyber-star-vote
  • 新增 scripts/:DB 探查 / SQL 迁移 apply / E2E 回归测试(走完整 OTP 登录)
  • 提交后 DB 测试数据清空,从 0/12 重新开始

风险 / 已知问题

  • 前端 hydrate 仍只用 localStorage,不消费后端 /api/me.votedArtists。用户清缓存或换设备会看到"我能再投",但 DB unique 兜底,重投会被服务端拒绝(toast 提示已投过)
  • 旧 daily_quota 表数据保留未清,新逻辑不再读取

报告: docs/todo/voting-refactor-完成报告.md、docs/todo/voting-refactor-backend-完成报告.md

v0.2.2 · 2026-05-15 · 内容批次 v2 修正 + 单人视频

Commit 信息

改了什么

  • 多位艺人立绘 / 头像 / 氛围图替换(003 / 006 / 007 / 010 / 014 / 017 / 019 / 027 / 033 等)
  • 单人表演视频更新(5 个艺人)
  • Hero PV 视频压缩 4K 1.19GB → 1080p 47MB
  • Nav logo 去除 + Hero 视频默认静音

技术点

  • TOS bucket ?v= 缓存版本号 4→7 多次升级
  • sharp + ffmpeg-static 资源压缩管线(scripts/ 多个工具)

v0.2.1 · 2026-05-14 · UI 视觉打磨

Commit 信息

  • Tag 打在: 7168e50 fix: prod login + env-file driven config + scroll-snap bounce
  • 完整 diff: v0.2.0...v0.2.1

改了什么

  • 导航栏滚动到 Hero 下方时自动从透明变毛玻璃
  • 加浮动返回按钮 + 滚动位置 per-tab 记忆
  • 筛选条吸顶时与 nav 合并为单一 backdrop-filter 带,消除接缝

技术点

  • useUIStore 跨组件感知 filter 吸顶状态
  • 修复生产登录失败 + .env 驱动配置

v0.2.0 · 2026-05-13 · 真实持久化 + CI/CD 打通

Commit 信息

  • Tag 打在: 1073262 ci(secret): inject Aliyun SMS credentials into cyberstar-env
  • 核心 commit: a9f4799 feat(db): wire real persistence for votes / users / quota / supports
  • 完整 diff: v0.1.0...v0.2.0

改了什么

  • 投票 / 用户 / 应援 / 额度全部走真实数据库(火山引擎 RDS),不再 mock
  • 阿里云短信 OTP 登录上线(国内手机号)
  • 静态资源全部迁移到火山引擎 TOS 桶
  • 排行榜真实动态计算(基于 DB 聚合)

技术点

  • CI/CD 流水线接通 Gitea Actions → Docker build → K3s 部署
  • cyberstar-env Secret 注入 DATABASE_URL + SMS 凭据
  • Prisma alpine binary target + hoisted node_modules 适配 docker
  • next/image 对 TOS 资源关掉优化(否则会代理拉破带宽)

v0.1.0 · 2026-05-12 · 项目骨架与全部页面初版

Commit 信息

  • Tag 打在: d5ed43a feat(ui): design overhaul, global login modal, design spec
  • 核心 commit: 8a83815 chore: bootstrap Next.js 16 + Tailwind v4 + TypeScript baseline
  • 范围: 项目第一个 commit 到 d5ed43a(共 16 个 commit)

改了什么

  • Next.js 16 + Tailwind v4 + TypeScript 项目搭建
  • 紫色品牌设计系统(Megrim / Audiowide / Cinzel / Inter 字体)
  • 首页(Hero + Top12 + 36 艺人候选区)
  • 排行榜(Top3 podium + Top4-12 列表 + 出道线 + 候补区)
  • 艺人详情页(Hero + 15s 视频 + Gallery + 人物小传)
  • /me 用户中心(配额卡 / 签到日历 / 统计 / 应援)
  • 通用组件(Button / Countdown / ArtistCard / Top12Bar / VoteModal)
  • Auth.js v5 手机号 OTP 登录(全局登录 modal)
  • REST API(artists / ranking / me / vote / signin)+ Redis 限流 + Zod 校验
  • Prisma 6 + MySQL schema(Vote / DailyQuota / FanSupport / Invitation / RiskLog 等)
  • 实时排名 polling + LiveBadge

技术点

  • 首版投票规则:无限制(无日额度、无单艺人上限)—— 后续逐步加严
  • API 不可达时前端降级到 mock 数据

格式参考 Keep a Changelog,宽松版