https://github.com/pi-johns/inventory_management_system
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.
https://github.com/pi-johns/inventory_management_system
ajax authentication chartjs django django-rest-framework html-css-javascript javascript postgresql python sqlite tailwindcss
Last synced: 1 day ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/pi-johns/inventory_management_system
- Owner: Pi-johns
- License: mit
- Created: 2025-02-20T00:30:01.000Z (1 day ago)
- Default Branch: main
- Last Pushed: 2025-02-20T01:25:52.000Z (1 day ago)
- Last Synced: 2025-02-20T01:36:37.496Z (1 day ago)
- Topics: ajax, authentication, chartjs, django, django-rest-framework, html-css-javascript, javascript, postgresql, python, sqlite, tailwindcss
- Language: Python
- Homepage:
- Size: 20.7 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
### 🏪 Shop Management System
-📌 Overview
The 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.
### 🚀 Key Features
- 🔹 User Roles & Access
- ✅ Superadmin: Full system control, manages all users, shops, and reports.
- ✅ Manager: Manages shops, sellers, inventory, and sales tracking.
- ✅ Seller: Records sales, tracks stock, and manages credit payments.
### 🛒 Shop & Seller Management
- ✅ Create & Manage Shops: Managers or Superadmins can create shops.
- ✅ Assign Sellers to Shops: Sellers are linked to specific shops.
- ✅ Inventory Management: Add, edit, delete products in the shop.
- ✅ Low Stock Alerts: Get notified when stock is low.
### 💰 Sales & Credit Tracking
- ✅ Record Sales: Sellers can record sales with multiple products.
- ✅ Cash & Credit Sales: Choose between cash or credit transactions.
- ✅ Partial Payments: Buyers can pay part of the amount and settle later.
- ✅ Automatic Stock Reduction: Sold products reduce from inventory.
- ✅ Sales History & Filtering: Search sales by date, seller, or shop.
- ✅ Sales Returns: Delete or modify sales to return items to stock.
### 📊 Reports & Analytics
- ✅ Sales Reports: Daily, Weekly, Monthly revenue breakdown.
- ✅ Profit Analysis: Compare cost price vs selling price.
- ✅ Top & Least Selling Products: Identify performance trends.
- ✅ Credit Sales Report: Track outstanding customer payments.
- ✅ Graphical Representations: Interactive charts using Chart.js.
- ✅ Export Reports: Download reports as CSV or PDF.
### 🔔 Notifications & Alerts
- ✅ Real-Time Low Stock Alerts: Get notified of products running out.
- ✅ Pending Credit Payments Alert: Track customers with outstanding debts.
- ✅ Sales & Performance Updates: Monitor daily sales trends.
### 🎨 User Interface & Experience
- ✅ Django Admin Panel Style: Clean and professional UI.
- ✅ Fixed Sidebar Navigation: Easy access to dashboard features.
- ✅ Mobile Responsive: Works on all devices (PC, tablet, mobile).
- ✅ Smooth UI with TailwindCSS: Fast-loading, modern design.
- ✅ Interactive Graphs: Sales & profit trends using Chart.js.
### ⚙️ Tech Stack
- ✅ Backend: Django (Python)
- ✅ Frontend: HTML, TailwindCSS, JavaScript
- ✅ Database: PostgreSQL / SQLite
- ✅ Charts & Reports: Chart.js for analytics
- ✅ Authentication: Django User Model
## 📸 Screenshots 🪄✨
### 🔥 Home Page for login
)
### 📜 manager dashboard
)
### ✨ reports
)
### ✨ reports
)
### ✨ admin dash
)
### ✨ admin dash inventory management
)
### ✨ admin dash sales management
### ✨ django admin panel
)
### ✨ users and roles
)
### ✨ modify user
)
---
### 🔧 Installation & Setup
## 📜 **How to Install & Run Locally**
```bash
# Clone the repository
git clone https://github.com/your-repo/shop-management.git
cd shop-management
# Create a virtual environment and activate it
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Install dependencies
pip install -r requirements.txt
# Run database migrations
python manage.py migrate
# Create a superuser
python manage.py createsuperuser
# Start the server
python manage.py runserver
```
Now, visit **http://127.0.0.1:8000/** and log in! 🚀
---
## 🎯 **User Roles & Actions**
| Role | Actions |
|-------------|--------------------------------|
| Superadmin | Manage all users, shops, reports, notifications |
| Manager | Manage inventory, sellers, sales tracking |
| Seller | Record sales, manage payments, view reports |
---
## 📌 **Future Enhancements**
- 🔄 **AI-based Sales Predictions**
- 📱 **Mobile App Integration**
- 🏆 **Loyalty Program for Customers**
---
## 💡 **Contributors**
Developed by **Pi-Johns** 🚀
🤝 Contributions & Support
Feel free to contribute to this project! Fork, modify, and submit a pull request.
For any issues, create a GitHub issue or contact the developer.