Awaaz is a web application that provides a platform for users to communicate and address grievances. It simplifies the process of listing and managing grievances, allowing users to interact with admins and seek resolutions. The application is built using ReactJS for the frontend, NodeJS for the backend, MongoDB as the database, and Tailwind CSS for styling.
Click here to visit Frontend Repo.
- User Registration and Login: Users can register and login to the portal using their credentials, which allows them to submit and manage grievances.
- Grievance Submission: Registered users can submit grievances by providing relevant details such as grievance type, description, and supporting documents.
- Officer Dashboard: Officers can access a dedicated dashboard that displays all the submitted grievances, allowing them to manage and track the status of each grievance.
- Grievance Status Tracking: Users can view the status of their submitted grievances, which is updated by the Officers as the grievances progress through different stages of resolution.
- Officers Response and Resolution: Officers can communicate with users through the portal and provide responses to grievances. They can also update the status of grievances and mark them as resolved. Also they can forward a particular grievance to the officer at a higher level
- User Profile Management: Users can manage their profile information, including updating their contact details and viewing their submitted grievances.
- Admin Panel: Admins can supervise and review the activities of officers in their district, and also register new officers.
- Frontend: ReactJS, Tailwind CSS
- Backend: NodeJS
- Database: MongoDB
To run the Grievance Portal locally, follow these steps:
- Clone the repository to your local machine.
- Install the dependencies for both frontend and backend using
npm installcommand. - Set up the MongoDB database and configure the connection settings in the backend.
- Start the backend server using
npm startcommand in the server directory. - Start the frontend server using
npm run devcommand in the client directory. - Access the application in your web browser at
http://localhost:5173.
- To login as a user, you need to register yourself first. If you need an existing account the credentials are email:"[email protected]",password:"savvy123"
- To login as an officer, the format is [district][department][level(1,2 & 3)]@gmail.com and the password is "password".
- To login as a district admin, the format is [district][email protected] and the password is "password".
The Grievance Portal project is open-source and released under the IIITA License.
For any inquiries or suggestions regarding Awaaz, please contact the project contributors:
- Priyadarshini Roy: [email protected]
- Vishesh Vijayvargiya: [email protected]
- Utsav Singh Tomar: [email protected]
- Mehak Gupta: [email protected]
- Keshav Pandey: [email protected]