KTV点歌系统产品系统

KTV 包厢娱乐场景中，顾客需要在大屏/手机端快速检索歌曲并发起点歌，店员需要在后台维护曲库与账号。传统纸质歌单更新慢、搜索效率低、排队易混乱，本系统用于提升点歌效率、减少人工操作，并支持曲库更新与基础运营管理。

系统包含用户端与管理端两部分：用户端提供歌曲搜索（歌名/歌手/分类等）、热门推荐与分类浏览、点歌/已点列表管理、播放控制（切歌/置顶/重唱/原伴唱等）及个人功能（登录、用户中心等）。管理端提供账号与权限管理、歌曲/歌手/分类等基础数据维护、数据导入与校验、日志与基础统计。前端基于 Vue3 + Vite，使用 Element Plus 组件库与 Pinia 状态管理，提升交互体验与页面响应速度。

项目采用前后端分离：前端 Vue3 负责页面与状态管理；后端同时提供 Node.js/Express 接口（如歌曲数据与第三方资源接入）以及 FastAPI 用户服务，统一以 HTTP API 对外提供能力。数据以 JSON 文件存储并提供导入/校验脚本，重点处理大列表分页与搜索体验、接口跨域、以及多端点歌操作下的队列一致性与异常兜底。