|
1 |
| -# Project Template |
| 1 | +**Welcome to Bargain Bin Quizlet (BBQ for short)!** |
2 | 2 |
|
3 |
| -This is a template repository for CSC 207 projects. |
4 |
| -This repository contains starter code for a gradle project. |
5 |
| -It also contains workflow documents that give instructions on how to manage your Github repository and how to use Github Projects for efficient collaboration. |
| 3 | +This is a flashcard study application inspired by Quizlet. |
6 | 4 |
|
7 |
| -## Checklist For Your Project |
8 |
| -- [ ] Verify the correct settings for your project repository |
9 |
| -- [ ] Set up Github Projects |
10 |
| -- [ ] Create the implementation plan using issues and Github Projects |
11 |
| -- [ ] Create deveopment branches for your features |
12 |
| -- [ ] Use pull requests to merge finished features into main branch |
13 |
| -- [ ] Conduct code reviews |
| 5 | +# Main Features |
14 | 6 |
|
15 |
| -**If your team has trouble with any of these steps, please ask on Piazza. For example, with how GitHub Classroom works, your team *may* not have permissions to do some of the first few steps, in which case we'll post alternative instructions as needed.** |
| 7 | +### 1. Log in or sign up for the application. |
16 | 8 |
|
17 |
| -## Workflow Documents |
| 9 | +### 2. Create a flashcard or a flashcard set. |
18 | 10 |
|
19 |
| -* Github Workflow: Please refer to the workflow that was introduced in the first lab. You should follow this when working on your code. The following document provides additional details too. |
| 11 | +### 3. Edit a flashcard or a flashcard set. |
20 | 12 |
|
21 |
| -* [Project Planning and Development Guide](project_plan_dev.md): This document helps you to understand how to create and maintain a project plan for your class project. **This document helps you to complete the Implementation Plan Milestone.** |
| 13 | +### 4. Delete a flashcard or a flashcard set. |
22 | 14 |
|
23 |
| -## Gradle Project |
24 |
| -Import this project into your Intellij editor. It should automatically recognise this as a gradle repository. |
25 |
| -The starter code was built using SDK version 11.0.1. Ensure that you are using this version for this project. (You can, of course, change the SDK version as per your requirement if your team has all agreed to use a different version) |
| 15 | +### 5. Search for a public flashcard set. |
26 | 16 |
|
27 |
| -You have been provided with two starter files for demonstration: HelloWorld and HelloWorldTest. |
| 17 | +### 6. Study from a flashcard set. |
28 | 18 |
|
29 |
| -You will find HelloWorld in `src/main/java/tutorial` directory. Right click on the HelloWorld file and click on `Run HelloWorld.main()`. |
30 |
| -This should run the program and print on your console. |
| 19 | +### 7. Generate and take a quiz from a flashcard set. |
| 20 | +- Given a flashcard set, the user can enter quiz mode. |
| 21 | +- Quiz mode features three types of questions: multiple choice, text entry, and true/false. |
| 22 | +- First, the user toggles a set of quiz settings (such as number of questions, question types, and timer). |
| 23 | +- Then, the user submits their quiz settings and a quiz is automatically generated for them. |
| 24 | +- After taking and submitting the quiz, the user can receive their quiz results and identify which questions they answered incorrectly. |
31 | 25 |
|
32 |
| -You will find HelloWorldTest in `src/test/java/tutorial` directory. Right click on the HelloWorldTest file and click on `Run HelloWorldTest`. |
33 |
| -All tests should pass. Your team can remove this sample of how testing works once you start adding your project code to the repo. |
| 26 | +### 8. Save user and flashcard data to the database. |
34 | 27 |
|
35 |
| -Moving forward, we expect you to maintain this project structure. You *should* use Gradle as the build environment, but it is fine if your team prefers to use something else -- just remove the gradle files and push your preferred project setup. Assuming you stick with Gradle, your source code should go into `src/main/java` (you can keep creating more subdirectories as per your project requirement). Every source class can auto-generate a test file for you. For example, open HelloWorld.java file and click on the `HelloWorld` variable as shown in the image below. You should see an option `Generate` and on clicking this your should see an option `Test`. Clicking on this will generate a JUnit test file for `HelloWorld` class. This was used to generate the `HelloWorldTest`. |
| 28 | +# How to run the application? |
36 | 29 |
|
37 |
| - |
38 |
| - |
39 |
| -You can create another simple class and try generating a test for this class. |
| 30 | +Run src/main/java/Main.java. |
0 commit comments