How aiannyyyy/nscsl-modern-dashboard works
NSCSL Modern Dashboard is an internal newborn-screening operations app spanning PDO programs, laboratory workflows, follow-up, administration, intranet files, IT job orders, and staff chat. Staff enter through the React dashboard; domain screens use hooks and services to call Express APIs, whose routes and controllers access MySQL and, for source screening data, read-only Oracle. The map emphasizes these documented request stages and major product areas. Some subsystems were not sampled at source level, so their internal links reflect README documentation rather than inspected implementations.
Main entry points: pages Domain screens · controllers Domain controllers · App.tsx React app · routes Domain routes
Components 18
Web client
- React app
frontend/src/App.tsx - Authentication
frontend/src/context/AuthContext.tsx - Domain screens
frontend/src/pages - Hooks and services
frontend/src/hooks
Screening operations
- PDO workflows
frontend/src/pages/pdo - Laboratory workflows
frontend/src/pages/laboratory - Follow-up workflows
frontend/src/pages/followup - Admin workflows
frontend/src/pages/admin
Staff collaboration
- File management
frontend/src/pages/intranet - IT job orders
frontend/src/pages/it-job-order - Staff chat
frontend/src/pages/chat
API and domain logic
- Express API
backend/server.js - JWT middleware
backend/middleware/authMiddleware.js - Domain routes
backend/routes - Domain controllers
backend/controllers
Persistence
- MySQL stores
backend/config/database.js - Oracle screening source
backend/config/database.js
Other components
- Staff member
Connections 18
- Staff member → React app: uses
README.md - React app → Authentication: provides auth
frontend/src/App.tsx - React app → Domain screens: routes to
frontend/src/App.tsx - Domain screens → Hooks and services: loads data
README.md - Hooks and services → Express API: calls API
README.md - Express API → Domain routes: mounts routes
backend/server.js - Domain routes → JWT middleware: guards requests
backend/routes/AdminRoutes/adminInventoryRoutes.js - Domain routes → Domain controllers: dispatches
backend/routes/AdminRoutes/adminInventoryRoutes.js - Domain controllers → MySQL stores: reads and writes
backend/controllers/AdminController/adminInventoryController.js - Domain controllers → Oracle screening source: reads source data
README.md - Domain screens → PDO workflows: includes
frontend/src/App.tsx - Domain screens → Laboratory workflows: includes
frontend/src/App.tsx - Domain screens → Follow-up workflows: includes
frontend/src/App.tsx - Domain screens → Admin workflows: includes
frontend/src/App.tsx - Domain screens → File management: includes
README.md - Domain screens → IT job orders: includes
frontend/src/App.tsx - Domain screens → Staff chat: includes
README.md - Domain controllers → Staff chat: broadcasts updates
backend/controllers/ChatController/chatController.js