How aiannyyyy/nscsl-dashboard works
NSCSL Modern Dashboard is a multi-domain operational dashboard with React/TypeScript views and an Express API backed by MySQL and Oracle. Users sign in, enter protected dashboard routes, and use domain tools such as laboratory and PDO reporting, follow-up, intranet file management, chat, and IT job orders. The IT job-order workflow includes requests, approvals, queueing, assignment, and resolution. The graph highlights that workflow and documented product areas; unsampled service and route wiring is omitted where the evidence does not establish a connection.
Main entry points: App.tsx Route shell · database.js Database pools · server.js Express server · AuthContext.tsx Auth state
Components 22
Dashboard UI
- Route shell
frontend/src/App.tsx - Auth state
frontend/src/context/AuthContext.tsx - Job order manager
frontend/src/components/GlobalJobOrderManager.tsx - Job order hooks
frontend/src/hooks/ITHooks/useJobOrderHooks.ts - Job order API client
frontend/src/services/ITServices/itJobOrderService.ts - PDO reporting
frontend/src/pages/pdo - Laboratory reporting
frontend/src/pages/laboratory - Follow-up tools
frontend/src/pages/followup - Intranet files
frontend/src/pages/intranet
API Runtime
- Express server
backend/server.js - Job-order routes
backend/routes/ITRoutes/itJobOrderRoutes.js - PDO routes
backend/routes/PDORoutes - Laboratory routes
backend/routes/LaboratoryRoutes - Follow-up routes
backend/routes/FollowupRoutes
Operational Workflows
- Job-order workflow
backend/controllers/ITController/itJobOrderController.js - Chat messaging
backend/controllers/ChatController/chatController.js - NSF facilities
backend/controllers/PDOController/nsfFacilitiesController.js
Data And Files
- File management
backend/controllers/IntranetController/fileController.js
Shared Services
- Request authentication
backend/middleware/authMiddleware.js - Database pools
backend/config/database.js - Authentication API client
frontend/src/services/authService.ts
Other components
- Dashboard user
Connections 20
- Dashboard user → Route shell: opens dashboard
- Route shell → Auth state: provides auth
frontend/src/App.tsx - Route shell → PDO reporting: routes to
frontend/src/App.tsx - Route shell → Laboratory reporting: routes to
frontend/src/App.tsx - Route shell → Follow-up tools: routes to
frontend/src/App.tsx - Route shell → Job order manager: routes to
frontend/src/App.tsx - Auth state → Authentication API client: calls
frontend/src/context/AuthContext.tsx - Job order manager → Job order hooks: uses
frontend/src/components/GlobalJobOrderManager.tsx - Job order hooks → Job order API client: calls
frontend/src/hooks/ITHooks/useJobOrderHooks.ts - Express server → Job-order routes: mounts
backend/server.js - Job-order routes → Job-order workflow: dispatches
backend/routes/ITRoutes/itJobOrderRoutes.js - Job-order workflow → Database pools: queries
backend/controllers/ITController/itJobOrderController.js - Express server → PDO routes: mounts
backend/server.js - PDO routes → NSF facilities: dispatches
backend/routes/PDORoutes/nsfFacilitiesRoutes.js - NSF facilities → Database pools: queries
backend/controllers/PDOController/nsfFacilitiesController.js - Express server → Laboratory routes: mounts
backend/server.js - Express server → Follow-up routes: mounts
backend/server.js - Chat messaging → Database pools: queries
backend/controllers/ChatController/chatController.js - File management → Database pools: queries
backend/controllers/IntranetController/fileController.js - Request authentication → Database pools: loads user
backend/middleware/authMiddleware.js