Project Description
ResolveNow is a community-driven problem-solving web application that must be built on the full MERN stack with Tailwind CSS for styling. The core flow is simple: residents post local issues, departments review them, track progress, and finally upload proof that the job is done. Everything needs to run smoothly on both mobile and desktop.
Key application flow
• Auth: secure registration / login with JWT, clearly separated User and Admin roles.
• User post section: a resident fills a form, writes a description, and attaches one or more images; no categories or tags are required in this first release.
• Complaint management: Admins see an inbox of new issues, update status (Pending → In Progress → Resolved), and can export a concise report of all resolved cases for their internal records.
• Status tracking dashboard: each complaint shows its history and allows threaded user comments on every status change so everyone knows why something moved forward.
• Resolution proof: when a ticket is set to Resolved, Admin adds final images before closing.
• UI/UX: React 18 + Tailwind CSS, responsive breakpoints, clean dark/light-mode friendly layout.
• API: Node 16+, Express 4, REST endpoints with proper validation and rate limiting.
• Database: MongoDB (mongoose models, indexes for fast status queries).
Deliverables
1. Complete source code in a Git repository with clear README.
2. Postman (or Swagger) collection documenting every endpoint.
3. Deployed demo on Render/Heroku/Vercel or a Docker compose file for local spin-up.
4. Brief hand-off note that explains how to add future features such as category filters or tagging without rewriting core logic.
Acceptance criteria
• All major user journeys tested end-to-end.
• Lighthouse mobile score ≥ 90.
• Admin report exports CSV of resolved tickets grouped by month.
• No critical security warnings on npm audit.
With these pieces in place the community will finally have a transparent, efficient way to report, track, and resolve local problems.