Implementation Cards Meta- Data | Goals & Interventions

User Story

As a user, I need to enter Implementation Card metadata details so that the Implementation Cards can be located and displayed in the CMS Authoring Tool and the Intervention Library.

UI Description

Title
- Description: The name or headline of the Implementation Card.
- Required: Yes.
- Type of Input: Text field.
- Validation Criteria: Must contain at least 3 characters and no more than 255 characters. It should accurately reflect the content or subject of the Focus Area to ensure easy identification and searchability.
Short Description
- Description: A concise summary of the Implementation Card, highlighting its main points or features.
- Required: Yes.
- Type of Input: Text area.
- Validation Criteria: A minimum of 10 characters and a maximum of 500 characters. This constraint ensures the description is brief yet informative enough to convey the resource's value or purpose.
Subject
- Description: The subject area of the Implementation Card.
- Required: Yes.
- Type of Input: Dropdown menu.
- Dropdown Values (single select):
  - ELA
  - Math
  - SEL
  - Behavior
Grade
- Description: The grade for which the Implementation Card applies to.
- Required: Yes
- Type of Input: Dropdown menu
- Dropdown values (multi-select):
  - Pre-K, Kindergarten, 1st Grade, 2nd Grade, 3rd Grade, 4th Grade, 5th Grade, 6th Grade, 7th Grade, 8th Grade, 9th Grade, 10th Grade, 11th Grade, 12th Grade, Not Applicable
Intervention Strategy
- Description: The Intervention Strategy the Implementation Card belongs to.
- Required: Yes
- Type of Input: Dropdown menu
- Dropdown values: Varies depending on the Subject selected. Should be filled with all Intervention Strategies that correspond to the subject.
Focus Area
- Description: The Focus Area the Implementation Card belongs to.
- Required: No
- Type of Input: Drop down menu
- Dropdown Values: Varies depending on the Intervention Strategy selected. Should be filled with all Focus Area that correspond to the Intervention Strategy.
Related Teaching Skills
- Description: Used in place of Focus Areas for SEL and Behavior. Allows the user to mark an implementation card that should be recognized as a ‘Related Teaching Skill’.
- Required: No
- Type of Input: Checkbox

User Interaction and Validation Notes

Title and Short Description fields are required to proceed. These fields are crucial for basic identification and understanding of the Implementation Card.
Subject, Grade and Intervention Strategy fields are also required fields and users must select from the predefined options. This ensures consistency and reliability in filtering and searching for an implementation Card across the platform.
- Grade: Grade(s) should display in consecutive numerical order. If there is a grade range, the grades should be separated with an “ndash”.
Subject must be selected first before the Intervention Strategy, Focus Area, and Related Teaching Skills Check box appear.
Behavior Subject Selected: Grade field is pre-filled with Pre-K - Grade 12 and disabled.
Related Teaching Skills Checkbox: Will only appear if the Subject of Behavior or SEL is selected.
- See additional information in the Related Teaching Skills checkbox here. Implementation Cards | Related Teaching Skills
Selecting Related Teaching Skills Checkbox: Will hide the Intervention Strategy and Focus Area Drop-down.
Validation for text fields should include checks for prohibited characters or patterns that might interfere with the system's functionality or the database's integrity.

Intervention Metadata Workflow Description

Accessing the Page:
- When a user navigates to the "Implementation Card" page, they can either be creating a new Implementation Card or editing an existing one. The system differentiates these scenarios based on whether a Implementation Card ID is provided (for editing) or not (for creating).
Initial State:
- New Implementation Card: If the user is adding a new Implementation Card, all fields on the left panel of the "Implementation Card Builder" page are presented as empty, ready for the user to input the new information.
- Existing Implementation Card: If the user is editing an existing Implementation Card, the system retrieves all current metadata for that Implementation Card from the server and populates the fields accordingly. This ensures that the user can see the existing information and make any necessary updates.
Editing Metadata:
- Users can make changes to any of the metadata fields, regardless of whether they are creating a new Implementation Card or editing an existing one. This includes updating the title, short description, subject, grade, among others.
Validation and Feedback:
- Before submission, the system validates all input based on the specified criteria for each field. If any field does not meet its validation requirements, the system displays an appropriate error message, prompting the user to correct the input.
- This step ensures data integrity and prevents the submission of incomplete or incorrect metadata.
Saving Changes:
- Once all fields are correctly filled out and validated, the user can save the changes by clicking the "Save" button.
- Upon saving, the system updates the metadata on the server. For a new Implementation Card, this action creates a new record; for an existing Implementation Card, it updates the existing record with the new metadata.
Access Control:
- The form for editing or adding metadata is accessible only to users who have the "Edit Goals & Interventions" permission. This ensures that only authorized personnel can modify Implementation Card information, maintaining the integrity and security of the content on the portal.
Confirmation and Redirect:
- After successfully saving the metadata, the user may receive a confirmation message, and the system will stay on the page displayed. This action provides clear feedback that the operation was successful and guides the user on what to do next. The user can close the Implementation Card Builder to return to the Implementation Card table.