# acridgold/system_hack_novosibirsk architecture

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

- Interactive diagram: https://gitdiagram.com/acridgold/system_hack_novosibirsk
- Repository: https://github.com/acridgold/system_hack_novosibirsk

## Overview

This is a demo employee-burnout assessment and support application. Users register or sign in, complete an assessment, and review burnout metrics and recommendations; an embedded assistant offers AI chat. The graph separates the React experience and state/API layer from Flask workflows and persistence. The README documents AI-provider fallback, while sampled source confirms app registration, selected UI/store/API links, and database initialization. Some backend route-to-helper and route-to-model relationships are not established by the available excerpts or index, so they are omitted.

Main entry points: [`Back-End/app.py`](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/app.py) (Flask app and routing), [`Front-End/src/App.jsx`](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/App.jsx) (App and routes), [`Front-End/src/services/api.js`](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/services/api.js) (HTTP API client), [`Front-End/src/pages/Assessment.jsx`](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Assessment.jsx) (Assessment flow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React experience"]
  node_app_router["App and routes<br/>[App.jsx]"]
  node_auth_pages["Sign-in and registration<br/>[Login.jsx]"]
  node_assessment_ui["Assessment flow<br/>[Assessment.jsx]"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.jsx]"]
  node_recommendations_ui["Recommendations view"]
  node_profile_ui["Profile and team<br/>[Profile.jsx]"]
  node_assistant_ui["AI assistant<br/>[Assistant.jsx]"]
  node_assessment_questions["Assessment questions"]
  node_team_modal["Team management modal<br/>[TeamModal.jsx]"]
end

subgraph group_client_state["Client state and API"]
  node_user_state["User state<br/>[userSlice.js]"]
  node_assessment_state["Assessment state<br/>[assessmentSlice.js]"]
  node_recommendation_state["Recommendation state"]
  node_api_client["HTTP API client<br/>[api.js]"]
end

subgraph group_backend["Flask workflows"]
  node_flask_app["Flask app and routing<br/>[app.py]"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_ai_api["AI chat endpoint<br/>[ai.py]"]
  node_ai_manager["AI provider manager<br/>[ai_manager.py]"]
  node_ai_provider["AI provider utilities<br/>[ai.py]"]
  node_hf_provider["Hugging Face utility<br/>[ai_hf.py]"]
end

subgraph group_domain["Assessment and guidance"]
  node_assessment_api["Assessment API<br/>[assessment.py]"]
  node_score_logic["Burnout scoring<br/>[burnoutScore.py]"]
  node_recommendation_api["Recommendations API<br/>[recommendations.py]"]
  node_recommendation_selector["Recommendation selection"]
  node_dashboard_api["Dashboard API<br/>[dashboard.py]"]
end

subgraph group_persistence["Persistence and AI"]
  node_db_init["Database initialization<br/>[database.py]"]
  node_orm_models["Domain data models<br/>[db_models.py]"]
  node_database[("Application database<br/>[database.py]")]
  node_logger["Application logging<br/>[logger.py]"]
end

node_employee(("Employee"))
node_llm_service["Configured LLM service"]

node_employee -->|"uses"| node_app_router
node_app_router -->|"routes to"| node_auth_pages
node_app_router -->|"routes to"| node_assessment_ui
node_app_router -->|"routes to"| node_dashboard_ui
node_app_router -->|"routes to"| node_recommendations_ui
node_app_router -->|"routes to"| node_profile_ui
node_assessment_ui -->|"renders"| node_assessment_questions
node_profile_ui -->|"uses"| node_team_modal
node_auth_pages -->|"dispatches auth"| node_user_state
node_assessment_ui -->|"dispatches assessment"| node_assessment_state
node_dashboard_ui -->|"loads history"| node_assessment_state
node_profile_ui -->|"uses"| node_user_state
node_recommendations_ui -->|"uses"| node_recommendation_state
node_user_state -->|"requests data"| node_api_client
node_assessment_state -->|"requests data"| node_api_client
node_recommendation_state -->|"requests data"| node_api_client
node_assistant_ui -->|"sends chat"| node_api_client
node_api_client -.->|"HTTP requests"| node_flask_app
node_flask_app -->|"registers"| node_auth_api
node_flask_app -->|"registers"| node_assessment_api
node_flask_app -->|"registers"| node_dashboard_api
node_flask_app -->|"registers"| node_recommendation_api
node_flask_app -->|"registers"| node_ai_api
node_flask_app -->|"initializes"| node_db_init
node_flask_app -->|"logs through"| node_logger
node_db_init -->|"initializes"| node_database
node_orm_models -->|"uses ORM"| node_database
node_assessment_api -->|"uses scoring"| node_score_logic
node_assessment_api -->|"selects guidance"| node_recommendation_selector
node_ai_manager -->|"uses"| node_ai_provider
node_hf_provider -->|"uses"| node_ai_provider
node_ai_api -.->|"selects provider"| node_llm_service
node_ai_manager -.->|"provider fallback"| node_llm_service

click node_app_router "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/App.jsx"
click node_auth_pages "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Login.jsx"
click node_assessment_ui "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Assessment.jsx"
click node_dashboard_ui "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Dashboard.jsx"
click node_recommendations_ui "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Recommendations.jsx"
click node_profile_ui "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Profile.jsx"
click node_assistant_ui "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/components/common/Assistant.jsx"
click node_assessment_questions "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/components/assessment/questions/RelaxAbilityQuestion.jsx"
click node_team_modal "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/components/TeamModal.jsx"
click node_user_state "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/store/slices/userSlice.js"
click node_assessment_state "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/store/slices/assessmentSlice.js"
click node_recommendation_state "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/store/slices/recommendationsSlice.js"
click node_api_client "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/services/api.js"
click node_flask_app "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/app.py"
click node_auth_api "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/auth.py"
click node_assessment_api "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/assessment.py"
click node_score_logic "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/burnoutScore.py"
click node_recommendation_api "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/recommendations.py"
click node_recommendation_selector "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/utils/recommendations_selector.py"
click node_dashboard_api "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/dashboard.py"
click node_ai_api "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/ai.py"
click node_ai_manager "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/ai_manager.py"
click node_ai_provider "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/utils/ai.py"
click node_hf_provider "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/utils/ai_hf.py"
click node_db_init "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/db/database.py"
click node_orm_models "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/db/db_models.py"
click node_database "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/db/database.py"
click node_logger "https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/data/logger.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_app_router,node_auth_pages,node_assessment_ui,node_dashboard_ui,node_recommendations_ui,node_profile_ui,node_assistant_ui,node_assessment_questions,node_team_modal toneBlue
class node_user_state,node_assessment_state,node_recommendation_state,node_api_client toneAmber
class node_flask_app,node_auth_api,node_ai_api,node_ai_manager,node_ai_provider,node_hf_provider toneMint
class node_assessment_api,node_score_logic,node_recommendation_api,node_recommendation_selector,node_dashboard_api toneRose
class node_db_init,node_orm_models,node_database,node_logger,node_employee,node_llm_service toneIndigo
```

## Components

### React experience

- [App and routes](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/App.jsx): `Front-End/src/App.jsx`
- [Sign-in and registration](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Login.jsx): `Front-End/src/pages/Login.jsx`
- [Assessment flow](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Assessment.jsx): `Front-End/src/pages/Assessment.jsx`
- [Dashboard](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Dashboard.jsx): `Front-End/src/pages/Dashboard.jsx`
- [Recommendations view](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Recommendations.jsx): `Front-End/src/pages/Recommendations.jsx`
- [Profile and team](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/pages/Profile.jsx): `Front-End/src/pages/Profile.jsx`
- [AI assistant](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/components/common/Assistant.jsx): `Front-End/src/components/common/Assistant.jsx`
- [Assessment questions](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/components/assessment/questions/RelaxAbilityQuestion.jsx): `Front-End/src/components/assessment/questions/RelaxAbilityQuestion.jsx`
- [Team management modal](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/components/TeamModal.jsx): `Front-End/src/components/TeamModal.jsx`

### Client state and API

- [User state](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/store/slices/userSlice.js): `Front-End/src/store/slices/userSlice.js`
- [Assessment state](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/store/slices/assessmentSlice.js): `Front-End/src/store/slices/assessmentSlice.js`
- [Recommendation state](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/store/slices/recommendationsSlice.js): `Front-End/src/store/slices/recommendationsSlice.js`
- [HTTP API client](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Front-End/src/services/api.js): `Front-End/src/services/api.js`

### Flask workflows

- [Flask app and routing](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/app.py): `Back-End/app.py`
- [Authentication API](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/auth.py): `Back-End/routes/auth.py`
- [AI chat endpoint](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/ai.py): `Back-End/routes/ai.py`
- [AI provider manager](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/ai_manager.py): `Back-End/routes/ai_manager.py`
- [AI provider utilities](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/utils/ai.py): `Back-End/routes/utils/ai.py`
- [Hugging Face utility](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/utils/ai_hf.py): `Back-End/routes/utils/ai_hf.py`

### Assessment and guidance

- [Assessment API](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/assessment.py): `Back-End/routes/assessment.py`
- [Burnout scoring](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/burnoutScore.py): `Back-End/routes/burnoutScore.py`
- [Recommendations API](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/recommendations.py): `Back-End/routes/recommendations.py`
- [Recommendation selection](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/utils/recommendations_selector.py): `Back-End/routes/utils/recommendations_selector.py`
- [Dashboard API](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/dashboard.py): `Back-End/routes/dashboard.py`

### Persistence and AI

- [Database initialization](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/db/database.py): `Back-End/routes/db/database.py`
- [Domain data models](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/db/db_models.py): `Back-End/routes/db/db_models.py`
- [Application database](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/db/database.py): `Back-End/routes/db/database.py`
- [Application logging](https://github.com/acridgold/system_hack_novosibirsk/blob/master/Back-End/routes/data/logger.py): `Back-End/routes/data/logger.py`

### Other components

- **Employee**
- **Configured LLM service**

## Connections

- Employee → App and routes: uses (evidence: `Front-End/src/App.jsx`)
- App and routes → Sign-in and registration: routes to (evidence: `Front-End/src/App.jsx`)
- App and routes → Assessment flow: routes to (evidence: `Front-End/src/App.jsx`)
- App and routes → Dashboard: routes to (evidence: `Front-End/src/App.jsx`)
- App and routes → Recommendations view: routes to (evidence: `Front-End/src/App.jsx`)
- App and routes → Profile and team: routes to (evidence: `Front-End/src/App.jsx`)
- Assessment flow → Assessment questions: renders (evidence: `Front-End/src/pages/Assessment.jsx`)
- Profile and team → Team management modal: uses
- Sign-in and registration → User state: dispatches auth (evidence: `Front-End/src/store/slices/userSlice.js`)
- Assessment flow → Assessment state: dispatches assessment (evidence: `Front-End/src/pages/Assessment.jsx`)
- Dashboard → Assessment state: loads history (evidence: `Front-End/src/pages/Dashboard.jsx`)
- Profile and team → User state: uses (evidence: `Front-End/src/pages/Profile.jsx`)
- Recommendations view → Recommendation state: uses (evidence: `Front-End/src/pages/Recommendations.jsx`)
- User state → HTTP API client: requests data (evidence: `Front-End/src/store/slices/userSlice.js`)
- Assessment state → HTTP API client: requests data (evidence: `Front-End/src/store/slices/assessmentSlice.js`)
- Recommendation state → HTTP API client: requests data (evidence: `Front-End/src/store/slices/recommendationsSlice.js`)
- AI assistant → HTTP API client: sends chat (evidence: `Front-End/src/components/common/Assistant.jsx`)
- HTTP API client → Flask app and routing: HTTP requests (evidence: `README.md`)
- Flask app and routing → Authentication API: registers (evidence: `Back-End/app.py`)
- Flask app and routing → Assessment API: registers (evidence: `Back-End/app.py`)
- Flask app and routing → Dashboard API: registers (evidence: `Back-End/app.py`)
- Flask app and routing → Recommendations API: registers (evidence: `Back-End/app.py`)
- Flask app and routing → AI chat endpoint: registers (evidence: `Back-End/app.py`)
- Flask app and routing → Database initialization: initializes (evidence: `Back-End/app.py`)
- Flask app and routing → Application logging: logs through (evidence: `Back-End/app.py`)
- Database initialization → Application database: initializes (evidence: `Back-End/routes/db/database.py`)
- Domain data models → Application database: uses ORM (evidence: `Back-End/routes/db/db_models.py`)
- Assessment API → Burnout scoring: uses scoring (evidence: `Back-End/routes/assessment.py`)
- Assessment API → Recommendation selection: selects guidance (evidence: `Back-End/routes/assessment.py`)
- AI provider manager → AI provider utilities: uses (evidence: `Back-End/routes/ai_manager.py`)
- Hugging Face utility → AI provider utilities: uses (evidence: `Back-End/routes/utils/ai_hf.py`)
- AI chat endpoint → Configured LLM service: selects provider (evidence: `README.md`)
- AI provider manager → Configured LLM service: provider fallback (evidence: `README.md`)
