移动其他-远程-1个月

项目编号：【41227】
# 智能吉他 App PRD（MVP）

## 1. 背景与目标
- 背景：为智能吉他硬件提供配套的学习、演奏与社区体验，验证硬件+内容的商业可行性。
- MVP目标：
- 完成“设备连接-演奏练习-反馈-内容消费/创作”的闭环。
- 支持基础的后台运营与固件 OTA。
- 覆盖首批真实用户（含付费/赠机用户）的核心需求，便于快速迭代。

## 2. 用户与场景
- 角色：游客、注册用户（未绑定设备）、设备用户（已绑定智能吉他）、创作者。
- 核心场景：
1) 新用户下载、注册、选择学习目标并进入首页。
2) 打开硬件，APP 扫描/绑定，固件校验与升级。
3) 配置演奏参数（调音、节奏、音色等）并实时生效。
4) 练习或跟弹曲谱，实时识别与评分反馈。
5) 浏览/收藏/下载曲谱；观看教学视频。
6) 使用简易编辑器创作曲谱并分享到社区。
7) 后台运营对用户、设备、曲谱、固件进行管理。

## 3. 范围说明
- **In Scope（MVP）**：EP-001~EP-010 需求全量落地；基础社区“大家在唱/我的创作/我的最爱”；简易曲谱编辑器；后台用户/设备/曲谱/固件管理。
- **Out of Scope（本期不做）**：复杂社交关系（关注/私信）、付费订阅与商城、AI自动编曲、PC 端客户端。

## 4. 需求总览（Epic）
- EP-001 用户注册与登录
- EP-002 设备连接与管理
- EP-003 演奏参数配置
- EP-004 曲谱库与搜索
- EP-005 智能演奏识别与反馈
- EP-006 教学视频播放
- EP-007 个人中心与数据统计
- EP-008 曲谱创作工具
- EP-009 社区与分享
- EP-010 后台管理系统

## 5. 详细需求

### EP-001 用户注册与登录
- 功能：手机号登录（短信验证码）；第三方登录（微信、Google）；首次登录即注册；登录后拉取/创建用户档案；异常/频繁登录触发验证码或风控拦截。
- 验收：短信验证码送达率 ≥ 98%，验证耗时 < 5s；第三方登录成功率 ≥ 97%；登录接口 P99 < 300ms。

### EP-002 设备连接与管理
- 功能：蓝牙连接、实时状态显示、断线自动重连、连接历史；设备/APP 配置参数实时同步；电量/固件/温度/异常提醒；多国语言与跨区域加速。
- 验收：连接成功率 ≥ 98%；断线重连 ≤ 5s；状态刷新延迟 < 1s。

### EP-003 演奏参数配置
- 功能：和弦映射自定义；±12 半音移调；BPM 40–260；节奏库（31 个预设+自定义 MIDI pattern）；音色 ≥ 5 种；参数保存与一键切换。
- 验收：参数调整实时生效；预设/音色数量达标；保存/切换成功率 ≥ 99%。

### EP-004 曲谱库与搜索
- 功能：曲谱分类（热门/最新/难度/推荐）；搜索（歌名/歌手/风格/难度）；详情含封面、信息、和弦谱与歌词；收藏与下载（离线使用）。
- 验收：搜索首屏返回 < 500ms；离线模式可正常打开已下载曲谱。

### EP-005 智能演奏识别与反馈
- 功能：实时识别和弦/音符；对比标准曲谱给出评分；错误提示与纠正建议；数据可视化（准确率、节奏稳定性）；练习模式：慢速/循环/分段。
- 验收：识别延迟 < 50ms；评分结果在练习结束 < 1s 展示。

### EP-006 教学视频播放
- 功能：教学视频列表与播放。
- 验收：首帧 < 2s；播放卡顿率（rebuffering ratio） < 5%。

### EP-007 个人中心与数据统计
- 功能：头像/昵称；收藏/下载管理；弹唱记录；资料编辑。
- 验收：数据加载 < 1s；记录保存成功率 ≥ 99%。

### EP-008 曲谱创作工具
- 功能：简易和弦谱编辑；添加和弦/歌词/段落（Intro/Verse/Chorus/Interlude/Outro）；预览；保存到个人曲谱库；首页“曲谱创作”入口。
- 验收：保存成功率 ≥ 99%；预览与实际显示一致。

### EP-009 社区与分享
- 功能：“大家在唱”展示弹唱记录；“我的最爱”收藏；“我的创作”展示个人曲谱。
- 验收：列表滚动流畅；内容审核策略由后台配置。

### EP-010 后台管理系统
- 用户管理：列表筛选（手机号/昵称/注册时间/设备绑定）、详情、启用/禁用、标签（VIP/普通）、批量导出/通知。
- 设备管理：序列号/型号/激活状态/绑定用户/固件版本；激活码生成与记录；绑定历史与解绑。
- 曲谱管理：列表、分类/标签、编辑、难度标注、批量上下架/定时上架。
- 固件管理：版本发布、回滚、OTA监控。

## 6. 核心流程（文字版）
- 用户注册/登录：下载 → 手机号/邮箱或第三方（微信/Google/Apple ID） → 填资料/偏好 → 选择学习目标 → 首页。
- 设备连接：开机 → APP 扫描 → 配对 → 成功后校验固件 → 有新版本则提示升级 → 进入演奏配置；可选校准/音色测试。
- OTA 升级：自动/手动检测 → 显示版本说明 → 用户确认/强制提示 → 下载固件包（进度） → 升级过程（禁止断连，展示进度） → 设备重启 → 验证版本 → 成功/失败回滚。
- 学习练习：选曲谱/教程 → 查看详情/难度 → 练习模式 → 实时识别+反馈 → 查看评分/建议 → 保存记录。
- 曲谱创作分享：进入编辑器 → 创作/预览 → 保存个人库 → 可选分享到社区 → 获得反馈。

## 7. 数据模型概述（概念级）
- 用户 User：基本信息、等级、设备绑定状态。
- 设备 Device：序列号、绑定关系、激活状态、固件版本。
- 固件版本 FirmwareVersion：版本号、发布时间、更新说明、包 URL、是否强制。
- 升级记录 UpgradeLog：设备ID、前后版本、状态、时间。
- 曲谱 SheetMusic：内容、元数据、难度、创作者。
- 练习记录 PracticeRecord：演奏数据、评分、时长。
- 教程 Tutorial：视频、练习题。
- 用户行为 UserBehavior：收藏/下载/浏览。
- 社区内容 CommunityPost：作品、动态、点赞。
- 硬件订单 HardwareOrder：购买与激活码。

## 8. 权限与角色
- 前端：游客 / 注册用户（未绑定） / 设备用户 / 创作者。
- 后台：超级管理员、运营管理员、技术管理员、数据分析师、客服。
- 访问控制：JWT 认证 + RBAC；设备绑定验证；接口鉴权。

## 9. 非功能需求
- 性能：API < 200ms；演奏识别 < 50ms；页面加载 < 2s；支持 1 万并发；曲谱数据 10 万+；用户 100 万+；可用性 99.9%；音频 48kHz/24bit。
- 安全：密码 bcrypt；HTTPS；序列号/激活码加密；JWT；RBAC；每日+异地备份；数据脱敏；合规（GDPR/国内法规）。
- 兼容：iOS 13+ / Android 8.0+；蓝牙 5.0+；2GB RAM/500MB 存储；4G/5G/WiFi；离线已下载内容。

## 10. 技术与约束
- 移动端：Flutter（跨平台）；蓝牙协议适配智能吉他。
- 后端：Python FastAPI；PostgreSQL + Redis；阿里云 Kubernetes；对象存储 + CDN 分发固件；RESTful API；ECharts 数据可视化；大列表分页/虚拟滚动。
- 后台：Vue 3 + Element Plus；响应式设计；RBAC 控制。


## 11. 风险与依赖
- 硬件蓝牙兼容性与低延迟传输需联调；固件回滚机制必须预留。
- 演奏识别算法准确度依赖训练数据；需与算法团队迭代评测。
- 多地区访问速度与合规（GDPR/国内）需提前评估存储/域名策略。
- 教学视频/曲谱版权获取与审核流程需明确。

## 12. 交付、上线与软著要求
- 源码交付：需交付完整可编译源码（前端APP、后端、后台）、构建脚本与必要的环境配置说明。
- 部署：使用阿里云 Kubernetes 服务部署，需考虑海外用户访问速度（CDN/多地域加速策略）。
- 上架：初始版本同时上架 App Store（iOS）、Google Play、应用宝，使用公司自有账号信息完成提交与发布。
- 软著：申请 3 个软件著作权，分别覆盖后台、APP 端、后端服务，主体均为公司账号。