/Budget-app

This is an educational project is about building a mobile web application where you can manage your budget.

Primary LanguageCSSMIT LicenseMIT

BudgetOnRails

This is an educational project is about building a 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 Ruby on Rails application that 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.

Learning 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.

Project Documentation 📄

Here is the presentation video link👈 https://drive.google.com/file/d/1VvoRzbA8VvHDA4HTo09LZ8Qdrii4QjK8/view?usp=sharing

Built With 🛠️

  • Programming Language: Ruby
  • Framework: Ruby on Rails
  • Linter: Rubocop
  • Code Editor: VS Code

Getting Started

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

  • $ git clone the repo url
  • $ cd yourrepo
  • $ bundle
  • $ rails db:setup
  • $ rails s

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 repo url

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

Authors

👤 Sahar Saba Amiri

🤝 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.