# karuki00/tenant-hub-oasis architecture

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

- Interactive diagram: https://gitdiagram.com/karuki00/tenant-hub-oasis
- Repository: https://github.com/karuki00/tenant-hub-oasis

## Overview

TenantHub is a local-first Windows desktop tenant-management application. Tenant Relation staff authenticate, then view dashboard summaries or search and filter the directory; they can create, edit, delete, or import tenant records, with successful database operations reflected in the UI. Excel import includes parsing, validation, duplicate/conflict classification, preview, and merge/add/replace planning; export, backup/restore, and signed updates are documented capabilities. The Rust backend, updater implementation, and backup wiring were not excerpted, so their internal links are omitted where unverified.

Main entry points: [`src/pages/DashboardPage.tsx`](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/pages/DashboardPage.tsx) (Dashboard & directory UI), [`src/App.tsx`](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/App.tsx) (App coordinator), [`src/components/LoginPage.tsx`](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/LoginPage.tsx) (Login & recovery), [`src/components/TenantFormModal.tsx`](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/TenantFormModal.tsx) (Tenant editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access &amp; Dashboard"]
  node_app["App coordinator<br/>[App.tsx]"]
  node_login["Login &amp; recovery<br/>[LoginPage.tsx]"]
  node_auth["Authentication commands<br/>[auth.ts]"]
  node_overview["Dashboard overview"]
end

subgraph group_directory["Tenant Directory"]
  node_dashboard["Dashboard &amp; directory UI<br/>[DashboardPage.tsx]"]
  node_tenantform["Tenant editor"]
  node_detail["Tenant detail"]
  node_pagination["Directory pagination<br/>[Pagination.tsx]"]
  node_tenant["Tenant record model<br/>[tenant.ts]"]
  node_validation["Tenant validation"]
end

subgraph group_import["Excel Import"]
  node_preview["Import preview"]
  node_excel["Excel import planning<br/>[excelImport.ts]"]
end

subgraph group_local["Local Data"]
  node_database_api["Tenant database API<br/>[tenantDatabase.ts]"]
  node_sqlite[("SQLite backend<br/>[lib.rs]")]
  node_export["XLSX export &amp; save<br/>[lib.rs]"]
  node_backup["JSON backup &amp; restore"]
  node_tauri["Tauri runtime<br/>[main.rs]"]
end

subgraph group_updates["Updates"]
  node_updater["Update checker<br/>[updater.ts]"]
  node_github["GitHub updates"]
end

node_staff(("Tenant Relation staff"))

node_staff -->|"signs in"| node_login
node_login -->|"requests auth"| node_auth
node_auth -->|"invokes commands"| node_tauri
node_login -.->|"signals login"| node_app
node_app -->|"renders"| node_dashboard
node_dashboard -->|"renders overview"| node_overview
node_staff -->|"manages records"| node_dashboard
node_dashboard -->|"opens editor"| node_tenantform
node_dashboard -->|"shows details"| node_detail
node_dashboard -->|"paginates results"| node_pagination
node_tenantform -->|"normalizes and validates"| node_validation
node_excel -->|"normalizes rows"| node_validation
node_tenantform -->|"edits records"| node_tenant
node_app -->|"loads and mutates"| node_database_api
node_database_api -->|"invokes commands"| node_tauri
node_tauri -->|"persists tenants"| node_sqlite
node_dashboard -->|"parses and plans"| node_excel
node_dashboard -->|"presents preview"| node_preview
node_preview -->|"confirms mode"| node_dashboard
node_app -->|"applies import plan"| node_excel
node_app -->|"replaces imported rows"| node_database_api
node_staff -->|"exports workbook"| node_export
node_export -->|"reads tenant data"| node_sqlite
node_staff -.->|"backs up or restores"| node_backup
node_app -->|"checks periodically"| node_updater
node_updater -.->|"checks signed releases"| node_github
node_staff -->|"installs update"| node_updater

click node_app "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/App.tsx"
click node_login "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/LoginPage.tsx"
click node_auth "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/auth.ts"
click node_dashboard "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/pages/DashboardPage.tsx"
click node_overview "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/pages/DashboardOverview.tsx"
click node_tenantform "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/TenantFormModal.tsx"
click node_detail "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/TenantDetailModal.tsx"
click node_pagination "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/Pagination.tsx"
click node_tenant "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/types/tenant.ts"
click node_validation "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/tenantValidation.ts"
click node_preview "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/ImportPreviewModal.tsx"
click node_excel "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/excelImport.ts"
click node_database_api "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/tenantDatabase.ts"
click node_sqlite "https://github.com/karuki00/tenant-hub-oasis/blob/main/src-tauri/src/lib.rs"
click node_export "https://github.com/karuki00/tenant-hub-oasis/blob/main/src-tauri/src/lib.rs"
click node_backup "https://github.com/karuki00/tenant-hub-oasis/tree/main/src"
click node_updater "https://github.com/karuki00/tenant-hub-oasis/blob/main/src/updater.ts"
click node_tauri "https://github.com/karuki00/tenant-hub-oasis/blob/main/src-tauri/src/main.rs"

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_app,node_login,node_auth,node_overview toneBlue
class node_dashboard,node_tenantform,node_detail,node_pagination,node_tenant,node_validation toneAmber
class node_preview,node_excel toneMint
class node_database_api,node_sqlite,node_export,node_backup,node_tauri toneRose
class node_updater,node_github,node_staff toneIndigo
```

## Components

### Access & Dashboard

- [App coordinator](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/App.tsx): `src/App.tsx`
- [Login & recovery](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/LoginPage.tsx): `src/components/LoginPage.tsx`
- [Authentication commands](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/auth.ts): `src/services/auth.ts`
- [Dashboard overview](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/pages/DashboardOverview.tsx): `src/pages/DashboardOverview.tsx`

### Tenant Directory

- [Dashboard & directory UI](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/pages/DashboardPage.tsx): `src/pages/DashboardPage.tsx`
- [Tenant editor](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/TenantFormModal.tsx): `src/components/TenantFormModal.tsx`
- [Tenant detail](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/TenantDetailModal.tsx): `src/components/TenantDetailModal.tsx`
- [Directory pagination](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/Pagination.tsx): `src/components/Pagination.tsx`
- [Tenant record model](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/types/tenant.ts): `src/types/tenant.ts`
- [Tenant validation](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/tenantValidation.ts): `src/services/tenantValidation.ts`

### Excel Import

- [Import preview](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/components/ImportPreviewModal.tsx): `src/components/ImportPreviewModal.tsx`
- [Excel import planning](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/excelImport.ts): `src/services/excelImport.ts`

### Local Data

- [Tenant database API](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/services/tenantDatabase.ts): `src/services/tenantDatabase.ts`
- [SQLite backend](https://github.com/karuki00/tenant-hub-oasis/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [XLSX export & save](https://github.com/karuki00/tenant-hub-oasis/blob/main/src-tauri/src/lib.rs): `src-tauri/src/lib.rs`
- [JSON backup & restore](https://github.com/karuki00/tenant-hub-oasis/tree/main/src): `src`
- [Tauri runtime](https://github.com/karuki00/tenant-hub-oasis/blob/main/src-tauri/src/main.rs): `src-tauri/src/main.rs`

### Updates

- [Update checker](https://github.com/karuki00/tenant-hub-oasis/blob/main/src/updater.ts): `src/updater.ts`
- **GitHub updates**

### Other components

- **Tenant Relation staff**

## Connections

- Tenant Relation staff → Login & recovery: signs in (evidence: `README.md`)
- Login & recovery → Authentication commands: requests auth (evidence: `src/components/LoginPage.tsx`)
- Authentication commands → Tauri runtime: invokes commands (evidence: `src/services/auth.ts`)
- Login & recovery → App coordinator: signals login (evidence: `src/App.tsx`)
- App coordinator → Dashboard & directory UI: renders (evidence: `src/App.tsx`)
- Dashboard & directory UI → Dashboard overview: renders overview (evidence: `src/pages/DashboardPage.tsx`)
- Tenant Relation staff → Dashboard & directory UI: manages records (evidence: `README.md`)
- Dashboard & directory UI → Tenant editor: opens editor (evidence: `src/pages/DashboardPage.tsx`)
- Dashboard & directory UI → Tenant detail: shows details (evidence: `src/pages/DashboardPage.tsx`)
- Dashboard & directory UI → Directory pagination: paginates results (evidence: `src/pages/DashboardPage.tsx`)
- Tenant editor → Tenant validation: normalizes and validates (evidence: `src/components/TenantFormModal.tsx`)
- Excel import planning → Tenant validation: normalizes rows (evidence: `src/services/excelImport.ts`)
- Tenant editor → Tenant record model: edits records (evidence: `src/components/TenantFormModal.tsx`)
- App coordinator → Tenant database API: loads and mutates (evidence: `src/App.tsx`)
- Tenant database API → Tauri runtime: invokes commands (evidence: `src/services/tenantDatabase.ts`)
- Tauri runtime → SQLite backend: persists tenants (evidence: `README.md`)
- Dashboard & directory UI → Excel import planning: parses and plans (evidence: `src/pages/DashboardPage.tsx`)
- Dashboard & directory UI → Import preview: presents preview (evidence: `src/pages/DashboardPage.tsx`)
- Import preview → Dashboard & directory UI: confirms mode (evidence: `src/components/ImportPreviewModal.tsx`)
- App coordinator → Excel import planning: applies import plan (evidence: `src/App.tsx`)
- App coordinator → Tenant database API: replaces imported rows (evidence: `src/App.tsx`)
- Tenant Relation staff → XLSX export & save: exports workbook (evidence: `README.md`)
- XLSX export & save → SQLite backend: reads tenant data (evidence: `README.md`)
- Tenant Relation staff → JSON backup & restore: backs up or restores
- App coordinator → Update checker: checks periodically (evidence: `src/App.tsx`)
- Update checker → GitHub updates: checks signed releases (evidence: `README.md`)
- Tenant Relation staff → Update checker: installs update
