# README

## Overview

User & Role Management is a foundational administrative application for managing user accounts and role-based access control. It provides user lifecycle management, granular permission assignment through roles, and self-service profile management.

Key features:

- **User Lifecycle Management**: Create, view, edit, activate, and deactivate user accounts with IDP integration
- **Role-Based Access Control**: Define roles with granular permissions and assign them to users
- **Self-Service Profile Management**: Users can view and update their own profile without admin privileges

## Industry Context

### Target Industry

Enterprise Administration and Identity Management (cross-industry)

### Domain Terminology

- **User**: An internal system user whose capabilities are determined by assigned roles
- **Role**: A named collection of permissions that can be assigned to users
- **Permission**: A scope-based key from a registered module that grants access to specific operations
- **Lifecycle**: The state transitions of users and roles (ACTIVE ↔ INACTIVE)
- **IDP (Identity Provider)**: External authentication system provisioned during user creation
