H0-09 知识库订阅(KnowledgeBaseSubscription) #54

Open
opened 2026-05-29 19:19:01 +08:00 by wangdl · 1 comment
Owner

目标

实现知识库订阅/取消订阅,支撑 iOS 端「已订阅知识库」分类。

背景说明

iOS 文档要求三种知识库分类:我的/已订阅/官方。当前无订阅模型。

模块职责

1. Prisma Schema 新增

model KnowledgeBaseSubscription {
  id              String   @id @default(cuid())
  userId          String
  knowledgeBaseId String
  createdAt       DateTime @default(now())

  user          User          @relation(fields: [userId], references: [id])
  knowledgeBase KnowledgeBase @relation(fields: [knowledgeBaseId], references: [id])

  @@unique([userId, knowledgeBaseId])
}

2. API

方法 路径 说明
POST /knowledge-bases/:id/subscribe 订阅
DELETE /knowledge-bases/:id/subscribe 取消订阅
GET /knowledge-bases/subscribed 已订阅列表
GET /knowledge-bases/discover 发现公开库

3. 规则

  • 公开库才可被订阅
  • 已订阅库只读
  • 取消订阅保留学习记录

禁止事项

  • 第一版不做付费订阅、创作者主页
## 目标 实现知识库订阅/取消订阅,支撑 iOS 端「已订阅知识库」分类。 ## 背景说明 iOS 文档要求三种知识库分类:我的/已订阅/官方。当前无订阅模型。 ## 模块职责 ### 1. Prisma Schema 新增 ```prisma model KnowledgeBaseSubscription { id String @id @default(cuid()) userId String knowledgeBaseId String createdAt DateTime @default(now()) user User @relation(fields: [userId], references: [id]) knowledgeBase KnowledgeBase @relation(fields: [knowledgeBaseId], references: [id]) @@unique([userId, knowledgeBaseId]) } ``` ### 2. API | 方法 | 路径 | 说明 | |------|------|------| | POST | /knowledge-bases/:id/subscribe | 订阅 | | DELETE | /knowledge-bases/:id/subscribe | 取消订阅 | | GET | /knowledge-bases/subscribed | 已订阅列表 | | GET | /knowledge-bases/discover | 发现公开库 | ### 3. 规则 - 公开库才可被订阅 - 已订阅库只读 - 取消订阅保留学习记录 ## 禁止事项 - 第一版不做付费订阅、创作者主页
wangdl added this to the H0:iOS 对接阻断修复(P0) milestone 2026-05-29 19:19:01 +08:00
Author
Owner

H0-09 已在 H0-08 中一并完成

KnowledgeBaseSubscription 表 + 订阅/取消订阅/已订阅列表 API 全量随 H0-08 交付。

API

方法 路径 说明
POST /knowledge-bases/:id/subscribe 订阅公开库
DELETE /knowledge-bases/:id/subscribe 取消订阅
GET /knowledge-bases/subscribed 已订阅列表(分页)
GET /knowledge-bases/discover 发现公开库(搜索+分页)

业务规则

  • 只能订阅公开库
  • 不能订阅自己的库
  • 取消订阅保留学习记录
## ✅ H0-09 已在 H0-08 中一并完成 `KnowledgeBaseSubscription` 表 + 订阅/取消订阅/已订阅列表 API 全量随 H0-08 交付。 ### API | 方法 | 路径 | 说明 | |------|------|------| | POST | /knowledge-bases/:id/subscribe | 订阅公开库 | | DELETE | /knowledge-bases/:id/subscribe | 取消订阅 | | GET | /knowledge-bases/subscribed | 已订阅列表(分页) | | GET | /knowledge-bases/discover | 发现公开库(搜索+分页) | ### 业务规则 - 只能订阅公开库 - 不能订阅自己的库 - 取消订阅保留学习记录
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: wangdl/api-server#54
No description provided.