How adm1n1strat0r-mam/techdesk-360 works
ITserve is an IT support and asset-management application. Users sign in, then work through dashboard, lab-case, inventory, branch, and user/device-record screens; the React app coordinates page state and API calls, while the Express API routes requests to controllers and MongoDB models. The README also documents vendor coordination, warranty tracking, branch visits, and hardware disposal, though their implementation details are not shown in the supplied excerpts. Edges are limited to excerpted calls, indexed references, or README statements; unsampled wiring is omitted.
Main entry points: App.jsx App coordinator · authenticate.middleware.js Authentication and permissions · app.js HTTP application · user.js User records
Components 31
Client application
- App coordinator
client/src/App.jsx - Auth context
client/src/auth-context.jsx - API client
client/src/api.js - Inventory screens
client/src/pages/InventoryManagementPage.jsx - Branch screens
client/src/pages/BranchManagementPages.jsx - Lab workflows
client/src/pages/LabWorkflowPages.jsx - User and ID screens
client/src/pages/IdWorkflowPages.jsx - Dashboard and lab overview
client/src/pages/DashboardPage.jsx - Account screens
client/src/pages/AccountPages.jsx
API and access control
- HTTP application
server/src/app.js - Authentication routes
server/src/routes/auth.routes.js - User routes
server/src/routes/user.routes.js - Branch routes
server/src/routes/branch.routes.js - Inventory routes
server/src/routes/inventory.routes.js - Lab-case routes
server/src/routes/labCase.routes.js - Authentication and permissions
server/src/middleware/authenticate.middleware.js - Sign-in handling
server/src/controllers/auth.controller.js
Operations domains
- User administration
server/src/controllers/user.controller.js - Branch management
server/src/controllers/branch.controller.js - Inventory import
server/src/controllers/inventory.controller.js - Inventory parsing and summary
server/src/services/inventory.service.js - Lab case lifecycle
server/src/controllers/labCase.controller.js - Role administration
server/src/controllers/role.controller.js
Persistence
- User records
server/src/models/user.js - Branch records
server/src/models/Branch.js - Inventory records
server/src/models/InventoryRecord.js - Lab cases
server/src/models/LabCase.js - Case counters
server/src/models/Counter.js - Role records
server/src/models/Role.js
Other components
- Staff user
- MongoDB
Connections 36
- Staff user → App coordinator: uses
- App coordinator → Auth context: provides auth
client/src/App.jsx - App coordinator → API client: calls
client/src/App.jsx - App coordinator → Inventory screens: renders
client/src/App.jsx - App coordinator → Branch screens: renders
client/src/App.jsx - App coordinator → Lab workflows: renders
client/src/App.jsx - App coordinator → User and ID screens: renders
client/src/App.jsx - App coordinator → Dashboard and lab overview: renders
client/src/App.jsx - App coordinator → Account screens: renders
client/src/App.jsx - HTTP application → Authentication routes: mounts
server/src/app.js - HTTP application → User routes: mounts
server/src/app.js - HTTP application → Branch routes: mounts
server/src/app.js - HTTP application → Inventory routes: mounts
server/src/app.js - HTTP application → Lab-case routes: mounts
server/src/app.js - Authentication routes → Sign-in handling: dispatches
server/src/routes/auth.routes.js - User routes → User administration: dispatches
server/src/routes/user.routes.js - Branch routes → Branch management: dispatches
server/src/controllers/branch.controller.js - Inventory routes → Inventory import: dispatches
server/src/routes/inventory.routes.js - Lab-case routes → Lab case lifecycle: dispatches
server/src/routes/labCase.routes.js - User routes → Authentication and permissions: authenticates and checks
server/src/routes/user.routes.js - Branch routes → Authentication and permissions: authenticates and checks
server/src/routes/branch.routes.js - Inventory routes → Authentication and permissions: authenticates and checks
server/src/routes/inventory.routes.js - Lab-case routes → Authentication and permissions: authenticates and checks
server/src/routes/labCase.routes.js - Sign-in handling → User records: reads and updates
server/src/controllers/auth.controller.js - Authentication and permissions → User records: checks account
server/src/middleware/authenticate.middleware.js - Authentication and permissions → Role records: checks permissions
- Branch management → Branch records: reads and writes
server/src/controllers/branch.controller.js - Inventory import → Inventory parsing and summary: delegates to
server/src/controllers/inventory.controller.js - Inventory parsing and summary → Inventory records: reads and writes
server/src/services/inventory.service.js - Lab case lifecycle → Lab cases: reads and writes
server/src/controllers/labCase.controller.js - Lab case lifecycle → Case counters: increments
server/src/controllers/labCase.controller.js - User administration → User records: manages
server/src/controllers/user.controller.js - Role administration → Role records: manages
server/src/controllers/role.controller.js - Role administration → User records: updates assignments
server/src/controllers/role.controller.js - Inventory screens → API client: imports and submits
client/src/pages/InventoryManagementPage.jsx - Inventory screens → MongoDB: imports into
README.md