[BE-27] Implement global search endpoint across assets, users, and documents

[yusuftomilola]

Overview

The frontend command palette (frontend/components/ui/command-palette.tsx) and a planned global search page ([FE-19]) need one endpoint that searches across the platform. A global search page existed before the reset commit.

What to Build

A SearchModule in backend/src/search/:

Method	Path	Description
GET	/api/search?q=&types=&limit=	Cross-entity search

• Searches: assets (name, assetId, serialNumber, manufacturer, model, tags), users (name, email), documents (name) — types filter narrows scope
• Postgres ILIKE for v1 is fine; structure the service so full-text (tsvector) can replace it later
• Grouped response: { assets: [...], users: [...], documents: [...] }, each item with id, display label, and route hint (e.g. /assets/:id)
• Respect RBAC ([BE-15]): staff results limited to what they can view
• Min query length 2; limit per group (default 5, max 20)

References

• Pre-reset version: git log --oneline --all -- 'backend/src/**search**' / commit 0c2b80b
• Blocked by [BE-06], [BE-03], [BE-10]

Acceptance Criteria

• One request returns grouped, ranked matches across all three types
• types=assets narrows correctly; per-group limit respected
• Query under 2 chars returns 400
• Response includes enough data for the command palette to render and navigate

[Leemxiey]

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

Hi, maintainer can i work on this issue?

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

[PEPPERITO23]

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

I'd love to work on this. I understand the requirements and can handle the implementation.

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

[Chenelvis1203]

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

Hello maintainer, id like to work on this issue. thank you

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

[Bilalishaq7]

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

Hi @maintainers! 👋

I would like to apply to work on this issue under the GrantFox OSS Campaign.

Proposed Technical Approach:

• Diagnosis & Strategy: I will locate the core source files responsible for this component and design a modular, production-ready solution adhering to GrantFox quality standards.
• Implementation: Clean, well-typed code written to integrate seamlessly with the existing repository architecture without unnecessary dependencies or dummy fallbacks.
• Testing & Quality Assurance: I will add robust unit/integration test coverage (targeting ≥90% coverage) to verify edge cases, clean compilation (cargo test / vitest), and static analysis (clippy / eslint).

Developer Profile:

• Active Campaign Issue: None (I am currently unassigned and ready to start immediately).
• Stack Expertise: Web3 Software Developer (React, Next.js, TypeScript, Soroban / Stellar Rust Smart Contracts, Avalanche EVM).

Please assign this issue to me so I can begin implementation. Thanks!

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

[barnabasolutayo-lgtm]

@barnabasolutayo-lgtm has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello Maintainer. I would love to resolve this issue. Please assign

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

[Jerry-Tekh]

@Jerry-Tekh has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi repo maintainer, permits me please work on this repo. I've issue solved correctly on repo. Ready to start ASAP. Thank

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

[oladev2026-tech]

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

Hi can i work on this?

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

[Nimatstar]

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

Hi can i work on this?

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

[drips-wave]

Congratulations, @Nimatstar! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

🧑‍💻 @Nimatstar: 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 🌊