Vuoi contribuire allo sviluppo?

Nonostante usufruibile pubblicamente all'indirizzo http://brewday.officinasoftware.com, il software non è attualmente rilasciato con licenza Open Source, ma non è detto che non lo sarà in futuro.

Qualora volessi comunque dare il tuo contributo allo sviluppo del software o fossi solamente curioso di vedere come è stato sviluppato, è possibile contattare Marco, che valuterà la possibilità di includerti nel team e fornirti l'accesso al Repository GitHub su cui risiede il codice sorgente.

Come è sviluppato

Come illustreremo meglio nel capitolo sulla Implementazione, il progetto è sviluppato con architettura .NET MVC 5 in Microsoft Visual Studio Community 2017. Lato server usiamo Entity Framework 6 e un database SQL Server 2016 Express LocalDB con approccio Code First. I componenti principali dell'interfaccia utente sono invece Bootstrap 3.3.7, jQuery UI e DataTables.

Procedura per eseguire il progetto in locale

Se hai già accesso al repository e vuoi compilare, buildare ed eseguire il progetto, è necessario scaricare gratuitamente Microsoft Visual Studio Community e durante l'installazione premunirsi che vengano installati i seguenti pacchetti e componenti:

• Sviluppo ASP.NET e Web
  • .NET Framework 4.6+ (e inferiori)
  • Servizi di linguaggio Razor
  • Strumenti di Entity Framework 6
• Elaborazione ed archiviazione dati
  • IIS Express
  • LocalDB per SQL Server Express
• Gestione pacchetti NuGet
• Strumenti di LINQ to SQL
• GIT e GitHub Extensions for VS [opzionale]

É doveroso far notare che il progetto è stato sviluppato con .NET Framework 4.5.2 ed è questa la versione che verrà usata in Visual Studio, ma è necessario aver installato una versione .NET 4.6+ per l'analisi statica del codice tramite SonarQube.

Una volta clonata la repository GitHub, è possibile aprire direttamente il progetto con Visual Studio e lanciare innanzitutto una ricompilazione (menù Debug > Ricompila soluzione).

Questo non è sufficiente, poiché sarà necessario far generare a Visual Studio il database, secondo approccio Code First di Entity Framework. Aprire quindi la Console di Gestione pacchetti NuGet (menu Strumenti > Gestione pacchetti NuGet > Console di gestione pacchetti) e dopo aver selezionato BrewDay.Domain come progetto predefinito dal menù a tendina (reperibile nella parte alta della console stessa), lanciare in sequenza i comandi:

Enable-Migrations –EnableAutomaticMigrations
Update-Database –Verbose [-Force]

Il primo comando serve ad abilitare le migrazioni automatiche code first e andrà a creare una cartella Migrations nel progetto Domain. Il secondo comando aggiorna il database (se necessario) e va lanciato (sul progetto giusto) ogni volta che si modifica una classe in BrewDay.Domain.Entities

Dopodiché, nella finestra Esplora Soluzioni è possibile fare click destro sul progetto BrewDay.Web > Imposta come progetto di avvio.

Finalmente eseguire il progetto (click sul play verde in alto o Debug > Avvia Debug).

Problemi ed estensioni

Per qualsiasi problema riscontrato durante la procedura di esecuzione del progetto o consigli sulle estensioni utili per Visual Studio, contattare Marco.