Case Study

Questo sito

Una porta d'ingresso pubblica che combina portfolio, blog, workbench, generatori e una companion API.

Sistema live HTML/CSS/JS Hugo Rust/WASM Go GitHub Pages
Diagramma architetturale del sito AndreaBozzo che mostra landing page, blog Hugo, workbench Rust e WebAssembly, harvester Go, GitHub Pages e companion API Vercel

Anatomia del sistema

  1. Input

    • Structured JSON sources
    • Hugo blog content
    • README contribution badges
    • Live GitHub API
  2. Core

    • Go harvester + generators
    • Rust/WASM workbench engine
    • Hugo blog build
    • Vercel-hosted Go API
  3. Output

    • Generated case-study pages
    • Static GitHub Pages site
    • Live stats + badge endpoints
    • Interactive knowledge graph
Vincoli
  • Static-first delivery
  • Live API only where needed
  • Typed inputs everywhere
  • No CMS, no SPA framework

Perché esiste

Un sito personale non dovrebbe essere una pagina profilo sottile se il lavoro stesso è lavoro di sistemi. Questo repository è pensato per funzionare come porta d'ingresso pubblica, archivio di scrittura ed esempio concreto di come mi piace strutturare strumenti e piattaforme. Il sito è quindi trattato come un vero sistema: il contenuto è generato da sorgenti strutturate, il workbench ha dietro un motore Rust/WASM e il percorso di deploy è parte della storia invece che un dopo-pensiero.

Forma del sistema

Il sito root è HTML, CSS e JavaScript puri, la scrittura lunga vive in un blog Hugo, la logica interattiva del workbench è specchiata tra JavaScript e Rust compilato a WebAssembly, e le pagine work generate vengono da JSON strutturato invece che da HTML mantenuto a mano. Quella separazione tiene la superficie pubblica veloce e ispezionabile permettendo però tooling più ricco dietro: i generatori Go costruiscono artefatti, il blog organizza i post lunghi e la homepage può comportarsi come una piccola applicazione.

Centro tecnico

Il repository ora usa un harvester Go per generare artefatti di case study e di contribuzioni, GitHub Actions per assemblare e pubblicare il sito statico su GitHub Pages e una piccola API Go su Vercel per esporre statistiche GitHub live ed endpoint badge che la homepage può consumare. Il centro tecnico è il confine tra affidabilità statica e dati live: la maggior parte del sito resta cacheable e semplice, mentre la companion API gestisce i pezzi che davvero hanno bisogno di cambiare.

Prove correnti

Il repository espone già l'intero percorso pubblico del sistema: JSON strutturato e l'harvester Go generano gli artefatti di work e contribuzioni, Hugo costruisce il blog, la logica del workbench è specchiata in JavaScript e Rust/WASM, e GitHub Pages più l'API Vercel separano la delivery statica dalle statistiche GitHub live. Questo rende il sito utile sia come portfolio sia come implementazione ispezionabile delle stesse preferenze di design mostrate nel lavoro: input tipati, output generati, servizi piccoli e confini di deploy chiari.