[FE-02] Build global Maintenance page — kanban board and calendar of all work orders

[yusuftomilola]

Overview

Maintenance today only exists as a tab inside a single asset's detail page. Teams need the global view: everything scheduled/in-progress/overdue across all assets — the core screen of CMMS tools like UpKeep and Fiix.

What to Build

A /maintenance page under frontend/app/(dashboard)/:

• Board view: columns for SCHEDULED / IN_PROGRESS / COMPLETED / CANCELLED (dnd-kit is already installed for drag-to-change-status)
• Calendar view toggle: month grid plotting records by scheduledDate
• Each card: asset name + link, maintenance type badge, scheduled date, cost
• Filters: type (PREVENTIVE/CORRECTIVE/SCHEDULED), department, date range
• "New maintenance" modal (asset picker + the fields from the existing per-asset form)
• Needs a small backend addition: list maintenance across assets (GET /api/maintenance?status=&from=&to=) — coordinate with [BE-11] or file the endpoint as part of this issue's PR

Conventions to Follow

• API calls: add a typed client in frontend/lib/api/ (see frontend/lib/api/assets.ts for the pattern) — never call axios directly from components
• Data fetching: TanStack Query hooks in frontend/lib/query/hooks/ with keys registered in frontend/lib/query/keys.ts
• UI: reuse frontend/components/ui/ (button, input, confirm-dialog, toast) and the badge/modal patterns in frontend/components/assets/
• Route goes under frontend/app/(dashboard)/ and gets a sidebar entry in frontend/components/layout/sidebar.tsx
• Forms: React Hook Form + Zod resolver, matching the existing create-asset modal

References

• Blocked by [BE-11]
• Per-asset maintenance UI already exists in frontend/app/(dashboard)/assets/[id]/page.tsx — reuse its types and form

Acceptance Criteria

• Board and calendar views both render all records with working filters
• Dragging a card between columns updates the record status (with rollback on API error)
• Overdue scheduled items are visually flagged
• Creating a record from this page also appears on the asset's detail tab

[naallahmagaji31-tech]

@naallahmagaji31-tech has applied to work on this issue as part of the Stellar Wave Program's 7th wave.

Hello sir I'll love to work on this issue please 🙏

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

[NnamdiCyber]

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

Hello, I'm interested in resolving this issue.

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

[Diggardson270]

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

Let me work on this brother

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

[drips-wave]

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

🧑‍💻 @Diggardson270: 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]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@Diggardson270's PR #1250 was approved and merged by @yusuftomilola.

🏆 @Diggardson270: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (191 total points). Track your full progress on GrantFox.

👏 Great work, @Diggardson270! Keep contributing to DistinctCodes.

[drips-wave]

This issue has been completed by @Diggardson270 as part of the Stellar Wave Program's 7th Wave 🥳

😎 @Diggardson270: You earned 200 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.