User Management
Comprehensive guide for managing users, roles, and permissions in the MedFeed platform.
Overview
The User Management system provides administrators with tools to manage hospital staff accounts, configure roles and permissions, and maintain security across the platform.
[Screenshot placeholder: User management dashboard overview]
Key Features
- User Account Management: Create, update, and deactivate user accounts
- Role-Based Access Control: Assign roles and permissions
- Department Management: Organize users by departments
- Bulk Operations: Import/export users and bulk updates
- Audit Tracking: Complete user activity monitoring
Accessing User Management
Navigation
- Log in as an administrator
- Navigate to Administration > User Management
- Or use the quick access: Settings > Users
[Screenshot placeholder: Navigation to user management]
Required Permissions
- user:read - View user information
- user:create - Create new users
- user:update - Modify user accounts
- user:delete - Deactivate users
- role:manage - Assign roles and permissions
User Account Management
Creating New Users
[Screenshot placeholder: New user creation form]
Manual User Creation
- Click Add New User button
- Fill in required information:
- Email Address (primary identifier)
- Full Name
- Employee ID (if applicable)
- Department
- Role
- Phone Number
- Set Account Status (Active/Inactive)
- Configure Initial Password options:
- Generate temporary password
- Send invitation email
- Require password change on first login
- Click Create User
Bulk User Import
- Navigate to Bulk Operations > Import Users
- Download the CSV template
- Fill in user information:
email,firstName,lastName,employeeId,department,role,phoneNumber
doctor@hospital.com,John,Smith,EMP001,Cardiology,doctor,+1234567890
nurse@hospital.com,Jane,Doe,EMP002,Emergency,nurse,+1234567891 - Upload the completed CSV file
- Review and confirm the import
- Monitor import progress and results
[Screenshot placeholder: Bulk import interface and progress]
User Profile Management
Viewing User Details
[Screenshot placeholder: User profile details view]
Basic Information:
- Personal details (name, email, phone)
- Employment information (ID, department, role)
- Account status and last login
- Profile picture and preferences
Security Information:
- Password last changed
- MFA status and methods
- Active sessions
- Recent login history
Activity Summary:
- Recent actions and logins
- Document access history
- Task assignments and completions
- System usage statistics
Editing User Information
- Select user from the user list
- Click Edit Profile
- Modify allowed fields:
- Contact information
- Department assignment
- Role and permissions
- Account status
- Save changes
- Notify user of updates (optional)
[Screenshot placeholder: User editing interface]
Account Status Management
Account States
- Active: Full system access
- Inactive: Suspended access, data preserved
- Pending: Awaiting email verification
- Locked: Temporarily locked due to security issues
- Archived: Permanently deactivated, historical data only
Status Change Procedures
[Screenshot placeholder: Account status change interface]
Deactivating Users:
- Select user account
- Click Change Status > Deactivate
- Choose deactivation reason:
- Employee termination
- Extended leave
- Security concern
- Role change
- Set Effective Date
- Configure Data Handling:
- Transfer ownership of documents
- Reassign active tasks
- Archive personal data
- Confirm deactivation
Reactivating Users:
- Filter for inactive users
- Select user to reactivate
- Click Reactivate Account
- Update information if needed
- Reset password (optional)
- Send welcome back notification
Role and Permission Management
Understanding Roles
[Screenshot placeholder: Role hierarchy visualization]
Default System Roles
Super Administrator
- Full system access
- User and role management
- System configuration
- Security settings
Hospital Administrator
- User management within organization
- Department configuration
- Analytics and reporting
- Compliance monitoring
Doctor
- Patient record access
- Clinical documentation
- Task management
- Analytics viewing
Nurse
- Patient care documentation
- Task execution
- Feedback collection
- Shift reporting
Quality Manager
- Feedback analysis
- Quality metrics
- Compliance reporting
- Performance analytics
Technician
- Equipment maintenance tasks
- Technical documentation
- System monitoring
- Basic reporting
Creating Custom Roles
[Screenshot placeholder: Custom role creation interface]
- Navigate to Roles & Permissions > Create Role
- Define role properties:
- Role Name: Descriptive name
- Role ID: System identifier
- Description: Role purpose and scope
- Department: Associated department (optional)
- Configure permissions:
- Select from available permissions
- Set permission levels (read, write, delete)
- Define resource access scope
- Set role hierarchy:
- Parent roles (inheritance)
- Child roles (delegation)
- Save and activate role
Permission Categories
[Screenshot placeholder: Permission matrix interface]
Patient Management
patient:read- View patient informationpatient:create- Add new patientspatient:update- Modify patient recordspatient:delete- Archive patient records
Clinical Documentation
notes:read- View clinical notesnotes:create- Create new notesnotes:update- Edit existing notesnotes:sign- Approve and sign notes
Task Management
task:read- View taskstask:create- Create new taskstask:assign- Assign tasks to otherstask:complete- Mark tasks as complete
Analytics and Reporting
analytics:read- View analytics dashboardsreports:create- Generate reportsreports:export- Export report datareports:schedule- Set up automated reports
Assigning Roles to Users
[Screenshot placeholder: Role assignment interface]
Individual Assignment
- Select user from user list
- Click Manage Roles
- Choose from available roles:
- Primary role (main responsibilities)
- Secondary roles (additional permissions)
- Temporary roles (time-limited access)
- Set effective dates (optional)
- Add assignment notes
- Save changes
Bulk Role Assignment
- Select multiple users (checkbox selection)
- Click Bulk Actions > Assign Role
- Choose role to assign
- Set assignment parameters
- Review affected users
- Confirm bulk assignment
Department Management
Department Structure
[Screenshot placeholder: Department hierarchy tree]
Creating Departments
- Navigate to Departments > Add Department
- Enter department information:
- Name: Department name
- Code: Short identifier (e.g., "ER", "ICU")
- Description: Department purpose
- Parent Department: Hierarchical relationship
- Assign department leadership:
- Head of Department
- Assistant Managers
- Administrative Staff
- Configure department settings:
- Default permissions
- Workflow preferences
- Notification settings
- Save department configuration
Managing Department Membership
[Screenshot placeholder: Department membership interface]
Adding Users to Departments:
- Select department from list
- Click Manage Members
- Add users by:
- Individual selection
- Bulk import
- Role-based assignment
- Set membership type:
- Primary (main department)
- Secondary (cross-training)
- Temporary (rotation)
Department Transfers:
- Select user to transfer
- Click Transfer Department
- Choose new department
- Set transfer date
- Configure permission updates
- Notify relevant parties
User Invitation System
Invitation Workflow
[Screenshot placeholder: Invitation workflow diagram]
Sending Invitations
- Navigate to User Management > Invite Users
- Enter invitation details:
- Email addresses (single or multiple)
- Role assignment
- Department assignment
- Custom message
- Configure invitation settings:
- Expiration time (default 7 days)
- Required actions (password setup, profile completion)
- Access restrictions (IP whitelist, device limits)
- Send invitations
Invitation Templates
[Screenshot placeholder: Email invitation template]
Standard Invitation Email:
Subject: Welcome to MedFeed - Complete Your Account Setup
Dear [Name],
You have been invited to join MedFeed at [Hospital Name].
Your account details:
- Email: [email]
- Role: [role]
- Department: [department]
To complete your account setup:
1. Click the link below
2. Set your secure password
3. Complete your profile
4. Review system orientation
[Setup Link - Expires in 7 days]
If you have questions, contact IT support at [support_email].
Welcome to the team!
Managing Pending Invitations
[Screenshot placeholder: Pending invitations management]
Invitation Status Tracking:
- Sent: Invitation email delivered
- Opened: Recipient opened email
- In Progress: Account setup started
- Completed: Account fully activated
- Expired: Invitation time limit exceeded
- Cancelled: Invitation revoked
Invitation Actions:
- Resend: Send invitation again
- Extend: Extend expiration date
- Cancel: Revoke invitation
- Modify: Change role or department
Security and Compliance
Password Policies
[Screenshot placeholder: Password policy configuration]
Policy Configuration
- Navigate to Security > Password Policies
- Configure requirements:
- Minimum length (8-20 characters)
- Character requirements (uppercase, lowercase, numbers, symbols)
- Dictionary checks (prevent common passwords)
- Personal information (prevent name/email usage)
- Set expiration rules:
- Password age (30-365 days)
- History limit (prevent reuse of last N passwords)
- Grace period (days before forced change)
- Configure lockout policies:
- Failed attempts (3-10 attempts)
- Lockout duration (15 minutes - 24 hours)
- Progressive delays (increasing delays per attempt)
Password Reset Management
[Screenshot placeholder: Password reset interface]
Administrative Reset:
- Select user account
- Click Security > Reset Password
- Choose reset method:
- Generate temporary password
- Send reset email
- Force change on next login
- Set password requirements
- Notify user of reset
Multi-Factor Authentication
MFA Policy Configuration
[Screenshot placeholder: MFA policy settings]
Organization-wide MFA Settings:
- Mandatory roles (require MFA for specific roles)
- Grace period (time to set up MFA)
- Backup methods (alternative authentication)
- Trusted devices (remember device settings)
Supported MFA Methods:
- SMS text messages
- Authenticator apps (Google, Authy, Microsoft)
- Email verification
- Hardware tokens (FIDO2/WebAuthn)
- Biometric authentication
Managing User MFA
- Select user account
- Navigate to Security > MFA Settings
- View current MFA status:
- Enabled methods
- Backup codes status
- Trusted devices
- Administrative actions:
- Force MFA setup
- Reset MFA methods
- Generate backup codes
- Revoke trusted devices
Audit and Compliance
User Activity Monitoring
[Screenshot placeholder: User activity dashboard]
Tracked Activities:
- Login/logout events
- Password changes
- Role modifications
- Permission changes
- Data access patterns
- Failed authentication attempts
Audit Reports:
- User Access Report: Who accessed what and when
- Permission Changes: Role and permission modifications
- Security Events: Authentication failures and security incidents
- Compliance Report: Regulatory compliance status
Data Privacy Controls
[Screenshot placeholder: Privacy controls interface]
HIPAA Compliance Features:
- Minimum necessary access (role-based data access)
- Audit trails (complete activity logging)
- Data encryption (at rest and in transit)
- Access controls (authentication and authorization)
- Breach notification (automated incident reporting)
Bulk Operations
Mass User Updates
[Screenshot placeholder: Bulk operations interface]
Bulk Edit Users
- Select users using filters or checkboxes
- Click Bulk Actions > Edit Selected
- Choose fields to update:
- Department changes
- Role assignments
- Status updates
- Contact information
- Preview changes
- Execute bulk update
- Monitor progress and results
Data Export/Import
Export User Data:
- Navigate to Bulk Operations > Export
- Select export format (CSV, Excel, JSON)
- Choose data fields to include
- Apply filters (department, role, status)
- Generate and download export
Import User Updates:
- Prepare CSV file with user updates
- Navigate to Bulk Operations > Import Updates
- Upload file and map columns
- Validate data and preview changes
- Execute import with error handling
Troubleshooting User Issues
Common User Problems
[Screenshot placeholder: Troubleshooting guide interface]
Login Issues
Problem: User cannot log in Solutions:
- Check account status (active/inactive)
- Verify password reset requirements
- Check MFA configuration
- Review IP restrictions
- Examine audit logs for clues
Problem: Frequent account lockouts Solutions:
- Review failed login attempts
- Check for automated systems using old passwords
- Verify user training on password requirements
- Consider adjusting lockout policies
Permission Issues
Problem: User cannot access features Solutions:
- Verify role assignments
- Check permission inheritance
- Review department-based restrictions
- Validate resource-specific permissions
Problem: Excessive permissions Solutions:
- Audit user roles and permissions
- Remove unnecessary role assignments
- Implement principle of least privilege
- Regular permission reviews
Support Procedures
User Support Workflow
-
Receive Support Request
- Via help desk ticket
- Direct administrator contact
- Self-service portal
-
Initial Assessment
- Verify user identity
- Understand the issue
- Check system status
-
Troubleshooting Steps
- Review user account status
- Check recent changes
- Examine audit logs
- Test permissions
-
Resolution and Follow-up
- Implement solution
- Verify resolution with user
- Document issue and solution
- Update knowledge base
For technical user management APIs, see the API Reference. For security configuration, refer to the Authentication System.