docs(readme): 新增初次部署清单与常见问题;统一 root 执行写法;清除 markdown 粗体标记与残留真实库名
This commit is contained in:
@@ -12,7 +12,7 @@ React 管理端的歌曲管理页面:列表、检索、新建/编辑、音频
|
||||
```
|
||||
DSH.md
|
||||
contracts/rest-api.yaml # 锚点:#/paths/~1api~1songs、#/components/schemas/Song
|
||||
contracts/data-models.md # 锚点:§2 Song
|
||||
contracts/data-models.md # 锚点:2 Song
|
||||
web-server/admin/src/**
|
||||
web-server/admin/package.json
|
||||
```
|
||||
@@ -22,7 +22,7 @@ web-server/admin/package.json
|
||||
`web-server/admin/`(React 18 + Vite + TypeScript):
|
||||
|
||||
| 路径 | 说明 |
|
||||
|---|---|
|
||||
|--|--|
|
||||
| `src/pages/SongsPage.tsx` | 歌曲列表 + 分页 + 检索(`q` / `status` / `artist`) |
|
||||
| `src/components/SongForm*` | 新建/编辑表单,含来源五元组 |
|
||||
| `src/api/client.ts` | fetch 封装;非 2xx 抛 `ApiError`,兼容 Nest 的 `message: string[]` |
|
||||
@@ -32,8 +32,8 @@ web-server/admin/package.json
|
||||
## 页面能力
|
||||
|
||||
- 分页表格 + 关键词/状态/歌手过滤
|
||||
- 新建与编辑:曲名、歌手、专辑、语言、时长(秒输入 → 毫秒提交)、BPM、
|
||||
难度 1–5、标签(逗号分隔)、状态、**来源五元组**
|
||||
- 新建与编辑:曲名、歌手、专辑、语言、时长(秒输入 -> 毫秒提交)、BPM、
|
||||
难度 1-5、标签(逗号分隔)、状态、**来源五元组**
|
||||
- 音频上传(`POST /api/songs/:id/audio`,字段名 `file`)与 `<audio controls>` 试听
|
||||
- 删除需二次确认(软删除)
|
||||
- 客户端校验:曲名/歌手与来源五项必填,`sourceUrl` 必须以 `http` 开头
|
||||
|
||||
Reference in New Issue
Block a user