zijunchiang
9f7b926a9a
- README.md / README.txt 新增初次部署章节：前置条件、获取代码、首次运行、 配置服务端地址（API 3000 / 管理端 3001 分离）、与 Android 的 WebSocket 联通、 打包导出、自检清单、常见问题 - 三库同源契约：':=' 写法修回、去掉真实 MariaDB 版本串 - 全文去除易被 Gitea 判为「模棱两可 Unicode」的字符（- - ... -> 取代 — – … § →） - 真实内网地址与库名改占位符
41 lines
1.1 KiB
Markdown
41 lines
1.1 KiB
Markdown
# T-WIN-009 来源信息展示
|
||
|
||
- **状态**：done
|
||
- **依赖**：T-WIN-008
|
||
|
||
## 目标
|
||
|
||
在客户端展示模型/动作的**来源五元组**（来源类型、名称、链接、许可、作者）。
|
||
|
||
## load
|
||
|
||
```
|
||
DSH.md
|
||
contracts/data-models.md # 锚点：1 来源五元组
|
||
src/ui/source_panel.gd
|
||
src/net/catalog_types.gd
|
||
```
|
||
|
||
## 交付物
|
||
|
||
`src/ui/source_panel.gd`（可复用组件）+ `CatalogTypes.SourceInfo`（含 `type_label()` 与 `is_complete()`）。
|
||
|
||
## 展示规则
|
||
|
||
- 标题 + 来源类型中文标签（原创 / 已获授权 / Creative Commons / 公共领域 / 用户上传 / 其他）
|
||
- 资产名 ｜ 来源名称
|
||
- 作者
|
||
- 许可 + **可点击外链**跳转到 `sourceUrl`
|
||
- **五元组不齐备时显式告警**（"⚠ 来源信息不完整，请联系管理员补全后再使用"），不静默展示
|
||
|
||
## 使用位置
|
||
|
||
- 主菜单：选中动作时显示
|
||
- 游戏页：当前跟练动作
|
||
- 结算页：本轮动作
|
||
|
||
## 验收
|
||
|
||
`tests/test_api_integration.gd` 对真实服务端断言曲目与模型的来源五元组齐备
|
||
（`song.source.is_complete()`），保证展示组件拿到的数据完整。
|