michaelrmc / project-full-stack-portfolio

Full-stack Portfolio Project

This project is designed to test all of the skills you've learned so far. By the end of this project, you should have a portfolio-ready project you can share on your resume as well as with potential employers.

Project scoring

This project has three different parts on which you will be graded. Each part is weighted differently.

• 70% of the project is scored on completion.
• 20% of the project is scored through the mastery rubric.
• 10% of the project is scored through stretch goals.

In total, you must receive at least 70% to complete this project. For example, you could attain 55% of points through the completion requirements, 10% of points through the mastery rubric, and 5% of points through the stretch goals.

Completion

To complete this project, you will need to build a full-stack application that meets the following feature and technical requirements.

Overall requirements

1. Create a GitHub repository for both the front-end and back-end applications and upload your code to it.
2. Both the front-end and back-end applications should be successfully deployed to the web.
3. Your front-end repository should have a readme.md file with setup instructions for your application.
   • Your readme should also include links to your back-end GitHub repository, both of your deployed URLs, and a link to the Trello board you used to manage your work.
4. Your project should have a coherent theme and narrative.

Back-end feature requirements

To complete the back-end application, you will need to build a RESTful server that performs CRUD actions on a single resource.

5. Your server should incorporate at least one table that includes:
   • A primary key
   • At least 7 total fields
   • At least 4 different data types are used among those fields
6. Your table should have at least two constraints, which can include DEFAULT values.
7. A route exists to create new resources.
8. A route exists to read all resources.
9. A route exists to read a single resource.
10. A route exists to update a single resource.
11. A route exists to delete a single resource.
12. An appropriate "Not Found" response is given when a route is requested that does not match the created routes.

Front-end feature requirements

To complete the front-end application, you will need to build a React application that allows for CRUD operations to be performed on a single resource. You will also need to display the data thoughtfully and clearly.

13. All pages should include the same navigation bar, which includes the name of the application and a button to create a new resource.
14. You should have an Index page that presents all of the resources in your database table.
15. After clicking on a single resource, you should be brought to a Show page which includes more detailed information about the specific resource.
16. When the button in the navigation bar to create a new resource is clicked, you should be brought to a new page that includes a form to create a new resource.
17. Forms should be properly labeled and the type of inputs should be properly set. For example, an input that requires a number should have type number, not text.
18. When a new resource form is submitted, the resource should be created in the database and the user should be brought to that new resource's Show page.
19. On the resource's Show page, there should be a button to edit the current resource. When clicked, the user is brought to a form page with data already filled in that can be edited.
20. When an edited resource form is submitted, the resource should be edited in the database and the user should be brought to that existing resource's Show page.
21. On the resource's Show page, there should be a button to delete the current show page. When clicked, a message is displayed that asks the user if they are sure they want to delete the resource. If the user confirms, the resource is deleted and the user is brought to the Index page.
22. Using the resource's data, perform a calculation or create a useful feature (e.g., sort, filter, infinite-scroll) that can be performed on the front-end application and displayed to the user that has not been demonstrated in class.
    • For example, if your app has a list of products, load the first 10 and when the user scrolls to the bottom the next ten are loaded. Your sort or filter feature may take more than one argument and/or include being able to sort in ascending or descending order.

Mastery rubric

This section of the project is designed to measure your increasing skill at writing good code and following best practices.

To view components of the mastery rubric, view the appropriate assignment on Canvas.

Stretch goals

This section of the project measures your ability to go above and beyond in creating your project. To score points in this section, you should incorporate a feature, technology, or skill not explicitly required by the project instructions.

When you submit your pull request, make sure to include a description of any stretch goals you implemented. You may choose from the list below or come up with features or tasks that are more relevant to your specific implementation of the project.

• Display errors to your user when they incorrectly fill out a form attempting to create or update a resource.
• Add a one-to-many table relationship to your database.
• Create middleware as part of your back-end application that validates for particular values when a resource is being created or updated.
• Use query parameters to filter your resource by different fields or qualities.
• When viewing all resources, break up your resources visually onto multiple pages.
• Visually allow for interacting with a second resource from the front-end.
• Allow for a list of "favorite" resources that are stored locally through localStorage.
• Make your application responsive to different kinds of devices.

Points will be allocated in this section at the discretion of the instructor.

Getting started

Do not fork this repository. Instead, create your repositories on GitHub and submit the URL directly to Canvas.

Then, follow the specifications above to create your application. Work with your instructors to approve your features before you begin working on them.