project-society

byPalak

You are a senior Staff Software Engineer, SaaS Architect, UI/UX Designer, DevOps Engineer, and Product Manager. Your task is to build a COMPLETE production-ready multi-tenant Apartment Society Management SaaS for India. The application should not look like a hackathon prototype. It should look like a real SaaS product that could compete with commercial platforms. ================================================== PROJECT NAME ================================================== SocietyFlow Tagline: Smart Apartment Management Platform ================================================== PROJECT GOAL ================================================== Develop a cloud-based Apartment Society Management Platform where multiple apartment societies can subscribe and manage all their operations from one application. The application should support multiple societies. Every society should have isolated data. This is a B2B SaaS. The application should be modern, responsive, scalable, secure and production-ready. ================================================== TECH STACK ================================================== Frontend - React - TypeScript - Vite - TailwindCSS - Shadcn UI - React Router - React Query (TanStack Query) - React Hook Form - Zod - Framer Motion - Recharts Backend - Node.js - Express.js - TypeScript Database PostgreSQL ORM Prisma Authentication JWT Access Token Refresh Token Role Based Access Control Password Hashing using bcrypt Storage Cloudinary Email Nodemailer Notifications Firebase Cloud Messaging Payments Razorpay Deployment Ready Docker Docker Compose Nginx ================================================== PROJECT STRUCTURE ================================================== Create proper scalable folder structure. Frontend src components pages hooks services layouts features utils types contexts Backend controllers routes middlewares services repositories prisma config utils types validators ================================================== MULTI TENANT SAAS ================================================== This MUST be multi tenant. Every society has Society ID Name Subscription Plan Admin Residents Buildings Floors Flats Every query should automatically filter by Society ID. No resident can access another society's data. ================================================== USER ROLES ================================================== Super Admin Society Admin Committee Member Resident Tenant Security Guard Maintenance Staff Accountant Each role must have different permissions. Implement middleware for RBAC. ================================================== AUTHENTICATION ================================================== Implement Register Login Forgot Password Reset Password Refresh Token Email Verification Profile Change Password Two Factor Authentication (optional) ================================================== MODULE 1 SOCIETY MANAGEMENT ================================================== Create Society Add Towers Add Buildings Add Floors Add Flats Assign Residents Assign Owners Assign Tenants Upload Society Documents Society Settings Subscription Plan ================================================== MODULE 2 RESIDENT MANAGEMENT ================================================== Resident Profile Family Members Emergency Contact Vehicles Documents Occupation Move In Move Out Lease Expiry Digital ID Card ================================================== MODULE 3 VISITOR MANAGEMENT ================================================== Resident invites visitor. Generate QR Code. Visitor receives QR. Security scans QR. Check In. Check Out. Visitor history. Delivery tracking. Cab tracking. Domestic worker entry. ================================================== MODULE 4 MAINTENANCE BILLING ================================================== Monthly bill generation. Recurring charges. Parking charges. Water charges. Electricity. Penalty. Interest. GST. Payment reminders. Download invoice PDF. Payment status. ================================================== MODULE 5 ONLINE PAYMENTS ================================================== Integrate Razorpay. Payment Gateway. Generate Receipt. Refund. Transaction History. Late Fees. Recurring Payments. ================================================== MODULE 6 COMPLAINT MANAGEMENT ================================================== Residents create complaints. Categories Water Electricity Lift Parking Cleaning Security Others Upload images. Assign to staff. Track status. Timeline. Comments. Escalation. Priority. ================================================== MODULE 7 AMENITY BOOKING ================================================== Book Gym Swimming Pool Club House Tennis Court Badminton Court Guest Room Calendar View Prevent double booking. Booking approval. ================================================== MODULE 8 NOTICE BOARD ================================================== Committee can publish Notices Events Water Shutdown Festival Emergency Attach PDFs Push Notification ================================================== MODULE 9 DIGITAL VOTING ================================================== Society Elections Anonymous Voting Poll Results Single Vote Voting Window ================================================== MODULE 10 PARKING MANAGEMENT ================================================== Parking Allocation Visitor Parking Parking Availability Vehicle Database QR Parking Pass ================================================== MODULE 11 STAFF MANAGEMENT ================================================== Guards Housekeeping Electricians Gardeners Attendance Salary Shift Management ================================================== MODULE 12 VENDOR MANAGEMENT ================================================== Vendor Registration AMC Tracking Invoices Payments Renewals ================================================== MODULE 13 ACCOUNTING ================================================== Income Expense Ledger Bank Accounts GST Reports Audit Logs ================================================== MODULE 14 COMMUNITY MARKETPLACE ================================================== Residents can Sell Products Rent Items Offer Services Lost & Found ================================================== MODULE 15 DOCUMENT MANAGEMENT ================================================== Store Society Rules Meeting Minutes AGM Documents Certificates Invoices Insurance ================================================== MODULE 16 EMERGENCY SYSTEM ================================================== Emergency SOS Notify Security Committee Family Fire Medical Police ================================================== MODULE 17 ANALYTICS DASHBOARD ================================================== Charts Monthly Collection Pending Payments Visitor Trends Complaint Trends Revenue Expense Occupancy Amenity Usage ================================================== DATABASE ================================================== Design proper relational database. Entities include Users Roles Permissions Society Buildings Floors Flats Residents Visitors Vehicles Bills Payments Complaints Amenities Bookings Polls Votes Vendors Invoices Documents Notifications Audit Logs Use Prisma relations. ================================================== UI DESIGN ================================================== Use modern SaaS dashboard. Minimalistic. Rounded cards. Beautiful gradients. Dark Mode Light Mode Responsive. Glassmorphism where appropriate. Smooth animations. Professional typography. Dashboard similar quality to Linear, Stripe Dashboard, Notion or Vercel. ================================================== EXTRA FEATURES ================================================== Global Search Command Palette Keyboard Shortcuts Realtime Notifications Activity Feed Export CSV Export PDF Import Excel Theme Customization Notification Center ================================================== ADMIN PANEL ================================================== Platform Analytics Manage Societies Subscriptions Revenue Dashboard Support Tickets Announcements Feature Flags ================================================== SECURITY ================================================== Helmet Rate Limiting CORS SQL Injection Protection XSS Protection CSRF Protection JWT Password Hashing Input Validation ================================================== API ================================================== Follow REST architecture. Use proper status codes. Pagination Filtering Sorting Search Error handling. ================================================== CODE QUALITY ================================================== Use SOLID principles Clean Architecture Reusable Components Custom Hooks Service Layer Repository Pattern Environment Variables Proper comments ================================================== DELIVERABLES ================================================== Generate the project in phases. Phase 1 Project setup Folder structure Database Authentication Phase 2 Core Society Modules Phase 3 Billing Complaints Visitor Management Phase 4 Analytics Notifications Payments Phase 5 Deployment Testing Documentation Do not generate placeholder code. Every feature should be fully implemented with production-quality code. Always explain architectural decisions before writing code. Maintain a clean Git history by suggesting meaningful commits after each completed feature. The final product should be polished enough to be deployed for real apartment societies and should demonstrate senior-level software engineering practices.