Real-Time Geolocation Updates for Artisans

[ohamamarachi474-del]

Layer: Backend API / Redis
Effort: Medium (3–5h)

Artisan locations are currently static. To provide a true "Uber-like" proximity matching experience, we need a high-frequency ingestion endpoint that allows artisan mobile devices to update their coordinates in real-time.

Because this endpoint will be hit frequently (e.g., every 10–30 seconds while the artisan app is open), it must strictly avoid heavy PostgreSQL writes and instead rely entirely on our Redis in-memory datastore.

Required Changes

1. Fast Geolocation Endpoint

• Create a PUT /api/v1/artisans/location endpoint in backend/app/api/v1/endpoints/artisan.py.
• Secure the endpoint using Depends(require_artisan) so only authenticated artisans can update their location.
• The request payload should accept simple latitude and longitude floats.

2. Redis Geospatial Indexing

• In backend/app/services/geolocation.py, implement a method to handle the Redis GEOADD command.
• The Redis key should be a spatial index (e.g., artisans:locations) where the member is the artisan_id.
• Crucial: Implement a TTL (Time-To-Live) mechanism. If an artisan closes their app or loses signal, their location should expire from the map after ~15 minutes to prevent clients from booking "ghost" artisans who are no longer online.

---

Acceptance Criteria

• PUT /artisans/location successfully accepts coordinate payloads and strictly requires artisan authentication.
• Submitting a location correctly updates or inserts the artisan into the Redis GEOADD index.
• No synchronous PostgreSQL database writes occur during the location update to ensure maximum throughput.
• Artisan locations automatically expire/drop from the Redis index after 15 minutes of inactivity.
• Unit tests verify that unauthorized users (Clients) cannot update an artisan's location.

[jabir-dev788]

Hey, I’d love to work on this issue if it’s available 🙏
I've reviewed this issue and have a clear approach to fix it. I can deliver a clean, minimal PR within 5

[grantfox-oss]

🦊 GrantFox — @jabir-dev788 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 #299)
2. Your PR will be reviewed by the stemscreatives maintainers

Good luck! Track your progress on GrantFox.

[ohamamarachi474-del]

@jabir-dev788 any update ????

[gloskull]

Hi, I’d love to work on this issue. I have 4 years of experience across backend, frontend, full-stack, and smart contract development. I understand the task clearly and can deliver a clean, efficient, well-tested solution on time, with strong focus on code quality and maintainability. My PR will be submitted in 12hours