{"id":15152580,"url":"https://github.com/solirius/grad_academy_debug_app","last_synced_at":"2025-04-01T17:33:10.804Z","repository":{"id":246880086,"uuid":"822496877","full_name":"Solirius/grad_academy_debug_app","owner":"Solirius","description":"About Exam app for grad training debugging exercise","archived":false,"fork":false,"pushed_at":"2024-07-24T13:11:26.000Z","size":182,"stargazers_count":0,"open_issues_count":0,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-02T17:07:14.789Z","etag":null,"topics":["bootstrap","css","forms","html","ruby-on-rails","training"],"latest_commit_sha":null,"homepage":"https://exam-grad-training-app-2db294b62f5c.herokuapp.com/","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Solirius.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-01T09:08:41.000Z","updated_at":"2024-07-16T08:24:30.000Z","dependencies_parsed_at":"2024-07-16T10:51:33.078Z","dependency_job_id":null,"html_url":"https://github.com/Solirius/grad_academy_debug_app","commit_stats":null,"previous_names":["solirius/grad_academy_debug_app"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solirius%2Fgrad_academy_debug_app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solirius%2Fgrad_academy_debug_app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solirius%2Fgrad_academy_debug_app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Solirius%2Fgrad_academy_debug_app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Solirius","download_url":"https://codeload.github.com/Solirius/grad_academy_debug_app/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222749365,"owners_count":17031913,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","css","forms","html","ruby-on-rails","training"],"created_at":"2024-09-26T16:03:50.823Z","updated_at":"2024-11-02T17:07:22.165Z","avatar_url":"https://github.com/Solirius.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grad Academy Debugging App\n\nThis is the base Graduate Academy debugging app (no errors - at least, not intentional). The following is a setup guide for new starters.\n\n## Contents\n- Setup 💻\n  - [General Setup (Clone Repository, Setup Ruby)](#general-setup-clone-repository-setup-ruby)\n  - [Setting Up the Ruby on Rails App](#setting-up-the-ruby-on-rails-app)\n    - [PostgreSQL](#postgresql)\n    - [Ruby on Rails](#ruby-on-rails)\n    - [Setting Up the Ruby on Rails Database](#setting-up-the-ruby-on-rails-database)\n- [Running the Application](#running-the-application)\n\n## Setup 💻\n\nIn this setup, you will:\n- Have all the necessary technology on your machine:\n  - Terminal (with Xcode installed)\n  - Homebrew\n  - VSCode\n  - Github account\n  - Github CLI\n  - Rbenv\n  - Ruby\n\n### General Setup (Clone Repository, Setup Ruby)\n\n1. **Clone the Repository**:\n   - If you need a refresher on how to setup your laptop, or want to do this again at another time, follow this tutorial: [training_github_pages](https://github.com/Solirius/training_github_pages) tutorial.\n   - Git clone the repository:\n     - Click on the green `\u003c\u003e Code` button.\n     - Select `SSH`.\n     - Copy the value, e.g., `git@github.com:lambley/exam-grad-training-app.git`.\n     - On your machine, in the folder you want this app to be in, use this command in your terminal:\n     ```bash\n     git clone git@github.com:lambley/exam-grad-training-app.git\n     ```\n\n2. **Install rbenv**:\n   - Ensure you have `rbenv` installed - this project uses `Ruby 3.3.0`.\n   - Install via this command in your terminal (read more [here](https://github.com/rbenv/rbenv)):\n     ```bash\n     brew install rbenv ruby-build\n     # then run the following command after install is complete\n     rbenv init\n     ```\n\n3. **Install Ruby**:\n   - Run the following command in your terminal to install the version of Ruby we're using (this will take a few minutes to install):\n     ```bash\n     rbenv install 3.3.0\n     ```\n\n4. **Verify Ruby Installation**:\n   - To check that you have installed Ruby correctly, run the following commands:\n     ```bash\n     rbenv local\n     # you should see this output:\n     # 3.3.0\n     rbenv shell\n     # you should also see this output:\n     # 3.3.0\n     ```\n   - If you get errors like `rbenv: no shell-specific version configured`, you need to set the version for the local or shell environments. To do so, run either `rbenv shell 3.3.0` or `rbenv local 3.3.0`.\n\nAt this point, you should have:\n- A working Terminal with Github working on the command line.\n- A local version of this application on your machine.\n- rbenv and Ruby 3.3.0 installed on your device.\n\n\u003e **IMPORTANT**:\n\u003e If you are stuck for more than 15 minutes during setup or encounter any unexpected errors, please speak to one of the tutors.\n\n### Setting Up the Ruby on Rails App\n\nIn this section, you will:\n- Install PostgreSQL database software via Homebrew.\n- Install application dependencies.\n- Setup the database.\n- Launch the app on `localhost:3000`.\n\n#### PostgreSQL\nTo install PostgreSQL, use the following commands in your terminal:\n\u003e Read more about PostgreSQL setup [here](https://wiki.postgresql.org/wiki/Homebrew)\n```bash\nbrew install postgresql@15 libpq\nbrew link --force libpq\n```\n- To check that you have installed PostgreSQL correctly, run the following:\n```bash\n# to login to the default database\npsql -d postgres\n```\nyou should see:\n```bash\npsql (15.x)\nType \"help\" for help.\n\npostgres=#\n```\nto exit, type in `\\q;` or `exit;` (semicolon may not be necessary)\n\n#### Ruby on Rails\nTo setup `Ruby on Rails`, we will use the `Bundler` package manager.\n\nIdeally, open the terminal window in VSCode:\n  - Terminal \u003e New Terminal\n  - Or, `Ctrl + Shift + Backtick`\n\n- To install `bundler`:\n```bash\ngem install bundler\nrbenv rehash\n```\n\n- In the terminal, then run `bundle install` (or just `bundle`)\n  - This will install all the application dependencies, including the Ruby on Rails framework\n\n#### Setting up the Ruby on Rails database\nNow that we have PostgreSQL and all our dependencies installed, you need to run the following commands to setup the database.\n\nIn the terminal run:\n```bash\nrails db:setup\nrails db:migrate\n```\nYou should see this:\n\n![example database setup output](public/docs/images/image-1.png)\n\nWe will know populate the database with some dummy records:\n```bash\nrails db:seed\n```\n\nThat's it, the database is setup!\n\n## Running the Application\n\nTo run the Ruby on Rails Application, run this command in the terminal:\n```bash\nrails server\n```\n\nYou should see this:\n![example rails server initial output](public/docs/images/image-2.png)\n\nNavigate to `http://127.0.0.1:3000` in your browser. When you do, you will see the server window update - these are your server logs - very important in debugging!\n\n![example server logs](public/docs/images/image-3.png)\n\n# Setup finished\n\nYou should be setup to start debugging. Follow the debugging document and try to find and solve each error.\n\nGood luck and happy debugging 🐛\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolirius%2Fgrad_academy_debug_app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsolirius%2Fgrad_academy_debug_app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsolirius%2Fgrad_academy_debug_app/lists"}