/AseFioi2017

Repository per il corso ASE 2017

Primary LanguageRubyMIT LicenseMIT

AseFioi 2017

This repository contains the material for the "Advanced Software Engineering" course at University of Trento, 2017-2018 edition.

BillingFioi

BillingFioi is a system used by users that need to keep track of their worked hours and create invoices based on that.

We got a user that can add his clients and record hours linked to a specific client. Once he is ready, he can create an invoice and save it as PDF. This system also lets you check all the statistics that you need in /statistics page, where you can visualise all data with tables and graphs.

System Requirements

This web app is developed in Ruby On Rails, so you need to install it on your machine before installing our app.

This app needs Rails 5.1.4 and Ruby 2.4.2.

We tested it on:

  • Ubuntu 17.10
  • Mac OS X 10.13

Installing

  • Clone the repository using git clone https://github.com/ImGere/AseFioi2017.git :octocat:.
  • Then from terminal type:
    • cd Assignments/AppFatturazione/ # to go into the app directory
    • bundle install # to install all the gems 💎 that are needed in this app
    • rails db:migrate # to create the db and execute all the migrations
    • rails server # to launch the webserver (Puma in this case) and to be able to run our app in your browser
  • Go to http://localhost:3000/
  • Now you are ready to go you just need to sign up and start adding your hours and clients.

Upgrading

Instead of cloning the repository you just need to pull the new code:

  • Go to the repository folder from your terminal and run git pull :octocat:.
  • Then the process is the same:
    • cd Assignments/AppFatturazione/ # to go into the app directory
    • bundle install # to install all the gems 💎 that may be needed with the upgrade
    • rails db:migrate # to execute all the migrations
    • rails server # to launch the webserver (Puma in this case) and to be able to run our app in your browser
  • Go to http://localhost:3000/
  • Now you are ready to go with the updated source code and the new features.

Tests

In order to run test you need to go into the project folder and run rake cucumber. Note that you need to install a specific add-on on Mozilla Firefox to be able to check the delete billed/unbilled hours and delete clients 'cause bugs.

💎 Tested with cucumber

Coverage

You can check this application's test coverage by running rake cucumber and then open the Assignments/AppFatturazione/coverage/index.html that has been created, where there are useful information about the code that has been covered in the tests.

💎 Created with simplecov

Application's structure

Here is the application's structure:

Controllers

Controller

Models

Models

💎 Created with railsroady

License

BillingFioi is distribuited under the terms of the MIT License.

See LICENSE for datails.

Copyright

Copyright ©️ 2017 Gerevini Alessandro, Coba Paolo and Pietro Fabris.

Team 🚀

Developer name Matricola
Alessandro Gerevini 186052
Paolo Coba 185013
Pietro Fabris 188417

You can even check us in the /about page when you run it to get more information about us and who we are. 🎆