shop audit and subject

subjects/shop/README.md

@@ -0,0 +1,105 @@
+### Shop
+
+### Objectives
+
+In this project a website will be given to you. This website is still in the creation process, so not all features are available. The purpose is for you to implement some of the missing features.
+
+You should also know that the website was created using Rails, a web application development framework written in Ruby. You can learn more about this framework in its own [website](https://guides.rubyonrails.org/getting_started.html).
+
+You will have to create an e-Commerce shop application with user authentication where you can sell any type of product.
+As we said some of the process is already done, so first of all lets see what you will have to implement.
+
+### Instructions
+
+In this website the goal is for you to fix it so that it will be possible to create users and those users will be able to create adds to sell products in the website.
+
+To create an add you will have to go to the `Sell` button and create the add. You will be able to give a title to your add, a price, a model and a description. You also must select a brand, a finish, a condition to your product and you will be able to choose images from your folder in app/assets/images.
+
+First you will have to implement a controller called `registrations_controller` that can be found incomplete in app/controllers. You will need [Devise](https://github.com/heartcombo/devise) witch is a flexible authentication solution for Rails based on Warden.
+
+- You will have to create two definitions in this controller:
+
+The first one is `sign_up_params` where you will have to permit the necessary params to sign up, which are:
+
+        - name
+        - email
+        - password
+        - password_confirmation
+
+The second one is`account_update_params` and you will also need to permit the necessary params to edit or update an account, which are:
+
+        - name
+        - email
+        - password
+        - password_confirmation
+        - current_password
+
+- You will also need to compleat the `products_helper.rb` located in app/helpers. This helper will be responsible for showing who is selling the products and who is able to edit and delete the adds, in this case who created the add. So you will have to find a way to show the name of the seller in each product.
+
+- You have to find a way so that only the user who creates an add can also permanently delete it. Only the users who create the adds can edit or delete them.
+
+- All e-Commerce apps need some sort of Cart. So you will have to create a shopping cart to your application.
+
+To create the cart you will have to define a new model `Cart`.
+The cart must work like any other e-commerce shopping cart.
+
+- You must be able to add one or more items to the cart.
+- It must be shown a total, which is the sum of all the products in the cart. This total must be updated every time you add or remove an item from the cart.
+- The cart must have an `Empty Cart` button, that clears the cart and takes you bak to the home page.
+- It must be possible to remove single items from the cart as well, without emptying the cart.
+- The message "Added to your cart" and "Removed from your cart" must be shown when you add or remove something from the cart. This messages must disappear from the screen after a short time.
+- You must add a shopping cart icon, that shows the number of items in the cart, in the home page that updates each time you add a new product.
+
+- You will have to create a concern in models/concerns/ called `current_cart.rb`. A concern is similar to a helper of which you can include in controllers throughout the app. This concern must allow you to add stuff to the cart when your not signed in and then when you sign in to an account the cart will have the products that you added before you sign in.
+
+#### Ruby on Rails
+
+Ruby is a programming language, similar to Python and Perl. It is dynamically typed, interpreted, and can be modified at runtime (such as adding new methods to classes). It has many shortcuts that make it very clean, methods are rarely over 10 lines. It has good RegEx support and works well for shell scripting.
+
+Rails is a gem, or a Ruby library. Rails help make web applications, providing classes for saving to the database, handling URLs and displaying html (along with a webserver, maintenance tasks, and much more).
+
+This project was created using:
+
+- Ruby 3.0.0
+- Rails 6.1.3
+
+If you decide to install other versions you will need to update your gems according to the version you are using. If you go with this versions you already have the necessary gems in your gemfile.
+
+Now, that you know what the project is about, we will explain you the file system architecture.
+
+When starting a new Rails project (with the command `rails new name_of_project`).
+This will create a Rails application in a directory with the given name and then you will need to install the gem dependencies using the command `bundle install`.
+
+You can learn more about the purpose of each directory that is created [here](https://www.tutorialspoint.com/ruby-on-rails/rails-directory-structure.htm).
+
+Here are some commands that you may need and that were used in the project:
+
+- `bundle install`
+- `bundle update`
+- `rails` -> It will give you a list of commands you can use.
+- `rails s` -> runs a server in the port 3000 by default.
+- `rails g scaffold Product brand:string model:string description:text condition:string finish:string title:string price:decimal --no-stylesheets --no-javascripts` -> Product will be our main model within the app. Scaffolding in Ruby on Rails refers to the auto-generation of a set of a model, views and a controller usually used for a single database table.
+- `rails g controller store index` -> Creates a controller named store that will have the Index path to go to if you need.
+- `rails generate uploader Image` -> This create an uploader and should give you a file in "app/uploaders/Image_uploader.rb"
+- `rails g migration add_image_to_products image:string` -> This will create the migration.
+- `rails db:migrate` -> Checks which missing migrations still need to be applied.
+
+You can get the code which is already done [here](https://assets.01-edu.org/shop/shop.zip). You will notice that there is some code missing. Your task is to complete it so that the website works as explained above.
+
+You should do this steps after unzipping:
+
+- bundle install
+- bundle update
+- rails db:migrate
+- rails db:seed
+- rails s
+
+### Bonus
+
+As bonus for this project there are a couple things you could do:
+
+- You can add a category to the product so that the user can chose between cars, clothes, computers and many more. Or you can add more fields to describe the products, for example add more brands.
+- Create a button `add to cart` so that it is possible to add a product to the cart without opening the adds?
+- Find a way to remove items from the cart one by one.
+- You can implement your own display and design?
+- Add a payment method.

subjects/shop/audit/README.md

@@ -0,0 +1,91 @@
+### Functional
+
+##### Try to create a new user and login.
+
+###### Can you confirm that the user was created?
+
+##### Go tho the home page using the user you created.
+
+###### Is it impossible to edit and delete products that were not created by your user?
+
+##### Try to sell a product by creating an add with the user created.
+
+###### Can you confirm that it is possible to create adds and sell a product using your user?
+
+##### Go to the home page and try to edit the add that you have created.
+
+###### Can you confirm that it is possible for you to edit your own add?
+
+##### Try to create another new user, login and create at least two new adds.
+
+###### Can you confirm that the new user and the adds were created?
+
+##### Login in the first user and check if the adds created by the second user are there.
+
+###### Can you confirm that the adds created by the second user are present?
+
+##### Go to the home page with a user at your choice and try to delete an add that you have created.
+
+###### Can you confirm that it is possible for you to delete your own add?
+
+##### Go to the home page with a any user and try to check who is selling each product.
+
+###### Can you confirm that it is possible for you to see who is selling the products without opening the add?
+
+##### Go to the home page and try to find the cart icon.
+
+###### Can you confirm that the cart icon is present in the home page?
+
+##### Try to add one item to the cart using the first user.
+
+###### Can you confirm that the item was added to the cart of the first user?
+
+###### Did the message "Added to your cart" appeared on the screen when you add something to the cart?
+
+###### Can you confirm that the cart icon in the home page shows the number "1", meaning that you have one product in the cart?
+
+##### Try to add four more items to the cart.
+
+###### Can you confirm that all the added items are present in the cart?
+
+###### Can you confirm that the cart icon in the home page shows the number "5", meaning that you have five product in the cart?
+
+##### Try to open your cart and check if you can see how much you have to pay for all the products in your cart.
+
+###### Can you confirm that the cart displays the total of all the products in your cart?
+
+##### Try to open your cart and remove one item from it.
+
+###### Can you confirm that the product was removed from the cart and the message "Removed from your cart" appeared on the screen?
+
+##### Try to go to the cart and check the total.
+
+###### Can you confirm that the total was updated when you removed the item?
+
+###### Can you confirm that the cart item in the home page was updated an shows the number "4", meaning that you have four product in the cart?
+
+##### Try to login with the second user and check if the cart is empty.
+
+###### Can you confirm that the cart is empty, and the cart from the first user was not carried to the second user?
+
+##### Try to logout and add items in the cart without any user. Now after you add items to the cart, login to one user at your choice.
+
+###### Can you confirm that the items that you added to the cart are present in the user cart?
+
+##### Try to add some items to the cart and then push the button `Empty cart`. After the message appears, confirm that you want to empty the cart.
+
+###### Did the message "Are you sure?" appeared on the screen for you to confirm the action?
+
+###### After the confirmation were you redirected to the home page?
+
+### Bonus
+
+###### +Can you confirm that the student created or added something new like a new brand or the category field?
+
+###### +Can you add a product to the cart without opening the add?
+
+###### +If you add to the cart four products form the same seller, can you remove just one from the cart and keep the other three?
+
+###### +Did the student implement its own display and design?
+
+###### +Did the student implement a payment method?