哈基哈米网站重构需求文档

一、项目背景

哈基哈米（hajihami.com）是一个以“哈基米”文化为核心的音乐收录与分享平台，目前构建在 Notion 之上。随着用户规模增长、内容量扩大及互动需求提升，现有架构在性能、扩展性、用户体验等方面已无法满足长期发展。为此，需对网站进行完整重构，打造一个自主可控、功能完善、体验优良、可持续演进的“哈基米”音乐社区。

二、项目目标

  1. 脱离 Notion 依赖：构建独立站，拥有完整前后端与数据库。
  2. 功能无损迁移：原有关键功能（搜索、投稿、榜单、分类、互动、社群）全部保留并增强。
  3. 体验全面升级：响应式、加载快、交互流畅、支持夜间模式。
  4. 开放生态：提供开放 API，方便第三方机器人、小程序、App 接入。
  5. 可持续运营：内置数据仪表盘、内容审核后台、激励发放系统，降低运维成本。

三、用户画像

角色 描述 核心需求
听众 浏览、搜索、播放、收藏、评论、分享 快、全、准、流畅
创作者 上传音频/封面、填写信息、查看数据、领取激励 低门槛、实时反馈、收益透明
审核员 过审/驳回/下架、批量操作、查看日志 高效、安全、可追溯
管理员 配置榜单、发放哈气金、发布公告、数据分析 一站式后台、可视化、权限分级
开发者 调用开放 API、开发机器人 文档清晰、限频合理、版本稳定

四、功能模块与需求拆解

1. 音乐数据库（核心）

子功能 需求描述 验收标准
曲库管理 字段：ID、标题、原曲名、UP主、全民制作人、风格标签、时长、BPM、封面图、音频文件、发布时间、播放量、点赞量、收藏量、审核状态、备注 字段可扩展；支持批量导入旧数据
原曲关联 一首歌可关联 0-N 个“原曲”条目（标题、作者、外链、类型） 前端可展示“原曲出处在哪”
多源音频 支持本地上传、外链（B 站、网易云、SoundCloud 等）双模式，自动转码 mp3 128k/320k 转码失败率<1%，支持重试
封面图 自动压缩 WebP，多分辨率 200/600/1200 CDN 加速，懒加载
失效检测 每日定时任务检测外链失效，标记“需补档”并通知 UP 检测覆盖率 100%，T+1 完成

2. 搜索与筛选

子功能 需求描述 验收标准
全文检索 支持“歌名/原曲/UP主/风格/歌词”组合搜索，实时联想 响应 <300 ms，支持拼音/首字母
高级筛选 风格、有无翻唱、有无 AI、时间区间、播放量区间、排序方式 与搜索框联动，URL 可分享
标签系统 多级标签（风格：原教旨/婉约/曼波/电音…；类型：翻唱/原创/AI）；支持用户提报新标签 后台可审核标签，滥用可下架

3. 榜单与推荐