# sachingunawardhana10/customs-ebid architecture

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

- Interactive diagram: https://gitdiagram.com/sachingunawardhana10/customs-ebid
- Repository: https://github.com/sachingunawardhana10/customs-ebid

## Overview

This repository contains the User/Auth service within the larger Customs eBid auction platform. Its main workflow accepts registration or login requests, creates a role-bearing user or authenticates credentials, then returns a JWT on successful login; bearer tokens are checked on later requests. The README also names auction, bidding, payment, and notification/audit services, but their source is absent from this tree, so they are shown only as documented platform context. The graph follows sampled auth-service calls; it does not infer deployment or persistence wiring beyond the shown repositories and entities.

Main entry points: [`user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java) (Auth endpoints), [`user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java`](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java) (User registration), [`user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java`](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java) (Bearer filter), [`user-auth-service/src/main/java/lk/customsebid/userauth/security/CustomUserDetailsService.java`](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/CustomUserDetailsService.java) (Load user details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["Auth API"]
  node_auth_controller["Auth endpoints"]
  node_auth_dtos["Auth DTOs"]
end

subgraph group_identity["Identity Management"]
  node_user_service["User registration<br/>[UserService.java]"]
  node_user_repo["User repository"]
  node_role_repo["Role repository"]
  node_user_entity["User and roles<br/>[User.java]"]
end

subgraph group_security["Authentication Security"]
  node_auth_manager["Credential authentication"]
  node_details_service["Load user details"]
  node_jwt_service["JWT operations<br/>[JwtService.java]"]
  node_jwt_filter["Bearer filter"]
  node_security_config["Security configuration"]
end

subgraph group_platform["Auction Platform"]
  node_platform_services["Other eBid services"]
end

node_client(("API caller"))

node_client -->|"sends auth request"| node_auth_controller
node_auth_controller -->|"accepts and returns"| node_auth_dtos
node_auth_controller -->|"registers user"| node_user_service
node_user_service -->|"checks and saves"| node_user_repo
node_user_service -->|"finds bidder role"| node_role_repo
node_user_service -->|"builds user"| node_user_entity
node_auth_controller -->|"authenticates credentials"| node_auth_manager
node_auth_manager -.->|"loads account"| node_details_service
node_details_service -->|"looks up email"| node_user_repo
node_auth_controller -->|"creates login token"| node_jwt_service
node_client -->|"sends bearer token"| node_jwt_filter
node_jwt_filter -->|"extracts and validates"| node_jwt_service
node_jwt_filter -->|"loads token account"| node_details_service
node_security_config -->|"registers filter"| node_jwt_filter
node_platform_services -.->|"platform consumers"| node_client

click node_auth_controller "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java"
click node_auth_dtos "https://github.com/sachingunawardhana10/customs-ebid/tree/develop/user-auth-service/src/main/java/lk/customsebid/userauth/dto"
click node_user_service "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java"
click node_user_repo "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/repository/UserRepository.java"
click node_role_repo "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/repository/RoleRepository.java"
click node_user_entity "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/entity/User.java"
click node_auth_manager "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java"
click node_details_service "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/CustomUserDetailsService.java"
click node_jwt_service "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtService.java"
click node_jwt_filter "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java"
click node_security_config "https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/SecurityConfig.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_auth_controller,node_auth_dtos toneBlue
class node_user_service,node_user_repo,node_role_repo,node_user_entity toneAmber
class node_auth_manager,node_details_service,node_jwt_service,node_jwt_filter,node_security_config,node_client toneMint
class node_platform_services toneRose
```

## Components

### Auth API

- [Auth endpoints](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java): `user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`
- [Auth DTOs](https://github.com/sachingunawardhana10/customs-ebid/tree/develop/user-auth-service/src/main/java/lk/customsebid/userauth/dto): `user-auth-service/src/main/java/lk/customsebid/userauth/dto`

### Identity Management

- [User registration](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java): `user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java`
- [User repository](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/repository/UserRepository.java): `user-auth-service/src/main/java/lk/customsebid/userauth/repository/UserRepository.java`
- [Role repository](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/repository/RoleRepository.java): `user-auth-service/src/main/java/lk/customsebid/userauth/repository/RoleRepository.java`
- [User and roles](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/entity/User.java): `user-auth-service/src/main/java/lk/customsebid/userauth/entity/User.java`

### Authentication Security

- [Credential authentication](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java): `user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`
- [Load user details](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/CustomUserDetailsService.java): `user-auth-service/src/main/java/lk/customsebid/userauth/security/CustomUserDetailsService.java`
- [JWT operations](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtService.java): `user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtService.java`
- [Bearer filter](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java): `user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java`
- [Security configuration](https://github.com/sachingunawardhana10/customs-ebid/blob/develop/user-auth-service/src/main/java/lk/customsebid/userauth/security/SecurityConfig.java): `user-auth-service/src/main/java/lk/customsebid/userauth/security/SecurityConfig.java`

### Auction Platform

- **Other eBid services**

### Other components

- **API caller**

## Connections

- API caller → Auth endpoints: sends auth request (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`)
- Auth endpoints → Auth DTOs: accepts and returns (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`)
- Auth endpoints → User registration: registers user (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`)
- User registration → User repository: checks and saves (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java`)
- User registration → Role repository: finds bidder role (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java`)
- User registration → User and roles: builds user (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/service/UserService.java`)
- Auth endpoints → Credential authentication: authenticates credentials (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`)
- Credential authentication → Load user details: loads account
- Load user details → User repository: looks up email (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/security/CustomUserDetailsService.java`)
- Auth endpoints → JWT operations: creates login token (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/controller/AuthController.java`)
- API caller → Bearer filter: sends bearer token (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java`)
- Bearer filter → JWT operations: extracts and validates (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java`)
- Bearer filter → Load user details: loads token account (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/security/JwtAuthenticationFilter.java`)
- Security configuration → Bearer filter: registers filter (evidence: `user-auth-service/src/main/java/lk/customsebid/userauth/security/SecurityConfig.java`)
- Other eBid services → API caller: platform consumers (evidence: `README.md`)
