Backend: Create QR Code generation endpoint for delivery handoff verification

[Tybravo]

📁 Implementation Directory

backend/src/controllers/deliveryController.ts

🎯 Goal

Generate QR codes for secure physical handoffs.

📋 Requirements

• Create GET /api/v1/deliveries/:id/qrcode.\n- Generate QR encoding delivery ID and a secure verification token.\n- Return image or base64 string.

🔧 Technical Scope

• Node.js / Express
• TypeScript
• MongoDB / Mongoose
• Stellar Soroban RPC

🌿 Branch

git checkout -b feat/generate-handoff-qrcode

✅ Acceptance Criteria

• Using an AI Agent to submit a PR is DISALLOWED.
• Strict Layered Architecture (Non-Negotiable): Implement using the Controller -> Service -> Model pattern.
• Data Source: Response data must be retrieved from the database. No Inline Mock Objects or Hardcoded Values usage for integration.
• Environment: Contributors must use the requested .env credentials to enable implementation with real-life data.
• API Versioning: API Must Be Versioned (e.g., /api/v1/...).
• Production Ready: Code must look production-ready (robust error handling, strong typings).
• Proof of Work: Upload a screenshot of work done (i.e., API Response Success via Postman/Browser, or all unit tests passed successfully).
• PR Content: Must include Closes #[issue_id] with a work done summary.

📌 PR Requirements

• ⚠️ Assignment required before starting — comment on this issue to request assignment.
• PR must comply fully with the CONTRIBUTING.md.
• AI Agent submissions are DISALLOWED and will be closed without review.
• No Inline Mock Objects or Hardcoded Values usage for integration.

[RemmyAcee]

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

I've checked the requirements and am confident I can resolve this efficiently. Happy to take it on.

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

[codefather2026]

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

Hi maintainer, i will like to solve this issue

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

[Jerry-Tekh]

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

hi repo maintainer,

please let me take this issue.

I'll add GET /api/v1/deliveries/:id/qrcode in deliveryController.ts to generate a QR with the delivery ID + secure token, returning image/base64 using real DB data, with full typing and error handling.

i am ready, or pls assign me

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

[JoshuaEdd]

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

I would like to work on this issue.

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

[drips-wave]

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

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

[olufunsoolutayo]

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

Hello Maintainer. I would love to work on this issue. Please assign to me. Thank you.

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

[OZILSOLAR]

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

OZILSOLAR
Hi team!!!!
I came across this issue and would love to work on it. I have experience with similar tasks and I'm confident I can investigate, implement a clean solution, and thoroughly test it before submitting a PR. If the issue is still open, I would appreciate it if you could assign it to me. Thank you!!!!!!

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

[darius-daniel]

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

I'd like to work on this issue.

I'll implement the GET /api/v1/deliveries/:id/qrcode endpoint using the project's layered architecture (Controller → Service → Model). The endpoint will retrieve the delivery from the database, generate a QR code containing the delivery ID and a secure verification token, and return it as an image or base64 response with robust error handling and strong TypeScript typings. I'll ensure the implementation uses real data, includes appropriate tests where applicable, and provide the required proof of work and PR summary referencing Closes #20.

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