# fisal1/azentio architecture

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

- Interactive diagram: https://gitdiagram.com/fisal1/azentio
- Repository: https://github.com/fisal1/azentio

## Overview

Sentinel AML is a Spring Boot transaction-monitoring prototype with a browser-based analyst dashboard. Its main workflow is authenticated customer/account and transaction ingestion, rule-based screening into explainable alerts, and analyst investigation through cases and audit history. The README documents the controller/service/repository layering and major capabilities; the supplied source excerpts chiefly show dashboard API calls and network rendering, not backend call wiring. Dashed, uncited edges mark those unverified backend connections.

Main entry points: [`src/main/resources/static/app.js`](https://github.com/fisal1/azentio/blob/main/src/main/resources/static/app.js) (Dashboard), [`src/main/java/azentio/com/demo/service/SentinelService.java`](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/SentinelService.java) (Application facade), [`src/main/java/azentio/com/demo/service/MonitoringService.java`](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/MonitoringService.java) (Transaction monitoring), [`src/main/java/azentio/com/demo/controller/CustomerController.java`](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/CustomerController.java) (Customer API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Analyst interface"]
  node_dashboard["Dashboard<br/>[app.js]"]
  node_network_view["Network visualization<br/>[network.js]"]
end

subgraph group_ingest["Ingestion and detection"]
  node_csv_import["CSV ingestion"]
  node_demo_data["Synthetic demo data"]
  node_monitoring["Transaction monitoring"]
  node_rule_engine["Rule evaluation<br/>[RuleEngine.java]"]
end

subgraph group_investigate["Investigation"]
  node_workflow["Case workflow"]
  node_network_service["Network graph data"]
end

subgraph group_platform["Application platform"]
  node_customer_api["Customer API"]
  node_account_api["Account API"]
  node_transaction_api["Transaction API"]
  node_alert_api["Alert API"]
  node_case_api["Case API"]
  node_rule_api["Rule API"]
  node_network_api["Network API"]
  node_workspace_api["Workspace API"]
  node_security["Role enforcement"]
  node_sentinel["Application facade"]
  node_repository["JPA persistence"]
end

node_analyst(("Analyst or admin"))
node_database[("PostgreSQL")]

node_analyst -->|"uses"| node_dashboard
node_dashboard -->|"calls API"| node_customer_api
node_dashboard -.->|"calls API"| node_account_api
node_dashboard -->|"calls API"| node_transaction_api
node_dashboard -->|"calls API"| node_alert_api
node_dashboard -.->|"calls API"| node_case_api
node_dashboard -.->|"calls API"| node_rule_api
node_dashboard -->|"calls API"| node_network_api
node_dashboard -.->|"calls API"| node_workspace_api
node_dashboard -->|"mounts graph"| node_network_view
node_customer_api -.->|"delegates"| node_sentinel
node_account_api -.->|"delegates"| node_sentinel
node_transaction_api -.->|"delegates"| node_sentinel
node_alert_api -.->|"delegates"| node_sentinel
node_case_api -.->|"delegates"| node_sentinel
node_rule_api -.->|"delegates"| node_sentinel
node_network_api -.->|"delegates"| node_network_service
node_sentinel -.->|"coordinates"| node_csv_import
node_sentinel -.->|"coordinates"| node_monitoring
node_sentinel -.->|"coordinates"| node_workflow
node_monitoring -.->|"evaluates with"| node_rule_engine
node_sentinel -.->|"persists through"| node_repository
node_repository -.->|"reads and writes"| node_database

click node_dashboard "https://github.com/fisal1/azentio/blob/main/src/main/resources/static/app.js"
click node_network_view "https://github.com/fisal1/azentio/blob/main/src/main/resources/static/network.js"
click node_customer_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/CustomerController.java"
click node_account_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/AccountController.java"
click node_transaction_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/TransactionController.java"
click node_alert_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/AlertController.java"
click node_case_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/CaseController.java"
click node_rule_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/RuleController.java"
click node_network_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/NetworkController.java"
click node_workspace_api "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/WorkspaceController.java"
click node_security "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/config/SecurityConfig.java"
click node_sentinel "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/SentinelService.java"
click node_csv_import "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/CsvImportService.java"
click node_demo_data "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/DemoDataService.java"
click node_monitoring "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/MonitoringService.java"
click node_rule_engine "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/RuleEngine.java"
click node_workflow "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/WorkflowService.java"
click node_network_service "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/NetworkGraphService.java"
click node_repository "https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/repository/SentinelRepository.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_dashboard,node_network_view toneBlue
class node_csv_import,node_demo_data,node_monitoring,node_rule_engine,node_database toneAmber
class node_workflow,node_network_service toneMint
class node_customer_api,node_account_api,node_transaction_api,node_alert_api,node_case_api,node_rule_api,node_network_api,node_workspace_api,node_security,node_sentinel,node_repository toneRose
class node_analyst toneIndigo
```

## Components

### Analyst interface

- [Dashboard](https://github.com/fisal1/azentio/blob/main/src/main/resources/static/app.js): `src/main/resources/static/app.js`
- [Network visualization](https://github.com/fisal1/azentio/blob/main/src/main/resources/static/network.js): `src/main/resources/static/network.js`

### Ingestion and detection

- [CSV ingestion](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/CsvImportService.java): `src/main/java/azentio/com/demo/service/CsvImportService.java`
- [Synthetic demo data](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/DemoDataService.java): `src/main/java/azentio/com/demo/service/DemoDataService.java`
- [Transaction monitoring](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/MonitoringService.java): `src/main/java/azentio/com/demo/service/MonitoringService.java`
- [Rule evaluation](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/RuleEngine.java): `src/main/java/azentio/com/demo/service/RuleEngine.java`

### Investigation

- [Case workflow](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/WorkflowService.java): `src/main/java/azentio/com/demo/service/WorkflowService.java`
- [Network graph data](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/NetworkGraphService.java): `src/main/java/azentio/com/demo/service/NetworkGraphService.java`

### Application platform

- [Customer API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/CustomerController.java): `src/main/java/azentio/com/demo/controller/CustomerController.java`
- [Account API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/AccountController.java): `src/main/java/azentio/com/demo/controller/AccountController.java`
- [Transaction API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/TransactionController.java): `src/main/java/azentio/com/demo/controller/TransactionController.java`
- [Alert API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/AlertController.java): `src/main/java/azentio/com/demo/controller/AlertController.java`
- [Case API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/CaseController.java): `src/main/java/azentio/com/demo/controller/CaseController.java`
- [Rule API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/RuleController.java): `src/main/java/azentio/com/demo/controller/RuleController.java`
- [Network API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/NetworkController.java): `src/main/java/azentio/com/demo/controller/NetworkController.java`
- [Workspace API](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/controller/WorkspaceController.java): `src/main/java/azentio/com/demo/controller/WorkspaceController.java`
- [Role enforcement](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/config/SecurityConfig.java): `src/main/java/azentio/com/demo/config/SecurityConfig.java`
- [Application facade](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/service/SentinelService.java): `src/main/java/azentio/com/demo/service/SentinelService.java`
- [JPA persistence](https://github.com/fisal1/azentio/blob/main/src/main/java/azentio/com/demo/repository/SentinelRepository.java): `src/main/java/azentio/com/demo/repository/SentinelRepository.java`

### Other components

- **Analyst or admin**
- **PostgreSQL**

## Connections

- Analyst or admin → Dashboard: uses (evidence: `README.md`)
- Dashboard → Customer API: calls API (evidence: `src/main/resources/static/app.js`)
- Dashboard → Account API: calls API
- Dashboard → Transaction API: calls API (evidence: `src/main/resources/static/app.js`)
- Dashboard → Alert API: calls API (evidence: `src/main/resources/static/app.js`)
- Dashboard → Case API: calls API
- Dashboard → Rule API: calls API
- Dashboard → Network API: calls API (evidence: `src/main/resources/static/app.js`)
- Dashboard → Workspace API: calls API
- Dashboard → Network visualization: mounts graph (evidence: `src/main/resources/static/app.js`)
- Customer API → Application facade: delegates
- Account API → Application facade: delegates
- Transaction API → Application facade: delegates
- Alert API → Application facade: delegates
- Case API → Application facade: delegates
- Rule API → Application facade: delegates
- Network API → Network graph data: delegates
- Application facade → CSV ingestion: coordinates
- Application facade → Transaction monitoring: coordinates
- Application facade → Case workflow: coordinates
- Transaction monitoring → Rule evaluation: evaluates with
- Application facade → JPA persistence: persists through
- JPA persistence → PostgreSQL: reads and writes
