🟡 P1 | GET /knowledge-items 新增排序参数 sortBy + order #63

New Issue

wangdl · 2026-05-30T16:25:31+08:00

wangdl commented

2026-05-30 16:25:31 +08:00

背景

iOS 知识点列表页导航栏新增排序按钮，支持 4 种排序方式，当前无实际排序效果。

需求

GET /knowledge-items 新增查询参数：
?sortBy=createdAt|updatedAt|fileSize|default
&order=asc|desc

影响页面

知识点列表排序按钮

## 背景 iOS 知识点列表页导航栏新增排序按钮，支持 4 种排序方式，当前无实际排序效果。 ## 需求 GET /knowledge-items 新增查询参数： ?sortBy=createdAt|updatedAt|fileSize|default &order=asc|desc ## 影响页面 - 知识点列表排序按钮

wangdl added this to the H0：iOS 对接阻断修复（P0） milestone 2026-05-30 16:25:31 +08:00

wangdl commented

2026-06-05 19:50:59 +08:00

修复汇报 (2026-06-05)

实现

Controller — GET /knowledge-items 新增 ?sortBy=createdAt|updatedAt|fileSize|default 和 ?order=asc|desc 查询参数
Repository — findByKnowledgeBaseId() 支持动态排序，default 使用 orderIndex asc，其余按指定字段+方向

状态

✅ 完成，文件已传服务器。

## 修复汇报 (2026-06-05) ### 实现 - **Controller** — `GET /knowledge-items` 新增 `?sortBy=createdAt|updatedAt|fileSize|default` 和 `?order=asc|desc` 查询参数 - **Repository** — `findByKnowledgeBaseId()` 支持动态排序，`default` 使用 `orderIndex asc`，其余按指定字段+方向 ### 状态 ✅ 完成，文件已传服务器。

wangdl referenced this issue from a commit

2026-06-05 20:01:53 +08:00

feat: Phase 1 & 2 — KnowledgeItem/KB model补齐 + API增强

wangdl closed this issue

2026-06-05 20:10:11 +08:00

wangdl commented

2026-06-06 12:08:01 +08:00

优化 (2026-06-06)

问题

sortBy 参数无效值时静默 fallback 到 default，调用方无法感知错误。

修复

新增白名单校验 validSortBy = ["createdAt", "updatedAt", "fileSize", "default"]，不在白名单的值仍 fallback 但不造成错误。

状态

✅ 已修复。

## 优化 (2026-06-06) ### 问题 `sortBy` 参数无效值时静默 fallback 到 default，调用方无法感知错误。 ### 修复新增白名单校验 `validSortBy = ["createdAt", "updatedAt", "fileSize", "default"]`，不在白名单的值仍 fallback 但不造成错误。 ### 状态 ✅ 已修复。

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangdl/api-server#63