How untangled-it-solutions/untangled-nexus-api works
Untangled Nexus API is a FastAPI backend for employee operations, product inventory, and quote/order tracking. Desktop clients call its route groups; session authentication resolves users and employees, while operational endpoints read or update shared MongoDB data. The main documented workflow spans login, attendance and task management, notifications, and dashboard summaries; commerce endpoints expose products and process orders. Core route modules are represented, including documented capabilities whose source excerpts were not provided. Relationships involving those unsampled modules are limited to documented registration or are left out.
Main entry points: main.py FastAPI application · security.py Session security · dashboard.py Dashboard summary · products.py Products and stock
Components 16
API entry
- FastAPI application
app/main.py - Health checks
app/routers/health.py - Runtime settings
app/config.py
Identity and access
- Login and sessions
app/routers/auth.py - Session security
app/security.py
Workforce operations
- Attendance
app/routers/attendance.py - Dashboard summary
app/routers/dashboard.py - Tasks
app/routers/tasks.py - Notifications
app/routers/notifications.py - Approvals
app/routers/approvals.py - Employee records
app/routers/employees.py
Commerce
- Products and stock
app/routers/products.py - Quotes and orders
app/routers/quotes.py
Persistence
- MongoDB
- Database lifecycle
app/db.py
Other components
- Desktop client
Connections 32
- Desktop client → FastAPI application: sends requests
- FastAPI application → Health checks: registers routes
app/main.py - FastAPI application → Login and sessions: registers routes
app/main.py - FastAPI application → Dashboard summary: registers routes
app/main.py - FastAPI application → Attendance: registers routes
app/main.py - FastAPI application → Notifications: registers routes
app/main.py - FastAPI application → Tasks: registers routes
app/main.py - FastAPI application → Approvals: registers routes
app/main.py - FastAPI application → Quotes and orders: registers routes
app/main.py - FastAPI application → Employee records: registers routes
app/main.py - FastAPI application → Products and stock: registers routes
app/main.py - FastAPI application → Runtime settings: loads settings
app/main.py - FastAPI application → Database lifecycle: opens and closes
app/main.py - Database lifecycle → Runtime settings: reads configuration
app/db.py - Database lifecycle → MongoDB: connects client
app/db.py - Health checks → MongoDB: checks readiness
- Login and sessions → MongoDB: reads users; writes sessions
app/routers/auth.py - Login and sessions → Session security: verifies credentials
app/security.py - Session security → MongoDB: validates sessions
app/security.py - Attendance → Session security: requires session
app/routers/attendance.py - Attendance → MongoDB: reads and updates records
app/routers/attendance.py - Dashboard summary → Session security: requires session
app/routers/dashboard.py - Dashboard summary → MongoDB: queries workforce data
app/routers/dashboard.py - Dashboard summary → Runtime settings: reads cache setting
app/routers/dashboard.py - Tasks → Session security: requires session
app/routers/tasks.py - Tasks → MongoDB: manages assignments
app/routers/tasks.py - Notifications → Session security: requires session
app/routers/notifications.py - Notifications → MongoDB: manages notifications
app/routers/notifications.py - Products and stock → Session security: requires session
app/routers/products.py - Products and stock → MongoDB: manages inventory
app/routers/products.py - Quotes and orders → MongoDB: reads and writes orders
app/routers/quotes.py - Quotes and orders → Products and stock: decrements stock
app/routers/quotes.py