User Management

This guide documents user-management features confirmed by current routes and UsersController.

Access

• Staff directory: /dashboard/users
• Create user: /dashboard/users/create
• Edit user: /dashboard/users/{user}/edit
• Doctors listing: /dashboard/doctors
• Pending users: /dashboard/users/pending

What Exists Today

From the current implementation, you can:

• list users with filters (search, role, profession, email presence, availability)
• create users with role/profile basics
• edit user profile and professional fields
• soft-delete users
• view a doctor-focused directory (/dashboard/doctors)

User Fields in Active Flow

Common fields used in create/edit:

• first name, last name
• email, username, phone
• role
• country, city, address
• profession
• availability
• designation, bio, qualifications, consultation fee
• photo upload

Filtering and Stats

The listing pages provide:

• paginated results
• role/profession filter options
• summary stats (total, filtered, with email, available)

Doctors page adds appointment totals and profession split stats.

Notes on Roles and Permissions

Role and permission checks are enforced through middleware/policies in app code. This page intentionally avoids claiming permission matrices that are not explicitly documented in current UI docs yet.

Common Issues

• Cannot access users pages: verify account has user permission gate in middleware.
• Cannot update in demo: demo mode blocks updates/deletes.
• Username rejected: only letters, numbers, and hyphen; cannot start with numeric.

Related

• user-management/clients.md
• configuration/settings.md
• reference/route-map.md