Society Maintenance Tracker

The Problem

Apartment societies often manage maintenance requests through fragmented communication channels, making it difficult for residents to track complaints and for administrators to prioritize, resolve and audit issues consistently.

The Approach

Built a role-based complaint-management application where residents can submit maintenance issues with optional photos and track their history, while administrators can triage complaints, update priorities and statuses, publish notices, monitor overdue tickets and view operational metrics.

Architecture

A React 18 frontend communicates with a Node.js and Express REST API. MongoDB and Mongoose persist users, complaints, notices and configuration settings. JWT middleware protects authenticated routes and enforces admin permissions. Cloudinary handles uploaded complaint images, while Nodemailer sends status-change and notice notifications. Docker configuration and GitHub Actions support reproducible deployment and CI workflows.

Key Features

• —JWT-based registration and login with bcrypt password hashing
• —Resident complaint submission with category, details and optional photo upload
• —Complaint status history with timestamps, notes and acting-user records
• —Admin workflow for Open, In Progress and Resolved complaint states
• —Priority management using Low, Medium and High levels
• —Immutable resolved-ticket workflow to preserve complaint history
• —Overdue complaint detection based on configurable thresholds
• —Advanced complaint filtering by category, status, priority, date range and search
• —Central notice board with pinned important announcements
• —Automated email alerts for complaint updates and important notices
• —Administrative dashboard with status, category, priority and overdue metrics

Technical Challenges

Key challenges included maintaining a reliable complaint audit trail, implementing role-based authorization, preventing changes to resolved issues, calculating overdue status dynamically and coordinating image uploads with email-based workflow notifications.

Result

Created an end-to-end maintenance workflow that gives residents visibility into their issues while providing administrators a centralized dashboard for triage, communication, status tracking and operational reporting.

Learnings

Strengthened full-stack skills in JWT authorization, MongoDB schema design, workflow state management, audit history, Cloudinary file uploads, SMTP email integration, Docker-based local setup and CI configuration.