# djamoone/mti architecture

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

- Interactive diagram: https://gitdiagram.com/djamoone/mti
- Repository: https://github.com/djamoone/mti

## Overview

This repository is a small collection of Python coursework exercises, not a single integrated application. Its clearest domain workflow models academic modules, units, and semesters to calculate averages and earned credits. Separate exercises demonstrate text-frequency analysis and converting a curriculum CSV into HTML. The excerpts show those scripts’ internal calls, but provide no README or evidence that the exercises are wired together; the graph keeps them as independent branches.

Main entry points: [`tp1/tp1p2.py`](https://github.com/djamoone/mti/blob/main/tp1/tp1p2.py) (CSV loader), [`tp2/part1.py`](https://github.com/djamoone/mti/blob/main/tp2/part1.py) (Unit aggregation), [`tp1/modules.csv`](https://github.com/djamoone/mti/blob/main/tp1/modules.csv) (Curriculum data), [`tp1/modules.html`](https://github.com/djamoone/mti/blob/main/tp1/modules.html) (HTML output)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_academic["Academic model"]
  node_module["Module grades<br/>[part1.py]"]
  node_unit["Unit aggregation<br/>[part1.py]"]
  node_semester["Semester aggregation<br/>[part1.py]"]
end

subgraph group_curriculum["Curriculum conversion"]
  node_csv["Curriculum data<br/>[modules.csv]"]
  node_csv_loader["CSV loader<br/>[tp1p2.py]"]
  node_html_renderer["HTML renderer<br/>[tp1p2.py]"]
  node_html_output["HTML output<br/>[modules.html]"]
end

subgraph group_text["Text exercises"]
  node_text_basics["Python basics<br/>[tp1p1-1.py]"]
  node_text_analysis["Text analysis<br/>[tp1p1-2.py]"]
end

node_user(("Script user"))

node_user -->|"runs demo"| node_module
node_unit -->|"aggregates grades"| node_module
node_semester -->|"aggregates credits"| node_unit
node_user -->|"runs converter"| node_csv_loader
node_csv_loader -->|"reads CSV"| node_csv
node_csv_loader -->|"passes data"| node_html_renderer
node_html_renderer -->|"writes HTML"| node_html_output
node_user -.->|"runs examples"| node_text_basics
node_user -->|"runs analysis"| node_text_analysis

click node_module "https://github.com/djamoone/mti/blob/main/tp2/part1.py"
click node_unit "https://github.com/djamoone/mti/blob/main/tp2/part1.py"
click node_semester "https://github.com/djamoone/mti/blob/main/tp2/part1.py"
click node_csv "https://github.com/djamoone/mti/blob/main/tp1/modules.csv"
click node_csv_loader "https://github.com/djamoone/mti/blob/main/tp1/tp1p2.py"
click node_html_renderer "https://github.com/djamoone/mti/blob/main/tp1/tp1p2.py"
click node_html_output "https://github.com/djamoone/mti/blob/main/tp1/modules.html"
click node_text_basics "https://github.com/djamoone/mti/blob/main/tp1/tp1p1-1.py"
click node_text_analysis "https://github.com/djamoone/mti/blob/main/tp1/tp1p1-2.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_module,node_unit,node_semester,node_user toneBlue
class node_csv,node_csv_loader,node_html_renderer,node_html_output toneAmber
class node_text_basics,node_text_analysis toneMint
```

## Components

### Academic model

- [Module grades](https://github.com/djamoone/mti/blob/main/tp2/part1.py): `tp2/part1.py`
- [Unit aggregation](https://github.com/djamoone/mti/blob/main/tp2/part1.py): `tp2/part1.py`
- [Semester aggregation](https://github.com/djamoone/mti/blob/main/tp2/part1.py): `tp2/part1.py`

### Curriculum conversion

- [Curriculum data](https://github.com/djamoone/mti/blob/main/tp1/modules.csv): `tp1/modules.csv`
- [CSV loader](https://github.com/djamoone/mti/blob/main/tp1/tp1p2.py): `tp1/tp1p2.py`
- [HTML renderer](https://github.com/djamoone/mti/blob/main/tp1/tp1p2.py): `tp1/tp1p2.py`
- [HTML output](https://github.com/djamoone/mti/blob/main/tp1/modules.html): `tp1/modules.html`

### Text exercises

- [Python basics](https://github.com/djamoone/mti/blob/main/tp1/tp1p1-1.py): `tp1/tp1p1-1.py`
- [Text analysis](https://github.com/djamoone/mti/blob/main/tp1/tp1p1-2.py): `tp1/tp1p1-2.py`

### Other components

- **Script user**

## Connections

- Script user → Module grades: runs demo (evidence: `tp2/part1.py`)
- Unit aggregation → Module grades: aggregates grades (evidence: `tp2/part1.py`)
- Semester aggregation → Unit aggregation: aggregates credits (evidence: `tp2/part1.py`)
- Script user → CSV loader: runs converter (evidence: `tp1/tp1p2.py`)
- CSV loader → Curriculum data: reads CSV (evidence: `tp1/tp1p2.py`)
- CSV loader → HTML renderer: passes data (evidence: `tp1/tp1p2.py`)
- HTML renderer → HTML output: writes HTML (evidence: `tp1/tp1p2.py`)
- Script user → Python basics: runs examples
- Script user → Text analysis: runs analysis (evidence: `tp1/tp1p1-2.py`)
