{"id":31265408,"url":"https://github.com/ishanshah018/storezen-retail-system","last_synced_at":"2026-04-11T17:44:41.289Z","repository":{"id":315534550,"uuid":"1014888375","full_name":"ishanshah018/StoreZen-Retail-system","owner":"ishanshah018","description":"A comprehensive smart retail management system featuring inventory tracking, customer analytics, and AI-powered shopping assistance. Built with React, Node.js, and Django with Razorpay payments and Twilio notifications.","archived":false,"fork":false,"pushed_at":"2025-09-19T05:25:05.000Z","size":4808,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-19T07:32:50.948Z","etag":null,"topics":["api","backend","database","django-rest-framework","express-js","frontend","jwt-authentication","mern-stack","middlewares","mongodb","node-js","react-js","web-development"],"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/ishanshah018.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-06T15:51:24.000Z","updated_at":"2025-09-19T05:25:08.000Z","dependencies_parsed_at":"2025-09-19T07:43:28.459Z","dependency_job_id":null,"html_url":"https://github.com/ishanshah018/StoreZen-Retail-system","commit_stats":null,"previous_names":["ishanshah018/storezen-retail-system"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/ishanshah018/StoreZen-Retail-system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ishanshah018%2FStoreZen-Retail-system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ishanshah018%2FStoreZen-Retail-system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ishanshah018%2FStoreZen-Retail-system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ishanshah018%2FStoreZen-Retail-system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ishanshah018","download_url":"https://codeload.github.com/ishanshah018/StoreZen-Retail-system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ishanshah018%2FStoreZen-Retail-system/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276589102,"owners_count":25669035,"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","status":"online","status_checked_at":"2025-09-23T02:00:09.130Z","response_time":73,"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":["api","backend","database","django-rest-framework","express-js","frontend","jwt-authentication","mern-stack","middlewares","mongodb","node-js","react-js","web-development"],"created_at":"2025-09-23T14:23:04.023Z","updated_at":"2025-09-23T14:23:06.719Z","avatar_url":"https://github.com/ishanshah018.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛍️ StoreZen - Smart Retail Management System\n\nA comprehensive retail management system with intelligent features including inventory management, customer analytics, smart shopping assistant, and integrated payment processing.\n\n## 🌟 Features\n\n- **Smart Inventory Management**: Real-time stock tracking and automated alerts\n- **Customer Analytics**: Advanced insights and purchase behavior analysis\n- **Payment Integration**: Secure Razorpay payment processing\n- **Smart Shopping Assistant**: AI-powered product recommendations\n- **Coupon \u0026 Loyalty System**: Smart coins and discount management\n- **WhatsApp Integration**: Automated notifications via Twilio\n- **Multi-platform**: React frontend, Node.js API, Django backend\n\n## 🏗️ Architecture\n\n```\nStoreZen/\n├── client/           # React.js Frontend\n├── server/           # Node.js API Server\n├── django_backend/   # Django Backend (Inventory \u0026 Payments)\n└── README.md\n```\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 16+ and npm\n- Python 3.8+\n- MongoDB Atlas account\n- Razorpay account (for payments)\n- Twilio account (for SMS/WhatsApp)\n\n### 1. Clone the Repository\n\n```bash\ngit clone https://github.com/your-username/StoreZen-Retail-system.git\ncd StoreZen-Retail-system\n```\n\n### 2. Environment Setup\n\n#### Backend (Django)\n```bash\ncd django_backend\ncp .env.example .env\n# Edit .env with your actual API keys\npip install -r requirements.txt\npython manage.py migrate\npython manage.py runserver 8000\n```\n\n#### API Server (Node.js)\n```bash\ncd server\ncp .env.example .env\n# Edit .env with your actual credentials\nnpm install\nnpm start\n```\n\n#### Frontend (React)\n```bash\ncd client\nnpm install\nnpm start\n```\n\n### 3. Configure Environment Variables\n\n#### Django Backend (.env)\n```env\nTWILIO_ACCOUNT_SID=your_twilio_sid\nTWILIO_AUTH_TOKEN=your_twilio_token\nTWILIO_WHATSAPP_FROM=whatsapp:+1415XXXXXXX\nSECRET_KEY=your_django_secret_key\nRAZORPAY_KEY_ID=rzp_test_your_key\nRAZORPAY_KEY_SECRET=your_razorpay_secret\nDEBUG=True\n```\n\n#### Node.js Server (.env)\n```env\nPORT=8080\nMONGO_CONN=mongodb+srv://user:pass@cluster.mongodb.net/db\nJWT_SECRET=your_jwt_secret\nTWILIO_ACCOUNT_SID=your_twilio_sid\nTWILIO_AUTH_TOKEN=your_twilio_token\nTWILIO_PHONE_NUMBER=+1XXXXXXXXXX\n```\n\n## 🔐 Security Features\n\n- ✅ Environment variables for all sensitive data\n- ✅ JWT authentication\n- ✅ Payment signature verification\n- ✅ CORS configuration\n- ✅ Input validation and sanitization\n\n## 🧪 Demo Mode\n\nThe application includes demo/test modes:\n- **Razorpay Test Mode**: Uses test API keys for safe payment testing\n- **Sample Data**: Pre-populated inventory and customer data\n- **Test Cards**: Razorpay provides test card numbers for development\n\n### Test Payment Cards\n- **Success**: 2305 3242 5784 8228\n- **UPI Success**: success@razorpay\n- **UPI Failure**: failure@razorpay\n\n## 📱 API Endpoints\n\n### Authentication\n- `POST /auth/signup` - User registration\n- `POST /auth/login` - User login\n- `POST /manager/auth/login` - Manager login\n\n### Inventory\n- `GET /api/products` - Get all products\n- `POST /api/products` - Add new product\n- `PUT /api/products/:id` - Update product\n\n### Payments\n- `POST /payment/create-order/` - Create Razorpay order\n- `POST /payment/verify/` - Verify payment signature\n\n## 🛠️ Development\n\n### Running Tests\n```bash\n# Backend tests\ncd django_backend \u0026\u0026 python manage.py test\n\n# Frontend tests  \ncd client \u0026\u0026 npm test\n\n# API tests\ncd server \u0026\u0026 npm test\n```\n\n### Code Style\n- Frontend: ESLint + Prettier\n- Backend: PEP 8 (Python)\n- API: ESLint\n\n## 🚀 Deployment\n\n### Production Checklist\n- [ ] Set `DEBUG=False` in Django settings\n- [ ] Use production MongoDB cluster\n- [ ] Configure production Razorpay keys\n- [ ] Set up SSL certificates\n- [ ] Configure CORS for production domains\n- [ ] Set secure environment variables\n\n### Recommended Hosting\n- **Frontend**: Vercel, Netlify\n- **API**: Railway, Heroku\n- **Backend**: Railway, PythonAnywhere\n- **Database**: MongoDB Atlas\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit changes (`git commit -m 'Add AmazingFeature'`)\n4. Push to branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- React.js team for the amazing frontend framework\n- Django team for the robust backend framework\n- Razorpay for payment gateway integration\n- Twilio for communication services\n\n## 📞 Support\n\nFor support, email ishanrshah087@gmail.com or create an issue in this repository.\n\n---\n\n**⚡ Built with passion for modern retail solutions**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fishanshah018%2Fstorezen-retail-system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fishanshah018%2Fstorezen-retail-system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fishanshah018%2Fstorezen-retail-system/lists"}