# ibubenok/safeworkhub architecture

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

- Interactive diagram: https://gitdiagram.com/ibubenok/safeworkhub
- Repository: https://github.com/ibubenok/safeworkhub

## Overview

SafeWorkHub is a corporate occupational-safety SaaS combining organization accounts and subscriptions with a knowledge base, LMS, checklist templates and inspection runs. Users enter through the React application or API; backend routes dispatch work to domain services, which use repositories and PostgreSQL. The frontend and backend responsibilities are shown separately, with major documented product areas retained. Edges follow sampled imports/calls or README statements; unsampled integrations are not asserted.

Main entry points: [`backend/app/api/v1/router.py`](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/router.py) (API v1 router), [`backend/app/db/repositories/__init__.py`](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/db/repositories/__init__.py) (Data repositories), [`backend/app/main.py`](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/main.py) (FastAPI runtime), [`backend/app/services/material_service.py`](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/material_service.py) (Knowledge base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_webapp["Web application<br/>[App.tsx]"]
  node_api_client["API client<br/>[client.ts]"]
end

subgraph group_api["API and runtime"]
  node_app_runtime["FastAPI runtime<br/>[main.py]"]
  node_api_router["API v1 router<br/>[router.py]"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_materials_api["Materials API<br/>[materials.py]"]
  node_checklists_api["Checklist API<br/>[checklists.py]"]
  node_runs_api["Inspection API<br/>[checklist_runs.py]"]
  node_courses_api["Courses API<br/>[courses.py]"]
  node_users_api["Users API<br/>[users.py]"]
  node_notifications_api["Notifications API<br/>[notifications.py]"]
end

subgraph group_domain["Product services"]
  node_auth_service["Auth and subscriptions<br/>[auth_service.py]"]
  node_materials_service["Knowledge base"]
  node_storage["File storage<br/>[file_storage.py]"]
  node_checklists_service["Checklist templates"]
  node_runs_service["Inspection runs"]
  node_courses_service["Learning courses<br/>[course_service.py]"]
  node_notifications_service["Notifications"]
  node_reminders["Deadline reminders"]
end

subgraph group_data["Persistence"]
  node_repositories["Data repositories<br/>[__init__.py]"]
  node_db_session["Database sessions<br/>[session.py]"]
  node_postgres[("PostgreSQL")]
  node_redis_service["Redis service<br/>[redis_service.py]"]
end

node_user(("User"))

node_user -->|"uses"| node_webapp
node_webapp -.->|"requests data"| node_api_client
node_api_client -.->|"calls API"| node_app_runtime
node_app_runtime -->|"mounts routes"| node_api_router
node_api_router -->|"routes"| node_auth_api
node_api_router -->|"routes"| node_materials_api
node_api_router -->|"routes"| node_checklists_api
node_api_router -->|"routes"| node_runs_api
node_api_router -->|"routes"| node_courses_api
node_api_router -->|"routes"| node_users_api
node_api_router -->|"routes"| node_notifications_api
node_auth_api -->|"delegates"| node_auth_service
node_materials_api -->|"delegates"| node_materials_service
node_checklists_api -->|"delegates"| node_checklists_service
node_runs_api -->|"delegates"| node_runs_service
node_courses_api -->|"delegates"| node_courses_service
node_materials_service -->|"stores files"| node_storage
node_auth_service -->|"uses repositories"| node_repositories
node_materials_service -->|"uses repositories"| node_repositories
node_runs_service -->|"uses repositories"| node_repositories
node_app_runtime -->|"starts task"| node_reminders
node_reminders -->|"sends reminders"| node_notifications_service
node_reminders -->|"uses Redis"| node_redis_service
node_db_session -->|"opens sessions"| node_postgres
node_repositories -.->|"uses sessions"| node_db_session

click node_webapp "https://github.com/ibubenok/safeworkhub/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/ibubenok/safeworkhub/blob/main/frontend/src/api/client.ts"
click node_app_runtime "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/main.py"
click node_api_router "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/router.py"
click node_auth_api "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/auth.py"
click node_materials_api "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/materials.py"
click node_checklists_api "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/checklists.py"
click node_runs_api "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/checklist_runs.py"
click node_courses_api "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/courses.py"
click node_users_api "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/users.py"
click node_notifications_api "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/notifications.py"
click node_auth_service "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/auth_service.py"
click node_materials_service "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/material_service.py"
click node_storage "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/file_storage.py"
click node_checklists_service "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/checklist_service.py"
click node_runs_service "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/checklist_run_service.py"
click node_courses_service "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/course_service.py"
click node_notifications_service "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/notification_service.py"
click node_reminders "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/tasks/deadline_reminders.py"
click node_repositories "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/db/repositories/__init__.py"
click node_db_session "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/db/session.py"
click node_redis_service "https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/redis_service.py"

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_api_client,node_user toneBlue
class node_app_runtime,node_api_router,node_auth_api,node_materials_api,node_checklists_api,node_runs_api,node_courses_api,node_users_api,node_notifications_api toneAmber
class node_auth_service,node_materials_service,node_storage,node_checklists_service,node_runs_service,node_courses_service,node_notifications_service,node_reminders toneMint
class node_repositories,node_db_session,node_postgres,node_redis_service toneRose
```

## Components

### Web application

- [Web application](https://github.com/ibubenok/safeworkhub/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API client](https://github.com/ibubenok/safeworkhub/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### API and runtime

- [FastAPI runtime](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/main.py): `backend/app/main.py`
- [API v1 router](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`
- [Authentication API](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/auth.py): `backend/app/api/v1/endpoints/auth.py`
- [Materials API](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/materials.py): `backend/app/api/v1/endpoints/materials.py`
- [Checklist API](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/checklists.py): `backend/app/api/v1/endpoints/checklists.py`
- [Inspection API](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/checklist_runs.py): `backend/app/api/v1/endpoints/checklist_runs.py`
- [Courses API](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/courses.py): `backend/app/api/v1/endpoints/courses.py`
- [Users API](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/users.py): `backend/app/api/v1/endpoints/users.py`
- [Notifications API](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/api/v1/endpoints/notifications.py): `backend/app/api/v1/endpoints/notifications.py`

### Product services

- [Auth and subscriptions](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Knowledge base](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/material_service.py): `backend/app/services/material_service.py`
- [File storage](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/file_storage.py): `backend/app/services/file_storage.py`
- [Checklist templates](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/checklist_service.py): `backend/app/services/checklist_service.py`
- [Inspection runs](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/checklist_run_service.py): `backend/app/services/checklist_run_service.py`
- [Learning courses](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/course_service.py): `backend/app/services/course_service.py`
- [Notifications](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/notification_service.py): `backend/app/services/notification_service.py`
- [Deadline reminders](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/tasks/deadline_reminders.py): `backend/app/tasks/deadline_reminders.py`

### Persistence

- [Data repositories](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/db/repositories/__init__.py): `backend/app/db/repositories/__init__.py`
- [Database sessions](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/db/session.py): `backend/app/db/session.py`
- **PostgreSQL**
- [Redis service](https://github.com/ibubenok/safeworkhub/blob/main/backend/app/services/redis_service.py): `backend/app/services/redis_service.py`

### Other components

- **User**

## Connections

- User → Web application: uses (evidence: `README.md`)
- Web application → API client: requests data
- API client → FastAPI runtime: calls API
- FastAPI runtime → API v1 router: mounts routes (evidence: `backend/app/main.py`)
- API v1 router → Authentication API: routes (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Materials API: routes (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Checklist API: routes (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Inspection API: routes (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Courses API: routes (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Users API: routes (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Notifications API: routes (evidence: `backend/app/api/v1/router.py`)
- Authentication API → Auth and subscriptions: delegates (evidence: `backend/app/api/v1/endpoints/auth.py`)
- Materials API → Knowledge base: delegates (evidence: `backend/app/api/v1/endpoints/materials.py`)
- Checklist API → Checklist templates: delegates (evidence: `backend/app/api/v1/endpoints/checklists.py`)
- Inspection API → Inspection runs: delegates (evidence: `backend/app/api/v1/endpoints/checklist_runs.py`)
- Courses API → Learning courses: delegates (evidence: `backend/app/api/v1/endpoints/courses.py`)
- Knowledge base → File storage: stores files (evidence: `backend/app/services/material_service.py`)
- Auth and subscriptions → Data repositories: uses repositories (evidence: `backend/app/services/auth_service.py`)
- Knowledge base → Data repositories: uses repositories (evidence: `backend/app/services/material_service.py`)
- Inspection runs → Data repositories: uses repositories (evidence: `backend/app/services/checklist_run_service.py`)
- FastAPI runtime → Deadline reminders: starts task (evidence: `backend/app/main.py`)
- Deadline reminders → Notifications: sends reminders (evidence: `backend/app/tasks/deadline_reminders.py`)
- Deadline reminders → Redis service: uses Redis (evidence: `backend/app/tasks/deadline_reminders.py`)
- Database sessions → PostgreSQL: opens sessions (evidence: `backend/app/db/session.py`)
- Data repositories → Database sessions: uses sessions
