marine-complaint

byPRATHAM

Build a production-quality full-stack web application called “Smart Complaint Management System” for colleges, universities, residential communities, companies, or government offices. Goal Create a centralized platform where users can submit complaints, automatically categorize and prioritize them, track progress in real time, and allow administrators to efficiently assign, resolve, and analyze complaints. Core users User/Complainant – submits complaints and tracks their status. Staff/Resolver – receives assigned complaints and updates progress. Admin – manages users, departments, complaints, priorities, assignments, and analytics. Main features Authentication Email/password login and registration Role-based access control: User, Staff, Admin Forgot/reset password Secure session handling Complaint submission Title Detailed description Category: infrastructure, cleanliness, security, IT, transport, academics, maintenance, etc. Location Optional image/video attachment Anonymous complaint option where appropriate Auto-generated complaint ID Timestamp AI-powered complaint processing Automatically classify the complaint into a category Detect urgency/severity: Low, Medium, High, Critical Detect duplicate or highly similar complaints Extract important entities such as location, department, issue type, and keywords Recommend the responsible department/staff member Generate a concise complaint summary for administrators Explain why a complaint was given its priority level Complaint workflow Submitted Under Review Assigned In Progress Resolved Rejected/Closed Reopened Assignment system Admin can assign complaints to departments or individual staff Staff dashboard showing assigned, pending, overdue, and completed complaints Automatic escalation when a complaint remains unresolved beyond its SLA Notifications Notify users when complaint status changes Notify staff when a complaint is assigned Notify admins about overdue/high-priority complaints Support email/in-app notifications User dashboard Total complaints Pending In progress Resolved Reopened Complaint timeline Search, filter, and sort complaints Admin dashboard Total complaints Open vs resolved Complaints by category Complaints by department Priority distribution Average resolution time SLA violations Monthly complaint trends Most common complaint types Staff performance metrics Interactive charts Smart analytics Identify recurring problems Detect departments with unusually high complaint volumes Find locations with repeated issues Predict which complaints are likely to become overdue Provide actionable recommendations to administrators Search and filtering Search by complaint ID, title, description, user, category, department, location, and status Filter by date, priority, category, status, department, and assigned staff Feedback After resolution, allow users to rate the resolution 1–5 star rating Optional feedback/comment Track satisfaction by department Important UI requirements Create a modern, professional, responsive dashboard rather than a basic CRUD interface. Use: Clean sidebar navigation Dashboard cards Data tables with pagination Status badges Priority indicators Complaint timeline Charts and analytics Modal/drawer for complaint details Mobile-responsive layouts Accessible forms and keyboard navigation Loading, empty, and error states Confirmation dialogs for destructive actions Recommended pages Landing page Login/Register User Dashboard Submit Complaint My Complaints Complaint Details Staff Dashboard Assigned Complaints Admin Dashboard All Complaints Departments Users & Roles Analytics Notifications Profile/Settings Technical requirements Build the application with: Frontend: React + TypeScript + Tailwind CSS + shadcn/ui Backend: Supabase Database: PostgreSQL Authentication: Supabase Auth File storage: Supabase Storage Charts: Recharts AI: Integrate an LLM API for classification, summarization, duplicate detection, and priority recommendation Design a proper relational database with tables such as: users/profiles complaints complaint_categories departments staff_assignments complaint_status_history notifications complaint_feedback SLA_rules audit_logs Implement: Row Level Security Role-based authorization Input validation Secure file uploads Audit logging API error handling Database indexes for frequently searched fields AI priority logic Do not let AI make completely uncontrolled decisions. Store: AI category AI severity AI confidence score AI explanation Allow admins to override AI recommendations, and record every override in the audit log. Unique feature: Complaint Intelligence Add a dedicated “Complaint Intelligence” section that automatically identifies: recurring complaints duplicate complaints emerging problems high-risk unresolved complaints locations with repeated issues departments with poor resolution performance Display these insights as actionable recommendations such as: “18 complaints about water leakage were reported in Block B this month. Consider inspecting the main pipeline.” Development approach First create the database schema and application architecture. Then implement authentication and role-based access. Then build complaint submission/workflow, dashboards, AI processing, notifications, analytics, and feedback. Generate realistic seed/demo data so every dashboard and feature can be demonstrated immediately. Make the application modular, maintainable, and ready for deployment. Do not create a superficial demo—build the core functionality end-to-end with working database operations, authentication, permissions, validation, and realistic UI states.