# akshatkunder/devops_labca architecture

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

- Interactive diagram: https://gitdiagram.com/akshatkunder/devops_labca
- Repository: https://github.com/akshatkunder/devops_labca

## Overview

DevOps Theory IA is a Flask quiz application: a learner opens the quiz form, submits a topic and difficulty, answers a generated quiz, then sees a score and answer explanations. The route layer coordinates quiz generation, session-backed answer storage, scoring, and page rendering; the AI service obtains and validates questions through Gemini. The README also describes responsive desktop/mobile presentation. Template submission details and asset wiring were not sampled, so those relationships are not inferred.

Main entry points: [`app/routes.py`](https://github.com/akshatkunder/devops_labca/blob/main/app/routes.py) (Quiz routes), [`app/__init__.py`](https://github.com/akshatkunder/devops_labca/blob/main/app/__init__.py) (Flask app), [`app/ai.py`](https://github.com/akshatkunder/devops_labca/blob/main/app/ai.py) (Quiz generation), [`templates/index.html`](https://github.com/akshatkunder/devops_labca/blob/main/templates/index.html) (Home form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_flask["Flask app<br/>[__init__.py]"]
  node_routes["Quiz routes<br/>[routes.py]"]
end

subgraph group_quiz["Quiz workflow"]
  node_quiz_session[("Quiz session<br/>[routes.py]")]
  node_generation["Quiz generation<br/>[ai.py]"]
  node_scoring["Result scoring<br/>[routes.py]"]
end

subgraph group_ui["User interface"]
  node_home_page["Home form<br/>[index.html]"]
  node_quiz_page["Quiz page<br/>[quiz.html]"]
  node_result_page["Results page<br/>[result.html]"]
  node_styles["Responsive styles<br/>[style.css]"]
  node_client_script["Client script<br/>[script.js]"]
end

node_learner(("Learner"))
node_gemini{{"Gemini API"}}

node_learner -->|"opens app"| node_flask
node_flask -->|"registers routes"| node_routes
node_routes -->|"renders form"| node_home_page
node_routes -->|"requests questions"| node_generation
node_generation -->|"generates content"| node_gemini
node_routes -->|"stores quiz"| node_quiz_session
node_routes -->|"renders quiz"| node_quiz_page
node_routes -->|"reads and clears"| node_quiz_session
node_routes -->|"calculates score"| node_scoring
node_routes -->|"renders results"| node_result_page
node_learner -.->|"submits answers"| node_routes

click node_flask "https://github.com/akshatkunder/devops_labca/blob/main/app/__init__.py"
click node_routes "https://github.com/akshatkunder/devops_labca/blob/main/app/routes.py"
click node_quiz_session "https://github.com/akshatkunder/devops_labca/blob/main/app/routes.py"
click node_generation "https://github.com/akshatkunder/devops_labca/blob/main/app/ai.py"
click node_scoring "https://github.com/akshatkunder/devops_labca/blob/main/app/routes.py"
click node_home_page "https://github.com/akshatkunder/devops_labca/blob/main/templates/index.html"
click node_quiz_page "https://github.com/akshatkunder/devops_labca/blob/main/templates/quiz.html"
click node_result_page "https://github.com/akshatkunder/devops_labca/blob/main/templates/result.html"
click node_styles "https://github.com/akshatkunder/devops_labca/blob/main/static/css/style.css"
click node_client_script "https://github.com/akshatkunder/devops_labca/blob/main/static/js/script.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_flask,node_routes toneBlue
class node_quiz_session,node_generation,node_scoring toneAmber
class node_home_page,node_quiz_page,node_result_page,node_styles,node_client_script,node_gemini toneMint
class node_learner toneIndigo
```

## Components

### Web application

- [Flask app](https://github.com/akshatkunder/devops_labca/blob/main/app/__init__.py): `app/__init__.py`
- [Quiz routes](https://github.com/akshatkunder/devops_labca/blob/main/app/routes.py): `app/routes.py`

### Quiz workflow

- [Quiz session](https://github.com/akshatkunder/devops_labca/blob/main/app/routes.py): `app/routes.py`
- [Quiz generation](https://github.com/akshatkunder/devops_labca/blob/main/app/ai.py): `app/ai.py`
- [Result scoring](https://github.com/akshatkunder/devops_labca/blob/main/app/routes.py): `app/routes.py`

### User interface

- [Home form](https://github.com/akshatkunder/devops_labca/blob/main/templates/index.html): `templates/index.html`
- [Quiz page](https://github.com/akshatkunder/devops_labca/blob/main/templates/quiz.html): `templates/quiz.html`
- [Results page](https://github.com/akshatkunder/devops_labca/blob/main/templates/result.html): `templates/result.html`
- [Responsive styles](https://github.com/akshatkunder/devops_labca/blob/main/static/css/style.css): `static/css/style.css`
- [Client script](https://github.com/akshatkunder/devops_labca/blob/main/static/js/script.js): `static/js/script.js`

### Other components

- **Learner**
- **Gemini API**

## Connections

- Learner → Flask app: opens app (evidence: `README.md`)
- Flask app → Quiz routes: registers routes (evidence: `app/__init__.py`)
- Quiz routes → Home form: renders form (evidence: `app/routes.py`)
- Quiz routes → Quiz generation: requests questions (evidence: `app/routes.py`)
- Quiz generation → Gemini API: generates content (evidence: `app/ai.py`)
- Quiz routes → Quiz session: stores quiz (evidence: `app/routes.py`)
- Quiz routes → Quiz page: renders quiz (evidence: `app/routes.py`)
- Quiz routes → Quiz session: reads and clears (evidence: `app/routes.py`)
- Quiz routes → Result scoring: calculates score (evidence: `app/routes.py`)
- Quiz routes → Results page: renders results (evidence: `app/routes.py`)
- Learner → Quiz routes: submits answers (evidence: `README.md`)
