{"id":28666425,"url":"https://github.com/d-evm/rapidmart","last_synced_at":"2026-05-05T14:32:31.938Z","repository":{"id":298154017,"uuid":"998506564","full_name":"d-evm/RapidMart","owner":"d-evm","description":"Mimicing the operational flow of modern quick-commerce","archived":false,"fork":false,"pushed_at":"2025-06-09T17:19:52.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-09T18:19:26.972Z","etag":null,"topics":["java","maven","q-commerce","quick-commerce","spring","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/d-evm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-08T18:50:56.000Z","updated_at":"2025-06-09T17:29:36.000Z","dependencies_parsed_at":"2025-06-09T18:29:32.315Z","dependency_job_id":null,"html_url":"https://github.com/d-evm/RapidMart","commit_stats":null,"previous_names":["d-evm/rapidmart"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/d-evm/RapidMart","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d-evm%2FRapidMart","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d-evm%2FRapidMart/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d-evm%2FRapidMart/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d-evm%2FRapidMart/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/d-evm","download_url":"https://codeload.github.com/d-evm/RapidMart/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d-evm%2FRapidMart/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259659774,"owners_count":22891683,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","maven","q-commerce","quick-commerce","spring","spring-boot"],"created_at":"2025-06-13T14:16:07.554Z","updated_at":"2026-05-05T14:32:31.933Z","avatar_url":"https://github.com/d-evm.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛒 RapidMart – Quick-Commerce Backend System (Under development)\n\nRapidMart is a Spring Boot-based backend system that mimics the operational flow of modern quick-commerce services like Zepto, Blinkit, and Instamart. The focus is on logistics, zone-based store allocation, and real-time delivery simulation — not just carts and listings.\n\n---\n\n## 🚀 Features\n\n- ✅ JWT-based Signup \u0026 Login\n- ✅ Product listing by user's zone (auto-resolved from pincode)\n- ✅ Store selection based on stock \u0026 proximity\n- ✅ ETA calculation: processing + delivery + buffer\n- ✅ Live order tracking via WebSocket\n- ✅ Realistic delivery simulation (10km/h, buffers)\n- ✅ Inventory deduction on order\n- ✅ Scheduler updates order status every 30s\n\n---\n\n## 📦 Tech Stack\n\n| Layer        | Tech                         |\n|--------------|------------------------------|\n| Backend      | Java, Spring Boot            |\n| Security     | Spring Security, JWT         |\n| Real-time    | WebSockets (STOMP + SockJS)  |\n| Database     | PostgreSQL                   |\n| Testing      | Postman, HTML Client         |\n\n---\n\n## 🔐 Authentication\n\nUse the `/auth/signup` and `/auth/login` endpoints to get a JWT token.\n\nThen pass it in the `Authorization` header like:\n```\nAuthorization: Bearer \u003cyour-jwt-token\u003e\n```\n\n---\n\n## 📡 WebSocket Live Order Tracking\n\nYou can test **live order tracking** in real time using this demo page:\n\n👉 [🖥 Live WebSocket Demo](https://d-evm.github.io/rapidmart-html-client/)\n\n### How to Use:\n\n1. Place an order via `/orders` (see Postman below)\n2. Open the demo link\n3. Enter:\n   - `Order ID` (from response)\n   - `JWT Token` (from login)\n4. You will receive live updates like:\n   ```\n   Status: Out for Delivery | 6 min left\n   ```\n\n---\n\n## 🔁 Order Flow\n\n1. User logs in (JWT token)\n2. User places order (POST `/orders`)\n3. System:\n   - Selects nearest store with full inventory\n   - Deducts stock\n   - Calculates ETA\n4. Background scheduler updates order status every 30s\n5. User receives WebSocket push updates\n\n---\n\n## 🧪 Postman Collection\n\nYou can import this collection to test signup, login, order placement, etc.\n\n📥 [Download RapidMart Postman Collection](./client-test/RapidMart_Postman_Collection.json)\n\n---\n\n## 🗂 Project Structure\n\n```\nsrc/main/java/com/rapidmart/\n├── controllers        # REST Controllers\n├── dtos               # Request/Response DTOs\n├── models             # JPA Entities\n├── repositories       # Spring Data JPA Repositories\n├── schedulers         # WebSocket update scheduler\n├── security           # JWT, Filters, Configs\n├── services           # Business logic\n├── config             # WebSocket \u0026 app configs\n└── RapidMartApplication.java\n```\n\n---\n\n## 🛠 Running the App\n\n```bash\n# Clone backend\ngit clone https://github.com/yourusername/rapidmart-backend.git\ncd rapidmart-backend\n\n# Configure PostgreSQL (update application.properties)\n\n# Run the app\n./mvnw spring-boot:run\n```\n\nApp runs at: `http://localhost:8084`\n\n---\n\n## 🌐 GitHub Pages Demo\n\nThe real-time HTML WebSocket client is deployed live:\n\n👉 https://d-evm.github.io/rapidmart-html-client/\n\nIf you want to run it locally:\n```bash\ncd client-test\nopen rapidmart_order_tracker.html\n```\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd-evm%2Frapidmart","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fd-evm%2Frapidmart","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd-evm%2Frapidmart/lists"}