ComplaintEase is a Django-based web application developed to simplify the collection, management, and analysis of complaints within institutions such as colleges, hostels, or organizations.
The system allows users to submit complaints through a simple and intuitive web form. Each complaint is automatically analyzed using a sentiment analysis library (TextBlob or VADER) and classified as Positive, Neutral, or Negative.
The application supports role-based access control. Regular users can submit complaints and view their own submissions, while administrators can view all complaints, filter them by category, and access a dashboard containing visual summaries of complaint trends.
Sentiment results and complaint details are stored in a database, enabling the generation of aggregated insights such as sentiment distribution and category-wise complaint counts. These insights help administrators understand overall user satisfaction and identify areas that require attention.
This project demonstrates the integration of web development, database management, and basic AI-powered sentiment analysis in a simple and practical application suitable for a first-semester micro project.
- User-friendly complaint submission form
- Category selection (College, Hostel, Mess, Other)
- Automatic sentiment classification (Positive / Neutral / Negative)
- Secure database storage of complaints
- Role-based access (User and Admin)
- Admin dashboard with charts and summaries
- Visual representation of sentiment and categories
Backend : Django (Python)
Frontend : HTML, CSS, Bootstrap
Database : SQLite
AI / ML : TextBlob or VADER
Visualization : Chart.js / Matplotlib
-
Clone the repository: git clone
-
Navigate to project folder: cd ComplaintEase
-
Create virtual environment: python -m venv venv
-
Activate virtual environment: venv\Scripts\activate source venv/bin/activate
-
Install dependencies: pip install -r requirements.txt
-
Run migrations: python manage.py makemigrations python manage.py migrate
-
Create superuser: python manage.py createsuperuser
-
Run server: python manage.py runserver
-
Open in browser: http://127.0.0.1:8000/
- Complaint status tracking
- Email or SMS notifications
- Department-wise analytics
- Advanced NLP models
- Export reports to PDF/Excel