# the-isogeniest/cyber-week-iitr architecture

> Architecture diagram of the GitHub repository the-isogeniest/cyber-week-iitr, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/the-isogeniest/cyber-week-iitr
- Repository: https://github.com/the-isogeniest/cyber-week-iitr

## Overview

##### Project type and purpose
- This is an educational/tutorial project (“Cyber-week-IITR”) consisting of Jupyter/SageMath notebooks that teach lattice-based cryptography.
- There is no standalone frontend/backend service, but rather:
- A user interface layer (Jupyter or CoCalc web UI)
- An execution layer (Jupyter server + SageMath kernel)
- Underlying cryptographic libraries (SageMath’s lattice modules)

##### File structure
- Top-level files are all “.ipynb” notebooks:
- “Tutorial 1.ipynb” and “Tutorial 2.ipynb” – guided lessons
- “SVPchallenge.txt” – challenge description
- “LLL different perspective .ipynb” and “Hands_on_practice_ready (1).ipynb” – exercises/additional perspectives
- No “src/” or “lib/” folders because cryptographic algorithms are leveraged from SageMath, not home-grown code.

##### Extract architecture hints from the README
- Requires SageMath (local install) or Cocalc (hosted Jupyter/Sage environment)
- No external microservices or databases—pure computation in notebooks.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "User Layer"
        User["User (Student/Instructor)"]:::user
    end

    subgraph "Interface Layer"
        Browser["Browser"]:::ui
        NotebookUI["Notebook Interface (Jupyter/CoCalc UI)"]:::ui
        Tutorial1["Tutorial 1.ipynb"]:::doc
        Tutorial2["Tutorial 2.ipynb"]:::doc
        LLLPersp["LLL different perspective .ipynb"]:::doc
        HandsOn["Hands_on_practice_ready (1).ipynb"]:::doc
        Challenge["SVPchallenge.txt"]:::doc
        Browser --> NotebookUI
        NotebookUI --> Tutorial1
        NotebookUI --> Tutorial2
        NotebookUI --> LLLPersp
        NotebookUI --> HandsOn
        NotebookUI --> Challenge
    end

    subgraph "Execution Layer"
        Server["Jupyter Server"]:::server
        Kernel["SageMath Kernel"]:::server
        NotebookUI -->|"execute code cell"| Server
        Server -->|"route to kernel"| Kernel
        Kernel -->|"invoke cryptographic libraries"| SageLib
        SageLib -->|"return results"| Kernel
        Kernel -->|"send output"| Server
        Server -->|"render results"| NotebookUI
    end

    subgraph "Library Layer"
        SageLib["SageMath Libraries (LLL, SVP solvers)"]:::lib
    end

    subgraph "Setup & Instructions"
        README["README.md"]:::doc
        README -.->|"setup instructions"| User
    end

    User --> Browser

    click Tutorial1 "https://github.com/the-isogeniest/cyber-week-iitr/blob/main/Tutorial 1.ipynb"
    click Tutorial2 "https://github.com/the-isogeniest/cyber-week-iitr/blob/main/Tutorial 2.ipynb"
    click LLLPersp "https://github.com/the-isogeniest/cyber-week-iitr/blob/main/LLL different perspective .ipynb"
    click HandsOn "https://github.com/the-isogeniest/cyber-week-iitr/blob/main/Hands_on_practice_ready (1).ipynb"
    click Challenge "https://github.com/the-isogeniest/cyber-week-iitr/blob/main/SVPchallenge.txt"
    click README "https://github.com/the-isogeniest/cyber-week-iitr/blob/main/README.md"

    classDef user fill:#B3E5FC,stroke:#000
    classDef ui fill:#BBDEFB,stroke:#000
    classDef server fill:#C8E6C9,stroke:#000
    classDef lib fill:#FFE0B2,stroke:#000
    classDef doc fill:#E0E0E0,stroke:#000
```
