{"id":25830694,"url":"https://github.com/sambit-mondal/stockx","last_synced_at":"2026-06-12T15:31:30.354Z","repository":{"id":278520470,"uuid":"935206397","full_name":"Sambit-Mondal/StockX","owner":"Sambit-Mondal","description":"StockX is a full-stack application designed to help store owners efficiently manage their inventory, track purchases, and analyze stock levels. The system integrates MongoDB, Express, React, and Flask (Python) to provide a seamless experience.","archived":false,"fork":false,"pushed_at":"2025-02-21T12:58:37.000Z","size":322,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-28T22:35:24.094Z","etag":null,"topics":["artificial-intelligence","data-analysis","inventory-management-system","machine-learning","mern-stack"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sambit-Mondal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2025-02-19T04:29:43.000Z","updated_at":"2025-02-21T12:58:41.000Z","dependencies_parsed_at":"2025-02-20T22:24:33.739Z","dependency_job_id":"cae7e25a-0e06-4ad4-a620-ff0a0bbf9675","html_url":"https://github.com/Sambit-Mondal/StockX","commit_stats":null,"previous_names":["sambit-mondal/cn-hackathon","sambit-mondal/stockx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Sambit-Mondal/StockX","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sambit-Mondal%2FStockX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sambit-Mondal%2FStockX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sambit-Mondal%2FStockX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sambit-Mondal%2FStockX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sambit-Mondal","download_url":"https://codeload.github.com/Sambit-Mondal/StockX/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sambit-Mondal%2FStockX/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34251774,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["artificial-intelligence","data-analysis","inventory-management-system","machine-learning","mern-stack"],"created_at":"2025-02-28T19:30:44.867Z","updated_at":"2026-06-12T15:31:30.337Z","avatar_url":"https://github.com/Sambit-Mondal.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# StockX\n\n\n## 🚀 About the Project\n\n**StockX** is a full-stack application designed to help store owners efficiently manage their inventory, track purchases, and analyze stock levels. The system integrates **MongoDB, Express, React, and Flask (Python)** to provide a seamless experience.\n\n## 🏗️ Features\n\n### ✅ **Inventory Management**\n- Add, update, and remove inventory items\n- Generate **unique 11-digit item codes** with **QR codes** for easy identification\n- Track real-time stock levels per item\n- **Low stock \u0026 excess stock alerts** via email notifications\n\n### 🛒 **Purchase Recording System**\n- Record purchases dynamically with buyer details\n- Fetch **item names from the resources database** using item codes\n- Automatically deduct **purchased quantities from inventory**\n- Generate unique **Purchase IDs** and **QR codes** for each transaction\n- Filter purchases by `storeEmail`\n\n### 📊 **Analytics \u0026 Dashboard**\n- Visual representation of stock trends \u0026 stock analysis\n- Display purchase history filtered by `storeEmail`\n- View **low stock warnings** and **excess stock alerts**\n\n### 🔑 **Authentication \u0026 Security**\n- Unique **store authentication system** with **QR code signup**\n- Secure login \u0026 access control using store-based filtering\n\n## 🏗️ Tech Stack\n\n### **Frontend:**\n- **Vite.js** (Dynamic UI)\n- **Tailwind CSS** (UI styling)\n- **Axios** (API calls)\n\n### **Backend:**\n- **Flask** (Python-based backend for processing)\n- **MongoDB Atlas** (Cloud database for inventory \u0026 purchases)\n- **Express.js** (Handling API routes efficiently)\n\n### **Libraries \u0026 Dependencies:**\n- `mongoose` (MongoDB ODM for schema modeling)\n- `pandas` (Data processing for analytics)\n- `qrcode` (QR Code generation)\n- `nodemailer` (Email alerts for inventory)\n\n## 📜 Installation \u0026 Setup\n\n### **1️⃣ Clone the Repository**\n```sh\n git clone https://github.com/Sambit-Mondal/StockX.git\n```\n\n### **2️⃣ Install Backend and ML Dependencies**\n```sh\n cd server\n npm install\n cd ml-models\n pip install -r requirements.txt\n```\n\n### **3️⃣ Install Frontend and Root Dependencies**\n```sh\n cd client\n npm install\n cd ../\n npm install\n```\n\n### **4️⃣ Set Up Environment Variables**\nCreate a `.env` file in both backend and frontend directories:\n\n#### **Server (.env)**\n```\nMONGODB_URI = \nPORT = \nJWT_SECRET = \nCLIENT_URL = \nEMAIL_USER = \nEMAIL_PASS = \nCLOUDINARY_API_SECRET =  \nCLOUDINARY_API_KEY = \nCLOUDINARY_CLOUD_PRESET = \nCLOUDINARY_CLOUD_NAME = \n```\n\n#### **Client (.env)**\n```\nVITE_PUBLIC_BACKEND_URL = \nVITE_CLOUDINARY_API = \nVITE_CLOUDINARY_API_SECRET =  \nVITE_CLOUDINARY_API_KEY = \n```\n\n#### **ML-models (.env)**\n```\nMONGODB_URI = \nDB_NAME = \nCOLLECTION_NAME = \nGROQ_API_KEY = \nEMAIL_USER = \nEMAIL_PASS = \n```\n\n### **5️⃣ Run the Project**\n#### Start ML Model\n```sh\ncd ml-models\npython server.py\n```\n#### Start Complete Project (At root)\n```sh\nnpm run start\n```\n\n## 📌 API Endpoints\n| Endpoint | Method | Description |\n|----------|--------|-------------|\n| `/api/resources/all` | `GET` | Fetch inventory for a specific storeEmail |\n| `/api/resources/add` | `POST` | Add a new inventory item |\n| `/api/purchase/add` | `POST` | Record a new purchase |\n| `/api/purchase/all` | `GET` | Fetch all purchases (filtered by storeEmail) |\n\n## 🛠️ Contributing\nWe welcome contributions! Follow these steps:\n1. **Fork the repo**\n2. **Create a branch:** `git checkout -b feature-branch`\n3. **Commit changes:** `git commit -m \"Added feature\"`\n4. **Push branch:** `git push origin feature-branch`\n5. **Open a Pull Request**\n\n## 📞 Contact \u0026 Support\nFor queries, reach out via:\n- 📧 Email: `devsambit2005@gmail.com`/`adarshrout321@gmail.com`\n\n## 🏆 Credits\nDeveloped with ❤️ by [Sambit Mondal](https://github.com/Sambit-Mondal) and [Adarsh Rout](https://github.com/AdarshRout).\n\n## 📝 License\nThis project is licensed under the **MIT License**.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsambit-mondal%2Fstockx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsambit-mondal%2Fstockx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsambit-mondal%2Fstockx/lists"}