Skip to content

ドキュメント一覧APIのページネーション追加とファイルサイズ上限の設定外部化 #23

@mohadayo

Description

@mohadayo

問題点

1. ドキュメント一覧APIにページネーションがない

  • GET /api/documents が全件を一括返却しており、ドキュメント数の増加に伴いレスポンスサイズとメモリ使用量が増大する
  • フロントエンドでの段階的読み込みに対応できない

2. MAX_FILE_SIZEがハードコードされている

  • routers/documents.pyMAX_FILE_SIZE = 10 * 1024 * 1024 が定数としてハードコードされている
  • 環境に応じたファイルサイズ上限の変更ができない

改善提案

  • list_documents エンドポイントに offset / limit クエリパラメータを追加
  • PaginatedDocumentResponse スキーマを新設し、items, total, offset, limit を返却
  • limit の上限を100に制限
  • MAX_FILE_SIZEconfig.pySettings に移動し、環境変数 MAX_FILE_SIZE で変更可能に
  • ページネーションのユニットテストを追加

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions