{"id":25538853,"url":"https://github.com/pi-johns/inventory_management_system","last_synced_at":"2025-06-30T20:34:12.274Z","repository":{"id":278477516,"uuid":"935747413","full_name":"Pi-johns/inventory_management_system","owner":"Pi-johns","description":"The **Shop Management System** is a powerful and efficient solution for managing sales, inventory, and shops. It provides **role-based dashboards** for **Superadmin, Managers, and Sellers**, ensuring seamless shop operations with real-time tracking, financial insights, and notifications.  ","archived":false,"fork":false,"pushed_at":"2025-03-04T20:08:16.000Z","size":34901,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-05-22T23:35:14.967Z","etag":null,"topics":["ajax","authentication","chartjs","django","django-rest-framework","html-css-javascript","javascript","postgresql","python","sqlite","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":"Python","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/Pi-johns.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-20T00:30:01.000Z","updated_at":"2025-03-04T20:08:19.000Z","dependencies_parsed_at":"2025-02-20T01:46:45.778Z","dependency_job_id":null,"html_url":"https://github.com/Pi-johns/inventory_management_system","commit_stats":null,"previous_names":["pi-johns/inventory_management_system"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Pi-johns/inventory_management_system","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pi-johns%2Finventory_management_system","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pi-johns%2Finventory_management_system/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pi-johns%2Finventory_management_system/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pi-johns%2Finventory_management_system/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pi-johns","download_url":"https://codeload.github.com/Pi-johns/inventory_management_system/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pi-johns%2Finventory_management_system/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262846648,"owners_count":23373848,"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":["ajax","authentication","chartjs","django","django-rest-framework","html-css-javascript","javascript","postgresql","python","sqlite","tailwindcss"],"created_at":"2025-02-20T05:24:23.100Z","updated_at":"2025-06-30T20:34:12.218Z","avatar_url":"https://github.com/Pi-johns.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n### 🏪 Shop Management System\n-📌 Overview\nThe Shop Management System is a powerful, role-based inventory and sales tracking platform designed to help businesses manage shops, sales, inventory, and financial reports efficiently. Built with Django (backend) and TailwindCSS + Chart.js (frontend), the system ensures seamless user experience, dynamic analytics, and real-time tracking of sales, real-time notifications and stock movements.\n\n### 🚀 Key Features\n- 🔹 User Roles \u0026 Access\n- ✅ Superadmin: Full system control, manages all users, shops, and reports.\n- ✅ Manager: Manages shops, sellers, inventory, and sales tracking.\n- ✅ Seller: Records sales, tracks stock, and manages credit payments.\n\n### 🛒 Shop \u0026 Seller Management\n- ✅ Create \u0026 Manage Shops: Managers or Superadmins can create shops.\n- ✅ Assign Sellers to Shops: Sellers are linked to specific shops.\n- ✅ Inventory Management: Add, edit, delete products in the shop.\n- ✅ Low Stock Alerts: Get notified when stock is low.\n\n### 💰 Sales \u0026 Credit Tracking\n- ✅ Record Sales: Sellers can record sales with multiple products.\n- ✅ Cash \u0026 Credit Sales: Choose between cash or credit transactions.\n- ✅ Partial Payments: Buyers can pay part of the amount and settle later.\n- ✅ Automatic Stock Reduction: Sold products reduce from inventory.\n- ✅ Sales History \u0026 Filtering: Search sales by date, seller, or shop.\n- ✅ Sales Returns: Delete or modify sales to return items to stock.\n\n### 📊 Reports \u0026 Analytics\n- ✅ Sales Reports: Daily, Weekly, Monthly revenue breakdown.\n- ✅ Profit Analysis: Compare cost price vs selling price.\n- ✅ Top \u0026 Least Selling Products: Identify performance trends.\n- ✅ Credit Sales Report: Track outstanding customer payments.\n- ✅ Graphical Representations: Interactive charts using Chart.js.\n- ✅ Export Reports: Download reports as CSV or PDF.\n\n### 🔔 Notifications \u0026 Alerts\n- ✅ Real-Time Low Stock Alerts: Get notified of products running out.\n- ✅ Pending Credit Payments Alert: Track customers with outstanding debts.\n- ✅ Sales \u0026 Performance Updates: Monitor daily sales trends.\n\n### 🎨 User Interface \u0026 Experience\n- ✅ Django Admin Panel Style: Clean and professional UI.\n- ✅ Fixed Sidebar Navigation: Easy access to dashboard features.\n- ✅ Mobile Responsive: Works on all devices (PC, tablet, mobile).\n- ✅ Smooth UI with TailwindCSS: Fast-loading, modern design.\n- ✅ Interactive Graphs: Sales \u0026 profit trends using Chart.js.\n\n### ⚙️ Tech Stack\n- ✅ Backend: Django (Python)\n- ✅ Frontend: HTML, TailwindCSS, JavaScript\n- ✅ Database: PostgreSQL / SQLite\n- ✅ Charts \u0026 Reports: Chart.js for analytics\n- ✅ Authentication: Django User Model\n\n\n\n---\n\n\n## 🎯 **User Roles \u0026 Actions**\n\n| Role         | Actions |\n|-------------|--------------------------------|\n| Superadmin  | Manage all users, shops, reports, notifications |\n| Manager     | Manage inventory, sellers, sales tracking |\n| Seller      | Record sales, manage payments, view reports |\n\n---\n\n## 📌 **Future Enhancements**\n- 🔄 **AI-based Sales Predictions**\n- 📱 **Mobile App Integration**\n- 🏆 **Loyalty Program for Customers**\n\n---\n\n## 💡 **Contributors**\nDeveloped by **Pi-Johns** 🚀  \n\n🤝 Contributions \u0026 Support\nFeel free to contribute to this project! Fork, modify, and submit a pull request.\nFor any issues, create a GitHub issue or contact the developer.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpi-johns%2Finventory_management_system","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpi-johns%2Finventory_management_system","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpi-johns%2Finventory_management_system/lists"}