[FE-16] Build /documents list page — searchable, filterable, paginated document table

[mftee]

Overview

Users need a full-page view of all their documents with search, filtering, and pagination. The dashboard only shows a preview — this page is the complete document management interface.

Background

File to create: frontend/app/(protected)/documents/page.tsx

Features:

• Search bar (debounced, calls GET /api/documents/search?q=)
• Status filter dropdown (ALL / PENDING / ANALYZING / VERIFIED / FLAGGED / REJECTED)
• Risk score range slider (0–100)
• Sort options: Newest first, Oldest first, Highest risk, Lowest risk
• Paginated table with columns: Name, Status (badge), Risk Score, Uploaded, Actions

Actions per row:

• View detail (link to /documents/:id)
• Verify (button, only shown if status is PENDING)
• Archive (button)
• Download report (link to /documents/:id/report)

Bulk actions:

• Select multiple documents → bulk archive, bulk download as ZIP (if implemented)

Acceptance Criteria

• Search is debounced by 300ms to avoid excessive API calls
• Filter, sort, and page state are reflected in the URL query params (shareable/bookmarkable)
• Pagination controls (first, prev, next, last) with current page indicator
• Table shows empty state when no documents match the filters
• Status badges use the colour-coded Badge component from FE-05

[TheShnider]

@TheShnider has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi. I have reviewed this issue and would like to work on it.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @TheShnider to this issue.

[Oluwasuyi-Oluwatimilehin-Daniel]

@Oluwasuyi-Timilehin has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello maintainer, please assign me to this task. I would get started immediately

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Oluwasuyi-Timilehin to this issue.

[divysam]

@divysam has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello
I would love to work on this issue please

ℹ️ Repo Maintainers: To accept this application, review their application or assign @divysam to this issue.

[mijinummi]

@mijinummi has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hello maintainers I'm a full stack developer experience in building scalable systems I can handle this perfectly

ℹ️ Repo Maintainers: To accept this application, review their application or assign @mijinummi to this issue.

[drips-wave]

Congratulations, @mijinummi! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @mijinummi: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[grantfox-oss]

🦊 GrantFox — @mijinummi has been assigned to this issue!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #828)
2. Your PR will be reviewed by the CodeGirlsInc maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox!

@mijinummi's PR #881 was approved and merged by @mftee.

🏆 @mijinummi: You earned 40 FoxPoints for this contribution! Your current tier: Builder (1,511 total points). Track your full progress on GrantFox.

👏 Great work, @mijinummi! Keep contributing to CodeGirlsInc.