How snehalkrushnabandal/atharva-society-ai-powered-smart-society-management-system works
Atharva Society is a residential-community management web application for residents, managers, administrators, and watch staff. Users enter through role-specific web pages to handle maintenance payments, complaints, emergencies, assets, notices, services, and visitor logs; the Express API applies authentication and domain operations, with MongoDB-backed records and scheduled billing/reminder jobs. The README describes these capabilities, while the supplied source excerpts and index expose selected backend wiring. Client-to-endpoint details and several unsampled controllers are not verified, so those links are omitted or marked unverified.
Main entry points: models Society records · server.js REST API server · email.service.js Email notifications · payment.controller.js Payment verification
Components 23
Web application
- Role portals
client/src/app - Complaint tracking
client/src/app/(dashboard)/complaints/page.tsx - Maintenance payments
client/src/app/(dashboard)/maintenance/page.tsx - Emergency response
client/src/app/(dashboard)/emergency/page.tsx - Gate and watchman
client/src/app/watchman/gate-log/page.tsx
API and access
- REST API server
server/server.js - Authentication routes
server/routes/auth.routes.js - Authentication
server/controllers/auth.controller.js - Role access control
server/middleware/auth.middleware.js
Society operations
- Complaint resolution
server/controllers/complaint.controller.js - Emergency dispatch
server/controllers/emergency.controller.js - Asset tracking
server/controllers/asset.controller.js - Notices and services
server/controllers - Gate visitor logs
server/controllers/gatelog.controller.js - Society records
server/models
Billing and messaging
- Maintenance operations
server/controllers/maintenance.controller.js - Payment verification
server/controllers/payment.controller.js - Billing schedules
server/jobs - Email notifications
server/services/email.service.js
Other components
- Residents
- Society staff
- Razorpay
- MongoDB
Connections 27
- Residents → Role portals: use
README.md - Society staff → Role portals: manage through
README.md - Residents → Complaint tracking: submit complaints
README.md - Residents → Maintenance payments: pay maintenance
README.md - Residents → Emergency response: trigger SOS
README.md - Society staff → Gate and watchman: log visitors
README.md - Role portals → REST API server: calls API
- REST API server → Authentication routes: mounts routes
server/server.js - REST API server → Maintenance operations: routes requests
- REST API server → Complaint resolution: routes requests
- REST API server → Emergency dispatch: routes requests
- Authentication routes → Authentication: dispatches to
server/routes/auth.routes.js - Authentication routes → Role access control: protects session route
server/routes/auth.routes.js - Authentication → Society records: reads and writes users
server/controllers/auth.controller.js - Role access control → Society records: loads user
server/middleware/auth.middleware.js - Maintenance operations → Society records: reads and writes billing
server/controllers/maintenance.controller.js - Maintenance operations → Razorpay: creates orders
server/controllers/maintenance.controller.js - Payment verification → Society records: updates payment records
server/controllers/payment.controller.js - Payment verification → Razorpay: verifies payments
server/controllers/payment.controller.js - Payment verification → Email notifications: sends confirmation
server/controllers/payment.controller.js - Billing schedules → Society records: generates and updates billing
server/jobs/index.js - Billing schedules → Email notifications: sends reminders
server/jobs/index.js - Complaint resolution → Society records: reads and writes complaints
server/controllers/complaint.controller.js - Complaint resolution → Email notifications: sends updates
server/controllers/complaint.controller.js - Asset tracking → Society records: reads and writes assets
server/controllers/asset.controller.js - Emergency dispatch → Email notifications: sends alerts
- Society records → MongoDB: persists documents
README.md