# abkwalid/first-jhipster-application architecture

> Architecture diagram of the GitHub repository abkwalid/first-jhipster-application, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/abkwalid/first-jhipster-application
- Repository: https://github.com/abkwalid/first-jhipster-application

## Overview

FirstJhipsterApplication is a JHipster user-account and administration web application. Users enter through the Angular client to register, activate, sign in, manage account settings, or access protected administration screens; the Java API provides account and user operations, authentication, and management data. The central backend domain is user and authority persistence, with JWT security around API access. The README identifies the broader admin capabilities; frontend feature modules and several REST resources were not sampled, so those branches are represented at their source paths without speculative call-level links.

Main entry points: [`src/main/java/tech/digiwise/japp/service/UserService.java`](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/service/UserService.java) (User service), [`src/main/webapp/app/app-routing.module.ts`](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/app-routing.module.ts) (App routing), [`src/main/java/tech/digiwise/japp/security/jwt/TokenProvider.java`](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/security/jwt/TokenProvider.java) (JWT provider), [`src/main/java/tech/digiwise/japp/domain/User.java`](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/domain/User.java) (User domain)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Angular client"]
  node_application["App shell<br/>[app.module.ts]"]
  node_main["Main layout<br/>[main.component.ts]"]
  node_routing["App routing"]
end

subgraph group_account["Account and admin"]
  node_accountui["Account screens"]
  node_loginui["Login screen"]
  node_adminroute["Admin routing"]
  node_usermgmt["User management"]
  node_adminops["Admin operations"]
end

subgraph group_api["Java API"]
  node_accountapi["Account API"]
  node_userapi["User API<br/>[UserResource.java]"]
  node_publicuser["Public user API"]
  node_authapi["JWT login API"]
  node_usersvc["User service<br/>[UserService.java]"]
  node_mail["Mail service<br/>[MailService.java]"]
  node_userrepo["User repository"]
end

subgraph group_identity["Identity and security"]
  node_userdomain["User domain<br/>[User.java]"]
  node_authority["Authorities<br/>[Authority.java]"]
  node_details["User authentication"]
  node_token["JWT provider<br/>[TokenProvider.java]"]
  node_jwtfilter["JWT filter<br/>[JWTFilter.java]"]
  node_meters["Security meters"]
end

node_visitor(("Browser user"))

node_visitor -->|"opens"| node_application
node_application -->|"loads"| node_routing
node_application -->|"bootstraps"| node_main
node_main -->|"tracks navigation"| node_routing
node_main -.->|"restores identity"| node_accountui
node_routing -->|"loads"| node_accountui
node_routing -->|"loads"| node_loginui
node_routing -->|"loads"| node_adminroute
node_adminroute -->|"loads"| node_usermgmt
node_adminroute -->|"routes admin"| node_adminops
node_loginui -.->|"authenticates"| node_authapi
node_accountui -.->|"requests account"| node_accountapi
node_usermgmt -.->|"manages users"| node_userapi
node_accountapi -.->|"delegates"| node_usersvc
node_userapi -.->|"delegates"| node_usersvc
node_publicuser -.->|"delegates"| node_usersvc
node_usersvc -->|"reads and writes"| node_userrepo
node_usersvc -->|"assigns roles"| node_authority
node_userrepo -->|"queries"| node_userdomain
node_userdomain -->|"associates roles"| node_authority
node_authapi -->|"creates token"| node_token
node_authapi -->|"sets header"| node_jwtfilter
node_jwtfilter -->|"validates token"| node_token
node_details -->|"loads credentials"| node_userrepo
node_details -->|"checks activation"| node_userdomain
node_details -->|"maps roles"| node_authority
node_token -->|"reads identity"| node_userdomain
node_token -->|"records failures"| node_meters
node_usersvc -.->|"sends account mail"| node_mail

click node_application "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/app.module.ts"
click node_main "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/layouts/main/main.component.ts"
click node_routing "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/app-routing.module.ts"
click node_accountui "https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/account"
click node_loginui "https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/login"
click node_adminroute "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/admin/admin-routing.module.ts"
click node_usermgmt "https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/admin/user-management"
click node_adminops "https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/admin"
click node_accountapi "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/AccountResource.java"
click node_userapi "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/UserResource.java"
click node_publicuser "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/PublicUserResource.java"
click node_authapi "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/UserJWTController.java"
click node_usersvc "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/service/UserService.java"
click node_mail "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/service/MailService.java"
click node_userrepo "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/repository/UserRepository.java"
click node_userdomain "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/domain/User.java"
click node_authority "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/domain/Authority.java"
click node_details "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/security/DomainUserDetailsService.java"
click node_token "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/security/jwt/TokenProvider.java"
click node_jwtfilter "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/security/jwt/JWTFilter.java"
click node_meters "https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/management/SecurityMetersService.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_application,node_main,node_routing,node_visitor toneBlue
class node_accountui,node_loginui,node_adminroute,node_usermgmt,node_adminops toneAmber
class node_accountapi,node_userapi,node_publicuser,node_authapi,node_usersvc,node_mail,node_userrepo toneMint
class node_userdomain,node_authority,node_details,node_token,node_jwtfilter,node_meters toneRose
```

## Components

### Angular client

- [App shell](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/app.module.ts): `src/main/webapp/app/app.module.ts`
- [Main layout](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/layouts/main/main.component.ts): `src/main/webapp/app/layouts/main/main.component.ts`
- [App routing](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/app-routing.module.ts): `src/main/webapp/app/app-routing.module.ts`

### Account and admin

- [Account screens](https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/account): `src/main/webapp/app/account`
- [Login screen](https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/login): `src/main/webapp/app/login`
- [Admin routing](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/webapp/app/admin/admin-routing.module.ts): `src/main/webapp/app/admin/admin-routing.module.ts`
- [User management](https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/admin/user-management): `src/main/webapp/app/admin/user-management`
- [Admin operations](https://github.com/abkwalid/first-jhipster-application/tree/main/src/main/webapp/app/admin): `src/main/webapp/app/admin`

### Java API

- [Account API](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/AccountResource.java): `src/main/java/tech/digiwise/japp/web/rest/AccountResource.java`
- [User API](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/UserResource.java): `src/main/java/tech/digiwise/japp/web/rest/UserResource.java`
- [Public user API](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/PublicUserResource.java): `src/main/java/tech/digiwise/japp/web/rest/PublicUserResource.java`
- [JWT login API](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/web/rest/UserJWTController.java): `src/main/java/tech/digiwise/japp/web/rest/UserJWTController.java`
- [User service](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/service/UserService.java): `src/main/java/tech/digiwise/japp/service/UserService.java`
- [Mail service](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/service/MailService.java): `src/main/java/tech/digiwise/japp/service/MailService.java`
- [User repository](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/repository/UserRepository.java): `src/main/java/tech/digiwise/japp/repository/UserRepository.java`

### Identity and security

- [User domain](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/domain/User.java): `src/main/java/tech/digiwise/japp/domain/User.java`
- [Authorities](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/domain/Authority.java): `src/main/java/tech/digiwise/japp/domain/Authority.java`
- [User authentication](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/security/DomainUserDetailsService.java): `src/main/java/tech/digiwise/japp/security/DomainUserDetailsService.java`
- [JWT provider](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/security/jwt/TokenProvider.java): `src/main/java/tech/digiwise/japp/security/jwt/TokenProvider.java`
- [JWT filter](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/security/jwt/JWTFilter.java): `src/main/java/tech/digiwise/japp/security/jwt/JWTFilter.java`
- [Security meters](https://github.com/abkwalid/first-jhipster-application/blob/main/src/main/java/tech/digiwise/japp/management/SecurityMetersService.java): `src/main/java/tech/digiwise/japp/management/SecurityMetersService.java`

### Other components

- **Browser user**

## Connections

- Browser user → App shell: opens (evidence: `src/main/webapp/app/app.module.ts`)
- App shell → App routing: loads (evidence: `src/main/webapp/app/app.module.ts`)
- App shell → Main layout: bootstraps (evidence: `src/main/webapp/app/app.module.ts`)
- Main layout → App routing: tracks navigation (evidence: `src/main/webapp/app/layouts/main/main.component.ts`)
- Main layout → Account screens: restores identity
- App routing → Account screens: loads (evidence: `src/main/webapp/app/app-routing.module.ts`)
- App routing → Login screen: loads (evidence: `src/main/webapp/app/app-routing.module.ts`)
- App routing → Admin routing: loads (evidence: `src/main/webapp/app/app-routing.module.ts`)
- Admin routing → User management: loads (evidence: `src/main/webapp/app/admin/admin-routing.module.ts`)
- Admin routing → Admin operations: routes admin (evidence: `src/main/webapp/app/admin/admin-routing.module.ts`)
- Login screen → JWT login API: authenticates
- Account screens → Account API: requests account
- User management → User API: manages users
- Account API → User service: delegates
- User API → User service: delegates
- Public user API → User service: delegates
- User service → User repository: reads and writes (evidence: `src/main/java/tech/digiwise/japp/service/UserService.java`)
- User service → Authorities: assigns roles (evidence: `src/main/java/tech/digiwise/japp/service/UserService.java`)
- User repository → User domain: queries (evidence: `src/main/java/tech/digiwise/japp/repository/UserRepository.java`)
- User domain → Authorities: associates roles (evidence: `src/main/java/tech/digiwise/japp/domain/User.java`)
- JWT login API → JWT provider: creates token (evidence: `src/main/java/tech/digiwise/japp/web/rest/UserJWTController.java`)
- JWT login API → JWT filter: sets header (evidence: `src/main/java/tech/digiwise/japp/web/rest/UserJWTController.java`)
- JWT filter → JWT provider: validates token (evidence: `src/main/java/tech/digiwise/japp/security/jwt/JWTFilter.java`)
- User authentication → User repository: loads credentials (evidence: `src/main/java/tech/digiwise/japp/security/DomainUserDetailsService.java`)
- User authentication → User domain: checks activation (evidence: `src/main/java/tech/digiwise/japp/security/DomainUserDetailsService.java`)
- User authentication → Authorities: maps roles (evidence: `src/main/java/tech/digiwise/japp/security/DomainUserDetailsService.java`)
- JWT provider → User domain: reads identity (evidence: `src/main/java/tech/digiwise/japp/security/jwt/TokenProvider.java`)
- JWT provider → Security meters: records failures (evidence: `src/main/java/tech/digiwise/japp/security/jwt/TokenProvider.java`)
- User service → Mail service: sends account mail
