How kimthuyveng20/rental-room works
RoomFlow is a property-management application: owners and administrators manage properties, rooms, tenants, and leases; billing covers invoices and payments, while tenants and managers can handle maintenance requests. Its Next.js dashboard and API routes sit over a PostgreSQL-backed data model, with authentication and file/email services supporting the workflows. The README is only the generic Next.js starter README, so product capabilities are inferred from the repository tree and sampled source; unsampled page-to-API relationships are not asserted.
Main entry points: index.ts Database Access · auth.ts Auth Configuration · email.service.ts Verification Email · route.ts Property Management
Components 25
Identity
- Auth Configuration
src/lib/auth.ts - Auth Routes
src/app/api/auth/[...nextauth]/route.ts - Registration
src/app/api/auth/register/route.ts - Verification Email
src/lib/services/email.service.ts
Property Operations
- Property Management
src/app/api/properties/route.ts - Room Management
src/app/api/rooms/route.ts - Tenant Management
src/app/api/tenants/route.ts - Lease Management
src/app/api/leases/route.ts - Maintenance Interface
src/components/maintenance-client.tsx - Maintenance Actions
src/actions/maintenance.ts - Maintenance Page
src/app/dashboard/maintenance/page.tsx - Dashboard Interface
src/components/dashboard-layout.tsx - Dashboard Page
src/app/dashboard/page.tsx - Dashboard API
src/app/api/dashboard/route.ts - Dashboard Actions
src/actions/dashboard.ts
Billing
- Invoice Management
src/app/api/invoices/route.ts - Payment Management
src/app/api/payments/route.ts - ABA Webhook
src/app/dashboard/payments/aba/webhook/route.ts
Shared Platform
- Domain Schema
src/lib/db/schema.ts - Database Access
src/lib/db/index.ts - File Storage Service
src/lib/services/s3.service.ts
Other components
- User
- AWS S3
- Email Service
- Google Sign-In
Connections 27
- User → Auth Routes: signs in
- Auth Configuration → Database Access: configures adapter
src/lib/auth.ts - Auth Configuration → Google Sign-In: offers sign-in
src/lib/auth.ts - Registration → Verification Email: sends code
src/app/api/auth/register/route.ts - User → Property Management: manages
- User → Room Management: manages
- User → Tenant Management: manages
src/app/api/tenants/route.ts - User → Lease Management: manages
- Maintenance Page → Maintenance Interface: renders
- Maintenance Interface → Maintenance Actions: submits request
src/components/maintenance-client.tsx - Dashboard Page → Dashboard Interface: renders
- Dashboard API → Dashboard Actions: delegates to
src/app/api/dashboard/route.ts - User → Invoice Management: requests billing
- User → Payment Management: records payment
- User → ABA Webhook: initiates payment
- Auth Configuration → Domain Schema: queries users
src/lib/auth.ts - Database Access → Domain Schema: loads schema
src/lib/db/index.ts - Property Management → Database Access: reads and writes
src/app/api/properties/route.ts - Room Management → Database Access: reads and writes
src/app/api/rooms/route.ts - Tenant Management → Database Access: reads and writes
src/app/api/tenants/route.ts - Lease Management → Database Access: reads and writes
src/app/api/leases/route.ts - Invoice Management → Database Access: reads and writes
src/app/api/invoices/route.ts - Payment Management → Database Access: reads and writes
src/app/api/payments/route.ts - Maintenance Actions → Database Access: reads and writes
src/actions/maintenance.ts - Dashboard Actions → Database Access: reads data
src/actions/dashboard.ts - File Storage Service → AWS S3: uploads objects
src/lib/services/s3.service.ts - Verification Email → Email Service: sends mail
src/lib/services/email.service.ts