Skills Assignment SA5-EV: Model Associations Explanation Video

Getting Started

  1. Access the GitHub organization’s repositories page.
    • In your web browser, log into GitHub.
    • Navigate to the repositories page of the memphis-comp-7012-2024-08fall GitHub organization.
  2. Create a new repository from the template.
    • Click the New repository button at the top-right of the page.
    • Fill out the Create a new repository form as follows:
      • Repository template: Select template-sa5-ev.
      • Owner: Select memphis-comp-7012-2024-08fall.
      • Repository name: Use the form below to generate the name for your repository.
        • It is required that your repository’s name precisely follow the format produced by the form.
      • Select Private, so that only you and your instructors can access your repository.
    • Once you have filled out all the fields, click the Create repository button at the bottom right of the page.
  3. Clone the repository and set up your local environment.
    • In your terminal, clone the newly created repository into your workspace folder.
    • Set up local repository by following steps similar to those in the Running Apps demo.

sa5-ev-hjsimpson-1

Task

The aim of this project is enable users to create and edit basketball team rosters. The project already includes a Team model class and a Player model class, as per this class diagram:

Along with these model classes, the app includes the standard resource-CRUDing pages and UI features for Team model objects (but not for Player objects). It also includes model validations and database seeds. (You can ignore the test fixtures and model tests for this assignment.) It is recommended that you initialize and run the base app at this point, so you can see what’s there.

Task to perform:

In the video, be sure to use all features that you create, so that it’s clear that they work. Don’t forget to enter invalid data into the forms.

Detailed Specifications

Existing Functionalities

New Functionalities

Additional Constraints:

Note: Italicized requirements will be manually confirmed by the graders.

Testing Your Work with RSpec

Each of the feature stories above corresponds to an RSpec feature spec. These tests (and others for the additional constraints) have been provided in the repository to help you check whether your implementation meets the requirements.

  1. Read through the detailed specifications first. Understand what is required for each page and scenario.
  2. Approach 1 - for those familiar with Test-Driven Development (TDD):
    • Run rspec spec/features to execute the feature tests.
    • Try to write the minimum amount of code needed to make each test pass.
    • Watch the tests fail and pass as you meet each requirement.
    • At the end, run all the provided tests with the rspec command to check if everything passes.
      • Note that not all tests are feature tests, so it is necessary to run rspec at the end to ensure that all tests are run.
  3. Approach 2 - for those less experienced with testing:
    • Work through the specifications step by step, ensuring your implementation meets each requirement.
    • Once you’ve completed your implementation, run all the tests with the rspec command to check if everything passes.

Either of the above approaches is fine, as long as all tests pass by the end.

How to Submit Your Work

Once you’ve completed the task and confirmed that all tests pass:

  1. Commit your changes:

    • Add all your changes:

      git add -A

    • Commit your work with a meaningful message:

      git commit -m "Completed SA5 Explanation Video"
  2. Push your changes to GitHub:

    • Push your commits to the remote repository:

      git push
  3. Submit to Canvas:
    • In Canvas, submit:
      • The link to your GitHub repository where your code is hosted.
      • The link to your video if you are using Teams to record. (If you are not using Teams, then upload the video file.)
    • You may submit the links in a single document.