# untangled-it-solutions/-untangled-it-solution-smart-it architecture

> Architecture diagram of the GitHub repository untangled-it-solutions/-untangled-it-solution-smart-it, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/untangled-it-solutions/-untangled-it-solution-smart-it
- Repository: https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it

## Overview

Untangled Nexus combines a desktop workplace-management client with a FastAPI backend. The principal workflow is starting the client, authenticating a user, presenting the main workspace, and loading domain data through API-backed services; task assignment can trigger notifications. The backend exposes domain routers and connects to MongoDB. Several important areas (including calendar, approvals, notifications, projects, reports, and quotes) appear in the tree but were not sampled, so they are represented at subsystem level. Links are limited to relationships shown in excerpts or the source index.

Main entry points: [`App/app/application.py`](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/application.py) (Application bootstrap), [`App/app/services/backend_api_client.py`](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/backend_api_client.py) (HTTP API client), [`App/app/services/work_service.py`](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/work_service.py) (Tasks and work), [`App/app/controllers/task_controller.py`](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/controllers/task_controller.py) (Task controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Desktop client"]
  node_launch["Application bootstrap<br/>[application.py]"]
  node_appflow["Login and navigation<br/>[app_controller.py]"]
  node_navigation["Workspace navigation"]
  node_views["Workspace views"]
  node_attendance_view["Attendance view<br/>[attendance_view.py]"]
end

subgraph group_domain["Workplace features"]
  node_auth["Authentication service<br/>[auth_service.py]"]
  node_backend_auth["Backend authentication"]
  node_people["People service<br/>[people_service.py]"]
  node_dashboard["Dashboard service"]
  node_attendance["Attendance services"]
  node_work["Tasks and work<br/>[work_service.py]"]
  node_other_services["Other feature services"]
  node_task_controller["Task controller<br/>[task_controller.py]"]
  node_models["Domain models"]
end

subgraph group_backend["Backend API"]
  node_api_client["HTTP API client"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_routers["API routers"]
  node_security["API security<br/>[security.py]"]
  node_database[("MongoDB connection<br/>[db.py]")]
end

subgraph group_runtime["Shared runtime"]
  node_async_tasks["UI background tasks<br/>[async_tasks.py]"]
  node_theme["Theme preferences<br/>[theme.py]"]
end

node_user(("Employee"))

node_user -->|"starts client"| node_launch
node_launch -->|"creates client"| node_api_client
node_launch -->|"creates service"| node_auth
node_launch -->|"creates service"| node_backend_auth
node_launch -->|"creates service"| node_people
node_launch -->|"creates service"| node_dashboard
node_launch -->|"creates service"| node_attendance
node_launch -->|"creates service"| node_work
node_launch -->|"starts lifecycle"| node_appflow
node_appflow -->|"routes workspace"| node_navigation
node_navigation -->|"selects views"| node_views
node_appflow -->|"creates attendance view"| node_attendance_view
node_auth -->|"delegates login"| node_backend_auth
node_backend_auth -->|"requests login"| node_api_client
node_attendance_view -->|"dispatches work"| node_async_tasks
node_attendance_view -->|"uses service"| node_attendance
node_task_controller -->|"uses service"| node_work
node_task_controller -->|"loads people"| node_people
node_task_controller -->|"uses task models"| node_models
node_work -->|"uses task model"| node_models
node_people -->|"requests employees"| node_api_client
node_attendance -->|"uses API client"| node_api_client
node_dashboard -->|"uses API client"| node_api_client
node_work -->|"uses API client"| node_api_client
node_api_client -.->|"calls backend API"| node_api_app
node_api_app -->|"registers routers"| node_routers
node_api_app -->|"connects database"| node_database
node_routers -->|"auth router imports"| node_security
node_security -->|"uses connection"| node_database

click node_launch "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/application.py"
click node_appflow "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/controllers/app_controller.py"
click node_navigation "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/controllers/navigation_controller.py"
click node_views "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/views"
click node_attendance_view "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/views/attendance_view.py"
click node_auth "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/auth_service.py"
click node_backend_auth "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/backend_auth_service.py"
click node_people "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/people_service.py"
click node_dashboard "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/dashboard_service.py"
click node_attendance "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/attendance_service.py"
click node_work "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/work_service.py"
click node_other_services "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/services"
click node_task_controller "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/controllers/task_controller.py"
click node_models "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/models"
click node_api_client "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/backend_api_client.py"
click node_api_app "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/main.py"
click node_routers "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/routers"
click node_security "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/security.py"
click node_database "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/db.py"
click node_async_tasks "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/utils/async_tasks.py"
click node_theme "https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/utils/theme.py"

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_launch,node_appflow,node_navigation,node_views,node_attendance_view toneBlue
class node_auth,node_backend_auth,node_people,node_dashboard,node_attendance,node_work,node_other_services,node_task_controller,node_models toneAmber
class node_api_client,node_api_app,node_routers,node_security,node_database toneMint
class node_async_tasks,node_theme toneRose
class node_user toneIndigo
```

## Components

### Desktop client

- [Application bootstrap](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/application.py): `App/app/application.py`
- [Login and navigation](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/controllers/app_controller.py): `App/app/controllers/app_controller.py`
- [Workspace navigation](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/controllers/navigation_controller.py): `App/app/controllers/navigation_controller.py`
- [Workspace views](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/views): `App/app/views`
- [Attendance view](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/views/attendance_view.py): `App/app/views/attendance_view.py`

### Workplace features

- [Authentication service](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/auth_service.py): `App/app/services/auth_service.py`
- [Backend authentication](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/backend_auth_service.py): `App/app/services/backend_auth_service.py`
- [People service](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/people_service.py): `App/app/services/people_service.py`
- [Dashboard service](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/dashboard_service.py): `App/app/services/dashboard_service.py`
- [Attendance services](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/attendance_service.py): `App/app/services/attendance_service.py`
- [Tasks and work](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/work_service.py): `App/app/services/work_service.py`
- [Other feature services](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/services): `App/app/services`
- [Task controller](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/controllers/task_controller.py): `App/app/controllers/task_controller.py`
- [Domain models](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/models): `App/app/models`

### Backend API

- [HTTP API client](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/services/backend_api_client.py): `App/app/services/backend_api_client.py`
- [FastAPI application](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/main.py): `App/app/main.py`
- [API routers](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/tree/main/App/app/routers): `App/app/routers`
- [API security](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/security.py): `App/app/security.py`
- [MongoDB connection](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/db.py): `App/app/db.py`

### Shared runtime

- [UI background tasks](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/utils/async_tasks.py): `App/app/utils/async_tasks.py`
- [Theme preferences](https://github.com/untangled-it-solutions/-untangled-it-solution-smart-it/blob/main/App/app/utils/theme.py): `App/app/utils/theme.py`

### Other components

- **Employee**

## Connections

- Employee → Application bootstrap: starts client
- Application bootstrap → HTTP API client: creates client (evidence: `App/app/application.py`)
- Application bootstrap → Authentication service: creates service (evidence: `App/app/application.py`)
- Application bootstrap → Backend authentication: creates service (evidence: `App/app/application.py`)
- Application bootstrap → People service: creates service (evidence: `App/app/application.py`)
- Application bootstrap → Dashboard service: creates service (evidence: `App/app/application.py`)
- Application bootstrap → Attendance services: creates service (evidence: `App/app/application.py`)
- Application bootstrap → Tasks and work: creates service (evidence: `App/app/application.py`)
- Application bootstrap → Login and navigation: starts lifecycle (evidence: `App/app/application.py`)
- Login and navigation → Workspace navigation: routes workspace (evidence: `App/app/controllers/app_controller.py`)
- Workspace navigation → Workspace views: selects views (evidence: `App/app/controllers/navigation_controller.py`)
- Login and navigation → Attendance view: creates attendance view (evidence: `App/app/controllers/app_controller.py`)
- Authentication service → Backend authentication: delegates login (evidence: `App/app/services/auth_service.py`)
- Backend authentication → HTTP API client: requests login (evidence: `App/app/services/backend_auth_service.py`)
- Attendance view → UI background tasks: dispatches work (evidence: `App/app/views/attendance_view.py`)
- Attendance view → Attendance services: uses service (evidence: `App/app/views/attendance_view.py`)
- Task controller → Tasks and work: uses service (evidence: `App/app/controllers/task_controller.py`)
- Task controller → People service: loads people (evidence: `App/app/controllers/task_controller.py`)
- Task controller → Domain models: uses task models (evidence: `App/app/controllers/task_controller.py`)
- Tasks and work → Domain models: uses task model (evidence: `App/app/services/work_service.py`)
- People service → HTTP API client: requests employees (evidence: `App/app/services/people_service.py`)
- Attendance services → HTTP API client: uses API client (evidence: `App/app/services/attendance_service.py`)
- Dashboard service → HTTP API client: uses API client (evidence: `App/app/services/dashboard_service.py`)
- Tasks and work → HTTP API client: uses API client (evidence: `App/app/services/work_service.py`)
- HTTP API client → FastAPI application: calls backend API
- FastAPI application → API routers: registers routers (evidence: `App/app/main.py`)
- FastAPI application → MongoDB connection: connects database (evidence: `App/app/main.py`)
- API routers → API security: auth router imports (evidence: `App/app/routers/auth.py`)
- API security → MongoDB connection: uses connection (evidence: `App/app/security.py`)
