How danilo20gonzalez/iot-lab-system works
LabControl Pro is a web application for managing laboratories, projects, work areas, users, sensors, and connected devices. Users sign in and navigate protected management and monitoring screens; the frontend calls an API and can receive Home Assistant state updates over WebSocket. The backend provides authentication and domain controllers backed by MySQL, with separate Home Assistant services. Several backend route/controller and integration files were not sampled, so those connections are shown only where the index or excerpts support them.
Main entry points: App.tsx App routing · index.ts Express API · api.ts HTTP client · Sensors.tsx Sensors
Components 24
Web application
- App routing
frontend/src/App.tsx - Session context
frontend/src/context/AppContext.tsx - Login
frontend/src/pages/Login.tsx - Dashboard
frontend/src/pages/Dashboard.tsx - Lab management
frontend/src/pages/LaboratoriesManagement.tsx - Laboratory view
frontend/src/pages/Laboratory.tsx - Projects
frontend/src/pages/Projects.tsx - Sensors
frontend/src/pages/Sensors.tsx - Device controls
frontend/src/components/deviceControl - Navigation
frontend/src/components/Navbar.tsx - HTTP client
frontend/src/api/api.ts - HA state hook
frontend/src/hooks/useHomeAssistant.ts
Backend API
- Express API
backend/src/index.ts - Authentication
backend/src/services/authService.ts - Token verification
backend/src/middlewares/authenticate.ts - Laboratory domain
backend/src/controllers/laboratorioController.ts - Project domain
backend/src/controllers/proyectosController.ts - Device domain
backend/src/controllers/deviceController.ts - HA endpoints
backend/src/controllers/homeAssistantController.ts
Persistence
- MySQL pool
backend/src/config/db.ts
Device integration
- Home Assistant service
backend/src/services/homeAssistantService.ts - HA WebSocket service
backend/src/services/haWebSocketService.ts
Other components
- User
- Home Assistant
Connections 37
- User → App routing: uses
frontend/src/App.tsx - App routing → Session context: provides context
frontend/src/App.tsx - App routing → Login: routes to
frontend/src/App.tsx - App routing → Dashboard: routes to
frontend/src/App.tsx - App routing → Lab management: routes to
frontend/src/App.tsx - App routing → Laboratory view: routes to
frontend/src/App.tsx - App routing → Projects: routes to
frontend/src/App.tsx - App routing → Sensors: routes to
frontend/src/App.tsx - Dashboard → Navigation: renders
frontend/src/pages/Dashboard.tsx - Lab management → Navigation: renders
frontend/src/pages/LaboratoriesManagement.tsx - Laboratory view → Navigation: renders
frontend/src/pages/Laboratory.tsx - Sensors → Navigation: renders
frontend/src/pages/Sensors.tsx - Sensors → Device controls: renders controls
frontend/src/pages/Sensors.tsx - Dashboard → HTTP client: requests data
frontend/src/pages/Dashboard.tsx - Lab management → HTTP client: requests data
frontend/src/pages/LaboratoriesManagement.tsx - Laboratory view → HTTP client: requests data
frontend/src/pages/Laboratory.tsx - Projects → HTTP client: requests data
frontend/src/pages/Projects.tsx - Sensors → HTTP client: requests HA data
frontend/src/pages/Sensors.tsx - Laboratory view → HA state hook: uses state hook
frontend/src/pages/Laboratory.tsx - Projects → HA state hook: uses state hook
frontend/src/pages/Projects.tsx - Sensors → HA state hook: uses state hook
frontend/src/pages/Sensors.tsx - HTTP client → Express API: HTTP requests
- Express API → Authentication: dispatches auth
- Express API → Laboratory domain: dispatches labs
- Express API → Project domain: dispatches projects
- Express API → Device domain: dispatches devices
- Authentication → MySQL pool: queries users
backend/src/services/authService.ts - Laboratory domain → MySQL pool: queries labs
backend/src/controllers/laboratorioController.ts - Project domain → MySQL pool: queries projects
backend/src/controllers/proyectosController.ts - Device domain → MySQL pool: queries devices
backend/src/controllers/deviceController.ts - Express API → Token verification: applies middleware
- Express API → HA endpoints: dispatches HA
- HA endpoints → Home Assistant service: delegates to
- HA endpoints → HA WebSocket service: uses WebSocket
- Home Assistant service → Home Assistant: controls devices
- HA WebSocket service → Home Assistant: exchanges state
- HA state hook → Home Assistant: receives live state