# rakshitv-12/aris architecture

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

- Interactive diagram: https://gitdiagram.com/rakshitv-12/aris
- Repository: https://github.com/rakshitv-12/aris

## Overview

ARIS monitors configured project services, persists probe telemetry, and analyzes it with an Isolation Forest. Anomalies are recorded as incidents with stack-trace localization and remediation/patch suggestions; the workspace supports developer review, while later probing can verify recovery. The README documents these product capabilities, but the excerpts do not establish every backend route or incident-to-AI connection, so those links are omitted. The UI and some controller behavior are not present in the supplied tree or excerpts.

Main entry points: [`ai-engine/engine.py`](https://github.com/rakshitv-12/aris/blob/main/ai-engine/engine.py) (Anomaly analysis), [`src/main/java/com/aris/probe/WorkspaceController.java`](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/WorkspaceController.java) (Workspace and review), [`src/main/java/com/aris/probe/MonitorSchedulerService.java`](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/MonitorSchedulerService.java) (Probe scheduler), [`src/main/java/com/aris/auth/AuthService.java`](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/auth/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and Projects"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_users[("User records<br/>[User.java]")]
  node_jwt["JWT security<br/>[JwtService.java]"]
  node_projects["Project ownership"]
  node_projectdata[("Project records<br/>[Project.java]")]
  node_services[("Target services<br/>[Service.java]")]
end

subgraph group_monitoring["Monitoring and Telemetry"]
  node_monitors[("Monitor configuration<br/>[Monitor.java]")]
  node_probe["HTTP probing<br/>[ProbeService.java]"]
  node_scheduler["Probe scheduler"]
  node_probehistory[("Probe history<br/>[ProbeResult.java]")]
  node_backendapi["Telemetry API"]
end

subgraph group_analysis["AI Analysis"]
  node_training["Feature training<br/>[train.py]"]
  node_engine["Anomaly analysis<br/>[engine.py]"]
end

subgraph group_response["Incident Response"]
  node_incident[("Incident lifecycle<br/>[Incident.java]")]
  node_diagnostics["Code localization<br/>[engine.py]"]
  node_recommendations["Fix and patch advice<br/>[engine.py]"]
  node_workspace["Workspace and review"]
  node_ecommerce["Demo commerce APIs"]
end

node_developer(("Developer"))
node_target["Monitored endpoint"]

node_developer -->|"registers or logs in"| node_auth
node_auth -->|"reads and saves"| node_users
node_auth -->|"issues token"| node_jwt
node_developer -->|"manages projects"| node_projects
node_projects -->|"persists"| node_projectdata
node_projects -->|"resolves owner"| node_users
node_projectdata -->|"owns services"| node_services
node_services -.->|"configured for"| node_monitors
node_scheduler -->|"loads enabled monitors"| node_monitors
node_scheduler -->|"executes checks"| node_probe
node_probe -->|"sends HTTP request"| node_target
node_scheduler -->|"saves results"| node_probehistory
node_training -->|"supplies models"| node_engine
node_engine -->|"fetches telemetry"| node_backendapi
node_backendapi -.->|"serves probe data"| node_probehistory
node_engine -.->|"records anomalies"| node_incident
node_engine -->|"locates stack traces"| node_diagnostics
node_diagnostics -->|"informs fixes"| node_recommendations
node_developer -->|"inspects and reviews"| node_workspace
node_workspace -->|"reads project metadata"| node_projectdata
node_workspace -->|"reads telemetry"| node_probehistory
node_recommendations -.->|"proposed for review"| node_workspace
node_developer -->|"tests demo faults"| node_ecommerce

click node_auth "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/auth/AuthService.java"
click node_users "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/auth/User.java"
click node_jwt "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/security/JwtService.java"
click node_projects "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/project/ProjectService.java"
click node_projectdata "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/project/Project.java"
click node_services "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/service/Service.java"
click node_monitors "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/monitor/Monitor.java"
click node_probe "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/ProbeService.java"
click node_scheduler "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/MonitorSchedulerService.java"
click node_probehistory "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/ProbeResult.java"
click node_training "https://github.com/rakshitv-12/aris/blob/main/ai-engine/train.py"
click node_engine "https://github.com/rakshitv-12/aris/blob/main/ai-engine/engine.py"
click node_backendapi "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/DashboardController.java"
click node_incident "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/incident/Incident.java"
click node_diagnostics "https://github.com/rakshitv-12/aris/blob/main/ai-engine/engine.py"
click node_recommendations "https://github.com/rakshitv-12/aris/blob/main/ai-engine/engine.py"
click node_workspace "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/WorkspaceController.java"
click node_ecommerce "https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/ecom/PaymentController.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,node_users,node_jwt,node_projects,node_projectdata,node_services toneBlue
class node_monitors,node_probe,node_scheduler,node_probehistory,node_backendapi toneAmber
class node_training,node_engine toneMint
class node_incident,node_diagnostics,node_recommendations,node_workspace,node_ecommerce toneRose
class node_developer,node_target toneIndigo
```

## Components

### Identity and Projects

- [Authentication](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/auth/AuthService.java): `src/main/java/com/aris/auth/AuthService.java`
- [User records](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/auth/User.java): `src/main/java/com/aris/auth/User.java`
- [JWT security](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/security/JwtService.java): `src/main/java/com/aris/security/JwtService.java`
- [Project ownership](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/project/ProjectService.java): `src/main/java/com/aris/project/ProjectService.java`
- [Project records](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/project/Project.java): `src/main/java/com/aris/project/Project.java`
- [Target services](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/service/Service.java): `src/main/java/com/aris/service/Service.java`

### Monitoring and Telemetry

- [Monitor configuration](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/monitor/Monitor.java): `src/main/java/com/aris/monitor/Monitor.java`
- [HTTP probing](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/ProbeService.java): `src/main/java/com/aris/probe/ProbeService.java`
- [Probe scheduler](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/MonitorSchedulerService.java): `src/main/java/com/aris/probe/MonitorSchedulerService.java`
- [Probe history](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/ProbeResult.java): `src/main/java/com/aris/probe/ProbeResult.java`
- [Telemetry API](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/DashboardController.java): `src/main/java/com/aris/probe/DashboardController.java`

### AI Analysis

- [Feature training](https://github.com/rakshitv-12/aris/blob/main/ai-engine/train.py): `ai-engine/train.py`
- [Anomaly analysis](https://github.com/rakshitv-12/aris/blob/main/ai-engine/engine.py): `ai-engine/engine.py`

### Incident Response

- [Incident lifecycle](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/incident/Incident.java): `src/main/java/com/aris/incident/Incident.java`
- [Code localization](https://github.com/rakshitv-12/aris/blob/main/ai-engine/engine.py): `ai-engine/engine.py`
- [Fix and patch advice](https://github.com/rakshitv-12/aris/blob/main/ai-engine/engine.py): `ai-engine/engine.py`
- [Workspace and review](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/probe/WorkspaceController.java): `src/main/java/com/aris/probe/WorkspaceController.java`
- [Demo commerce APIs](https://github.com/rakshitv-12/aris/blob/main/src/main/java/com/aris/ecom/PaymentController.java): `src/main/java/com/aris/ecom/PaymentController.java`

### Other components

- **Developer**
- **Monitored endpoint**

## Connections

- Developer → Authentication: registers or logs in
- Authentication → User records: reads and saves (evidence: `src/main/java/com/aris/auth/AuthService.java`)
- Authentication → JWT security: issues token (evidence: `src/main/java/com/aris/auth/AuthService.java`)
- Developer → Project ownership: manages projects
- Project ownership → Project records: persists (evidence: `src/main/java/com/aris/project/ProjectService.java`)
- Project ownership → User records: resolves owner (evidence: `src/main/java/com/aris/project/ProjectService.java`)
- Project records → Target services: owns services (evidence: `src/main/java/com/aris/service/Service.java`)
- Target services → Monitor configuration: configured for (evidence: `src/main/java/com/aris/monitor/Monitor.java`)
- Probe scheduler → Monitor configuration: loads enabled monitors (evidence: `src/main/java/com/aris/probe/MonitorSchedulerService.java`)
- Probe scheduler → HTTP probing: executes checks (evidence: `src/main/java/com/aris/probe/MonitorSchedulerService.java`)
- HTTP probing → Monitored endpoint: sends HTTP request (evidence: `src/main/java/com/aris/probe/ProbeService.java`)
- Probe scheduler → Probe history: saves results (evidence: `src/main/java/com/aris/probe/MonitorSchedulerService.java`)
- Feature training → Anomaly analysis: supplies models (evidence: `ai-engine/engine.py`)
- Anomaly analysis → Telemetry API: fetches telemetry (evidence: `ai-engine/engine.py`)
- Telemetry API → Probe history: serves probe data
- Anomaly analysis → Incident lifecycle: records anomalies
- Anomaly analysis → Code localization: locates stack traces (evidence: `ai-engine/engine.py`)
- Code localization → Fix and patch advice: informs fixes (evidence: `ai-engine/engine.py`)
- Developer → Workspace and review: inspects and reviews (evidence: `README.md`)
- Workspace and review → Project records: reads project metadata (evidence: `src/main/java/com/aris/probe/WorkspaceController.java`)
- Workspace and review → Probe history: reads telemetry (evidence: `src/main/java/com/aris/probe/WorkspaceController.java`)
- Fix and patch advice → Workspace and review: proposed for review
- Developer → Demo commerce APIs: tests demo faults (evidence: `README.md`)
