diff --git a/docs/superpowers/specs/2026-04-16-system-architecture-design.md b/docs/superpowers/specs/2026-04-16-system-architecture-design.md index c6c974a..2b3a762 100644 --- a/docs/superpowers/specs/2026-04-16-system-architecture-design.md +++ b/docs/superpowers/specs/2026-04-16-system-architecture-design.md @@ -133,11 +133,11 @@ activity-admin ──直连──▶ PostgreSQL (管理任务定义/统计) | Gateway | :8080 | Go | API 统一入口、认证、路由、协议转换 | 本文档 | | User Service | :20000 | Go | 用户注册登录、粉丝身份、JWT、水晶/经验/等级管理 | 本文档 | | Social Service | :20001 | Go | 好友关系、用户搜索、点赞 | 本文档 | -| Asset Service | :20003 | Go | 藏品铸造、OSS 上传、图生图、铸造奖励 | 2026-04-13-collection-asset-starbook-refactor.md
2026-04-07-minimax-image-generation-design.md
2026-04-15-economic-system-design.md | +| Asset Service | :20003 | Go | 藏品铸造、OSS 上传、图生图、铸造奖励 | 典藏/活动藏品体系 + 星册重构设计
MiniMax 图生图 API 集成设计方案
经济系统设计文档 | | 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-admin | :8090 | Python | 任务定义管理、统计、手动重置 | 2026-04-08-task-management-system-design.md | +| activity-admin | :8090 | Python | 任务定义管理、统计、手动重置 | 任务管理系统设计文档 | ### 3.2 服务目录结构 @@ -208,9 +208,9 @@ backend/ | `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 粉丝身份隔离机制 @@ -317,7 +317,7 @@ backend/ - `GET /api/v1/starbook/home` — 星册首页（按 type → category/grade 分组） - `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） - `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` - 展示收益：`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` — 水晶增减（含流水写入） - `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 集成设计 | -| [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-15-economic-system-design.md](./2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） | +| [MiniMax 图生图 API 集成设计方案](./2026-04-07-minimax-image-generation-design.md) | MiniMax 图生图 API 集成设计 | +| [任务管理系统设计文档](./2026-04-08-task-management-system-design.md) | 任务管理系统设计 | +| [典藏/活动藏品体系 + 星册重构设计](./2026-04-13-collection-asset-starbook-refactor.md) | 典藏/活动藏品体系 + 星册重构设计 | +| [经济系统设计文档](./2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） | | 本文档 | 平台级系统架构总览 | --- diff --git a/系统框架.md b/系统框架.md index 27bba04..4bfd14c 100644 --- a/系统框架.md +++ b/系统框架.md @@ -244,13 +244,13 @@ activity-admin ──直连──▶ PostgreSQL - **OSS URL 直回**：后端直接返回 OSS 公共 URL，前端直接访问 - **星册首页**：一次请求返回全量数据，每组最多 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 图生图 前端传递参数 → 后端异步调用 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 任务系统 @@ -258,7 +258,7 @@ activity-admin ──直连──▶ PostgreSQL - **引导任务**：每用户仅可完成一次，阶段切换需检查前置任务 - **展示收益**：展品到期后创建收益记录，每日 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 经济系统 @@ -267,7 +267,7 @@ activity-admin ──直连──▶ PostgreSQL - **铸造奖励**：基础返还 + 阶梯额外奖励，按 star_id 独立累计 - **并发控制**：`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 展馆系统 @@ -427,7 +427,7 @@ frontend/ | 文档 | 说明 | |------|------| | [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 集成设计 | -| [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) | 典藏/活动藏品体系 + 星册重构设计 | -| [2026-04-15-economic-system-design.md](./docs/superpowers/specs/2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） | +| [MiniMax 图生图 API 集成设计方案](./docs/superpowers/specs/2026-04-07-minimax-image-generation-design.md) | MiniMax 图生图 API 集成设计 | +| [任务管理系统设计文档](./docs/superpowers/specs/2026-04-08-task-management-system-design.md) | 任务管理系统设计 | +| [典藏/活动藏品体系 + 星册重构设计](./docs/superpowers/specs/2026-04-13-collection-asset-starbook-refactor.md) | 典藏/活动藏品体系 + 星册重构设计 | +| [经济系统设计文档](./docs/superpowers/specs/2026-04-15-economic-system-design.md) | 经济系统设计（水晶/经验/等级/铸造奖励） |