Profile Completion

After registering and verifying your account, EduShade may require you to complete your profile before accessing the platform. This ensures that essential information is collected for a personalized learning experience.

When is Profile Completion Required?

Profile completion is triggered when:

1. You have just registered and verified your email/phone
2. Required profile fields are missing from your account
3. The tenant administrator has configured mandatory profile fields

You will be automatically redirected to the Complete Profile page (/auth/complete-profile) if profile completion is required.

How the trigger works

Completion state is computed on the backend:

• The auth-service's user service computes a profile-completeness score against the tenant's required-fields configuration.
• Every authenticated request to GET /v1/auth/account returns a profileCompletionRequired boolean.
• The frontend's AuthProvider reads this flag and the AuthMiddleware redirects to /auth/complete-profile whenever it is true.
• Completeness is also exposed as a user-list filter (profile_complete=true|false) so admins can find users who haven't finished onboarding.

This means the rule is enforced server-side — clearing your local state or skipping the frontend won't bypass it.

How it Works

Multi-Step Wizard

The profile completion form is presented as a multi-step wizard:

1. Fields are organized into pages (steps)
2. Each page contains a few related fields
3. A progress bar shows your completion percentage
4. You can navigate back and forward between steps
5. The final step has a Complete button

Field Types

The form supports various field types depending on what information is required:

Required vs Optional Fields

• Required fields must be filled before you can proceed to the next step
• Optional fields can be skipped
• The distinction is configured by the tenant administrator

Common Required Fields

Depending on your tenant's configuration, you may be asked for:

Completing the Profile

Steps

1. You are redirected to /auth/complete-profile
2. Review the first page of fields
3. Fill in the required fields (marked with an asterisk *)
4. Click Next to proceed to the next page
5. Repeat until all pages are completed
6. Click Complete on the final page
7. You are redirected to your dashboard

Navigation

• Next — Move to the next page
• Back — Return to the previous page
• Progress Bar — Shows how far along you are (e.g., "Step 2 of 4")

After Completion

Once your profile is complete:

1. The profileCompletionRequired flag is cleared
2. You are redirected to your role-based dashboard:
   • Learner → /dashboard
   • Admin/Instructor → /admin/dashboard
3. You can edit your profile later from Account Settings

Skipping Profile Completion

Profile completion cannot be skipped if the tenant has configured required fields. You must fill in all required fields before accessing the platform.

If only optional fields are shown, you may be able to proceed without filling them.

Tenant Configuration

Administrators can configure which profile fields are required:

• Set fields as required or optional
• Choose which fields appear in the completion form
• Configure the order of fields
• Settings are managed through the tenant settings (fetched from GET /v1/public/tenant/settings)

Troubleshooting