# dr636457-oss/usermanagement architecture

> Architecture diagram of the GitHub repository dr636457-oss/usermanagement, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dr636457-oss/usermanagement
- Repository: https://github.com/dr636457-oss/usermanagement

## Overview

NexusPortal is a session-secured user governance web application. A browser user signs in or registers, then uses a dashboard and AJAX data grid for user administration; REST resources delegate authentication and user-management work to services, which validate requests, record audit events, and access MySQL through DAOs. The README documents dashboard metrics, search, filters, sorting, pagination, and security behavior. Source excerpts establish key service, DAO, and initialization calls; UI-to-API links reflect documented behavior, while unsampled view and wiring details are not inferred.

Main entry points: [`src/main/java/com/usermanagement/service/AuthService.java`](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/service/AuthService.java) (Session authentication), [`src/main/java/com/usermanagement/web/AuthResource.java`](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/web/AuthResource.java) (Auth endpoints), [`src/main/java/com/usermanagement/service/UserService.java`](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/service/UserService.java) (User governance), [`src/main/java/com/usermanagement/dao/ActivityLogDAO.java`](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/dao/ActivityLogDAO.java) (Audit persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_presentation["Web interface"]
  node_login["Login and registration<br/>[login.jsp]"]
  node_dashboard["Governance dashboard<br/>[home.jsp]"]
  node_appjs["Session UI behavior<br/>[app.js]"]
  node_usersjs["User grid controls<br/>[users.js]"]
end

subgraph group_http["HTTP and security"]
  node_authapi["Auth endpoints<br/>[AuthResource.java]"]
  node_userapi["User endpoints<br/>[UserResource.java]"]
  node_authfilter["Authentication filter"]
  node_nocache["No-cache filter<br/>[NoCacheFilter.java]"]
  node_jersey["REST registration"]
  node_response["API response model<br/>[ApiResponse.java]"]
end

subgraph group_domain["Governance services"]
  node_authservice["Session authentication<br/>[AuthService.java]"]
  node_userservice["User governance<br/>[UserService.java]"]
  node_password["BCrypt password handling<br/>[PasswordUtil.java]"]
  node_user["User account model<br/>[User.java]"]
  node_audit["Activity log model<br/>[ActivityLog.java]"]
end

subgraph group_persistence["Persistence and setup"]
  node_userdao["User persistence<br/>[UserDAOImpl.java]"]
  node_activitydao["Audit persistence"]
  node_dbmanager["Connection pool"]
  node_dbinit["Schema and seed setup<br/>[DBInitializer.java]"]
end

node_browser(("Browser user"))
node_mysql[("MySQL database")]

node_browser -->|"opens"| node_login
node_browser -->|"uses"| node_dashboard
node_login -->|"authenticates via"| node_authapi
node_usersjs -->|"calls CRUD API"| node_userapi
node_appjs -.->|"session requests"| node_authapi
node_dashboard -.->|"loads controls"| node_usersjs
node_jersey -->|"registers"| node_authapi
node_jersey -->|"registers"| node_userapi
node_authfilter -->|"checks sessions"| node_authservice
node_authapi -->|"delegates authentication"| node_authservice
node_authapi -->|"creates registrations"| node_userservice
node_userapi -->|"delegates user actions"| node_userservice
node_authservice -->|"looks up accounts"| node_userdao
node_authservice -->|"records auth events"| node_activitydao
node_userservice -->|"validates and mutates"| node_userdao
node_userservice -->|"records CRUD events"| node_activitydao
node_authservice -->|"checks password"| node_password
node_userservice -->|"hashes passwords"| node_password
node_userdao -->|"gets connections"| node_dbmanager
node_activitydao -->|"gets connections"| node_dbmanager
node_dbinit -->|"initializes through"| node_dbmanager
node_userdao -.->|"reads and writes"| node_mysql
node_activitydao -.->|"stores audit events"| node_mysql
node_dbmanager -->|"connects to"| node_mysql
node_authservice -->|"uses account data"| node_user
node_activitydao -->|"maps log records"| node_audit
node_authapi -->|"returns payloads"| node_response
node_userapi -->|"returns payloads"| node_response

click node_login "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/login.jsp"
click node_dashboard "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/home.jsp"
click node_appjs "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/js/app.js"
click node_usersjs "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/js/users.js"
click node_authapi "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/web/AuthResource.java"
click node_userapi "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/web/UserResource.java"
click node_authfilter "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/filter/AuthenticationFilter.java"
click node_nocache "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/filter/NoCacheFilter.java"
click node_jersey "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/config/JerseyApplication.java"
click node_authservice "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/service/AuthService.java"
click node_userservice "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/service/UserService.java"
click node_password "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/util/PasswordUtil.java"
click node_userdao "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/dao/UserDAOImpl.java"
click node_activitydao "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/dao/ActivityLogDAO.java"
click node_dbmanager "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/util/DBConnectionManager.java"
click node_dbinit "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/util/DBInitializer.java"
click node_user "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/model/User.java"
click node_audit "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/model/ActivityLog.java"
click node_response "https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/model/ApiResponse.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_login,node_dashboard,node_appjs,node_usersjs,node_browser toneBlue
class node_authapi,node_userapi,node_authfilter,node_nocache,node_jersey,node_response,node_mysql toneAmber
class node_authservice,node_userservice,node_password,node_user,node_audit toneMint
class node_userdao,node_activitydao,node_dbmanager,node_dbinit toneRose
```

## Components

### Web interface

- [Login and registration](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/login.jsp): `src/main/webapp/login.jsp`
- [Governance dashboard](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/home.jsp): `src/main/webapp/home.jsp`
- [Session UI behavior](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/js/app.js): `src/main/webapp/js/app.js`
- [User grid controls](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/webapp/js/users.js): `src/main/webapp/js/users.js`

### HTTP and security

- [Auth endpoints](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/web/AuthResource.java): `src/main/java/com/usermanagement/web/AuthResource.java`
- [User endpoints](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/web/UserResource.java): `src/main/java/com/usermanagement/web/UserResource.java`
- [Authentication filter](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/filter/AuthenticationFilter.java): `src/main/java/com/usermanagement/filter/AuthenticationFilter.java`
- [No-cache filter](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/filter/NoCacheFilter.java): `src/main/java/com/usermanagement/filter/NoCacheFilter.java`
- [REST registration](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/config/JerseyApplication.java): `src/main/java/com/usermanagement/config/JerseyApplication.java`
- [API response model](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/model/ApiResponse.java): `src/main/java/com/usermanagement/model/ApiResponse.java`

### Governance services

- [Session authentication](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/service/AuthService.java): `src/main/java/com/usermanagement/service/AuthService.java`
- [User governance](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/service/UserService.java): `src/main/java/com/usermanagement/service/UserService.java`
- [BCrypt password handling](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/util/PasswordUtil.java): `src/main/java/com/usermanagement/util/PasswordUtil.java`
- [User account model](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/model/User.java): `src/main/java/com/usermanagement/model/User.java`
- [Activity log model](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/model/ActivityLog.java): `src/main/java/com/usermanagement/model/ActivityLog.java`

### Persistence and setup

- [User persistence](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/dao/UserDAOImpl.java): `src/main/java/com/usermanagement/dao/UserDAOImpl.java`
- [Audit persistence](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/dao/ActivityLogDAO.java): `src/main/java/com/usermanagement/dao/ActivityLogDAO.java`
- [Connection pool](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/util/DBConnectionManager.java): `src/main/java/com/usermanagement/util/DBConnectionManager.java`
- [Schema and seed setup](https://github.com/dr636457-oss/usermanagement/blob/main/src/main/java/com/usermanagement/util/DBInitializer.java): `src/main/java/com/usermanagement/util/DBInitializer.java`

### Other components

- **Browser user**
- **MySQL database**

## Connections

- Browser user → Login and registration: opens (evidence: `README.md`)
- Browser user → Governance dashboard: uses (evidence: `README.md`)
- Login and registration → Auth endpoints: authenticates via (evidence: `README.md`)
- User grid controls → User endpoints: calls CRUD API (evidence: `README.md`)
- Session UI behavior → Auth endpoints: session requests
- Governance dashboard → User grid controls: loads controls
- REST registration → Auth endpoints: registers (evidence: `src/main/java/com/usermanagement/config/JerseyApplication.java`)
- REST registration → User endpoints: registers (evidence: `src/main/java/com/usermanagement/config/JerseyApplication.java`)
- Authentication filter → Session authentication: checks sessions (evidence: `src/main/java/com/usermanagement/filter/AuthenticationFilter.java`)
- Auth endpoints → Session authentication: delegates authentication (evidence: `src/main/java/com/usermanagement/web/AuthResource.java`)
- Auth endpoints → User governance: creates registrations (evidence: `src/main/java/com/usermanagement/web/AuthResource.java`)
- User endpoints → User governance: delegates user actions (evidence: `src/main/java/com/usermanagement/web/UserResource.java`)
- Session authentication → User persistence: looks up accounts (evidence: `src/main/java/com/usermanagement/service/AuthService.java`)
- Session authentication → Audit persistence: records auth events (evidence: `src/main/java/com/usermanagement/service/AuthService.java`)
- User governance → User persistence: validates and mutates (evidence: `src/main/java/com/usermanagement/service/UserService.java`)
- User governance → Audit persistence: records CRUD events (evidence: `src/main/java/com/usermanagement/service/UserService.java`)
- Session authentication → BCrypt password handling: checks password (evidence: `src/main/java/com/usermanagement/service/AuthService.java`)
- User governance → BCrypt password handling: hashes passwords (evidence: `src/main/java/com/usermanagement/service/UserService.java`)
- User persistence → Connection pool: gets connections (evidence: `src/main/java/com/usermanagement/dao/UserDAOImpl.java`)
- Audit persistence → Connection pool: gets connections (evidence: `src/main/java/com/usermanagement/dao/ActivityLogDAO.java`)
- Schema and seed setup → Connection pool: initializes through (evidence: `src/main/java/com/usermanagement/util/DBInitializer.java`)
- User persistence → MySQL database: reads and writes
- Audit persistence → MySQL database: stores audit events
- Connection pool → MySQL database: connects to (evidence: `README.md`)
- Session authentication → User account model: uses account data (evidence: `src/main/java/com/usermanagement/service/AuthService.java`)
- Audit persistence → Activity log model: maps log records (evidence: `src/main/java/com/usermanagement/dao/ActivityLogDAO.java`)
- Auth endpoints → API response model: returns payloads (evidence: `src/main/java/com/usermanagement/web/AuthResource.java`)
- User endpoints → API response model: returns payloads (evidence: `src/main/java/com/usermanagement/web/UserResource.java`)
