User Journey: Form Create/Edit

[EthanThatOneKid]

Overview

The user begins their journey at the /forms endpoint, where they can choose from a list of existing forms to edit or create a new one. If no forms are available, a prompt encourages them to create a new one.

Form creation

1. Selecting a form:
   • Choose from existing forms if available.
   • Create a new form if no forms exist.
2. Filling out form details:
   • Enter a descriptive title for the form.
   • Use Discord markdown syntax to add rich text content below the title.
   • Specify the target location for form submission by providing:
     • Guild ID (user must have a privileged role in that guild).
     • Channel ID (channel must not be blocklisted).
     • Thread ID (optional).
   • Choose a dispatch time:
     • Immediate: Submit the form to the selected location instantly.
     • Scheduled: Schedule the form draft for dispatch at a specific future date.
   • Configure additional settings:
     • Allow multiple submissions (repeatedly fill out the same form).
     • Auto-shuffle questions for each submission (randomizes question order).
     • Select a highlight color for the form.
     • Choose a background style for the form.
   • Create a list of questions:
     • Choose the question type from available options (including all HTML input types like text, checkbox, radio button, etc.).
     • Provide specific details for each question, including markdown content and other relevant information.

Note: Input values are conveniently restorable from being stored in localStorage.

Validation

• The user needs a privileged role in the selected guild for immediate submission.
• If the user lacks the required role, the form is saved as a draft until they acquire it.

Confirmation

• Upon successful submission, the form is sent to the specified Discord message location.
• For scheduled submissions, the form is automatically dispatched at the chosen future date.

Additional notes

• The UI provides clear instructions and prompts throughout the journey.
• Users can easily access and manage saved drafts.
• The system ensures secure and controlled form creations/edits based on user roles.