[BE-18] Locker management: backend

[yusuftomilola]

Overview

Many coworking members store laptops, chargers, and personal belongings in physical lockers at the hub. Administrators currently have no platform tool to track locker assignments — this leads to double-assignments and uncollected contents.

Context

• User entity: backend/src/users/entities/user.entity.ts
• NotificationsModule: backend/src/notifications/ — notify member when a locker is assigned or released

Tasks

• Create Locker entity: id, lockerNumber (string, unique), floor (string, e.g. "Floor 2"), size (SMALL / MEDIUM / LARGE), assignedToUserId (nullable FK), assignedAt (nullable timestamptz), isActive (bool), notes (text, nullable), createdAt, updatedAt
• POST /lockers — create a locker (admin only)
• PATCH /lockers/:id — update locker details or active status (admin only)
• DELETE /lockers/:id — soft-delete locker (admin only; only if unassigned)
• GET /lockers — list all lockers (admin: all; staff: all; member: only their own assigned locker)
• GET /lockers/mine — returns the locker assigned to the current member (or null)
• POST /lockers/:id/assign — assign locker to a member (admin only); notify member via NotificationsModule
• POST /lockers/:id/unassign — release the locker assignment (admin only); notify former assignee

Files to Modify / Create

• New: backend/src/lockers/ (module, entity, controller, service, providers)
• backend/src/app.module.ts

[Dayz-tech-co]

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

Hi maintainer, For thy lord's sake can you get this assign to me 🤲🏿?

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

[demilade18-git]

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

i would like to work on this, can it be assigned to me?

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

[grantfox-oss]

🦊 GrantFox — @demilade18-git has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

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

Good luck! Track your progress on GrantFox.

[drips-wave]

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

🧑‍💻 @demilade18-git: 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 campaign!

@demilade18-git's PR #1254 was approved and merged by @yusuftomilola.

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

👏 Great work, @demilade18-git! Keep contributing to DistinctCodes.

[drips-wave]

This issue has been completed by @demilade18-git as part of the Stellar Wave Program's 6th Wave 🥳

😎 @demilade18-git: 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.