# aompat28/jasmin architecture

> Architecture diagram of the GitHub repository aompat28/jasmin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aompat28/jasmin
- Repository: https://github.com/aompat28/jasmin

## Overview

This is a PHP/MySQL property-management application for administrators, tenants, and staff. Users sign in and reach role-oriented dashboards; tenants can manage requests, invoices, leases, room changes, move-outs, and co-residents, while administrators manage rooms, requests, billing, staff, announcements, and reporting. The graph groups these domain areas and includes the shared database connection and mail helper. README content is absent, and several listed pages were not sampled, so their internal behavior and cross-page workflow links are not inferred.

Main entry points: [`includes/db_connect.php`](https://github.com/aompat28/jasmin/blob/main/includes/db_connect.php) (MySQL database), [`tenant_dashboard.php`](https://github.com/aompat28/jasmin/blob/main/tenant_dashboard.php) (Tenant dashboard), [`manage_room.php`](https://github.com/aompat28/jasmin/blob/main/manage_room.php) (Room management), [`includes/time_helper.php`](https://github.com/aompat28/jasmin/blob/main/includes/time_helper.php) (Date and time helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and dashboards"]
  node_login["Sign in<br/>[login.php]"]
  node_admin_dash["Admin dashboard"]
  node_tenant_dash["Tenant dashboard"]
  node_staff_dash["Staff dashboard"]
  node_admin_nav["Admin navigation<br/>[admin_sidebar.php]"]
  node_tenant_nav["Tenant navigation<br/>[tenant_sidebar.php]"]
end

subgraph group_tenancy["Tenant services"]
  node_tenant_requests["Service requests<br/>[tenant_request.php]"]
  node_request_history["Request history"]
  node_tenant_invoices["Tenant invoices<br/>[view_invoices.php]"]
  node_renewals["Lease renewals<br/>[tenant_renewal.php]"]
  node_room_changes["Room changes"]
  node_move_out["Move-out requests"]
  node_coresidents["Co-residents"]
end

subgraph group_operations["Property operations"]
  node_room_admin["Room management<br/>[manage_room.php]"]
  node_check_in["Tenant check-in<br/>[check_in_form.php]"]
  node_admin_requests["Request administration<br/>[admin_requests.php]"]
  node_admin_billing["Invoice management<br/>[manage_invoice.php]"]
  node_staff_admin["Staff management<br/>[manage_staff.php]"]
  node_announcements["Announcements"]
  node_reports["Reports<br/>[admin_reports.php]"]
end

subgraph group_shared["Shared services"]
  node_db[("MySQL database<br/>[db_connect.php]")]
  node_mailer["Email delivery<br/>[mailer.php]"]
  node_doc_viewer["Document viewer"]
  node_time["Date and time helpers<br/>[time_helper.php]"]
end

node_users(("Application users"))

node_users -->|"sign in"| node_login
node_admin_dash -->|"queries"| node_db
node_tenant_dash -->|"queries"| node_db
node_staff_dash -->|"queries"| node_db
node_login -->|"authenticates against"| node_db
node_tenant_requests -->|"queries"| node_db
node_request_history -->|"queries"| node_db
node_tenant_invoices -->|"queries"| node_db
node_renewals -->|"queries"| node_db
node_room_changes -->|"queries"| node_db
node_move_out -->|"queries"| node_db
node_coresidents -->|"queries"| node_db
node_room_admin -->|"queries"| node_db
node_check_in -->|"queries"| node_db
node_admin_requests -->|"queries"| node_db
node_admin_billing -->|"queries"| node_db
node_staff_admin -->|"queries"| node_db
node_announcements -->|"queries"| node_db
node_reports -->|"queries"| node_db
node_db -->|"loads"| node_time
node_admin_dash -->|"uses"| node_time
node_tenant_dash -->|"uses"| node_time
node_admin_billing -->|"sends email"| node_mailer
node_announcements -->|"sends email"| node_mailer
node_room_admin -->|"uses"| node_doc_viewer
node_move_out -->|"uses"| node_doc_viewer
node_admin_nav -->|"links to"| node_room_admin
node_admin_nav -->|"links to"| node_admin_requests
node_tenant_nav -->|"links to"| node_tenant_dash
node_tenant_nav -->|"links to"| node_coresidents

click node_login "https://github.com/aompat28/jasmin/blob/main/login.php"
click node_admin_dash "https://github.com/aompat28/jasmin/blob/main/admin_dashboard.php"
click node_tenant_dash "https://github.com/aompat28/jasmin/blob/main/tenant_dashboard.php"
click node_staff_dash "https://github.com/aompat28/jasmin/blob/main/staff_dashboard.php"
click node_admin_nav "https://github.com/aompat28/jasmin/blob/main/includes/admin_sidebar.php"
click node_tenant_nav "https://github.com/aompat28/jasmin/blob/main/includes/tenant_sidebar.php"
click node_tenant_requests "https://github.com/aompat28/jasmin/blob/main/tenant_request.php"
click node_request_history "https://github.com/aompat28/jasmin/blob/main/tenant_request_history.php"
click node_tenant_invoices "https://github.com/aompat28/jasmin/blob/main/view_invoices.php"
click node_renewals "https://github.com/aompat28/jasmin/blob/main/tenant_renewal.php"
click node_room_changes "https://github.com/aompat28/jasmin/blob/main/tenant_room_change.php"
click node_move_out "https://github.com/aompat28/jasmin/blob/main/tenant_move_out.php"
click node_coresidents "https://github.com/aompat28/jasmin/blob/main/tenant_coresidents.php"
click node_room_admin "https://github.com/aompat28/jasmin/blob/main/manage_room.php"
click node_check_in "https://github.com/aompat28/jasmin/blob/main/check_in_form.php"
click node_admin_requests "https://github.com/aompat28/jasmin/blob/main/admin_requests.php"
click node_admin_billing "https://github.com/aompat28/jasmin/blob/main/manage_invoice.php"
click node_staff_admin "https://github.com/aompat28/jasmin/blob/main/manage_staff.php"
click node_announcements "https://github.com/aompat28/jasmin/blob/main/manage_announcements.php"
click node_reports "https://github.com/aompat28/jasmin/blob/main/admin_reports.php"
click node_db "https://github.com/aompat28/jasmin/blob/main/includes/db_connect.php"
click node_mailer "https://github.com/aompat28/jasmin/blob/main/includes/mailer.php"
click node_doc_viewer "https://github.com/aompat28/jasmin/blob/main/includes/doc_viewer_modal.php"
click node_time "https://github.com/aompat28/jasmin/blob/main/includes/time_helper.php"

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_login,node_admin_dash,node_tenant_dash,node_staff_dash,node_admin_nav,node_tenant_nav,node_users toneBlue
class node_tenant_requests,node_request_history,node_tenant_invoices,node_renewals,node_room_changes,node_move_out,node_coresidents toneAmber
class node_room_admin,node_check_in,node_admin_requests,node_admin_billing,node_staff_admin,node_announcements,node_reports toneMint
class node_db,node_mailer,node_doc_viewer,node_time toneRose
```

## Components

### Access and dashboards

- [Sign in](https://github.com/aompat28/jasmin/blob/main/login.php): `login.php`
- [Admin dashboard](https://github.com/aompat28/jasmin/blob/main/admin_dashboard.php): `admin_dashboard.php`
- [Tenant dashboard](https://github.com/aompat28/jasmin/blob/main/tenant_dashboard.php): `tenant_dashboard.php`
- [Staff dashboard](https://github.com/aompat28/jasmin/blob/main/staff_dashboard.php): `staff_dashboard.php`
- [Admin navigation](https://github.com/aompat28/jasmin/blob/main/includes/admin_sidebar.php): `includes/admin_sidebar.php`
- [Tenant navigation](https://github.com/aompat28/jasmin/blob/main/includes/tenant_sidebar.php): `includes/tenant_sidebar.php`

### Tenant services

- [Service requests](https://github.com/aompat28/jasmin/blob/main/tenant_request.php): `tenant_request.php`
- [Request history](https://github.com/aompat28/jasmin/blob/main/tenant_request_history.php): `tenant_request_history.php`
- [Tenant invoices](https://github.com/aompat28/jasmin/blob/main/view_invoices.php): `view_invoices.php`
- [Lease renewals](https://github.com/aompat28/jasmin/blob/main/tenant_renewal.php): `tenant_renewal.php`
- [Room changes](https://github.com/aompat28/jasmin/blob/main/tenant_room_change.php): `tenant_room_change.php`
- [Move-out requests](https://github.com/aompat28/jasmin/blob/main/tenant_move_out.php): `tenant_move_out.php`
- [Co-residents](https://github.com/aompat28/jasmin/blob/main/tenant_coresidents.php): `tenant_coresidents.php`

### Property operations

- [Room management](https://github.com/aompat28/jasmin/blob/main/manage_room.php): `manage_room.php`
- [Tenant check-in](https://github.com/aompat28/jasmin/blob/main/check_in_form.php): `check_in_form.php`
- [Request administration](https://github.com/aompat28/jasmin/blob/main/admin_requests.php): `admin_requests.php`
- [Invoice management](https://github.com/aompat28/jasmin/blob/main/manage_invoice.php): `manage_invoice.php`
- [Staff management](https://github.com/aompat28/jasmin/blob/main/manage_staff.php): `manage_staff.php`
- [Announcements](https://github.com/aompat28/jasmin/blob/main/manage_announcements.php): `manage_announcements.php`
- [Reports](https://github.com/aompat28/jasmin/blob/main/admin_reports.php): `admin_reports.php`

### Shared services

- [MySQL database](https://github.com/aompat28/jasmin/blob/main/includes/db_connect.php): `includes/db_connect.php`
- [Email delivery](https://github.com/aompat28/jasmin/blob/main/includes/mailer.php): `includes/mailer.php`
- [Document viewer](https://github.com/aompat28/jasmin/blob/main/includes/doc_viewer_modal.php): `includes/doc_viewer_modal.php`
- [Date and time helpers](https://github.com/aompat28/jasmin/blob/main/includes/time_helper.php): `includes/time_helper.php`

### Other components

- **Application users**

## Connections

- Application users → Sign in: sign in
- Admin dashboard → MySQL database: queries (evidence: `admin_dashboard.php`)
- Tenant dashboard → MySQL database: queries (evidence: `tenant_dashboard.php`)
- Staff dashboard → MySQL database: queries (evidence: `staff_dashboard.php`)
- Sign in → MySQL database: authenticates against (evidence: `login.php`)
- Service requests → MySQL database: queries (evidence: `tenant_request.php`)
- Request history → MySQL database: queries (evidence: `tenant_request_history.php`)
- Tenant invoices → MySQL database: queries (evidence: `view_invoices.php`)
- Lease renewals → MySQL database: queries (evidence: `tenant_renewal.php`)
- Room changes → MySQL database: queries (evidence: `tenant_room_change.php`)
- Move-out requests → MySQL database: queries (evidence: `tenant_move_out.php`)
- Co-residents → MySQL database: queries (evidence: `tenant_coresidents.php`)
- Room management → MySQL database: queries (evidence: `manage_room.php`)
- Tenant check-in → MySQL database: queries (evidence: `check_in_form.php`)
- Request administration → MySQL database: queries (evidence: `admin_requests.php`)
- Invoice management → MySQL database: queries (evidence: `manage_invoice.php`)
- Staff management → MySQL database: queries (evidence: `manage_staff.php`)
- Announcements → MySQL database: queries (evidence: `manage_announcements.php`)
- Reports → MySQL database: queries (evidence: `admin_reports.php`)
- MySQL database → Date and time helpers: loads (evidence: `includes/db_connect.php`)
- Admin dashboard → Date and time helpers: uses (evidence: `admin_dashboard.php`)
- Tenant dashboard → Date and time helpers: uses (evidence: `tenant_dashboard.php`)
- Invoice management → Email delivery: sends email (evidence: `manage_invoice.php`)
- Announcements → Email delivery: sends email (evidence: `manage_announcements.php`)
- Room management → Document viewer: uses (evidence: `manage_room.php`)
- Move-out requests → Document viewer: uses (evidence: `tenant_move_out.php`)
- Admin navigation → Room management: links to (evidence: `includes/admin_sidebar.php`)
- Admin navigation → Request administration: links to (evidence: `includes/admin_sidebar.php`)
- Tenant navigation → Tenant dashboard: links to (evidence: `includes/tenant_sidebar.php`)
- Tenant navigation → Co-residents: links to (evidence: `includes/tenant_sidebar.php`)
