Description
Summary Software Specifications: Person and Personal Proper Name Identification Quiz1. Project OverviewThe objective is to build a web-based, interactive language and conflict-analysis assessment application. The application presents a user (student) with a sequence of three distinct text scenarios. The student must identify and select every instance of a 1st person word, 2nd person word, or Personal Proper Name by clicking on the words directly within the text.The application must enforce a strict, all-or-nothing token-matching verification logic per scenario, execute an immediate first-click locking mechanism to prevent changing answers, visually highlight errors using a distinct dual-color system, and package the final results for secure teacher retrieval.2. Core Functional Mechanics & Anti-Tampering ConstraintsA. Immediate Selection Locking ("First-Click Lock")No Deselection: Once a student clicks a word token, that choice is permanent for the duration of the scenario attempt. Clicking a selected word a second time will not deselect it.Immutable State: The user cannot undo or alter their selections. Every single click adds to their permanent submission array.B. Input/Response FieldsDirectly beneath the interactive paragraph, a dynamic, read-only text area labeled "Your Selections:" must populate in real-time, displaying the student's chosen words in chronological order based on their location in the text.C. Binary Evaluation & Mandatory First-Selection SubmissionWhen the student clicks "Submit Answer", the system evaluates the exact set of words chosen on that first pass.The Validation Formula: Enforces a binary scoring paradigm ($Score = 100\%$ if the student's selections perfectly match the target index set; otherwise, $Score = 0\%$).Strict Penalty: If a student misses even one correct word, or includes even one extra incorrect word, the entire scenario submission is marked completely Incorrect. There is no partial credit.D. Visual Grading Feedback & Post-Submission LockoutUpon clicking submit, the interface must instantly transition into grading mode and execute these exact visual feedback rules:Red Highlights (Incorrect Additions): Any word selected by the student that is not a designated 1st/2nd person word or a personal proper name turns Red.Blue Highlights (Missed Targets): Any target word or personal name that the student completely overlooked and failed to click turns Blue.Complete Interaction Lockout: Once the red and blue highlights appear, the student cannot make any further selections. The paragraph becomes entirely read-only until they advance to the next question.3. Data Dictionary & Refined Answer KeysThe developer must program the following three scenarios using these exact target sets. Note that Tuesday, Texas, and March have been explicitly excluded from the target answer keys.Scenario 1"Listen to me [1st], you [2nd] don't know the half of it. I [1st] worked my [1st] fingers to the bone for five years building up the client list for this firm, and then last Tuesday [EXCLUDED], Karen [Proper Name] goes behind my [1st] back and downloads the entire database onto a personal flash drive. She’s planning to start her own agency and steal our [1st] accounts. When I [1st] confronted her about it, she called me [1st] a paranoid control freak and threatened to tell our [1st] boss that I [1st] was harassing her. You [2nd] need to make her hand over that drive to me [1st] right now before she ruins my [1st] life."Target Correct Word Tokens: me, you, I, my, Karen, my, our, I, me, our, I, You, me, myScenario 2"I [1st] am not going to sit here and let Robert [Proper Name] act like he didn't screw me [1st] over. We [1st] started this medical supply logistics company together in my [1st] garage, and I [1st] was the one who personally secured our [1st] Texas [EXCLUDED] state vendor certification while he was off taking vacations. Now that the state contract finally came through, he secretly changed the banking routing numbers on our [1st] corporate account, locked me [1st] out of the inventory management portal, and told our [1st] primary logistics coordinator that I [1st] resigned! Jim [Proper Name] (the mediator), you [2nd] need to look at me [1st] right now and understand that he is trying to steal my [1st] entire life's work. I [1st] want you [2nd] to freeze that bank account today and force him to give me [1st] my [1st] admin credentials back."Target Correct Word Tokens: I, Robert, me, We, my, I, our, our, me, our, I, Jim, you, me, my, I, you, me, myScenario 3"Look, Mark [Proper Name] is a total con man and you [2nd] can't believe a word he says. I [1st] signed a five-year commercial lease with his development group for my [1st] fitness franchise, and he explicitly promised me [1st] in writing that our [1st] building would be ready for occupancy by March [EXCLUDED] 1st. I [1st] already paid him a seventy-thousand-dollar deposit, I [1st] hired my [1st] entire training staff, and we [1st] launched our [1st] regional marketing blitz. Now he tells us [1st] the permit fell through and it’s going to be another six months? I [1st] am losing ten thousand dollars a week in membership revenue because of his incompetence! Caitlyn [Proper Name], you [2nd] need to make him pay for my [1st] lost profits and force him to give me [1st] my [1st] deposit back today before I [1st] lose my [1st] mind."Target Correct Word Tokens: Mark, you, I, my, me, our, I, I, my, we, our, us, I, Caitlyn, you, my, me, my, I, my Test Submission & Teacher Retrieval Architecture Final Submission Workflow The student progresses linearly through Scenarios 1, 2, and 3. Upon clicking "Submit Answer" on Scenario 3, a prominent "Submit Completed Test for Review" button unlocks. Once clicked, the application packages the data and pushes it to the teacher's tracking system. Teacher Data Retrieval Options (Developer to Implement One) Option A: Simple Email Dispatch (No Database Required) The system uses an API utility (like EmailJS or Formspree) to instantly email the finalized score report directly to the teacher's designated inbox. Email Subject Line Format: [QUIZ SUBMISSION] 1st & 2nd Person Quiz - Last Name, First Name