This repository contains the material for the "Advanced Software Engineering" course at University of Trento, 2017-2018 edition.
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.
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
- Clone the repository using
git clone https://github.com/ImGere/AseFioi2017.git
. - Then from terminal type:
cd Assignments/AppFatturazione/
# to go into the app directorybundle install
# to install all the gems 💎 that are needed in this apprails db:migrate
# to create the db and execute all the migrationsrails 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.
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
. - Then the process is the same:
cd Assignments/AppFatturazione/
# to go into the app directorybundle install
# to install all the gems 💎 that may be needed with the upgraderails db:migrate
# to execute all the migrationsrails 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.
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
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
Here is the application's structure:
💎 Created with railsroady
BillingFioi is distribuited under the terms of the MIT License.
See LICENSE for datails.
Copyright ©️ 2017 Gerevini Alessandro, Coba Paolo and Pietro Fabris.
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. 🎆