# faridbaharuddin/aos-aaa architecture

> Architecture diagram of the GitHub repository faridbaharuddin/aos-aaa, 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/faridbaharuddin/aos-aaa
- Repository: https://github.com/faridbaharuddin/aos-aaa

## Overview

This Java application provides account, authentication/authorization, OAuth, and person-profile services. The principal workflow accepts controller requests, processes them through services, and reads or mutates account/person/token data via DAOs. Account registration includes activation email; sign-in creates authorization tokens. OAuth providers and profile-image upload are additional branches. The README names no further capabilities; several controller/service connections are supported by indexed references rather than inspected call bodies, so uncertain edges are omitted.

Main entry points: [`src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java) (OAuth identity), [`src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java) (Account lifecycle), [`src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java`](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java) (Authentication), [`src/main/java/com/projektinnovatif/aosaaa/dao/PersonDao.java`](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/PersonDao.java) (Person data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API controllers"]
  node_accountctl["Account API"]
  node_authctl["Sign-in API"]
  node_oauthctl["OAuth API"]
  node_personctl["Person API"]
end

subgraph group_services["Identity services"]
  node_accountservice["Account lifecycle"]
  node_authservice["Authentication"]
  node_oauthservice["OAuth identity<br/>[OauthService.java]"]
  node_personservice["Person profiles<br/>[PersonService.java]"]
  node_uploadservice["Image upload"]
  node_security["Password security<br/>[Security.java]"]
end

subgraph group_persistence["Persistence"]
  node_accountdao["Account data<br/>[AccountDao.java]"]
  node_persondao["Person data<br/>[PersonDao.java]"]
  node_permissiondao["Permission data<br/>[PermissionDao.java]"]
  node_tokendao["Token data"]
  node_subscriptiondao["Subscription data"]
  node_basedao["DAO operations<br/>[BaseDao.java]"]
  node_accountmodel[("Account entity<br/>[Account.java]")]
  node_personmodel[("Person entity<br/>[Person.java]")]
  node_tokenmodel[("Authorization token")]
end

subgraph group_shared["Validation and support"]
  node_forms["Request forms<br/>[IForm.java]"]
  node_validator["Input validation<br/>[Validator.java]"]
  node_oauthinfo["OAuth identity data<br/>[OauthInfo.java]"]
  node_responses["API responses"]
  node_email["Email sender<br/>[EmailSender.java]"]
end

node_client(("API client"))
node_google(("Google identity"))
node_facebook(("Facebook identity"))
node_mail(("Mail service"))

node_client -->|"requests"| node_accountctl
node_client -->|"requests"| node_authctl
node_client -->|"requests"| node_oauthctl
node_client -->|"requests"| node_personctl
node_accountctl -->|"delegates"| node_accountservice
node_accountctl -->|"delegates"| node_authservice
node_accountctl -->|"delegates"| node_personservice
node_authctl -->|"delegates"| node_authservice
node_oauthctl -->|"delegates"| node_oauthservice
node_personctl -->|"delegates"| node_personservice
node_personctl -->|"delegates"| node_uploadservice
node_accountservice -->|"reads/writes"| node_accountdao
node_accountservice -->|"reads/writes"| node_persondao
node_accountservice -->|"assigns permissions"| node_permissiondao
node_accountservice -->|"accesses"| node_subscriptiondao
node_accountservice -->|"hashes passwords"| node_security
node_accountservice -.->|"sends activation"| node_email
node_email -.->|"delivers"| node_mail
node_authservice -->|"reads/writes"| node_accountdao
node_authservice -->|"creates/revokes"| node_tokendao
node_authservice -->|"checks access"| node_permissiondao
node_authservice -->|"resolves owner"| node_persondao
node_authservice -.->|"verifies passwords"| node_security
node_oauthservice -->|"verifies token"| node_google
node_oauthservice -->|"fetches profile"| node_facebook
node_oauthservice -->|"reads/writes"| node_accountdao
node_oauthservice -->|"reads/writes"| node_persondao
node_oauthservice -->|"assigns permissions"| node_permissiondao
node_oauthservice -.->|"creates token"| node_tokendao
node_oauthservice -->|"uses identity"| node_oauthinfo
node_personservice -->|"reads/writes"| node_persondao
node_personservice -->|"accepts form"| node_forms
node_personservice -.->|"validates"| node_validator
node_accountdao -.->|"inherits operations"| node_basedao
node_persondao -->|"inherits operations"| node_basedao
node_accountdao -.->|"persists"| node_accountmodel
node_persondao -->|"queries"| node_personmodel
node_tokendao -.->|"persists"| node_tokenmodel
node_accountctl -->|"builds response"| node_responses
node_authctl -->|"builds response"| node_responses
node_oauthctl -->|"builds response"| node_responses
node_personctl -->|"builds response"| node_responses

click node_accountctl "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java"
click node_authctl "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/AuthNAuthController.java"
click node_oauthctl "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/OauthController.java"
click node_personctl "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/PersonController.java"
click node_accountservice "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java"
click node_authservice "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java"
click node_oauthservice "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java"
click node_personservice "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/PersonService.java"
click node_uploadservice "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/FileUploadService.java"
click node_security "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/Security.java"
click node_accountdao "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/AccountDao.java"
click node_persondao "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/PersonDao.java"
click node_permissiondao "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/PermissionDao.java"
click node_tokendao "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/AuthorisationtokenDao.java"
click node_subscriptiondao "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/SubscriptionDao.java"
click node_basedao "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/BaseDao.java"
click node_accountmodel "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/model/Account.java"
click node_personmodel "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/model/Person.java"
click node_tokenmodel "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/model/Authorisationtoken.java"
click node_forms "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/form/IForm.java"
click node_validator "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/form/Validator.java"
click node_oauthinfo "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dto/OauthInfo.java"
click node_responses "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dto/ResponseBuilder.java"
click node_email "https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/common/EmailSender.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_accountctl,node_authctl,node_oauthctl,node_personctl,node_client toneBlue
class node_accountservice,node_authservice,node_oauthservice,node_personservice,node_uploadservice,node_security toneAmber
class node_accountdao,node_persondao,node_permissiondao,node_tokendao,node_subscriptiondao,node_basedao,node_accountmodel,node_personmodel,node_tokenmodel toneMint
class node_forms,node_validator,node_oauthinfo,node_responses,node_email toneRose
class node_google,node_facebook,node_mail toneIndigo
```

## Components

### API controllers

- [Account API](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java): `src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java`
- [Sign-in API](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/AuthNAuthController.java): `src/main/java/com/projektinnovatif/aosaaa/controller/AuthNAuthController.java`
- [OAuth API](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/OauthController.java): `src/main/java/com/projektinnovatif/aosaaa/controller/OauthController.java`
- [Person API](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/controller/PersonController.java): `src/main/java/com/projektinnovatif/aosaaa/controller/PersonController.java`

### Identity services

- [Account lifecycle](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java): `src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`
- [Authentication](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java): `src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java`
- [OAuth identity](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java): `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`
- [Person profiles](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/PersonService.java): `src/main/java/com/projektinnovatif/aosaaa/service/PersonService.java`
- [Image upload](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/FileUploadService.java): `src/main/java/com/projektinnovatif/aosaaa/service/FileUploadService.java`
- [Password security](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/service/Security.java): `src/main/java/com/projektinnovatif/aosaaa/service/Security.java`

### Persistence

- [Account data](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/AccountDao.java): `src/main/java/com/projektinnovatif/aosaaa/dao/AccountDao.java`
- [Person data](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/PersonDao.java): `src/main/java/com/projektinnovatif/aosaaa/dao/PersonDao.java`
- [Permission data](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/PermissionDao.java): `src/main/java/com/projektinnovatif/aosaaa/dao/PermissionDao.java`
- [Token data](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/AuthorisationtokenDao.java): `src/main/java/com/projektinnovatif/aosaaa/dao/AuthorisationtokenDao.java`
- [Subscription data](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/SubscriptionDao.java): `src/main/java/com/projektinnovatif/aosaaa/dao/SubscriptionDao.java`
- [DAO operations](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dao/BaseDao.java): `src/main/java/com/projektinnovatif/aosaaa/dao/BaseDao.java`
- [Account entity](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/model/Account.java): `src/main/java/com/projektinnovatif/aosaaa/model/Account.java`
- [Person entity](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/model/Person.java): `src/main/java/com/projektinnovatif/aosaaa/model/Person.java`
- [Authorization token](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/model/Authorisationtoken.java): `src/main/java/com/projektinnovatif/aosaaa/model/Authorisationtoken.java`

### Validation and support

- [Request forms](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/form/IForm.java): `src/main/java/com/projektinnovatif/aosaaa/form/IForm.java`
- [Input validation](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/form/Validator.java): `src/main/java/com/projektinnovatif/aosaaa/form/Validator.java`
- [OAuth identity data](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dto/OauthInfo.java): `src/main/java/com/projektinnovatif/aosaaa/dto/OauthInfo.java`
- [API responses](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/dto/ResponseBuilder.java): `src/main/java/com/projektinnovatif/aosaaa/dto/ResponseBuilder.java`
- [Email sender](https://github.com/faridbaharuddin/aos-aaa/blob/master/src/main/java/com/projektinnovatif/aosaaa/common/EmailSender.java): `src/main/java/com/projektinnovatif/aosaaa/common/EmailSender.java`

### Other components

- **API client**
- **Google identity**
- **Facebook identity**
- **Mail service**

## Connections

- API client → Account API: requests (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java`)
- API client → Sign-in API: requests (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AuthNAuthController.java`)
- API client → OAuth API: requests (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/OauthController.java`)
- API client → Person API: requests (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/PersonController.java`)
- Account API → Account lifecycle: delegates (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java`)
- Account API → Authentication: delegates (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java`)
- Account API → Person profiles: delegates (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java`)
- Sign-in API → Authentication: delegates (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AuthNAuthController.java`)
- OAuth API → OAuth identity: delegates (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/OauthController.java`)
- Person API → Person profiles: delegates (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/PersonController.java`)
- Person API → Image upload: delegates (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/PersonController.java`)
- Account lifecycle → Account data: reads/writes (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`)
- Account lifecycle → Person data: reads/writes (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`)
- Account lifecycle → Permission data: assigns permissions (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`)
- Account lifecycle → Subscription data: accesses (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`)
- Account lifecycle → Password security: hashes passwords (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`)
- Account lifecycle → Email sender: sends activation (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AccountService.java`)
- Email sender → Mail service: delivers
- Authentication → Account data: reads/writes (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java`)
- Authentication → Token data: creates/revokes (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java`)
- Authentication → Permission data: checks access (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java`)
- Authentication → Person data: resolves owner (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java`)
- Authentication → Password security: verifies passwords (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/AuthNAuthService.java`)
- OAuth identity → Google identity: verifies token (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`)
- OAuth identity → Facebook identity: fetches profile (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`)
- OAuth identity → Account data: reads/writes (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`)
- OAuth identity → Person data: reads/writes (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`)
- OAuth identity → Permission data: assigns permissions (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`)
- OAuth identity → Token data: creates token (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`)
- OAuth identity → OAuth identity data: uses identity (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/OauthService.java`)
- Person profiles → Person data: reads/writes (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/PersonService.java`)
- Person profiles → Request forms: accepts form (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/PersonService.java`)
- Person profiles → Input validation: validates (evidence: `src/main/java/com/projektinnovatif/aosaaa/service/PersonService.java`)
- Account data → DAO operations: inherits operations (evidence: `src/main/java/com/projektinnovatif/aosaaa/dao/AccountDao.java`)
- Person data → DAO operations: inherits operations (evidence: `src/main/java/com/projektinnovatif/aosaaa/dao/PersonDao.java`)
- Account data → Account entity: persists (evidence: `src/main/java/com/projektinnovatif/aosaaa/dao/AccountDao.java`)
- Person data → Person entity: queries (evidence: `src/main/java/com/projektinnovatif/aosaaa/dao/PersonDao.java`)
- Token data → Authorization token: persists (evidence: `src/main/java/com/projektinnovatif/aosaaa/dao/AuthorisationtokenDao.java`)
- Account API → API responses: builds response (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AccountController.java`)
- Sign-in API → API responses: builds response (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/AuthNAuthController.java`)
- OAuth API → API responses: builds response (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/OauthController.java`)
- Person API → API responses: builds response (evidence: `src/main/java/com/projektinnovatif/aosaaa/controller/PersonController.java`)
