# optivisionlab/haui_sict_fitness_score architecture

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

- Interactive diagram: https://gitdiagram.com/optivisionlab/haui_sict_fitness_score
- Repository: https://github.com/optivisionlab/haui_sict_fitness_score

## Overview

This repository combines a fitness-class management API with a camera-based recognition/check-in pipeline. The user-facing flow manages users, classes, exams and performance results; the camera pipeline detects and identifies people and can submit check-ins to the API. The sampled backend shows database-backed routes and Redis event handling. Recognition modules and several API capabilities are represented where the source index establishes them, but their internal wiring is not fully shown, so uncertain links are omitted.

Main entry points: [`backend/app/main.py`](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/main.py) (API Application), [`recognize_block/src/engine/detect.py`](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/engine/detect.py) (Detection Pipeline), [`backend/app/core/database.py`](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/core/database.py) (SQL Database Layer), [`backend/app/api/endpoints/classes.py`](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/classes.py) (Class Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Backend API"]
  node_api_app["API Application<br/>[main.py]"]
  node_user_routes["User Routes<br/>[users.py]"]
  node_class_routes["Class Routes<br/>[classes.py]"]
  node_exam_routes["Exam Routes<br/>[exams.py]"]
  node_result_routes["Result Routes<br/>[results.py]"]
  node_redis_events["Redis Event Routes<br/>[redis_events.py]"]
  node_security["Authentication<br/>[security.py]"]
  node_dispatcher["Redis Dispatcher"]
end

subgraph group_domain["Fitness Domain"]
  node_users["User Records<br/>[user.py]"]
  node_classes["Class Records<br/>[classes.py]"]
  node_exams["Exam Records<br/>[exams.py]"]
  node_results["Performance Results<br/>[result.py]"]
  node_camera_records["Camera Check-ins<br/>[camera.py]"]
  node_exam_service["Exam Service<br/>[exam_service.py]"]
  node_result_service["Result Service<br/>[result_service.py]"]
end

subgraph group_recognition["Camera Recognition"]
  node_detect["Detection Pipeline<br/>[detect.py]"]
  node_inference["ONNX Inference<br/>[load_model.py]"]
  node_tracking_utils["Tracking Utilities<br/>[engine.py]"]
  node_search_api["Identity Search<br/>[curl_api_search.py]"]
  node_kafka_process["Kafka Processing<br/>[kafka_process.py]"]
  node_kafka_producer["Kafka Producer<br/>[kafka_produce.py]"]
  node_kafka_consumer["Kafka Consumers<br/>[kafka_consumers.py]"]
  node_recognition_config["Recognition Config<br/>[config.py]"]
end

subgraph group_integrations["Data Integrations"]
  node_database["SQL Database Layer<br/>[database.py]"]
  node_redis["Redis"]
  node_sql_store[("Relational Store")]
  node_save_api["Check-in Save API<br/>[save_DB_api.py]"]
  node_sql_models["Recognition SQL Models<br/>[sql_model.py]"]
  node_minio["Image Object Store<br/>[minio_client.py]"]
  node_mongo["Mongo Database<br/>[mongo.py]"]
end

node_user(("User"))
node_camera(("Camera"))
node_search_service{{"Search Service"}}
node_kafka["Kafka"]

node_user -->|"sends requests"| node_api_app
node_api_app -->|"routes requests"| node_user_routes
node_api_app -->|"routes requests"| node_class_routes
node_api_app -->|"routes requests"| node_exam_routes
node_api_app -->|"routes requests"| node_result_routes
node_api_app -->|"routes requests"| node_redis_events
node_api_app -->|"starts"| node_dispatcher
node_class_routes -->|"authenticates"| node_security
node_exam_routes -->|"authenticates"| node_security
node_user_routes -->|"authenticates"| node_security
node_class_routes -->|"calls"| node_exam_service
node_class_routes -->|"calls"| node_result_service
node_exam_routes -->|"calls"| node_exam_service
node_exam_routes -->|"calls"| node_result_service
node_exam_service -->|"reads and writes"| node_exams
node_result_service -->|"reads and writes"| node_results
node_result_service -->|"validates user"| node_users
node_result_service -->|"validates exam"| node_exams
node_class_routes -->|"uses session"| node_database
node_exam_routes -->|"uses session"| node_database
node_redis_events -->|"uses session"| node_database
node_database -->|"connects"| node_sql_store
node_database -->|"creates clients"| node_redis
node_dispatcher -->|"uses clients"| node_database
node_dispatcher -->|"dispatches events"| node_redis_events
node_camera -.->|"supplies video"| node_detect
node_detect -.->|"uses model"| node_inference
node_detect -->|"uses utilities"| node_tracking_utils
node_detect -->|"searches identities"| node_search_api
node_search_api -.->|"queries"| node_search_service
node_detect -->|"reads settings"| node_recognition_config
node_search_api -->|"reads settings"| node_recognition_config
node_kafka_process -->|"calls"| node_kafka_producer
node_kafka_process -->|"reads settings"| node_recognition_config
node_kafka_consumer -.->|"consumes messages"| node_kafka
node_kafka_producer -.->|"produces messages"| node_kafka
node_detect -.->|"submits check-ins"| node_save_api
node_save_api -->|"uses models"| node_sql_models
node_save_api -->|"reads settings"| node_recognition_config
node_save_api -->|"uses dependency"| node_minio
node_mongo -->|"reads settings"| node_recognition_config

click node_api_app "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/main.py"
click node_user_routes "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/users.py"
click node_class_routes "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/classes.py"
click node_exam_routes "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/exams.py"
click node_result_routes "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/results.py"
click node_redis_events "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/redis_events.py"
click node_security "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/core/security.py"
click node_database "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/core/database.py"
click node_dispatcher "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/core/redis_dispatcher.py"
click node_users "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/user.py"
click node_classes "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/classes.py"
click node_exams "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/exams.py"
click node_results "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/result.py"
click node_camera_records "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/camera.py"
click node_exam_service "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/services/exam_service.py"
click node_result_service "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/services/result_service.py"
click node_detect "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/engine/detect.py"
click node_inference "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/onnx_model/load_model.py"
click node_tracking_utils "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/engine/engine.py"
click node_search_api "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/engine/curl_api_search.py"
click node_kafka_process "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/kafka/kafka_process.py"
click node_kafka_producer "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/kafka/kafka_produce.py"
click node_kafka_consumer "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/kafka/kafka_consumers.py"
click node_save_api "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/api/save_DB_api.py"
click node_sql_models "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/database/sql_model.py"
click node_minio "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/database/minio_client.py"
click node_mongo "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/database/mongo.py"
click node_recognition_config "https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/config/config.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_api_app,node_user_routes,node_class_routes,node_exam_routes,node_result_routes,node_redis_events,node_security,node_dispatcher,node_user toneBlue
class node_users,node_classes,node_exams,node_results,node_camera_records,node_exam_service,node_result_service toneAmber
class node_detect,node_inference,node_tracking_utils,node_search_api,node_kafka_process,node_kafka_producer,node_kafka_consumer,node_recognition_config toneMint
class node_database,node_redis,node_sql_store,node_save_api,node_sql_models,node_minio,node_mongo toneRose
class node_camera,node_search_service,node_kafka toneIndigo
```

## Components

### Backend API

- [API Application](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/main.py): `backend/app/main.py`
- [User Routes](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/users.py): `backend/app/api/endpoints/users.py`
- [Class Routes](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/classes.py): `backend/app/api/endpoints/classes.py`
- [Exam Routes](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/exams.py): `backend/app/api/endpoints/exams.py`
- [Result Routes](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/results.py): `backend/app/api/endpoints/results.py`
- [Redis Event Routes](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/api/endpoints/redis_events.py): `backend/app/api/endpoints/redis_events.py`
- [Authentication](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/core/security.py): `backend/app/core/security.py`
- [Redis Dispatcher](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/core/redis_dispatcher.py): `backend/app/core/redis_dispatcher.py`

### Fitness Domain

- [User Records](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- [Class Records](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/classes.py): `backend/app/models/classes.py`
- [Exam Records](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/exams.py): `backend/app/models/exams.py`
- [Performance Results](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/result.py): `backend/app/models/result.py`
- [Camera Check-ins](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/models/camera.py): `backend/app/models/camera.py`
- [Exam Service](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/services/exam_service.py): `backend/app/services/exam_service.py`
- [Result Service](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/services/result_service.py): `backend/app/services/result_service.py`

### Camera Recognition

- [Detection Pipeline](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/engine/detect.py): `recognize_block/src/engine/detect.py`
- [ONNX Inference](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/onnx_model/load_model.py): `recognize_block/src/onnx_model/load_model.py`
- [Tracking Utilities](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/engine/engine.py): `recognize_block/src/engine/engine.py`
- [Identity Search](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/engine/curl_api_search.py): `recognize_block/src/engine/curl_api_search.py`
- [Kafka Processing](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/kafka/kafka_process.py): `recognize_block/src/kafka/kafka_process.py`
- [Kafka Producer](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/kafka/kafka_produce.py): `recognize_block/src/kafka/kafka_produce.py`
- [Kafka Consumers](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/kafka/kafka_consumers.py): `recognize_block/src/kafka/kafka_consumers.py`
- [Recognition Config](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/config/config.py): `recognize_block/src/config/config.py`

### Data Integrations

- [SQL Database Layer](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- **Redis**
- **Relational Store**
- [Check-in Save API](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/api/save_DB_api.py): `recognize_block/src/api/save_DB_api.py`
- [Recognition SQL Models](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/database/sql_model.py): `recognize_block/src/database/sql_model.py`
- [Image Object Store](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/database/minio_client.py): `recognize_block/src/database/minio_client.py`
- [Mongo Database](https://github.com/optivisionlab/haui_sict_fitness_score/blob/main/recognize_block/src/database/mongo.py): `recognize_block/src/database/mongo.py`

### Other components

- **User**
- **Camera**
- **Search Service**
- **Kafka**

## Connections

- User → API Application: sends requests
- API Application → User Routes: routes requests
- API Application → Class Routes: routes requests
- API Application → Exam Routes: routes requests
- API Application → Result Routes: routes requests
- API Application → Redis Event Routes: routes requests
- API Application → Redis Dispatcher: starts (evidence: `backend/app/main.py`)
- Class Routes → Authentication: authenticates (evidence: `backend/app/api/endpoints/classes.py`)
- Exam Routes → Authentication: authenticates (evidence: `backend/app/api/endpoints/exams.py`)
- User Routes → Authentication: authenticates
- Class Routes → Exam Service: calls (evidence: `backend/app/api/endpoints/classes.py`)
- Class Routes → Result Service: calls (evidence: `backend/app/api/endpoints/classes.py`)
- Exam Routes → Exam Service: calls (evidence: `backend/app/api/endpoints/exams.py`)
- Exam Routes → Result Service: calls (evidence: `backend/app/api/endpoints/exams.py`)
- Exam Service → Exam Records: reads and writes (evidence: `backend/app/services/exam_service.py`)
- Result Service → Performance Results: reads and writes (evidence: `backend/app/services/result_service.py`)
- Result Service → User Records: validates user (evidence: `backend/app/services/result_service.py`)
- Result Service → Exam Records: validates exam (evidence: `backend/app/services/result_service.py`)
- Class Routes → SQL Database Layer: uses session (evidence: `backend/app/api/endpoints/classes.py`)
- Exam Routes → SQL Database Layer: uses session (evidence: `backend/app/api/endpoints/exams.py`)
- Redis Event Routes → SQL Database Layer: uses session (evidence: `backend/app/api/endpoints/redis_events.py`)
- SQL Database Layer → Relational Store: connects (evidence: `backend/app/core/database.py`)
- SQL Database Layer → Redis: creates clients (evidence: `backend/app/core/database.py`)
- Redis Dispatcher → SQL Database Layer: uses clients (evidence: `backend/app/core/redis_dispatcher.py`)
- Redis Dispatcher → Redis Event Routes: dispatches events (evidence: `backend/app/core/redis_dispatcher.py`)
- Camera → Detection Pipeline: supplies video
- Detection Pipeline → ONNX Inference: uses model
- Detection Pipeline → Tracking Utilities: uses utilities (evidence: `recognize_block/src/engine/detect.py`)
- Detection Pipeline → Identity Search: searches identities (evidence: `recognize_block/src/engine/detect.py`)
- Identity Search → Search Service: queries
- Detection Pipeline → Recognition Config: reads settings (evidence: `recognize_block/src/engine/detect.py`)
- Identity Search → Recognition Config: reads settings (evidence: `recognize_block/src/engine/curl_api_search.py`)
- Kafka Processing → Kafka Producer: calls (evidence: `recognize_block/src/kafka/kafka_process.py`)
- Kafka Processing → Recognition Config: reads settings (evidence: `recognize_block/src/kafka/kafka_process.py`)
- Kafka Consumers → Kafka: consumes messages
- Kafka Producer → Kafka: produces messages
- Detection Pipeline → Check-in Save API: submits check-ins
- Check-in Save API → Recognition SQL Models: uses models (evidence: `recognize_block/src/api/save_DB_api.py`)
- Check-in Save API → Recognition Config: reads settings (evidence: `recognize_block/src/api/save_DB_api.py`)
- Check-in Save API → Image Object Store: uses dependency
- Mongo Database → Recognition Config: reads settings (evidence: `recognize_block/src/database/mongo.py`)
