services/EnergyCalculatorWeb
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
874410a7740fedd48b2021c47fc0ec874f2d2517
EnergyCalculatorWeb/README.md
dnviti 38499e2ffa first commit
2025-06-05 01:25:47 +02:00

5.2 KiB
Raw Blame History

Calcolatore Costi Elettricità (Electricity Cost Calculator)

Questo progetto è una semplice applicazione web per calcolare il costo stimato del consumo di elettricità. L'utente può inserire la potenza media di un dispositivo, il costo dell'energia per kWh e la durata di utilizzo. L'applicazione simula quindi un consumo leggermente randomizzato per fornire una stima più realistica e visualizza i risultati insieme a un grafico dell'andamento del consumo.

✨ Caratteristiche Principali

  • Input Utente:
    • Potenza media del dispositivo (Watt)
    • Costo dell'energia per kWh (nella valuta locale)
    • Durata di utilizzo (Ore)
  • Calcolo e Output:
    • Energia totale consumata (Wh, kWh o MWh, a seconda della scala)
    • Costo totale stimato
  • Simulazione Realistica:
    • Introduce una leggera fluttuazione (±20%) sulla potenza media per simulare un consumo non lineare.
  • Visualizzazione Grafica:
    • Un grafico a linee mostra l'andamento simulato della potenza consumata nel tempo.
    • Una linea aggiuntiva mostra la potenza media inserita per confronto.
  • Interfaccia Moderna:
    • Realizzata con Tailwind CSS per un design pulito e responsivo.
  • Localizzazione:
    • Interfaccia utente tradotta in italiano.
  • Containerizzazione:
    • Dockerfile incluso per eseguire l'applicazione con Nginx.
  • Continuous Integration:
    • Workflow GitHub Actions per buildare e pubblicare automaticamente l'immagine Docker su GitHub Container Registry (GHCR).

🛠️ Tecnologie Utilizzate

  • Frontend: HTML, CSS (Tailwind CSS), JavaScript
  • Grafici: Chart.js
  • Web Server (in Docker): Nginx
  • Containerizzazione: Docker
  • Continuous Integration: GitHub Actions

🚀 Come Iniziare

Prerequisiti

  • Un browser web moderno (es. Chrome, Firefox, Safari, Edge)
  • Docker (opzionale, per l'esecuzione tramite container)
  • Git (opzionale, per clonare il repository)

Esecuzione Locale (Senza Docker)

  1. Clona il repository (opzionale):
    git clone [https://github.com/dnviti/EnergyCalculatorWeb.git](https://github.com/dnviti/EnergyCalculatorWeb.git)
    cd EnergyCalculatorWeb

    Oppure, scarica semplicemente il file index.html.

  2. Apri il file index.html:
    Fai doppio clic sul file index.html o aprilo direttamente con il tuo browser web.

Esecuzione con Docker

  1. Assicurati che Docker sia in esecuzione.

  2. Costruisci l'immagine Docker:
    Naviga nella directory principale del progetto (dove si trova il Dockerfile) ed esegui:
    docker build -t electricity-calculator-app .

  3. Esegui il container Docker:
    docker run -d -p 8080:80 electricity-calculator-app

    • -d esegue il container in background.
    • -p 8080:80 mappa la porta 8080 del tuo computer alla porta 80 del container (dove Nginx è in ascolto). Puoi cambiare 8080 se necessario.

  4. Accedi all'applicazione:
    Apri il tuo browser e vai a http://localhost:8080.

🐳 Immagine Docker

L'applicazione può essere eseguita come un container Docker. Il Dockerfile utilizza un'immagine Nginx stable-alpine per servire il file index.html.

L'immagine Docker viene automaticamente buildata e pubblicata su GitHub Container Registry (GHCR) ad ogni push sul branch main.

Pull dell'immagine da GHCR (esempio):

docker pull ghcr.io/dnviti/electricity-calculator-app:latest

(Sostituisci TUO_USERNAME con il tuo nome utente o organizzazione GitHub)

🔄 Continuous Integration (GitHub Actions)

Il file .github/workflows/docker-publish.yml definisce un workflow di GitHub Actions che:

  1. Si attiva ad ogni push sul branch main o manualmente.
  2. Effettua il checkout del codice.
  3. Esegue il login a GitHub Container Registry.
  4. Estrae metadati per i tag dell'immagine Docker.
  5. Costruisce l'immagine Docker utilizzando il Dockerfile presente nel repository.
  6. Pubblica l'immagine Docker su GHCR (ghcr.io/TUO_USERNAME/electricity-calculator-app).

💻 Come Usare l'Applicazione Web

  1. Apri l'applicazione nel tuo browser.
  2. Nel pannello "Inserisci i Dati":
    • Inserisci la Potenza Media del dispositivo in Watt.
    • Inserisci il Costo per kWh nella tua valuta (es. 0.25).
    • Inserisci la Durata di utilizzo in ore.
  3. Clicca sul pulsante "Calcola".
  4. I risultati appariranno nel pannello "Risultati Stimati":
    • Energia Totale Consumata.
    • Costo Totale Stimato.
  5. Il grafico "Andamento del Consumo Energetico Simulato" mostrerà la variazione simulata della potenza nel tempo.

🤝 Contributi

I contributi sono benvenuti! Se hai suggerimenti o miglioramenti, sentiti libero di aprire una issue o una pull request.

  1. Forka il Progetto
  2. Crea il tuo Branch per la Feature (git checkout -b feature/AmazingFeature)
  3. Committa le tue Modifiche (git commit -m 'Add some AmazingFeature')
  4. Pusha sul Branch (git push origin feature/AmazingFeature)
  5. Apri una Pull Request

📄 Licenza

Distribuito sotto la Licenza MIT. Vedi LICENSE.txt per maggiori informazioni (se presente, altrimenti si assume MIT).

Questo README è stato generato per il progetto Calcolatore Costi Elettricità.