Update app.py

app.py

@@ -12,251 +12,73 @@ import time
 import fitz
 
 GRADING_RUBRIC = """
-DETAILED GRADING RUBRIC & INSTRUCTIONS
-
-You will assess the paper against the following 16 criteria. For each criterion, you will determine the student's score based on a forensic analysis of their work.
-
-I. APA Formatting (Total 60 points)
-
-1. APA Title Page (5 pts):
-
-Check for the 9 required components of a student title page. For this task, the 9 components are defined as: (1) Page number in the header (Page 1), (2) Paper title (bolded), (3) Author's name, (4) Department name, (5) University name, (6) Course number and name, (7) Instructor's name, (8) Assignment due date, (9) All elements are centered and correctly spaced in the upper half of the page.
-
-Scoring:
-
-5 pts: All 9 components are present and correctly formatted.
-
-0 pts: 1 or more components are missing or incorrectly formatted.
-
-2. APA General Guidelines - Main Body (5 pts):
-
-Check for adherence to all of the following:
-
-(1) Paper is typed.
-
-(2) 1-inch margins on all sides.
-
-(3) Font is either 11 pt Calibri or 12 pt Times New Roman (consistently).
-
-The 3 additional main body text requirements are: (4) All text is double-spaced, (5) Text is aligned to the left margin (not justified), (6) The first line of every paragraph is indented 0.5 inches.
-
-Scoring:
-
-5 pts: All 6 guidelines are met perfectly.
-
-2 pts: 1 guideline is not met.
-
-0 pts: 2 or more guidelines are not met.
-
-3. APA Text - Main Body Misc. Errors (5 pts):
-
-Scan the entire document for the following: (1) Extra spacing between paragraphs, (2) Misspellings, (3) Typographical errors.
-
-Scoring:
-
-5 pts: 0 errors found.
-
-4 pts: Exactly 1 error found.
-
-0 pts: 2 or more errors found.
-
-4. APA In-text Citations - Presence (5 pts):
-
-Analyze the text: Identify every statement of fact, statistic, or opinion that is not common knowledge and requires a citation. Count how many of these required citations are missing.
-
-Scoring:
-
-5 pts: 0 missing in-text citations.
-
-3.5 pts: 1 to 5 missing in-text citations.
-
-0 pts: 6 or more missing in-text citations.
-
-5. APA In-text Citation - Formatting (5 pts):
-
-Analyze every provided in-text citation. Check for correct APA 7th Ed. format (e.g., (Author, Year) for parenthetical; Author (Year) for narrative; et al. usage; multiple authors). Count every single formatting error.
-
-Scoring:
-
-5 pts: 0 formatting errors.
-
-2 pts: 1 to 2 formatting errors.
-
-0 pts: 3 or more formatting errors.
-
-6. APA Reference Page - General Formatting (5 pts):
-
-Check for the following: (1) The title "References" is on a new page, centered, and bolded. (2) All entries are alphabetized by the first author's last name. (3) A 0.5-inch hanging indent is applied to all entries.
-
-Scoring:
-
-5 pts: The entire page meets all 3 general formatting expectations.
-
-0 pts: 1 or more errors are present.
-
-7. APA Reference Page - Line Spacing (5 pts):
-
-Check for the following: The entire reference page, including between entries, is uniformly double-spaced.
-
-Scoring:
-
-5 pts: The entire page adheres to APA double-spacing rules.
-
-0 pts: 1 or more line spacing errors are present (e.g., single spacing, extra space between entries).
-
-8. APA References - Scholarly & Timely (10 pts):
-
-Analyze the reference list. A "scholarly" reference is a peer-reviewed journal article, an academic book/chapter, or a publication from a professional organization (e.g., CDC, WHO). A non-scholarly source would be a general website, blog, or news article. A timely reference is one published within the last 7 years (i.e., between July 20, 2018, and July 19, 2025).
-
-Check for two conditions: (1) Are there at least 3 scholarly references? AND (2) Are all of those references dated within the last 7 years?
-
-Scoring:
-
-10 pts: At least 3 scholarly references are cited, AND all references are dated within the last 7 years.
-
-0 pts: Fewer than 3 scholarly references are cited, OR one or more references are older than 7 years.
-
-9. APA References - Author Names (5 pts):
-
-Analyze all author names on the reference page. Check for correct format: Lastname, F. M.. Also check for correct handling of sources with no author (the title or organization name moves to the author position).
-
-Scoring:
-
-5 pts: All author names are formatted perfectly.
-
-2 pts: There is 1 error where an author's name should have been a title/publisher, or vice versa.
-
-0 pts: There are general, repeated formatting errors in author names.
-
-10. APA References - Dates (5 pts):
-
-Analyze the date for each reference. Check for correct APA 7th Ed. format (e.g., (Year). for journals/books; (Year, Month Day). for web sources). Count every error.
-
-Scoring:
-
-5 pts: 0 errors.
-
-3 pts: Exactly 1 error.
-
-0 pts: 2 or more errors.
-
-11. APA References - Capitalization (5 pts):
-
-Analyze the titles in each reference. Check for correct APA 7th Ed. capitalization rules: Sentence case for article and book titles. Title case for periodical (journal) titles. Count every error.
-
-Scoring:
-
-5 pts: 0 errors.
-
-3 pts: Exactly 1 error.
-
-0 pts: 2 or more errors.
-
-12. APA References - Italics (5 pts):
-
-Analyze each reference for correct italicization. Check for APA 7th Ed. rules: Italicize journal titles and volume numbers. Italicize book titles. Count every error.
-
-Scoring:
-
-5 pts: 0 or 1 error in italicization.
-
-0 pts: 2 or more errors in italicization.
-
-13. APA References - Hyperlinks (5 pts):
-
-Analyze all DOIs and URLs. The 4 guidelines are: (1) All DOIs are presented as a full, active hyperlink (e.g., https://doi.org/...). (2) The phrase "Retrieved from" is NOT used before a URL or DOI. (3) There is no period after the DOI or URL. (4) URLs that are not DOIs are included.
-
-Scoring:
-
-5 pts: All 4 guidelines are followed for all relevant references.
-
-2 pts: 1 of the 4 guidelines is not followed.
-
-0 pts: 2 or more of the 4 guidelines are not followed.
-
-II. Content (Total 40 points)
-
-14. Skin Lesion: Introduction (10 pts):
-
-Analyze the introduction. Check that it: (1) Is one or two paragraphs long. (2) Clearly introduces the topic of skin lesions and states the issue to be examined. (3) Is not more than one page long. (4) Is free of spelling/typographical errors.
-
-Scoring:
-
-10 pts: Meets all requirements with 0 spelling/typo errors.
-
-5 pts: Meets length/content requirements but has 1-2 spelling/typo errors.
-
-0 pts: Does not include an introduction, OR the introduction is more than 1 page long, OR it has 3 or more spelling/typographical errors.
-
-15. Skin Lesion: Common Causes (10 pts):
-
-Analyze the body of the essay. Check if the paper discusses at least one common cause of skin lesions (e.g., infection, trauma, allergic reactions, systemic disease).
-
-Scoring:
-
-10 pts: Discusses at least 1 common cause.
-
-0 pts: Does not discuss any common causes.
-
-16. Skin Lesion: Nursing Considerations (10 pts):
-
-Analyze the body of the essay. Check if the paper discusses at least one specific nursing consideration or intervention for patients with skin lesions (e.g., wound care, patient education, assessment techniques like ABCDE for melanoma, comfort measures).
-
-Scoring:
-
-10 pts: Discusses at least 1 nursing intervention/consideration.
-
-0 pts: Does not discuss any nursing interventions/considerations.
+GRADING RUBRIC (Total 100 points)
+
+I. APA Formatting (60 pts)
+1. APA Title Page (5 pts): Requires 9 components: (1) Page number (1), (2) Title (bold), (3) Author, (4) Department, (5) University, (6) Course, (7) Instructor, (8) Due Date, (9) Centered/spaced correctly.
+   - Scoring: 5 pts: All 9 correct. 0 pts: 1+ error.
+2. APA General Guidelines (5 pts): Requires (1) Typed, (2) 1" margins, (3) 11pt Calibri or 12pt TNR, (4) Double-spaced, (5) Left-aligned, (6) Paragraphs indented 0.5".
+   - Scoring: 5 pts: All 6 met. 2 pts: 1 missing. 0 pts: 2+ missing.
+3. APA Text - Misc. Errors (5 pts): Check for: (1) Extra paragraph spacing, (2) Misspellings, (3) Typos.
+   - Scoring: 5 pts: 0 errors. 4 pts: 1 error. 0 pts: 2+ errors.
+4. APA In-text Citations - Presence (5 pts): Count missing citations for all non-common knowledge facts/opinions.
+   - Scoring: 5 pts: 0 missing. 3.5 pts: 1-5 missing. 0 pts: 6+ missing.
+5. APA In-text Citation - Formatting (5 pts): Check all in-text citations for correct APA 7 format.
+   - Scoring: 5 pts: 0 errors. 2 pts: 1-2 errors. 0 pts: 3+ errors.
+6. Ref Page - General Formatting (5 pts): Requires (1) "References" title (bold, centered, new page), (2) Alphabetical order, (3) 0.5" hanging indent.
+   - Scoring: 5 pts: All 3 correct. 0 pts: 1+ error.
+7. Ref Page - Line Spacing (5 pts): Entire page must be uniformly double-spaced.
+   - Scoring: 5 pts: Correct. 0 pts: Any error.
+8. References - Scholarly & Timely (10 pts): Must have >=3 scholarly sources, all dated within 7 years (after July 19, 2018).
+   - Scoring: 10 pts: Both conditions met. 0 pts: Fails one or both.
+9. References - Author Names (5 pts): Check all author names for correct APA 7 format (e.g., Lastname, F. M.) and correct handling of no-author sources.
+   - Scoring: 5 pts: 0 errors. 2 pts: 1 error of author vs. title/publisher. 0 pts: General format errors.
+10. References - Dates (5 pts): Check reference dates for correct APA 7 format.
+   - Scoring: 5 pts: 0 errors. 3 pts: 1 error. 0 pts: 2+ errors.
+11. References - Capitalization (5 pts): Check reference titles for APA 7 capitalization (sentence case for articles/books; title case for journals).
+   - Scoring: 5 pts: 0 errors. 3 pts: 1 error. 0 pts: 2+ errors.
+12. References - Italics (5 pts): Check references for correct APA 7 italics (journal titles/volumes, book titles).
+   - Scoring: 5 pts: 0-1 error. 0 pts: 2+ errors.
+13. References - Hyperlinks (5 pts): Requires (1) DOIs as active hyperlinks, (2) No "Retrieved from", (3) No period after URL/DOI, (4) Non-DOI URLs included.
+   - Scoring: 5 pts: All 4 rules met. 2 pts: 1 rule fails. 0 pts: 2+ rules fail.
+
+II. Content (40 pts)
+14. Introduction (10 pts): Must be 1-2 paragraphs, introduce the topic, be <=1 page long.
+    - Scoring: 10 pts: Meets reqs, 0 typos. 5 pts: Meets reqs, 1-2 typos. 0 pts: Fails reqs OR 3+ typos.
+15. Common Causes (10 pts): Discusses at least one common cause of skin lesions.
+    - Scoring: 10 pts: Yes. 0 pts: No.
+16. Nursing Considerations (10 pts): Discusses at least one nursing intervention/consideration.
+    - Scoring: 10 pts: Yes. 0 pts: No.
 
 REQUIRED OUTPUT FORMAT
-
 You must present your final evaluation in the following structured format. Do not deviate from this format.
 
 Grading Evaluation: NURS 305 Essay - Skin Lesions
-
 Student Submission Analysis
-
 Final Score: [Total Points] / 100
 
 Part I: APA Formatting (Score: [Points] / 60)
-
-1. APA Title Page: [Score]/5. Justification: [State precisely why the score was given. E.g., "Met all 9 requirements." or "0 points awarded. The title page was missing the course number and instructor's name."]
-
-2. APA General Guidelines: [Score]/5. Justification: [E.g., "5 points awarded. The document used 12 pt Times New Roman, 1-inch margins, double-spacing, left alignment, and paragraph indents." or "2 points awarded. The left and right margins were set to 1.25 inches instead of the required 1 inch."]
-
-3. APA Text - Misc. Errors: [Score]/5. Justification: [E.g., "4 points awarded. One typographical error ('hte' instead of 'the') was noted in paragraph 3."]
-
-4. APA In-text Citations - Presence: [Score]/5. Justification: [E.g., "3.5 points awarded. Analysis identified 4 statements requiring a citation that were not cited."]
-
-5. APA In-text Citation - Formatting: [Score]/5. Justification: [E.g., "2 points awarded. Two citations used an ampersand in the narrative format (e.g., 'Smith & Jones (2022) found...') which is incorrect."]
-
-6. APA Reference Page - General Formatting: [Score]/5. Justification: [E.g., "0 points awarded. The title 'References' was not bolded, and a hanging indent was not used."]
-
-7. APA Reference Page - Line Spacing: [Score]/5. Justification: [E.g., "0 points awarded. An extra space was added between each reference entry."]
-
-8. APA References - Scholarly & Timely: [Score]/10. Justification: [E.g., "10 points awarded. The paper cited 4 peer-reviewed journal articles, all published between 2020 and 2024." or "0 points awarded. Only two scholarly sources were used, and one reference was from 2016."]
-
-9. APA References - Author Names: [Score]/5. Justification: [E.g., "5 points awarded. All author names were formatted correctly."]
-
-10. APA References - Dates: [Score]/5. Justification: [E.g., "3 points awarded. One reference was missing the period after the year: (2021) instead of (2021)."]
-
-11. APA References - Capitalization: [Score]/5. Justification: [E.g., "0 points awarded. The titles of two journal articles were written in title case instead of sentence case."]
-
-12. APA References - Italics: [Score]/5. Justification: [E.g., "5 points awarded. One error noted where a journal volume number was not italicized. This falls within the 0-1 error threshold for full points."]
-
-13. APA References - Hyperlinks: [Score]/5. Justification: [E.g., "2 points awarded. The phrase 'Retrieved from' was incorrectly used before a URL."]
+1. APA Title Page: [Score]/5. Justification: [Provide specific justification for the score.]
+2. APA General Guidelines: [Score]/5. Justification: [Provide specific justification for the score.]
+3. APA Text - Misc. Errors: [Score]/5. Justification: [Provide specific justification for the score.]
+4. APA In-text Citations - Presence: [Score]/5. Justification: [Provide specific justification for the score.]
+5. APA In-text Citation - Formatting: [Score]/5. Justification: [Provide specific justification for the score.]
+6. APA Reference Page - General Formatting: [Score]/5. Justification: [Provide specific justification for the score.]
+7. APA Reference Page - Line Spacing: [Score]/5. Justification: [Provide specific justification for the score.]
+8. APA References - Scholarly & Timely: [Score]/10. Justification: [Provide specific justification for the score.]
+9. APA References - Author Names: [Score]/5. Justification: [Provide specific justification for the score.]
+10. APA References - Dates: [Score]/5. Justification: [Provide specific justification for the score.]
+11. APA References - Capitalization: [Score]/5. Justification: [Provide specific justification for the score.]
+12. APA References - Italics: [Score]/5. Justification: [Provide specific justification for the score.]
+13. APA References - Hyperlinks: [Score]/5. Justification: [Provide specific justification for the score.]
 
 Part II: Content (Score: [Points] / 40)
-
-14. Introduction: [Score]/10. Justification: [E.g., "10 points awarded. The introduction was a single, concise paragraph that clearly stated the paper's focus. No errors noted."]
-
-15. Common Causes: [Score]/10. Justification: [E.g., "10 points awarded. The paper successfully discussed infectious agents as a common cause of skin lesions."]
-
-16. Nursing Considerations: [Score]/10. Justification: [E.g., "0 points awarded. The paper failed to discuss any nursing interventions or specific considerations for patients with skin lesions."]
+14. Introduction: [Score]/10. Justification: [Provide specific justification for the score.]
+15. Common Causes: [Score]/10. Justification: [Provide specific justification for the score.]
+16. Nursing Considerations: [Score]/10. Justification: [Provide specific justification for the score.]
 
 Professor's Summary:
-
-[Provide a 2-3 sentence summary in the persona of Dr. Vance. E.g., "While the content discussing the cause of lesions was adequate, the submission demonstrated significant and widespread deficiencies in adhering to APA 7th Edition standards. These formatting and citation skills are non-negotiable in academic and professional nursing. Careful review of the APA manual is required before the next submission."]
+[Provide a 2-3 sentence summary in the persona of Dr. Vance, focusing on overall performance and key areas for improvement.]
 
 """