insidegubbio

la guida digitale alla città di gubbio

insidegubbio.com

---

perché siamo open source

gubbio è una città piccola. le risorse sono poche, i contributori potenziali anche.

rendere il codice pubblico significa che chiunque può capire come funziona la piattaforma, segnalare un problema o proporre un miglioramento. per noi è anche una questione di trasparenza: non chiediamo fiducia a scatola chiusa, e teniamo alla privacy di chi usa i nostri servizi.

restano private solo le repo con contenuti editoriali o dettagli implementativi sensibili. il resto è tutto qui.

---

repos

🗄️ console · privata

console.insidegubbio.com

l'api principale della piattaforma. converte file .docx hostati su github in json strutturati a runtime.

esistono due versioni attive:

• v1 basata su cloudflare kv, con documenti in formato legacy
• v2 basata su build json generato da github actions, con documenti nel formato aggiornato

---

🖼️ araldo · pubblica

araldo.insidegubbio.com

media manager, fork di zipline. i media vengono serviti tramite bucket b2 backblaze (s3-compatible), rispettando la struttura di path configurata in zipline.

---

✏️ cancelliere · pubblica

cancelliere.insidegubbio.com

editor web per i file .docx hostati su github che alimentano console. sviluppato da zero, senza dipendenze da cms o servizi terzi.

funzionalità: modifica, rinomina e cancellazione di file word, supporto a cartelle, gestione di più branch, supporto a repo private, dark mode.

---

🌐 www · privata

frontend di insidegubbio. sincronizza con framer i componenti personalizzati del sito.

---

🤖 ikuvium · pubblica

ikuvium.insidegubbio.com

worker cloudflare che espone ikuvium, l'llm di insidegubbio per la generazione di itinerari personalizzati. basato su gemini. il prompt di sistema è privato, la struttura del worker è pubblica.

endpoint	descrizione
GET /api/v1/health	health check
POST /api/v1/itinerary	genera un itinerario a partire da input utente

---

🗺️ condottiero · pubblica

condottiero.insidegubbio.com

fork di gpx.studio con modifiche custom per gubbio. espone un endpoint /api/gpx per la generazione di file gpx da una lista di poi.

{
  "name": "string (opzionale)",
  "description": "string (opzionale)",
  "create_track": true,
  "routing": true,
  "profile": "foot | bike | car | mtb | racingbike | hike",
  "color": "hex (es. 0055ff)",
  "pois": [
    {
      "lat": 43.1122,
      "lon": 12.3888,
      "name": "fontana dei matti",
      "desc": "piazza quaranta martiri",
      "ele": 520
    }
  ]
}

---

🧭 gh.condottiero · pubblica

graphhopper.insidegubbio.com

istanza graphhopper custom per condottiero. copertura ridotta al centro italia per ottimizzare risorse e tempi di risposta.

---

📊 camerlengo · pubblica

camerlengo.insidegubbio.com

istanza umami per l'analytics privacy-friendly della piattaforma.

---

domini

dominio	servizio
console.insidegubbio.com	api contenuti
araldo.insidegubbio.com	media manager
condottiero.insidegubbio.com	mappe e gpx
graphhopper.insidegubbio.com	routing stradale
ikuvium.insidegubbio.com	llm itinerari
camerlengo.insidegubbio.com	analytics
status.insidegubbio.com	status dei servizi

---

come contribuire

se vuoi darci una mano, segnalare un bug o proporre una nuova funzionalità, apri una issue nella repository di riferimento. le pull request sono sempre benvenute!

licenza

i progetti pubblici di insidegubbio sono rilasciati sotto licenza GNU GPLv3, se non diversamente specificato.