Analysis

Requirements

1. Accepts a zipped file containing all student submissions for Object-Oriented Programming 1 Assignment 1.

• Expected structure of submissions.zip:

  submissions/
      Firstname_Lastname_816000000_A1/
      Firstname_Lastname_816000001_A1/

2. Extracts and processes the Java files in each student’s submission directory.

• Expected structure of student submission:

  Firstname_Lastname_816000000_A1/
      ChatBot.java
      ChatBotGenerator.java
      ChatBotPlatform.java
      ChatBotSimulation.java

3. Evaluates the functionality and correctness of each submission against the assignment specifications.

4. Calculates an overall score for each submission based on the assignment rubric.

5. Generates a PDF for each submission with the marks awarded and a breakdown of test case results including a description and its outcome (pass/fail).

---

Use Cases

Submission Processing

Pre-condition:

• A ZIP file containing student submissions.

Description:

• The autograder processes submissions using the GradingFacade. The GradingFacade accepts the provided ZIP file and extracts submissions using the SubmissionExtractor class. The SubmissionExtractor then organizes the extracted files into individual folders for each submission.
  
  

Submission Grading

Pre-condition:

• Student submissions have been successfully extracted and organized.

Description:

• The autograder utilises the GradingFacade to assess student submissions. The GradingFacade validates the Java files in each student submission against predefined test cases using the AssignmentTestRunner class. Grades are subsequently assigned based test case results. A comprehensive score for each class is then calculated and stored in the AssignmentGrade.
  
  

Feedback Generation

Pre-condition:

• Student submissions have been processed and graded.

Description:

• The autograder generates an individual PDF report for each student submission using the PDFGenerator class. The PDF contains the overall score for the submission and a breakdown of scores for each class. It also provides detailed descriptions of all test cases, indicating which tests the submission passed and failed.

---

Target Students

• Primary Users: Course instructor and markers for Object-Oriented Programming 1.
• Other Beneficiaries: Undergraduate students in the Object-Oriented Programming 1 course, who receive detailed feedback on their assignment submissions.