xiaoyu/topfans
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: 修复规范文档引用，使用文档标题替代文件名

Browse Source 
链接文本从文件名改为各规范文档的实际标题：
- 典藏/活动藏品体系 + 星册重构设计
- MiniMax 图生图 API 集成设计方案
- 任务管理系统设计文档
- 经济系统设计文档

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
zheng020 2026-04-16 17:51:25 +08:00
parent 1f8d1ba3cf
commit 8b89e34b18
2 changed files with 22 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
docs/superpowers/specs/2026-04-16-system-architecture-design.md
View File

@ -133,11 +133,11 @@ activity-admin ──直连──▶ PostgreSQL (管理任务定义/统计)
| Gateway | :8080 | Go | API 统一入口、认证、路由、协议转换 | 本文档 | | Gateway | :8080 | Go | API 统一入口、认证、路由、协议转换 | 本文档 |
| User Service | :20000 | Go | 用户注册登录、粉丝身份、JWT、水晶/经验/等级管理 | 本文档 | | User Service | :20000 | Go | 用户注册登录、粉丝身份、JWT、水晶/经验/等级管理 | 本文档 |
| Social Service | :20001 | Go | 好友关系、用户搜索、点赞 | 本文档 | | Social Service | :20001 | Go | 好友关系、用户搜索、点赞 | 本文档 |
| Asset Service | :20003 | Go | 藏品铸造、OSS 上传、图生图、铸造奖励 | 2026-04-13-collection-asset-starbook-refactor.md<br>2026-04-07-minimax-image-generation-design.md<br>2026-04-15-economic-system-design.md | | Asset Service | :20003 | Go | 藏品铸造、OSS 上传、图生图、铸造奖励 | 典藏/活动藏品体系 + 星册重构设计<br>MiniMax 图生图 API 集成设计方案<br>经济系统设计文档 |
| Gallery Service | :20004 | Go | 展馆管理、展位管理、藏品展示、收益计算 | 本文档 | | Gallery Service | :20004 | Go | 展馆管理、展位管理、藏品展示、收益计算 | 本文档 |
| Task Service | :20005 | Go | 每日任务、引导任务、展示收益、定时重置 | 2026-04-08-task-management-system-design.md | | Task Service | :20005 | Go | 每日任务、引导任务、展示收益、定时重置 | 任务管理系统设计文档 |
| Activity Service | :20006 | Go | 运营活动（待完善） | 本文档 | | Activity Service | :20006 | Go | 运营活动（待完善） | 本文档 |
| activity-admin | :8090 | Python | 任务定义管理、统计、手动重置 | 2026-04-08-task-management-system-design.md | | activity-admin | :8090 | Python | 任务定义管理、统计、手动重置 | 任务管理系统设计文档 |
### 3.2 服务目录结构 ### 3.2 服务目录结构
@ -208,9 +208,9 @@ backend/
| `user_mint_count` | Asset Service | 用户铸造累计表 | | `user_mint_count` | Asset Service | 用户铸造累计表 |
详细表结构及索引设计见各子系统规范文档： 详细表结构及索引设计见各子系统规范文档：
- **经济系统表结构**：2026-04-15-economic-system-design.md § 三 - **经济系统表结构**：经济系统设计文档 § 三
- **任务系统表结构**：2026-04-08-task-management-system-design.md § 三 - **任务系统表结构**：任务管理系统设计文档 § 三
- **藏品/星册表结构**：2026-04-13-collection-asset-starbook-refactor.md § 二 - **藏品/星册表结构**：典藏/活动藏品体系 + 星册重构设计 § 二
### 4.2 粉丝身份隔离机制 ### 4.2 粉丝身份隔离机制
@ -317,7 +317,7 @@ backend/
- `GET /api/v1/starbook/home` — 星册首页（按 type → category/grade 分组） - `GET /api/v1/starbook/home` — 星册首页（按 type → category/grade 分组）
- `GET /api/v1/starbook/items` — 藏品列表（分页） - `GET /api/v1/starbook/items` — 藏品列表（分页）
**规范文档：** [2026-04-13-collection-asset-starbook-refactor.md](./2026-04-13-collection-asset-starbook-refactor.md) **规范文档：** [典藏/活动藏品体系 + 星册重构设计](./2026-04-13-collection-asset-starbook-refactor.md)
--- ---
@ -335,7 +335,7 @@ backend/
- `POST /api/v1/assets/mints/image/generation` — 创建图生图任务（返回 202） - `POST /api/v1/assets/mints/image/generation` — 创建图生图任务（返回 202）
- `GET /api/v1/assets/mints/image/generation/:job_id` — 查询任务状态（轮询） - `GET /api/v1/assets/mints/image/generation/:job_id` — 查询任务状态（轮询）
**规范文档：** [2026-04-07-minimax-image-generation-design.md](./2026-04-07-minimax-image-generation-design.md) **规范文档：** [MiniMax 图生图 API 集成设计方案](./2026-04-07-minimax-image-generation-design.md)
--- ---
@ -355,7 +355,7 @@ backend/
- 引导任务：`POST /api/tasks/guide/complete`、`GET /api/tasks/onboarding/status`、`POST /api/tasks/onboarding/advance-stage`、`POST /api/tasks/onboarding/claim-reward` - 引导任务：`POST /api/tasks/guide/complete`、`GET /api/tasks/onboarding/status`、`POST /api/tasks/onboarding/advance-stage`、`POST /api/tasks/onboarding/claim-reward`
- 展示收益：`GET /api/tasks/exhibition-revenue`、`POST /api/tasks/exhibition-revenue/claim`、`POST /api/tasks/exhibition-revenue/claim-all` - 展示收益：`GET /api/tasks/exhibition-revenue`、`POST /api/tasks/exhibition-revenue/claim`、`POST /api/tasks/exhibition-revenue/claim-all`
**规范文档：** [2026-04-08-task-management-system-design.md](./2026-04-08-task-management-system-design.md) **规范文档：** [任务管理系统设计文档](./2026-04-08-task-management-system-design.md)
--- ---
@ -374,7 +374,7 @@ backend/
- `UpdateCrystalBalance` — 水晶增减（含流水写入） - `UpdateCrystalBalance` — 水晶增减（含流水写入）
- `AddExperience` — 经验增减（含等级计算，返回 newLevel + levelDelta） - `AddExperience` — 经验增减（含等级计算，返回 newLevel + levelDelta）
**规范文档：** [2026-04-15-economic-system-design.md](./2026-04-15-economic-system-design.md) **规范文档：** [经济系统设计文档](./2026-04-15-economic-system-design.md)
--- ---
@ -571,10 +571,10 @@ frontend/
| 文档 | 说明 | | 文档 | 说明 |
|------|------| |------|------|
| [2026-04-07-minimax-image-generation-design.md](./2026-04-07-minimax-image-generation-design.md) | MiniMax 图生图 API 集成设计 | | [MiniMax 图生图 API 集成设计方案](./2026-04-07-minimax-image-generation-design.md) | MiniMax 图生图 API 集成设计 |
| [2026-04-08-task-management-system-design.md](./2026-04-08-task-management-system-design.md) | 任务管理系统设计 | | [任务管理系统设计文档](./2026-04-08-task-management-system-design.md) | 任务管理系统设计 |
| [2026-04-13-collection-asset-starbook-refactor.md](./2026-04-13-collection-asset-starbook-refactor.md) | 典藏/活动藏品体系 + 星册重构设计 | | [典藏/活动藏品体系 + 星册重构设计](./2026-04-13-collection-asset-starbook-refactor.md) | 典藏/活动藏品体系 + 星册重构设计 |
| [2026-04-15-economic-system-design.md](./2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） | | [经济系统设计文档](./2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） |
| 本文档 | 平台级系统架构总览 | | 本文档 | 平台级系统架构总览 |
--- ---

16
系统框架.md
View File

@ -244,13 +244,13 @@ activity-admin ──直连──▶ PostgreSQL
- **OSS URL 直回**：后端直接返回 OSS 公共 URL，前端直接访问 - **OSS URL 直回**：后端直接返回 OSS 公共 URL，前端直接访问
- **星册首页**：一次请求返回全量数据，每组最多 6 条 - **星册首页**：一次请求返回全量数据，每组最多 6 条
规范文档：[2026-04-13-collection-asset-starbook-refactor.md](./docs/superpowers/specs/2026-04-13-collection-asset-starbook-refactor.md) 规范文档：[典藏/活动藏品体系 + 星册重构设计](./docs/superpowers/specs/2026-04-13-collection-asset-starbook-refactor.md)
### 6.4 AI 图生图 ### 6.4 AI 图生图
前端传递参数 → 后端异步调用 MiniMax API → 前端 3 秒轮询任务状态 → 返回结果。Job 存储在内存 Map 中。 前端传递参数 → 后端异步调用 MiniMax API → 前端 3 秒轮询任务状态 → 返回结果。Job 存储在内存 Map 中。
规范文档：[2026-04-07-minimax-image-generation-design.md](./docs/superpowers/specs/2026-04-07-minimax-image-generation-design.md) 规范文档：[MiniMax 图生图 API 集成设计方案](./docs/superpowers/specs/2026-04-07-minimax-image-generation-design.md)
### 6.5 任务系统 ### 6.5 任务系统
@ -258,7 +258,7 @@ activity-admin ──直连──▶ PostgreSQL
- **引导任务**：每用户仅可完成一次，阶段切换需检查前置任务 - **引导任务**：每用户仅可完成一次，阶段切换需检查前置任务
- **展示收益**：展品到期后创建收益记录，每日 05:00 自动发放或手动领取 - **展示收益**：展品到期后创建收益记录，每日 05:00 自动发放或手动领取
规范文档：[2026-04-08-task-management-system-design.md](./docs/superpowers/specs/2026-04-08-task-management-system-design.md) 规范文档：[任务管理系统设计文档](./docs/superpowers/specs/2026-04-08-task-management-system-design.md)
### 6.6 经济系统 ### 6.6 经济系统
@ -267,7 +267,7 @@ activity-admin ──直连──▶ PostgreSQL
- **铸造奖励**：基础返还 + 阶梯额外奖励，按 star_id 独立累计 - **铸造奖励**：基础返还 + 阶梯额外奖励，按 star_id 独立累计
- **并发控制**：`SELECT FOR UPDATE` 悲观锁 - **并发控制**：`SELECT FOR UPDATE` 悲观锁
规范文档：[2026-04-15-economic-system-design.md](./docs/superpowers/specs/2026-04-15-economic-system-design.md) 规范文档：[经济系统设计文档](./docs/superpowers/specs/2026-04-15-economic-system-design.md)
### 6.7 展馆系统 ### 6.7 展馆系统
@ -427,7 +427,7 @@ frontend/
| 文档 | 说明 | | 文档 | 说明 |
|------|------| |------|------|
| [2026-04-16-system-architecture-design.md](./docs/superpowers/specs/2026-04-16-system-architecture-design.md) | 平台级系统架构规范（总览） | | [2026-04-16-system-architecture-design.md](./docs/superpowers/specs/2026-04-16-system-architecture-design.md) | 平台级系统架构规范（总览） |
| [2026-04-07-minimax-image-generation-design.md](./docs/superpowers/specs/2026-04-07-minimax-image-generation-design.md) | MiniMax 图生图 API 集成设计 | | [MiniMax 图生图 API 集成设计方案](./docs/superpowers/specs/2026-04-07-minimax-image-generation-design.md) | MiniMax 图生图 API 集成设计 |
| [2026-04-08-task-management-system-design.md](./docs/superpowers/specs/2026-04-08-task-management-system-design.md) | 任务管理系统设计 | | [任务管理系统设计文档](./docs/superpowers/specs/2026-04-08-task-management-system-design.md) | 任务管理系统设计 |
| [2026-04-13-collection-asset-starbook-refactor.md](./docs/superpowers/specs/2026-04-13-collection-asset-starbook-refactor.md) | 典藏/活动藏品体系 + 星册重构设计 | | [典藏/活动藏品体系 + 星册重构设计](./docs/superpowers/specs/2026-04-13-collection-asset-starbook-refactor.md) | 典藏/活动藏品体系 + 星册重构设计 |
| [2026-04-15-economic-system-design.md](./docs/superpowers/specs/2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） | | [经济系统设计文档](./docs/superpowers/specs/2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） |