# phamtanhao2505/quan-ly-du-an architecture

> Architecture diagram of the GitHub repository phamtanhao2505/quan-ly-du-an, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/phamtanhao2505/quan-ly-du-an
- Repository: https://github.com/phamtanhao2505/quan-ly-du-an

## Overview

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: [`backend/routes/index.js`](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/routes/index.js) (API Routing), [`backend/config/db.js`](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/config/db.js) (MySQL Pool), [`src/context/AuthContext.tsx`](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/context/AuthContext.tsx) (Authentication State), [`src/navigation/RootNavigator.tsx`](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/navigation/RootNavigator.tsx) (Role Navigation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Mobile App"]
  node_authui["Sign In / Register"]
  node_authstate["Authentication State<br/>[AuthContext.tsx]"]
  node_navigation["Role Navigation<br/>[RootNavigator.tsx]"]
  node_shareddata["App Data State<br/>[AppDataContext.tsx]"]
end

subgraph group_domain["Rental Operations"]
  node_landlordui["Landlord Workspace"]
  node_tenantui["Tenant Portal"]
  node_roomtenancy["Rooms, Tenants, Contracts"]
  node_utilities["Utilities &amp; Pricing"]
  node_billing["Invoices &amp; Payment"]
  node_depositsassets["Deposits &amp; Assets"]
  node_cashflowreports["Cashflow &amp; Reports<br/>[ReportsScreen.tsx]"]
  node_maintenance["Repair Requests"]
end

subgraph group_api["REST Backend"]
  node_sync["Data Sync &amp; Health<br/>[syncController.js]"]
  node_routes["API Routing<br/>[index.js]"]
  node_server["API Server<br/>[server.js]"]
end

subgraph group_persistence["Persistence"]
  node_client["API Client<br/>[apiClient.ts]"]
  node_localdata["Local Cache &amp; Sync<br/>[database.ts]"]
  node_mysqlpool["MySQL Pool<br/>[db.js]"]
end

node_landlord(("Landlord"))
node_tenant(("Tenant"))
node_mysql[("MySQL")]

node_landlord -->|"signs in"| node_authui
node_tenant -->|"signs in"| node_authui
node_authui -->|"authenticates through"| node_authstate
node_authstate -->|"reads and saves users"| node_localdata
node_authstate -->|"provides session"| node_navigation
node_navigation -->|"routes landlord"| node_landlordui
node_navigation -->|"routes tenant"| node_tenantui
node_landlordui -->|"uses shared state"| node_shareddata
node_tenantui -.->|"uses shared state"| node_shareddata
node_shareddata -->|"loads and persists"| node_localdata
node_localdata -->|"calls API client"| node_client
node_client -->|"calls REST API"| node_routes
node_server -->|"mounts routes"| node_routes
node_routes -->|"registers sync routes"| node_sync
node_routes -.->|"routes operations"| node_roomtenancy
node_routes -->|"routes utility API"| node_utilities
node_routes -.->|"routes invoice API"| node_billing
node_routes -->|"routes repair API"| node_maintenance
node_routes -.->|"routes operations"| node_depositsassets
node_roomtenancy -.->|"queries"| node_mysqlpool
node_utilities -.->|"queries"| node_mysqlpool
node_billing -->|"queries"| node_mysqlpool
node_maintenance -.->|"queries"| node_mysqlpool
node_sync -->|"reads records"| node_mysqlpool
node_mysqlpool -->|"connects to"| node_mysql
node_landlordui -.->|"views reports"| node_cashflowreports

click node_authui "https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/src/screens/auth"
click node_authstate "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/context/AuthContext.tsx"
click node_navigation "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/navigation/RootNavigator.tsx"
click node_landlordui "https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/src/screens/landlord"
click node_tenantui "https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/src/screens/tenant"
click node_shareddata "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/context/AppDataContext.tsx"
click node_roomtenancy "https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/backend/controllers"
click node_utilities "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/utilityController.js"
click node_billing "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/invoiceController.js"
click node_depositsassets "https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/backend/controllers"
click node_cashflowreports "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/screens/landlord/ReportsScreen.tsx"
click node_maintenance "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/requestController.js"
click node_sync "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/syncController.js"
click node_routes "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/routes/index.js"
click node_server "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/server.js"
click node_client "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/services/apiClient.ts"
click node_localdata "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/services/database.ts"
click node_mysqlpool "https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/config/db.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_authui,node_authstate,node_navigation,node_shareddata toneBlue
class node_landlordui,node_tenantui,node_roomtenancy,node_utilities,node_billing,node_depositsassets,node_cashflowreports,node_maintenance,node_mysql toneAmber
class node_sync,node_routes,node_server toneMint
class node_client,node_localdata,node_mysqlpool toneRose
class node_landlord,node_tenant toneIndigo
```

## Components

### Mobile App

- [Sign In / Register](https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/src/screens/auth): `src/screens/auth`
- [Authentication State](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Role Navigation](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/navigation/RootNavigator.tsx): `src/navigation/RootNavigator.tsx`
- [App Data State](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/context/AppDataContext.tsx): `src/context/AppDataContext.tsx`

### Rental Operations

- [Landlord Workspace](https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/src/screens/landlord): `src/screens/landlord`
- [Tenant Portal](https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/src/screens/tenant): `src/screens/tenant`
- [Rooms, Tenants, Contracts](https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/backend/controllers): `backend/controllers`
- [Utilities & Pricing](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/utilityController.js): `backend/controllers/utilityController.js`
- [Invoices & Payment](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/invoiceController.js): `backend/controllers/invoiceController.js`
- [Deposits & Assets](https://github.com/phamtanhao2505/quan-ly-du-an/tree/main/backend/controllers): `backend/controllers`
- [Cashflow & Reports](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/screens/landlord/ReportsScreen.tsx): `src/screens/landlord/ReportsScreen.tsx`
- [Repair Requests](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/requestController.js): `backend/controllers/requestController.js`

### REST Backend

- [Data Sync & Health](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/controllers/syncController.js): `backend/controllers/syncController.js`
- [API Routing](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/routes/index.js): `backend/routes/index.js`
- [API Server](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/server.js): `backend/server.js`

### Persistence

- [API Client](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/services/apiClient.ts): `src/services/apiClient.ts`
- [Local Cache & Sync](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/src/services/database.ts): `src/services/database.ts`
- [MySQL Pool](https://github.com/phamtanhao2505/quan-ly-du-an/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **Landlord**
- **Tenant**
- **MySQL**

## Connections

- Landlord → Sign In / Register: signs in (evidence: `README.md`)
- Tenant → Sign In / Register: signs in (evidence: `README.md`)
- Sign In / Register → Authentication State: authenticates through (evidence: `src/screens/auth/LoginScreen.tsx`)
- Authentication State → Local Cache & Sync: reads and saves users (evidence: `src/context/AuthContext.tsx`)
- Authentication State → Role Navigation: provides session (evidence: `src/navigation/RootNavigator.tsx`)
- Role Navigation → Landlord Workspace: routes landlord (evidence: `src/navigation/RootNavigator.tsx`)
- Role Navigation → Tenant Portal: routes tenant (evidence: `src/navigation/RootNavigator.tsx`)
- Landlord Workspace → App Data State: uses shared state (evidence: `src/screens/landlord/ServiceRequestsScreen.tsx`)
- Tenant Portal → App Data State: uses shared state
- App Data State → Local Cache & Sync: loads and persists (evidence: `src/context/AppDataContext.tsx`)
- Local Cache & Sync → API Client: calls API client (evidence: `src/services/database.ts`)
- API Client → API Routing: calls REST API (evidence: `README.md`)
- API Server → API Routing: mounts routes (evidence: `backend/server.js`)
- API Routing → Data Sync & Health: registers sync routes (evidence: `backend/routes/index.js`)
- API Routing → Rooms, Tenants, Contracts: routes operations (evidence: `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 (evidence: `backend/routes/index.js`)
- Rooms, Tenants, Contracts → MySQL Pool: queries (evidence: `backend/controllers/invoiceController.js`)
- Utilities & Pricing → MySQL Pool: queries (evidence: `backend/controllers/utilityController.js`)
- Invoices & Payment → MySQL Pool: queries (evidence: `backend/controllers/invoiceController.js`)
- Repair Requests → MySQL Pool: queries (evidence: `backend/controllers/requestController.js`)
- Data Sync & Health → MySQL Pool: reads records (evidence: `backend/controllers/syncController.js`)
- MySQL Pool → MySQL: connects to (evidence: `backend/config/db.js`)
- Landlord Workspace → Cashflow & Reports: views reports
