Skip to content

RodneySsemambo/retail-management-dashboard

Repository files navigation

Retail Management System 🏪

A feature-rich retail management solution that helps businesses track daily operations across multiple shops.

🎯 What It Does

  • Manages multiple retail shops from one central system
  • Organizes products with smart categories
  • Controls user access with role-based permissions
  • Tracks daily retail activities in real-time
  • Provides insights through detailed reports

🌟 Why This Project?

This system solves real business problems: manual tracking, scattered inventory data, and lack of multi-location visibility. It's designed for shop owners who need a simple yet powerful tool to run their retail operations efficiently.

🔧 Built With

  • Laravel 10.x
  • MySQL
  • Modern PHP practices
  • RESTful API design

![Retail Management Dashboard] Login - Retail_Mgt - Google Chrome 22_10_2025 13_34_57 Login - Retail_Mgt - Google Chrome 22_10_2025 13_35_09

A powerful Admin Dashboard built with Laravel & Filament for efficient project, orders, and retail management

Laravel Filament License Demo

📧 Contact💼 Hire Me


📋 Table of Contents


🎯 Overview

Retail Management Dashboard is a comprehensive web application designed to help businesses, teams, and organizations efficiently manage their projects from start to finish. Built with modern technologies and best practices, it provides an intuitive interface for tracking orders, managing users, and maintaining client relationships.

💡 Perfect For:

  • 🏢 Small to Medium Businesses — Manage multiple projects and teams
  • 🚀 Startups — Organize workflows and scale efficiently

🌟 Features

🔐 Role-Based Access Control (RBAC)

  • Admin: Full system access and configuration
  • Manager: Project and team management capabilities
  • Powered by Spatie Permission + Filament Shield

📊 Retal Management

  • Create and manage unlimited orders and products
  • Set start dates, deadlines, and budgets filters for products
  • Track order status (Planning, In Progress, Completed, On Hold)

📁 Category Organization

  • Organize orders by categories
  • Create custom categories for different products
  • Filter and group products efficiently
  • Better organization and reporting

📈 Dashboard Analytics

  • Real-time statistics and tablees
  • Visual charts and graphs
  • order completion rates
  • product distribution overview

🎨 Modern UI/UX

  • Clean and intuitive interface powered by Filament
  • Responsive design (Desktop, Tablet, Mobile)
  • Dark mode support
  • Fast and smooth navigation
  • Beautiful data tables with advanced filters
  • Export data to PDF/Excel

🔒 Security Features

  • Secure authentication system
  • Password encryption
  • CSRF protection
  • SQL injection prevention
  • XSS protection
  • Role-based route protection

📸 Screenshots

Click to expand all screenshots

🏠 Dashboard Overview

![Dashboard Home] Login - Retail_Mgt - Google Chrome 22_10_2025 13_35_09

Main dashboard with tables and quick actions

📊 Products Management

![Products List] Login - Retail_Mgt - Google Chrome 22_10_2025 13_36_29

Complete products list with filters, search, and bulk actions

![order list] Login - Retail_Mgt - Google Chrome 22_10_2025 13_36_02 Login - Retail_Mgt - Google Chrome 22_10_2025 13_36_16

✅ Category Management

![Category List] Login - Retail_Mgt - Google Chrome 22_10_2025 13_35_28

![Category page] Login - Retail_Mgt - Google Chrome 22_10_2025 13_35_42

👥 Team & Users

![User Management] Login - Retail_Mgt - Google Chrome 22_10_2025 13_36_56

![Roles & Permissions] Login - Retail_Mgt - Google Chrome 22_10_2025 13_37_04

Fine-grained permission control Login - Retail_Mgt - Google Chrome 22_10_2025 13_37_19

Fully responsive design for mobile devices


🛠️ Tech Stack

Backend

  • Framework: Laravel 12
  • PHP: 8.2+
  • Database: PostgreSQL / MySQL
  • Authentication: Laravel Sanctum
  • Authorization: Spatie Laravel Permission

Frontend

  • Admin Panel: Filament 4.x
  • UI Framework: TailwindCSS
  • JavaScript: Alpine.js
  • Icons: Heroicons

Development Tools

  • Version Control: Git & GitHub
  • Package Manager: Composer
  • Build Tool: Vite
  • Code Quality: Laravel Pint

Deployment

  • Hosting: Render.com
  • Database: PostgreSQL (Render)
  • Domain: Custom domain support
  • SSL: Auto-managed HTTPS

⚙️ Installation

Prerequisites

Before you begin, ensure you have the following installed:

  • PHP 8.2 or higher
  • Composer
  • Node.js & NPM
  • PostgreSQL or MySQL
  • Git

Step-by-Step Setup

1️⃣ Clone the Repository

git clone https://github.com/ssemamb/project-management-dashboard.git
cd project-management-dashboard

2️⃣ Install PHP Dependencies

composer install

3️⃣ Install Node Dependencies

npm install

4️⃣ Environment Configuration

# Copy the example environment file
cp .env.example .env

# Generate application key
php artisan key:generate

5️⃣ Configure Database

Edit .env file and add your database credentials:

DB_CONNECTION=pgsql  # or mysql
DB_HOST=127.0.0.1
DB_PORT=5432         # 3306 for MySQL
DB_DATABASE=project_mgt
DB_USERNAME=your_username
DB_PASSWORD=your_password

6️⃣ Run Migrations & Seed Database

# Run migrations
php artisan migrate

# Seed with demo data (optional)
php artisan db:seed

7️⃣ Create Storage Link

php artisan storage:link

8️⃣ Build Frontend Assets

npm run build

9️⃣ Create Admin User

php artisan make:filament-user

Follow the prompts to create your admin account.

🔟 Start Development Server

php artisan serve

Visit: http://localhost:8000/admin


🔑 Demo Credentials

Try the live demo with these credentials:

Admin Account

  • Email: rodney@gmail.com
  • Password: 1234567m
  • Access: Full system access

⚠️ Note: Demo data is reset every 24 hours


Database Diagram

┌─────────┐       ┌──────────┐       ┌──────────┐
│  Users  │───────│  Roles   │       │ Tags  │
└─────────┘       └──────────┘       └──────────┘
     │                                      │
     │            ┌──────────────┐          │
     └────────────│   Products   │──────────┘
                  └──────────────┘
                        │
                        │
                  ┌──────────┐
                  │  orders  │
                  └──────────┘
                        │
                  ┌──────────────┐
                  │  Categories  │
                  └──────────────┘

📡 API Documentation

This system includes a RESTful API for external integrations (coming soon).

🤝 Contributing

Contributions are welcome! Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

Development Guidelines

  • Follow PSR-12 coding standards
  • Write meaningful commit messages
  • Add tests for new features
  • Update documentation as needed

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

What this means:

✅ Commercial use
✅ Modification
✅ Distribution
✅ Private use


📞 Contact & Support

👨‍💻 Developer

*SsemamboRodney

💰 Hire Me

I'm available for freelance Laravel & Filament development:

  • 🔧 Custom Dashboard Development
  • 🎨 UI/UX Implementation
  • 🔌 API Integration
  • 🐛 Bug Fixes & Optimization

Platforms:


🎯 Roadmap

Future features planned:

  • API with full documentation
  • Real-time notifications
  • File attachments for tasks
  • Time tracking functionality
  • Gantt chart visualization
  • Team chat integration
  • Email notifications
  • Report generation (PDF/Excel)
  • Multi-language support

🙏 Acknowledgments


⭐ Show Your Support

Give a ⭐️ if this project helped you or you found it interesting!


Made with ❤️ in Uganda 🇺🇬

⬆ Back to Top

About

A comprehensive Retail Management System built with Laravel that streamlines daily retail operations. Features include multi-shop management, category organization, user role management, and real-time daily retail tracking. Perfect for small to medium retail businesses looking to digitize their operations.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages