Skip to content

NethVoice: improve usability and modernization of first configuration wizard #7825

@andrea-marchionni

Description

@andrea-marchionni

Description

A NethVoice First Configuration Wizard is required to guide administrators through the initial system setup in a simple, clear, and fast way, improving usability, immediacy, and reducing configuration errors.

The wizard should provide a step-by-step onboarding experience covering the essential system settings, including security, branding, and basic operational configuration, without exposing advanced or critical options.

The focus is on the initial onboarding experience, not on daily administration.


Main Goals

  • Provide a guided, sequential First Configuration Wizard
  • Configure Two-Factor Authentication (2FA) for administrative accounts
  • Simplify initial setup of users, extensions, and devices
  • Provide real-time validation and clear feedback
  • Ensure a mobile-friendly and responsive experience

Wizard Steps

1. Welcome & Context

  • Introductory screen explaining the setup process
  • Progress indicator (stepper)
  • System prerequisites check

2. Security

  • Enable (mandatory or recommended) 2FA for administrator
  • Select 2FA method (OTP app, Email, SMS if available)
  • 2FA configuration test

3. Branding

  • Support to:
    • favicon
    • background image of the login page
    • brand images of the login page
    • brand name
    • brand images of the admin page

4. User Structure

  • Create basic users
  • Assign:
    • Extensions
    • Devices
    • WebPhone / Mobile
  • Quick import (CSV / LDAP if available)
  • Group-based configuration

5. Lines and Devices

  • Associate users to extensions
  • Auto-detect and assign phones
  • Registration status verification

6. Essential Features

  • Configure using users group
    • profile
    • devices (Webphone, Mobile phone, Desktop phone)
    • device template
    • voicemail

7. Review & Activation

  • Configuration summary
  • Error / warning checks
  • “Complete setup” action
  • Switch system to operational mode

Wizard UI/UX Improvements

  • Modern, consistent design aligned with the new NethVoice UI
  • Step-by-step navigation with autosave
  • Ability to resume interrupted wizard
  • Real-time field validation
  • Contextual success, error, and hint messages
  • Unified terminology and iconography
  • Full mobile and tablet support

Expected Benefits

  • Significant reduction of first-time configuration errors
  • Faster time-to-value for new customers
  • Immediate security enablement through 2FA
  • Branding applied from the first login
  • Professional and guided onboarding experience
  • Reduced need for technical support during initial setup

Sub-issues

Metadata

Metadata

Assignees

No one assigned

    Labels

    nethvoiceBug or features releted to the NethVoice project

    Projects

    Status

    Todo

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions