williamscch / budget_rails_app

Mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what.

Budget Rails Web App

Mobile web application where you can manage your budget: you have a list of transactions associated with a category, so that you can see how much money you spent and on what. The RoR application allows the user to:

• Register and log in, so that the data is private to them.
• Introduce new transactions associated with a category.
• See the money spent on each category.

The result should look similar to the following data model:

Objectives 🔖

• Use ruby gems as software packages system.
• Install Ruby on Rails framework.
• Understand Rails RESTful design and router.
• Use controllers to handle requests and render empty views.
• Use params from browser request in a safe way.
• Use preprocessed html file with embedded Ruby code.
• Use layouts and templates for shared content.
• Use database migration files to maintain database schema.
• Use validations for models.
• Secure app from n+1 problems.
• Understand what ORM is.
• Write SQL queries with ActiveRecord.
• Set up associations between models.
• Build a webapp that requires the user to log in.
• Use devise gem for authentication.
• Limit access to webapp resources based on authorization rules.
• Analyze in writing why you have made a coding choice using one structure over another.

Interface Preview

Project Documentation 📄

• Here is the presentation video link👈
• Here is the deployed app in Heroku👈

Built With 🛠️

• Programming Language: Ruby
• Framework: Ruby on Rails
• Linter: Rubocop
• Code Editor: VS Code
• Testing Libraries: RSpec, Capybara

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• A web browser like Google Chrome.
• A code editor like Visual Studio Code with Git and Ruby.

You can check if Git is installed by running the following command in the terminal.

$ git --version

Likewise for Ruby installation.

$ ruby --version && irb

To install rails, in the terminal kindly run this command

$ gem install rails

Setup

Clone the repository using the GitHub link provided below.

Install

In the terminal, go to your file directory and run this command.

$ git clone [e-mail]:mavericks-db/BudgetOnRails.git

Usage

Kindly modify the files as needed.

Run tests

To install rspec, in the terminal kindly run this command

$ gem install rspec

To run tests, please run this command

$ rspec ./spec/#{filename}_spec.rb

Author

👤 Williams Colmenares

• GitHub: @williamscch
• Twitter: @wdavidcch
• LinkedIn: Williams Colmenares on LinkedIn

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

Show your support

Give a ⭐️ if you like this project!

Acknowledgments

• Microverse
• Code Reviewers
• Original design idea by Gregoire Vella on Behance.

The Creative Commons license of the design requires that you give appropriate credit to the author. Therefore, you must do it in the README of your project.

📝 License

This project is MIT licensed.