# roberto2213/imparadeputato architecture

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

- Interactive diagram: https://gitdiagram.com/roberto2213/imparadeputato
- Repository: https://github.com/roberto2213/imparadeputato

## Overview

ImparaDeputato is a web app for learning Italian deputies, parliamentary groups, and seat locations. A user opens the training interface, which fetches deputy, group, and committee data from Flask; they can then play quiz modes, explore the hemicycle, or search deputies. A data-building script prepares the JSON cache consumed by the app, while GodMode supports protected data edits. The README also documents audio feedback and PWA/offline support. Some routes and template wiring were not excerpted, so those connections are omitted unless documented.

Main entry points: [`static/training_logic.js`](https://github.com/roberto2213/imparadeputato/blob/main/static/training_logic.js) (Training UI), [`training_app.py`](https://github.com/roberto2213/imparadeputato/blob/main/training_app.py) (Flask routes), [`templates/emiciclo_moderno.html`](https://github.com/roberto2213/imparadeputato/blob/main/templates/emiciclo_moderno.html) (Hemicycle map), [`service-worker.js`](https://github.com/roberto2213/imparadeputato/blob/main/service-worker.js) (Service worker)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Learning experience"]
  node_training["Training UI<br/>[training_logic.js]"]
  node_classic["Quiz modes<br/>[training_logic.js]"]
  node_seatquiz["Seat quiz<br/>[emiciclo_quiz.html]"]
  node_search["Deputy search<br/>[training_logic.js]"]
  node_map["Hemicycle map"]
  node_audio["Audio feedback"]
  node_legacylogic["Alternate game logic<br/>[training_logic.js]"]
end

subgraph group_server["Web server"]
  node_flask["Flask routes<br/>[training_app.py]"]
  node_godmode["GodMode editing<br/>[training_app.py]"]
end

subgraph group_data["Deputy data"]
  node_cachebuilder["Cache builder"]
  node_deputycache[("Deputy cache<br/>[data_cache.json]")]
  node_seats[("Seat positions<br/>[seggi.json]")]
  node_seatmap["Hemicycle assets<br/>[emiciclo.html]"]
end

subgraph group_offline["Offline support"]
  node_pwa["Service worker<br/>[service-worker.js]"]
  node_manifest["PWA manifest<br/>[manifest.json]"]
end

node_learner(("Learner"))

node_learner -->|"uses"| node_training
node_training -->|"fetches data"| node_flask
node_training -->|"fetches positions"| node_seats
node_training -->|"starts quiz"| node_classic
node_training -->|"loads seat quiz"| node_seatquiz
node_training -->|"filters deputies"| node_search
node_training -.->|"plays feedback"| node_audio
node_learner -->|"views seats"| node_map
node_training -->|"requests admin actions"| node_godmode
node_flask -->|"reads and writes"| node_deputycache
node_cachebuilder -->|"builds cache"| node_deputycache
node_flask -->|"syncs edits"| node_seats
node_map -.->|"renders layout"| node_seatmap
node_training -->|"registers worker"| node_pwa
node_pwa -.->|"caches app assets"| node_manifest
node_learner -.->|"uses alternate interface"| node_legacylogic

click node_training "https://github.com/roberto2213/imparadeputato/blob/main/static/training_logic.js"
click node_classic "https://github.com/roberto2213/imparadeputato/blob/main/static/training_logic.js"
click node_seatquiz "https://github.com/roberto2213/imparadeputato/blob/main/static/emiciclo_quiz.html"
click node_search "https://github.com/roberto2213/imparadeputato/blob/main/static/training_logic.js"
click node_map "https://github.com/roberto2213/imparadeputato/blob/main/templates/emiciclo_moderno.html"
click node_audio "https://github.com/roberto2213/imparadeputato/tree/main/static/audio"
click node_legacylogic "https://github.com/roberto2213/imparadeputato/blob/main/training_logic.js"
click node_flask "https://github.com/roberto2213/imparadeputato/blob/main/training_app.py"
click node_godmode "https://github.com/roberto2213/imparadeputato/blob/main/training_app.py"
click node_cachebuilder "https://github.com/roberto2213/imparadeputato/blob/main/build_data_cache.py"
click node_deputycache "https://github.com/roberto2213/imparadeputato/blob/main/data_cache.json"
click node_seats "https://github.com/roberto2213/imparadeputato/blob/main/static/seggi.json"
click node_seatmap "https://github.com/roberto2213/imparadeputato/blob/main/static/emiciclo.html"
click node_pwa "https://github.com/roberto2213/imparadeputato/blob/main/service-worker.js"
click node_manifest "https://github.com/roberto2213/imparadeputato/blob/main/static/manifest.json"

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_training,node_classic,node_seatquiz,node_search,node_map,node_audio,node_legacylogic toneBlue
class node_flask,node_godmode toneAmber
class node_cachebuilder,node_deputycache,node_seats,node_seatmap toneMint
class node_pwa,node_manifest toneRose
class node_learner toneIndigo
```

## Components

### Learning experience

- [Training UI](https://github.com/roberto2213/imparadeputato/blob/main/static/training_logic.js): `static/training_logic.js`
- [Quiz modes](https://github.com/roberto2213/imparadeputato/blob/main/static/training_logic.js): `static/training_logic.js`
- [Seat quiz](https://github.com/roberto2213/imparadeputato/blob/main/static/emiciclo_quiz.html): `static/emiciclo_quiz.html`
- [Deputy search](https://github.com/roberto2213/imparadeputato/blob/main/static/training_logic.js): `static/training_logic.js`
- [Hemicycle map](https://github.com/roberto2213/imparadeputato/blob/main/templates/emiciclo_moderno.html): `templates/emiciclo_moderno.html`
- [Audio feedback](https://github.com/roberto2213/imparadeputato/tree/main/static/audio): `static/audio`
- [Alternate game logic](https://github.com/roberto2213/imparadeputato/blob/main/training_logic.js): `training_logic.js`

### Web server

- [Flask routes](https://github.com/roberto2213/imparadeputato/blob/main/training_app.py): `training_app.py`
- [GodMode editing](https://github.com/roberto2213/imparadeputato/blob/main/training_app.py): `training_app.py`

### Deputy data

- [Cache builder](https://github.com/roberto2213/imparadeputato/blob/main/build_data_cache.py): `build_data_cache.py`
- [Deputy cache](https://github.com/roberto2213/imparadeputato/blob/main/data_cache.json): `data_cache.json`
- [Seat positions](https://github.com/roberto2213/imparadeputato/blob/main/static/seggi.json): `static/seggi.json`
- [Hemicycle assets](https://github.com/roberto2213/imparadeputato/blob/main/static/emiciclo.html): `static/emiciclo.html`

### Offline support

- [Service worker](https://github.com/roberto2213/imparadeputato/blob/main/service-worker.js): `service-worker.js`
- [PWA manifest](https://github.com/roberto2213/imparadeputato/blob/main/static/manifest.json): `static/manifest.json`

### Other components

- **Learner**

## Connections

- Learner → Training UI: uses (evidence: `README.md`)
- Training UI → Flask routes: fetches data (evidence: `static/training_logic.js`)
- Training UI → Seat positions: fetches positions (evidence: `static/training_logic.js`)
- Training UI → Quiz modes: starts quiz (evidence: `static/training_logic.js`)
- Training UI → Seat quiz: loads seat quiz (evidence: `static/training_logic.js`)
- Training UI → Deputy search: filters deputies (evidence: `static/training_logic.js`)
- Training UI → Audio feedback: plays feedback (evidence: `README.md`)
- Learner → Hemicycle map: views seats (evidence: `README.md`)
- Training UI → GodMode editing: requests admin actions (evidence: `static/training_logic.js`)
- Flask routes → Deputy cache: reads and writes (evidence: `training_app.py`)
- Cache builder → Deputy cache: builds cache (evidence: `build_data_cache.py`)
- Flask routes → Seat positions: syncs edits (evidence: `training_app.py`)
- Hemicycle map → Hemicycle assets: renders layout (evidence: `README.md`)
- Training UI → Service worker: registers worker (evidence: `static/training_logic.js`)
- Service worker → PWA manifest: caches app assets (evidence: `service-worker.js`)
- Learner → Alternate game logic: uses alternate interface
