Figma Link
Epic:
Feature 193967: Module Builder | SEL Authoring
User Story
As a RethinkEd content creator, I need to create or edit an Activity module so that I can provide more resources for the Lesson Library.
...
Title
Description: The name or headline of the activitymodule.
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 resource to ensure easy identification and searchability.
Short Description
Description: A concise summary of the activity, highlighting its main points or features.
Required: YesNo.
Type of Input: Textarea.
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 activitymodule.
Required: Yes.
Type of Input: Dropdown menu.
Dropdown Values (single select):
SEL
Mental Health
Duration
Description: The category that best describes the time it takes to complete the activitymodule.
Required: Yes.
Type of Input: Dropdown menu.
Dropdown Values:
0-5 mins
5-10 mins
10-15 mins
15-30 mins
Asynchronous
Grade
Description: The grade for which the activity module 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
Tier
Description: The Tier for which the activity module applies to.
Required: Yes
Type of Input: Dropdown menu
Dropdown values (multi-select):
Tier 1
Tier 2
Tier 3
Domain (Subject: SEL)
Description: The Domain for which the activity module applies to.
Required: Yes
Type of Input: Dropdown menu
Dropdown values (single-select):
Awareness of Self & Others
Self-Management
Social Skills
Social Awareness
Self-Care
Trauma
Domain (Subject: Mental Health)
Description: The Domain for which the activity module applies to.
Required: Yes
Type of Input: Dropdown menu
Dropdown values (single-select):
Mental Wellness, Healthy Identities, Kindness to Animals, Online Safety, Anxiety, Depression, Substance Use Disorders, Reducing the Risk of Suicide, Preventing Violence, Human Trafficking, Trauma: Emotions, Trauma: Resilience, Trauma: Stress Management, Trauma: Support Systems
Main Topic (Subject: SEL)
Description: The Main Topic associated with the Domain of the activitymodule.
Required: Yes
Type of Input: Dropdown menu
Dropdown values (single select):
Awareness of Self & Others: Emotions, Growth Mindset, Learning Skills, Values, Wants & Needs, Self-Knowledge
Self-Management: Stress Management, Self-Control, Resilience, Problem Solving, Goal Setting, Focus
Social Skills: Respect, Relationships, Friendship, Fairness, Cooperation, Conflict Resolution
Social Awareness: Support Systems, Cultural Competence, Social Contributions, Safe & Ethical Behavior, Empathy, Actions & Consequences
Self-Care: Self-Efficacy, Self-Compassion, Self-Advocacy, Optimism, Mindfulness, Healthy Boundaries
Trauma: Emotions, Resilience, Stress Management, and Support Systems
Module Display Type
Description: Indicates the type of module and how it will be displayed to the end-user.
Required: Yes
Type of Input: Dropdown Menu
Dropdown values (single select):
Normal
Hidden
Teaching Resources
...
Title and Short Description fields are required to proceed. These fields are crucial for basic identification and understanding of the module.
For the Subject, Activity Type, Duration, Grade, Tier, Domain, and Main Topic, and Module Display Type fields, users must select from the predefined options. This ensures consistency and reliability in filtering and searching for an module across the platform.
The Main Topic field only displays when the user selects the Subject as SEL.
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.
Module Display Types:
A Normal Module will be searchable in the Lesson Library and also assignable as a module or pieces of the module. The module will display the header with the Title and Present button in the end-user view.
A Hidden Module will not be searchable in the Lesson Library > Module Activity tab and will not be assignable as an entire module. The module will not display the blue header with the Title, Duration, and Present button in the end-user view. Tier 3 Hidden Modules may still have assignable items that can be assigned from the Lesson Library > Lesson tab, or Lesson Plan.
A Teaching Resources Module will not be searchable in the Lesson Library > Module tab and will not be assignable as an entire module. The Teaching Resources Module also has different logic and a different display from a hidden module.
...
Accessing the Page:
When a user navigates to the "Module Metadata" page, they can either be creating a new module or editing an existing one. The system differentiates these scenarios based on whether an activity module ID is provided (for editing) or not (for creating).
Initial State:
New Activity: If the user is adding a new module, all fields on the "Module Metadata" page are presented as empty, ready for the user to input the new information.
Existing Activity: If the user is editing an existing module, the system retrieves all current metadata for that activity module 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 module or editing an existing one. This includes updating the title, short description, subject, activity type, duration, grade, tier, domain, and main topic, among others.
If the user changes the subject from SEL to Mental Health, the Main Topic dropdown menu will be hidden
If the user changes the subject from Mental Health to SEL, the Main topic dropdown menu will display
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 module, this action creates a new record; for an existing module, 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 Modules" permission. This ensures that only authorized personnel can modify activity module 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 could redirect them to either the activity module listing page, the module detail view, or another relevant page. This action provides clear feedback that the operation was successful and guides the user on what to do next.
...
This workflow emphasizes user-friendly interaction, data integrity, and proper access control, ensuring that the Module Metadata management process is efficient, secure, and intuitive. It accommodates both the creation of new activities modules and the modification of existing ones, with clear pathways and feedback mechanisms for users throughout the process.