# hamzaqanazi/monitorflow architecture

> Architecture diagram of the GitHub repository hamzaqanazi/monitorflow, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/hamzaqanazi/monitorflow
- Repository: https://github.com/hamzaqanazi/monitorflow

## Overview

MonitorFlow is a workforce operations and service-request platform, with a React oversight console and an Express API. Its central workflow is configuring services and their forms/workflows, receiving and assigning requests, then progressing employee tasks through gated status transitions; dashboards, reports, and audit records support oversight. The tree also shows scheduling, time clock, onboarding, knowledge, events, evaluations, and chatbot capabilities. The README is empty and sampled code is partial, so some feature links are omitted where call ownership is not evidenced.

Main entry points: [`backend/src/index.js`](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/index.js) (API application), [`backend/src/db.js`](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/db.js) (Application database), [`web/src/main.tsx`](https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/main.tsx) (Console routing), [`web/src/lib/api.ts`](https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/lib/api.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Web console"]
  node_webapp["Console routing<br/>[main.tsx]"]
  node_authui["Console session<br/>[AuthContext.tsx]"]
  node_serviceui["Service builder"]
  node_servicepage["Service management<br/>[ServicesPage.tsx]"]
  node_frontendapi["API client<br/>[api.ts]"]
end

subgraph group_api["API and access"]
  node_server["API application<br/>[index.js]"]
  node_authmw["Authentication gates<br/>[auth.js]"]
end

subgraph group_operations["Request operations"]
  node_services["Service configuration<br/>[services.js]"]
  node_requests["Request handling<br/>[requests.js]"]
  node_tasks["Employee tasks<br/>[tasks.js]"]
  node_workflow["Transition engine<br/>[workflowEngine.js]"]
  node_query["Request filtering<br/>[requestQuery.js]"]
  node_dashboard["Dashboard metrics<br/>[dashboard.js]"]
  node_reports["Reports and exports<br/>[reports.js]"]
end

subgraph group_workforce["Workforce modules"]
  node_employees["Employee directory<br/>[employees.js]"]
  node_schedule["Scheduling<br/>[schedule.js]"]
  node_timeclock["Time clock<br/>[timeclock.js]"]
  node_onboarding["Company onboarding<br/>[onboarding.js]"]
  node_knowledge["Knowledge base<br/>[knowledgeBase.js]"]
  node_events["Events and evaluations<br/>[events.js]"]
  node_chatbot["Chatbot service<br/>[chatbot.js]"]
end

subgraph group_platform["Shared platform"]
  node_db[("Application database<br/>[db.js]")]
  node_schema["Workflow and form rules<br/>[workflowSchema.js]"]
  node_audit["Operational audit<br/>[audit.js]"]
end

node_operator(("Staff and admins"))

node_operator -->|"uses console"| node_webapp
node_webapp -->|"provides session"| node_authui
node_webapp -->|"routes to"| node_servicepage
node_webapp -->|"routes to"| node_serviceui
node_authui -->|"requests session"| node_frontendapi
node_servicepage -->|"calls API"| node_frontendapi
node_serviceui -->|"submits config"| node_frontendapi
node_frontendapi -->|"sends API requests"| node_server
node_server -->|"guards routes"| node_authmw
node_server -->|"dispatches"| node_services
node_server -->|"dispatches"| node_requests
node_server -->|"dispatches"| node_tasks
node_server -->|"dispatches"| node_dashboard
node_server -->|"dispatches"| node_reports
node_server -->|"dispatches"| node_schedule
node_server -->|"dispatches"| node_timeclock
node_server -->|"dispatches"| node_onboarding
node_server -->|"dispatches"| node_knowledge
node_server -->|"dispatches"| node_events
node_server -->|"dispatches"| node_chatbot
node_services -->|"reads and writes"| node_db
node_services -->|"validates config"| node_schema
node_requests -->|"executes transitions"| node_workflow
node_requests -->|"builds list filters"| node_query
node_tasks -->|"reads tasks"| node_db
node_workflow -->|"updates state"| node_db
node_workflow -->|"records transitions"| node_audit
node_authmw -->|"loads account"| node_db
node_dashboard -->|"queries metrics"| node_db
node_reports -->|"shares filtering"| node_query

click node_webapp "https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/main.tsx"
click node_authui "https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/auth/AuthContext.tsx"
click node_serviceui "https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/pages/AddServiceWizard.tsx"
click node_servicepage "https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/pages/ServicesPage.tsx"
click node_frontendapi "https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/lib/api.ts"
click node_server "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/index.js"
click node_authmw "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/middleware/auth.js"
click node_services "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/services.js"
click node_requests "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/requests.js"
click node_tasks "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/tasks.js"
click node_workflow "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/workflowEngine.js"
click node_query "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/requestQuery.js"
click node_dashboard "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/dashboard.js"
click node_reports "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/reports.js"
click node_employees "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/employees.js"
click node_schedule "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/schedule.js"
click node_timeclock "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/timeclock.js"
click node_onboarding "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/onboarding.js"
click node_knowledge "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/knowledgeBase.js"
click node_events "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/events.js"
click node_chatbot "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/chatbot.js"
click node_db "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/db.js"
click node_schema "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/workflowSchema.js"
click node_audit "https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/audit.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_authui,node_serviceui,node_servicepage,node_frontendapi toneBlue
class node_server,node_authmw toneAmber
class node_services,node_requests,node_tasks,node_workflow,node_query,node_dashboard,node_reports toneMint
class node_employees,node_schedule,node_timeclock,node_onboarding,node_knowledge,node_events,node_chatbot toneRose
class node_db,node_schema,node_audit,node_operator toneIndigo
```

## Components

### Web console

- [Console routing](https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/main.tsx): `web/src/main.tsx`
- [Console session](https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/auth/AuthContext.tsx): `web/src/auth/AuthContext.tsx`
- [Service builder](https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/pages/AddServiceWizard.tsx): `web/src/pages/AddServiceWizard.tsx`
- [Service management](https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/pages/ServicesPage.tsx): `web/src/pages/ServicesPage.tsx`
- [API client](https://github.com/hamzaqanazi/monitorflow/blob/main/web/src/lib/api.ts): `web/src/lib/api.ts`

### API and access

- [API application](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/index.js): `backend/src/index.js`
- [Authentication gates](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`

### Request operations

- [Service configuration](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/services.js): `backend/src/routes/services.js`
- [Request handling](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/requests.js): `backend/src/routes/requests.js`
- [Employee tasks](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/tasks.js): `backend/src/routes/tasks.js`
- [Transition engine](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/workflowEngine.js): `backend/src/lib/workflowEngine.js`
- [Request filtering](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/requestQuery.js): `backend/src/lib/requestQuery.js`
- [Dashboard metrics](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/dashboard.js): `backend/src/routes/dashboard.js`
- [Reports and exports](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/reports.js): `backend/src/routes/reports.js`

### Workforce modules

- [Employee directory](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/employees.js): `backend/src/routes/employees.js`
- [Scheduling](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/schedule.js): `backend/src/routes/schedule.js`
- [Time clock](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/timeclock.js): `backend/src/routes/timeclock.js`
- [Company onboarding](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/onboarding.js): `backend/src/routes/onboarding.js`
- [Knowledge base](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/knowledgeBase.js): `backend/src/routes/knowledgeBase.js`
- [Events and evaluations](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/events.js): `backend/src/routes/events.js`
- [Chatbot service](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/routes/chatbot.js): `backend/src/routes/chatbot.js`

### Shared platform

- [Application database](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/db.js): `backend/src/db.js`
- [Workflow and form rules](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/workflowSchema.js): `backend/src/lib/workflowSchema.js`
- [Operational audit](https://github.com/hamzaqanazi/monitorflow/blob/main/backend/src/lib/audit.js): `backend/src/lib/audit.js`

### Other components

- **Staff and admins**

## Connections

- Staff and admins → Console routing: uses console
- Console routing → Console session: provides session
- Console routing → Service management: routes to
- Console routing → Service builder: routes to
- Console session → API client: requests session
- Service management → API client: calls API
- Service builder → API client: submits config
- API client → API application: sends API requests
- API application → Authentication gates: guards routes
- API application → Service configuration: dispatches
- API application → Request handling: dispatches
- API application → Employee tasks: dispatches
- API application → Dashboard metrics: dispatches
- API application → Reports and exports: dispatches
- API application → Scheduling: dispatches
- API application → Time clock: dispatches
- API application → Company onboarding: dispatches
- API application → Knowledge base: dispatches
- API application → Events and evaluations: dispatches
- API application → Chatbot service: dispatches
- Service configuration → Application database: reads and writes
- Service configuration → Workflow and form rules: validates config
- Request handling → Transition engine: executes transitions
- Request handling → Request filtering: builds list filters
- Employee tasks → Application database: reads tasks
- Transition engine → Application database: updates state
- Transition engine → Operational audit: records transitions
- Authentication gates → Application database: loads account
- Dashboard metrics → Application database: queries metrics
- Reports and exports → Request filtering: shares filtering