How untangled-it-solutions/-untangled-it-solution-smart-it works
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: application.py Application bootstrap · backend_api_client.py HTTP API client · work_service.py Tasks and work · task_controller.py Task controller
Components 22
Desktop client
- Application bootstrap
App/app/application.py - Login and navigation
App/app/controllers/app_controller.py - Workspace navigation
App/app/controllers/navigation_controller.py - Workspace views
App/app/views - Attendance view
App/app/views/attendance_view.py
Workplace features
- Authentication service
App/app/services/auth_service.py - Backend authentication
App/app/services/backend_auth_service.py - People service
App/app/services/people_service.py - Dashboard service
App/app/services/dashboard_service.py - Attendance services
App/app/services/attendance_service.py - Tasks and work
App/app/services/work_service.py - Other feature services
App/app/services - Task controller
App/app/controllers/task_controller.py - Domain models
App/app/models
Backend API
- HTTP API client
App/app/services/backend_api_client.py - FastAPI application
App/app/main.py - API routers
App/app/routers - API security
App/app/security.py - MongoDB connection
App/app/db.py
Shared runtime
- UI background tasks
App/app/utils/async_tasks.py - Theme preferences
App/app/utils/theme.py
Other components
- Employee
Connections 29
- Employee → Application bootstrap: starts client
- Application bootstrap → HTTP API client: creates client
App/app/application.py - Application bootstrap → Authentication service: creates service
App/app/application.py - Application bootstrap → Backend authentication: creates service
App/app/application.py - Application bootstrap → People service: creates service
App/app/application.py - Application bootstrap → Dashboard service: creates service
App/app/application.py - Application bootstrap → Attendance services: creates service
App/app/application.py - Application bootstrap → Tasks and work: creates service
App/app/application.py - Application bootstrap → Login and navigation: starts lifecycle
App/app/application.py - Login and navigation → Workspace navigation: routes workspace
App/app/controllers/app_controller.py - Workspace navigation → Workspace views: selects views
App/app/controllers/navigation_controller.py - Login and navigation → Attendance view: creates attendance view
App/app/controllers/app_controller.py - Authentication service → Backend authentication: delegates login
App/app/services/auth_service.py - Backend authentication → HTTP API client: requests login
App/app/services/backend_auth_service.py - Attendance view → UI background tasks: dispatches work
App/app/views/attendance_view.py - Attendance view → Attendance services: uses service
App/app/views/attendance_view.py - Task controller → Tasks and work: uses service
App/app/controllers/task_controller.py - Task controller → People service: loads people
App/app/controllers/task_controller.py - Task controller → Domain models: uses task models
App/app/controllers/task_controller.py - Tasks and work → Domain models: uses task model
App/app/services/work_service.py - People service → HTTP API client: requests employees
App/app/services/people_service.py - Attendance services → HTTP API client: uses API client
App/app/services/attendance_service.py - Dashboard service → HTTP API client: uses API client
App/app/services/dashboard_service.py - Tasks and work → HTTP API client: uses API client
App/app/services/work_service.py - HTTP API client → FastAPI application: calls backend API
- FastAPI application → API routers: registers routers
App/app/main.py - FastAPI application → MongoDB connection: connects database
App/app/main.py - API routers → API security: auth router imports
App/app/routers/auth.py - API security → MongoDB connection: uses connection
App/app/security.py