Complaint Management System | Documentation

Laravel is a web application framework with expressive, elegant syntax. We believe development must be an enjoyable and creative experience to be truly fulfilling. Laravel takes the pain out of development by easing common tasks used in many web projects, such as:

• Simple, fast routing engine.
• Powerful dependency injection container.
• Multiple back-ends for session and cache storage.
• Expressive, intuitive database ORM.
• Database agnostic schema migrations.
• Robust background job processing.
• Real-time event broadcasting.

Laravel is accessible, powerful, and provides tools required for large, robust applications.

Complaint Management System

A Laravel-based Complaint Management System designed to streamline the process of logging, assigning, and tracking customer complaints efficiently.

🚀 Features

• Role-Based Access Control (Admin, Department Heads, Unit Heads, and Members)
• Complaint Logging & Tracking
• Assignment Workflow (Customer Care → Unit Member → Unit Head → Department Head)
• Status Updates (Received, Open, In-Progress, Closed, Rejected, Reopened)
• Reopening Complaints (Either as new or reversing the last step)
• Automated Notifications (Emails, Messages, or Printable Letters for Status Updates)
• Dynamic Role & User Management
• Report Generation

🛠️ Installation

1. Clone the repository

   git clone https://github.com/ManushaUm/Complaint-Management-System.git
   cd Complaint-Management-System

2. Install dependencies

   composer install
   npm install

3. Set up the environment

   cp .env.example .env
   php artisan key:generate

   Update the .env file with your database configuration.

4. Run database migrations

   php artisan migrate --seed

5. Start the application

   php artisan serve

6. Compile assets (if using Vue/React frontend)

   npm run dev

📌 Usage

• Admin Dashboard: Manage users, complaints, and reports.
• Customer Care: Log and categorize complaints.
• Department Heads: Assign complaints to unit heads.
• Unit Members: Work on complaints and update statuses.
• Customers: Track complaint progress and receive notifications.

📜 API Endpoints (will change still going on dev)

Method	Endpoint	Description
POST	/api/login	User login
POST	/api/register	User registration
GET	/api/complaints	Get all complaints
POST	/api/complaints	Create a new complaint
PUT	/api/complaints/{id}	Update complaint status
DELETE	/api/complaints/{id}	Delete complaint

📄 License

This project is open-source and available under the MIT License.