\n )\n}\n```\n\n## ๐ง API Reference\n\n### User Service\n\n#### Methods\n- `getUsers(filters)` - Get paginated list of users\n- `getUser(id)` - Get single user by ID\n- `createUser(userData)` - Create new user\n- `updateUser(userData)` - Update existing user\n- `deleteUser(id)` - Delete user\n- `changePassword(request)` - Change user password\n- `lockUser(request)` - Lock user account\n- `unlockUser(userId)` - Unlock user account\n- `setupTwoFactor(userId)` - Setup 2FA for user\n- `verifyTwoFactor(request)` - Verify 2FA setup\n- `disableTwoFactor(userId)` - Disable 2FA\n- `getUserRoles(userId)` - Get user's assigned roles\n- `assignRoles(userId, roleNames)` - Assign roles to user\n- `getUserPermissions(userId)` - Get user's permissions\n\n### Role Service\n\n#### Methods\n- `getRoles(filters)` - Get paginated list of roles\n- `getRole(id)` - Get single role by ID\n- `createRole(roleData)` - Create new role\n- `updateRole(roleData)` - Update existing role\n- `deleteRole(id)` - Delete role\n- `getRolePermissions(roleId)` - Get role permissions\n- `grantPermission(roleId, permission)` - Grant permission to role\n- `revokePermission(roleId, permission)` - Revoke permission from role\n- `setPermissions(roleId, permissions)` - Set all role permissions\n- `getRoleUsers(roleId)` - Get users with specific role\n\n## ๐จ Component Props\n\n### UserList Props\n```typescript\ninterface UserListProps {\n users: User[]\n loading?: boolean\n onEdit?: (user: User) => void\n onDelete?: (user: User) => void\n onLock?: (user: User) => void\n onUnlock?: (user: User) => void\n}\n```\n\n### UserCreate Props\n```typescript\ninterface UserCreateProps {\n onSubmit?: (data: CreateUserFormData) => void\n loading?: boolean\n error?: string\n className?: string\n}\n```\n\n### RoleList Props\n```typescript\ninterface RoleListProps {\n roles: Role[]\n loading?: boolean\n onEdit?: (role: Role) => void\n onDelete?: (role: Role) => void\n}\n```\n\n## ๐ Security Features\n\n### Password Policy\n- Configurable minimum length (default: 8 characters)\n- Character requirements (uppercase, lowercase, numbers, special chars)\n- Password strength validation\n- Password history prevention\n- Automatic password expiration\n\n### Account Lockout\n- Failed login attempt tracking\n- Configurable lockout thresholds\n- Automatic unlock after specified duration\n- Manual unlock capabilities for administrators\n\n### Two-Factor Authentication\n- TOTP (Time-based One-Time Password) support\n- QR code generation for authenticator apps\n- Recovery codes for account recovery\n- Backup authentication methods\n\n### Audit Logging\n- Comprehensive activity tracking\n- Risk level assessment\n- IP address and user agent logging\n- Exportable audit reports\n- Real-time security alerts\n\n## ๐ Advanced Usage\n\n### Custom Permission System\n\n```tsx\nimport { useUserPermissions, useRolePermissions } from '@dbs-portal/module-identity'\n\nfunction PermissionGuard({ permission, children }) {\n const { data: userPermissions } = useUserPermissions(currentUserId)\n \n if (!userPermissions?.includes(permission)) {\n return
Access Denied
\n }\n \n return children\n}\n```\n\n### Bulk User Operations\n\n```tsx\nimport { useBulkUserOperation } from '@dbs-portal/module-identity'\n\nfunction BulkUserActions() {\n const bulkOperation = useBulkUserOperation()\n \n const handleBulkActivate = async (userIds: string[]) => {\n await bulkOperation.mutateAsync({\n operation: 'activate',\n userIds\n })\n }\n \n return (\n \n )\n}\n```\n\n## ๐ Monitoring & Analytics\n\n### User Statistics\n- Total user count and growth trends\n- Active vs inactive user ratios\n- Email and phone verification rates\n- Two-factor authentication adoption\n- Geographic distribution of users\n\n### Security Metrics\n- Failed login attempt patterns\n- Account lockout frequency\n- Password change frequency\n- High-risk activity detection\n- Compliance audit reports\n\n## ๐ Integration\n\n### With Authentication System\n```tsx\nimport { useAuthStore } from '@dbs-portal/core-auth'\nimport { useUser } from '@dbs-portal/module-identity'\n\nfunction UserProfile() {\n const { user: authUser } = useAuthStore()\n const { data: userDetails } = useUser(authUser?.id)\n \n return (\n navigate('/profile/edit')}\n />\n )\n}\n```\n\n### With Permission System\n```tsx\nimport { useUserPermissions } from '@dbs-portal/module-identity'\n\nfunction ProtectedComponent() {\n const { data: permissions } = useUserPermissions(userId)\n \n const canEdit = permissions?.includes('Users.Update')\n const canDelete = permissions?.includes('Users.Delete')\n \n return (\n
\n {canEdit && }\n {canDelete && }\n
\n )\n}\n```\n\n## ๐งช Testing\n\nThe module includes comprehensive test coverage:\n\n```bash\n# Run tests\nyarn test\n\n# Run tests with coverage\nyarn test:coverage\n\n# Run tests in watch mode\nyarn test:watch\n```\n\n## ๐ Contributing\n\n1. Follow the established code patterns and TypeScript conventions\n2. Ensure all components have proper prop types and documentation\n3. Add tests for new functionality\n4. Update this README for any new features or breaking changes\n5. Follow the monorepo's linting and formatting standards\n\n## ๐ License\n\nMIT License - see the [LICENSE](../../LICENSE) file for details.\n\n## ๐ Related Packages\n\n- [`@dbs-portal/core-auth`](../core/auth) - Authentication and authorization\n- [`@dbs-portal/core-api`](../core/api) - HTTP client and API utilities\n- [`@dbs-portal/core-ui`](../core/ui) - Shared UI components\n- [`@dbs-portal/core-shared`](../core/shared) - Common types and utilities\n","readmeFilename":"README.md","_rev":"1-26a49b73affb3f0c0dbc04380c7990a3"}