# joguarino/festa-tracker architecture

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

- Interactive diagram: https://gitdiagram.com/joguarino/festa-tracker
- Repository: https://github.com/joguarino/festa-tracker

## Overview

1. This repository is a small static website, not a traditional backend service. The architecture is centered on HTML entry pages, shared styling, and client-side JavaScript that reads local JSON content.

2. The top-level pages are the main user-facing boundaries:
   - `index.html` is likely the landing page.
   - `diretta.html` is a dedicated “live” or real-time view.
   - `percorso.html` is a route/route-map style view.
   - `programma.html` is a program/schedule view.

3. The `css/` directory is the shared presentation layer. It likely contains global layout and page-specific styling used by the HTML pages to keep the experience consistent.

4. The `js/` directory is the behavior layer. Since there is no backend code in the tree, any dynamic behavior is probably implemented in browser-side scripts: loading data, updating DOM content, switching views, and formatting page-specific information.

5. The JSON files are the main data source for the site:
   - `percorso.json` likely supplies structured route/path data for `percorso.html`.
   - `programma.json` likely supplies schedule/event data for `programma.html`.
   These files suggest a data-driven front end where page content is populated from local assets rather than an API.

6. `diretta.ref` looks like a reference artifact for the live page, possibly used as a fixture, expected output, or sample data. It suggests `diretta.html` may be compared against or generated from reference content during development or testing.

7. The data flow is simple and mostly one-way:
   - Browser loads an HTML page.
   - The page loads shared CSS and page-specific JavaScript.
   - JavaScript reads the local JSON assets or embedded reference content.
   - The DOM is rendered/updated entirely on the client side.
   There is no visible server-side processing path in the repository.

8. The repository has a lightweight CI/CD boundary in `.github/workflows/static.yml`. That strongly suggests GitHub Actions is used to validate or publish the static site, likely to a static hosting target such as GitHub Pages or another static deployment destination.

9. The `.vscode/` directory is development tooling only. It affects local editor setup, not runtime architecture.

10. From an architecture-diagram perspective, the key components are:
   - Static web pages as entry points
   - Shared CSS for presentation
   - Client-side JS for interactivity and rendering
   - Local JSON/reference files as content inputs
   - GitHub Actions as the automation layer for build/deploy checks

11. The main boundary to emphasize is that content and logic live in the repository itself, and the browser is responsible for assembling the final UI. There is no evidence of a database, API server, authentication layer, or external application backend.

Main entry points: [`js`](https://github.com/joguarino/festa-tracker/tree/master/js) (Scripts), [`.github/workflows/static.yml`](https://github.com/joguarino/festa-tracker/blob/master/.github/workflows/static.yml) (Static CI), [`diretta.html`](https://github.com/joguarino/festa-tracker/blob/master/diretta.html) (Live), [`percorso.html`](https://github.com/joguarino/festa-tracker/blob/master/percorso.html) (Route)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pages["Pages"]
  node_index_html["Home<br/>entry page<br/>[index.html]"]
  node_diretta_html["Live<br/>entry page<br/>[diretta.html]"]
  node_percorso_html["Route<br/>entry page<br/>[percorso.html]"]
  node_programma_html["Program<br/>entry page<br/>[programma.html]"]
end

subgraph group_assets["Assets"]
  node_css_dir["Styles<br/>shared css"]
  node_js_dir["Scripts<br/>client js"]
  node_percorso_json["Route data<br/>content json<br/>[percorso.json]"]
  node_programma_json["Program data<br/>content json<br/>[programma.json]"]
  node_diretta_ref["Live ref<br/>reference file<br/>[diretta.ref]"]
  node_readme["README<br/>docs<br/>[README.md]"]
end

subgraph group_automation["Automation"]
  node_workflow_static["Static CI<br/>github actions<br/>[static.yml]"]
  node_vscode["VS Code<br/>editor config<br/>[.vscode]"]
end

node_index_html -->|"styles"| node_css_dir
node_index_html -->|"behavior"| node_js_dir
node_diretta_html -->|"styles"| node_css_dir
node_diretta_html -->|"behavior"| node_js_dir
node_diretta_html -->|"reference"| node_diretta_ref
node_percorso_html -->|"styles"| node_css_dir
node_percorso_html -->|"behavior"| node_js_dir
node_percorso_html -->|"data"| node_percorso_json
node_programma_html -->|"styles"| node_css_dir
node_programma_html -->|"behavior"| node_js_dir
node_programma_html -->|"data"| node_programma_json
node_js_dir -->|"loads"| node_percorso_json
node_js_dir -->|"loads"| node_programma_json
node_workflow_static -->|"deploy/check"| node_index_html
node_workflow_static -->|"deploy/check"| node_diretta_html
node_workflow_static -->|"deploy/check"| node_percorso_html
node_workflow_static -->|"deploy/check"| node_programma_html
node_readme -.->|"documents"| node_index_html
node_vscode -.->|"dev setup"| node_js_dir

click node_index_html "https://github.com/joguarino/festa-tracker/blob/master/index.html"
click node_diretta_html "https://github.com/joguarino/festa-tracker/blob/master/diretta.html"
click node_percorso_html "https://github.com/joguarino/festa-tracker/blob/master/percorso.html"
click node_programma_html "https://github.com/joguarino/festa-tracker/blob/master/programma.html"
click node_css_dir "https://github.com/joguarino/festa-tracker/tree/master/css"
click node_js_dir "https://github.com/joguarino/festa-tracker/tree/master/js"
click node_percorso_json "https://github.com/joguarino/festa-tracker/blob/master/percorso.json"
click node_programma_json "https://github.com/joguarino/festa-tracker/blob/master/programma.json"
click node_diretta_ref "https://github.com/joguarino/festa-tracker/blob/master/diretta.ref"
click node_readme "https://github.com/joguarino/festa-tracker/blob/master/README.md"
click node_workflow_static "https://github.com/joguarino/festa-tracker/blob/master/.github/workflows/static.yml"
click node_vscode "https://github.com/joguarino/festa-tracker/blob/master/.vscode"

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_index_html,node_diretta_html,node_percorso_html,node_programma_html toneBlue
class node_css_dir,node_js_dir,node_percorso_json,node_programma_json,node_diretta_ref,node_readme toneAmber
class node_workflow_static,node_vscode toneMint
```

## Components

### Pages

User-facing HTML entry points that render the site in the browser.

- [Home](https://github.com/joguarino/festa-tracker/blob/master/index.html): entry page · Main landing page for the static site. · `index.html`
- [Live](https://github.com/joguarino/festa-tracker/blob/master/diretta.html): entry page · Dedicated live or real-time view. · `diretta.html`
- [Route](https://github.com/joguarino/festa-tracker/blob/master/percorso.html): entry page · Route or path view for structured journey content. · `percorso.html`
- [Program](https://github.com/joguarino/festa-tracker/blob/master/programma.html): entry page · Schedule or program view. · `programma.html`

### Assets

Shared presentation, scripts, and local content files consumed by the pages.

- [Styles](https://github.com/joguarino/festa-tracker/tree/master/css): shared css · Shared presentation layer for layout and page styling. · `css`
- [Scripts](https://github.com/joguarino/festa-tracker/tree/master/js): client js · Browser-side behavior for loading data and updating the DOM. · `js`
- [Route data](https://github.com/joguarino/festa-tracker/blob/master/percorso.json): content json · Local data source for the route/path page. · `percorso.json`
- [Program data](https://github.com/joguarino/festa-tracker/blob/master/programma.json): content json · Local data source for the schedule/program page. · `programma.json`
- [Live ref](https://github.com/joguarino/festa-tracker/blob/master/diretta.ref): reference file · Reference artifact associated with the live page. · `diretta.ref`
- [README](https://github.com/joguarino/festa-tracker/blob/master/README.md): docs · Repository overview and usage notes. · `README.md`

### Automation

Repository automation and deployment workflow.

- [Static CI](https://github.com/joguarino/festa-tracker/blob/master/.github/workflows/static.yml): github actions · Automation workflow for validation or static deployment. · `.github/workflows/static.yml`
- [VS Code](https://github.com/joguarino/festa-tracker/blob/master/.vscode): editor config · Local editor configuration for development. · `.vscode`

## Connections

- Home → Styles: styles · Loads shared styling.
- Home → Scripts: behavior · Uses browser-side scripts for interactions and rendering.
- Live → Styles: styles · Loads shared styling.
- Live → Scripts: behavior · Uses browser-side scripts for live view updates.
- Live → Live ref: reference · Uses or compares against the live reference artifact.
- Route → Styles: styles · Loads shared styling.
- Route → Scripts: behavior · Uses browser-side scripts for route rendering.
- Route → Route data: data · Reads local route content.
- Program → Styles: styles · Loads shared styling.
- Program → Scripts: behavior · Uses browser-side scripts for schedule rendering.
- Program → Program data: data · Reads local schedule content.
- Scripts → Route data: loads · Client-side code consumes route data.
- Scripts → Program data: loads · Client-side code consumes program data.
- Static CI → Home: deploy/check · Validates or publishes the static site.
- Static CI → Live: deploy/check · Validates or publishes the static site.
- Static CI → Route: deploy/check · Validates or publishes the static site.
- Static CI → Program: deploy/check · Validates or publishes the static site.
- README → Home: documents · Explains the site entry points and usage.
- VS Code → Scripts: dev setup · Supports local development of the client scripts.
