Skip to content

[FEATURE] First-time setup wizard and settings page rework #99

@mohammadsherif0

Description

@mohammadsherif0

Is your feature request related to a problem? Please describe

  • First-time installation of CARE is not guided: there is no setup flow and critical settings are spread across the dashboard.
  • Settings are not very user-friendly: naming is technical, grouping is unclear, and there is no single place to see and adjust configuration in a clear way.

Describe the solution you'd like

1. First-time setup wizard
Redirect to the wizard instead of login. Wizard steps in order:

  • Step 1 – Admin Account
    Create the first admin (username, email, password).

  • Step 2 – General Settings
    Copyright, consent feature, guest login, study mode, external links. Use agreed naming/suggested names from settings spreadsheet.

  • Step 3 – Mail Configuration

    • Checkbox: “Enable email service”.
    • When checked: collapsible section with SMTP/sendmail config and toggles for “Email verification” and “Forgot password”.
    • When unchecked: no mail config or mail-dependent options.
      Mail-related settings in wizard per spreadsheet feedback.
  • Step 4 – User Registration
    What is required at signup: request name, usage-stats consent, terms & conditions. “Email verification” only applies if mail is enabled in step 3.

  • Step 5 – Moodle Integration
    Dedicated wizard page: API URL, key, course ID. Optional: can be skipped and configured later.

  • Step 6 – Summary
    Review all selections and finish setup.

2. Settings page rework
Rework the Settings page so it uses the similar flow as the wizard. When admins want to change any setting or see their configuration, they get the same steps, grouping, naming, and dependencies as in the first-time wizard.

Describe alternatives you've considered

  • Reset wizard only: Rejected in favor of making the Settings page itself wizard-like so admins can review and edit without a separate “reset” flow.
  • Single long “Settings” step: Rejected in favor of separate Mail and Registration steps with clear dependencies (e.g. mail off ⇒ no email verification).

Metadata

Metadata

Labels

doingmarked as someone is working on thisenhancementNew feature or request

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions