Welcome to the Complaint Management System! 🎉 This is a comprehensive full-stack application designed to streamline customer complaint handling, featuring real-time chat, sentiment analysis, automatic prioritization, and powerful analytics. Built with modern technologies for efficiency and scalability. 💪

• ✨ Features
• 🛠️ Tech Stack
• 🏗️ Architecture
• 🚀 Installation
• ⚙️ Configuration
• 🎯 Usage
• 🔗 API Endpoints
• 📊 Analytics & Insights
• 🤝 Contributing
• 📄 License
• 👥 Authors
• 🙏 Acknowledgments

• 🔐 User Authentication: Secure login and registration with JWT tokens 🔑
• 📝 Query Management: Create, update, and track customer complaints/queries 📋
• 💬 Real-Time Chat: Instant messaging between customers and support agents 💬
• 🏷️ Auto-Tagging: Intelligent categorization of complaints using NLP 🤖
• ⚡ Auto-Priority: Smart prioritization based on content analysis 📈
• 🔍 Duplicate Detection: Prevent redundant ticket creation 🕵️‍♂️
• 😊 Sentiment Analysis: Gauge customer emotions and satisfaction levels ❤️
• 📈 Analytics Dashboard: Comprehensive insights and reporting 📊
• 👥 Multi-Tenant Support: Handle multiple companies/organizations 🏢
• 🔒 Role-Based Access: Different permissions for admins, agents, and customers 👤

• 📱 Responsive Design: Works seamlessly on desktop, tablet, and mobile 📱
• 🌟 Modern UI: Beautiful interface built with React and Tailwind CSS 🎨
• ⚡ Fast Performance: Optimized with Vite for lightning-fast development 🚀
• 🎭 Interactive Components: Smooth animations with Framer Motion ✨
• 📊 Data Visualization: Charts and graphs using Recharts 📈

• 🧠 AI-Powered Summarization: Automatic complaint summarization 🤖
• 🎙️ Voice Input: Support for voice-based complaint submission 🎤
• 🔄 Real-Time Updates: Live status updates and notifications 🔔
• 📋 Ticket History: Complete audit trail for all changes 📜
• 🎯 Smart Assignment: Intelligent agent assignment based on expertise 🎯

• Node.js - Runtime environment 🚀
• Express.js - Web framework 🌐
• MongoDB - NoSQL database 🍃
• Mongoose - ODM for MongoDB 📊
• Socket.io - Real-time communication ⚡
• JWT - Authentication 🔐
• bcryptjs - Password hashing 🛡️
• Natural - Natural language processing 🧠
• Sentiment - Sentiment analysis 😊
• @xenova/transformers - AI/ML models 🤖

• React - UI library ⚛️
• Vite - Build tool and dev server ⚡
• Tailwind CSS - Utility-first CSS framework 🎨
• React Router - Client-side routing 🛣️
• Axios - HTTP client 📡
• Socket.io-client - Real-time client 🔌
• Recharts - Data visualization 📊
• Framer Motion - Animation library 🎭
• React Hot Toast - Notification system 🍞
• Heroicons - Beautiful icons 🎯

• ESLint - Code linting 🔍
• Nodemon - Auto-restart for development 🔄
• Vercel - Deployment platform ☁️

📁 ComplaintManagement/
├── 📁 backend/           # Node.js/Express server
│   ├── 📄 app.js         # Main application file
│   ├── 📁 controllers/   # Business logic
│   ├── 📁 models/        # MongoDB schemas
│   ├── 📁 routes/        # API endpoints
│   ├── 📁 middleware/    # Custom middleware
│   ├── 📁 utils/         # Utility functions
│   └── 📁 socket/        # Real-time chat logic
├── 📁 client1/           # React frontend
│   ├── 📄 index.html     # Entry point
│   ├── 📁 src/
│   │   ├── 📁 components/ # Reusable UI components
│   │   ├── 📁 pages/      # Page components
│   │   ├── 📁 context/    # React context providers
│   │   ├── 📁 api/        # API service functions
│   │   └── 📁 socket/     # Socket client setup
│   └── 📄 vite.config.js  # Vite configuration
└── 📄 README.md          # Project documentation 📖

• Node.js (v16 or higher) 🟢
• MongoDB (local or cloud instance) 🍃
• npm or yarn 📦

1. Clone the repository 📥

   git clone https://github.com/SHIVAM1422000/ComplaintManagment.git
   cd ComplaintManagment

2. Navigate to backend directory 📂

   cd backend

3. Install dependencies 📦

   npm install

4. Set up environment variables 🔧 Create a .env file in the backend directory:

   PORT=8000
   MONGODB_URI=mongodb://localhost:27017/complaint_management
   JWT_SECRET=your_super_secret_jwt_key_here
   NODE_ENV=development

5. Start MongoDB 🍃 Make sure MongoDB is running on your system.

6. Run the backend server 🚀

   npm run dev

   The server will start on http://localhost:8000 🎉

1. Open a new terminal and navigate to client directory 📂

   cd ../client1

2. Install dependencies 📦

   npm install

3. Start the development server ⚡

   npm run dev

   The app will be available at http://localhost:5173 🎊

Configure the following environment variables in backend/.env:

The application uses MongoDB. Make sure to:

1. Install MongoDB locally or use a cloud service like MongoDB Atlas ☁️
2. Update the MONGODB_URI in your .env file
3. The app will automatically create collections as needed ✨

1. Register/Login 🔐
2. Submit a Complaint 📝
   • Fill out the complaint form
   • Add details, priority, and attachments if needed
3. Chat with Support 💬
   • Use the real-time chat feature
   • Get instant responses from support agents
4. Track Progress 📊
   • Monitor complaint status
   • View history and updates

1. Login to Dashboard 📈
2. View Inbox 📬
   • See all assigned complaints
   • Filter by status, priority, or tags
3. Manage Tickets 🎫
   • Update status and priority
   • Assign to team members
   • Add internal notes
4. Chat with Customers 💬
   • Respond to customer messages
   • Provide solutions and updates
5. Analyze Performance 📊
   • View analytics and reports
   • Track resolution times and satisfaction

1. User Management 👥
   • Add/remove users
   • Assign roles and permissions
2. System Configuration ⚙️
   • Configure auto-tagging rules
   • Set up priority algorithms
3. Analytics & Reporting 📊
   • Comprehensive dashboards
   • Export reports and insights

• POST /api/auth/register - User registration
• POST /api/auth/login - User login
• GET /api/auth/profile - Get user profile

• GET /api/queries - Get all queries
• POST /api/queries - Create new query
• GET /api/queries/:id - Get specific query
• PUT /api/queries/:id - Update query
• DELETE /api/queries/:id - Delete query

• GET /api/analytics/sentiment - Sentiment analysis data
• GET /api/analytics/trends - Trend analysis
• GET /api/analytics/summary - General summary

• WebSocket events handled via Socket.io
• Real-time messaging between users

The system provides comprehensive analytics including:

• 📈 Sentiment Trends: Track customer satisfaction over time
• 🎯 Resolution Metrics: Average resolution times and success rates
• 🏷️ Category Analysis: Most common complaint types
• 👥 Agent Performance: Individual and team productivity metrics
• 📊 Dashboard Widgets: Customizable visual insights

We love contributions! 🎉 Here's how you can help:

1. Fork the repository 🍴
2. Create a feature branch 🌿

   git checkout -b feature/amazing-feature

3. Commit your changes 💾

   git commit -m 'Add amazing feature ✨'

4. Push to the branch 🚀

   git push origin feature/amazing-feature

5. Open a Pull Request 📝

• Follow ESLint rules 🔍
• Write meaningful commit messages 💬
• Add tests for new features 🧪
• Update documentation 📖
• Use conventional commit format 📝

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

• Shivam Ojha 👨‍💻
  • Initial work - SHIVAM1422000

• React Team for the amazing framework ⚛️
• Tailwind CSS for the utility-first approach 🎨
• Socket.io for real-time communication ⚡
• MongoDB for the flexible database 🍃
• Open source community for inspiration and tools 🌟

Made with ❤️ by Shivam Ojha

⭐ Star this repo if you found it helpful! 🌟

📧 Contact: [Your Email Here] | 🔗 LinkedIn: [Your LinkedIn]

🎯 Live Demo: [Add your deployed app link here]

🐛 Report Issues: GitHub Issues

📚 Documentation: [Add docs link if available]