How phamtanhao2505/quan-ly-du-an works
This is a full-stack rental-property management system: landlords administer rooms, tenants, contracts, utilities, invoices, deposits, assets, cashflow, reports, and maintenance; tenants use a portal for invoices and repair requests. The mobile app initializes role-based navigation and shared auth/data state, with a local-storage data service and a documented REST API/MySQL backend. Backend controller and route details are represented at subsystem level where source was not sampled; links reflect README statements or indexed imports, not assumed business-call sequences.
Main entry points: index.js API Routing · db.js MySQL Pool · AuthContext.tsx Authentication State · RootNavigator.tsx Role Navigation
Components 21
Mobile App
- Sign In / Register
src/screens/auth - Authentication State
src/context/AuthContext.tsx - Role Navigation
src/navigation/RootNavigator.tsx - App Data State
src/context/AppDataContext.tsx
Rental Operations
- Landlord Workspace
src/screens/landlord - Tenant Portal
src/screens/tenant - Rooms, Tenants, Contracts
backend/controllers - Utilities & Pricing
backend/controllers/utilityController.js - Invoices & Payment
backend/controllers/invoiceController.js - Deposits & Assets
backend/controllers - Cashflow & Reports
src/screens/landlord/ReportsScreen.tsx - Repair Requests
backend/controllers/requestController.js
REST Backend
- Data Sync & Health
backend/controllers/syncController.js - API Routing
backend/routes/index.js - API Server
backend/server.js
Persistence
- API Client
src/services/apiClient.ts - Local Cache & Sync
src/services/database.ts - MySQL Pool
backend/config/db.js
Other components
- Landlord
- Tenant
- MySQL
Connections 26
- Landlord → Sign In / Register: signs in
README.md - Tenant → Sign In / Register: signs in
README.md - Sign In / Register → Authentication State: authenticates through
src/screens/auth/LoginScreen.tsx - Authentication State → Local Cache & Sync: reads and saves users
src/context/AuthContext.tsx - Authentication State → Role Navigation: provides session
src/navigation/RootNavigator.tsx - Role Navigation → Landlord Workspace: routes landlord
src/navigation/RootNavigator.tsx - Role Navigation → Tenant Portal: routes tenant
src/navigation/RootNavigator.tsx - Landlord Workspace → App Data State: uses shared state
src/screens/landlord/ServiceRequestsScreen.tsx - Tenant Portal → App Data State: uses shared state
- App Data State → Local Cache & Sync: loads and persists
src/context/AppDataContext.tsx - Local Cache & Sync → API Client: calls API client
src/services/database.ts - API Client → API Routing: calls REST API
README.md - API Server → API Routing: mounts routes
backend/server.js - API Routing → Data Sync & Health: registers sync routes
backend/routes/index.js - API Routing → Rooms, Tenants, Contracts: routes operations
backend/routes/index.js - API Routing → Utilities & Pricing: routes utility API
- API Routing → Invoices & Payment: routes invoice API
- API Routing → Repair Requests: routes repair API
- API Routing → Deposits & Assets: routes operations
backend/routes/index.js - Rooms, Tenants, Contracts → MySQL Pool: queries
backend/controllers/invoiceController.js - Utilities & Pricing → MySQL Pool: queries
backend/controllers/utilityController.js - Invoices & Payment → MySQL Pool: queries
backend/controllers/invoiceController.js - Repair Requests → MySQL Pool: queries
backend/controllers/requestController.js - Data Sync & Health → MySQL Pool: reads records
backend/controllers/syncController.js - MySQL Pool → MySQL: connects to
backend/config/db.js - Landlord Workspace → Cashflow & Reports: views reports