# msaf9/microsecgpt architecture

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

## Overview

MicroSecGPT is a Spring Boot API for AI-assisted microservice security analysis. Clients submit code, dependency-analysis, log-analysis, or chat requests; controllers gather relevant source, build metadata, or logs, then call the configured OpenAI API and return its response. Separate endpoints expose build.gradle and parsed dependency versions. The README also describes dynamic dependency analysis, static analysis, code review, and code readability/documentation. The graph follows sampled controller-to-service calls; the implementation of the remaining documented capabilities is not inferred beyond shown code.

Main entry points: [`src/main/java/cpre/term/project/Model/ChatRequest.java`](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Model/ChatRequest.java) (Chat request model), [`src/main/java/cpre/term/project/Controller/CodeAnalysisController.java`](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/CodeAnalysisController.java) (Code analysis API), [`src/main/java/cpre/term/project/Controller/LogController.java`](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/LogController.java) (Log analysis API), [`src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java`](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java) (Dependency security API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API endpoints"]
  node_chatbot["Chat endpoint"]
  node_codeapi["Code analysis API"]
  node_codecontroller["Code retrieval API"]
  node_logapi["Log analysis API<br/>[LogController.java]"]
  node_buildapi["Build metadata API"]
  node_vulnapi["Dependency security API"]
  node_application["Spring Boot application"]
end

subgraph group_analysis["Security analysis"]
  node_scanner["Java source scanner"]
  node_dependencyparser["Dependency parser"]
end

subgraph group_chat["AI integration"]
end

subgraph group_models["Chat payloads"]
  node_chatrequest["Chat request model<br/>[ChatRequest.java]"]
  node_chatmessage["Chat message model<br/>[ChatMessage.java]"]
  node_chatresponse["Chat response model<br/>[ChatResponse.java]"]
end

subgraph group_ops["Logs and metadata"]
  node_logservice["Log service<br/>[LogService.java]"]
  node_gradlefile["Project build.gradle<br/>[build.gradle]"]
end

node_client(("API client"))
node_openai(("OpenAI API"))

node_client -->|"submits prompt"| node_chatbot
node_client -->|"requests analysis"| node_codeapi
node_client -->|"requests log analysis"| node_logapi
node_client -->|"requests dependencies"| node_buildapi
node_client -->|"requests vulnerability review"| node_vulnapi
node_codeapi -->|"reads Java source"| node_scanner
node_codecontroller -->|"reads Java source"| node_scanner
node_buildapi -->|"gets build metadata"| node_dependencyparser
node_buildapi -->|"writes request logs"| node_logservice
node_vulnapi -->|"parses dependencies"| node_dependencyparser
node_logapi -->|"reads logs"| node_logservice
node_chatbot -->|"builds request"| node_chatrequest
node_codeapi -->|"builds request"| node_chatrequest
node_logapi -->|"builds request"| node_chatrequest
node_vulnapi -->|"builds request"| node_chatrequest
node_chatrequest -->|"contains messages"| node_chatmessage
node_chatresponse -->|"contains message"| node_chatmessage
node_chatbot -->|"sends prompt"| node_openai
node_codeapi -->|"sends analysis"| node_openai
node_logapi -->|"sends logs"| node_openai
node_vulnapi -->|"sends dependencies"| node_openai
node_openai -->|"returns answer"| node_chatresponse
node_dependencyparser -->|"reads dependencies"| node_gradlefile

click node_chatbot "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/ChatBotController.java"
click node_codeapi "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/CodeAnalysisController.java"
click node_codecontroller "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/CodeController.java"
click node_logapi "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/LogController.java"
click node_buildapi "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/ParseBuildGradleController.java"
click node_vulnapi "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java"
click node_scanner "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Service/CodeScannerService.java"
click node_dependencyparser "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Service/ParseBuildGradle.java"
click node_logservice "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Service/LogService.java"
click node_chatrequest "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Model/ChatRequest.java"
click node_chatmessage "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Model/ChatMessage.java"
click node_chatresponse "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Model/ChatResponse.java"
click node_application "https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/ProjectApplication.java"
click node_gradlefile "https://github.com/msaf9/microsecgpt/blob/master/build.gradle"

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_chatbot,node_codeapi,node_codecontroller,node_logapi,node_buildapi,node_vulnapi,node_application,node_client toneBlue
class node_scanner,node_dependencyparser toneAmber
class node_chatrequest,node_chatmessage,node_chatresponse toneRose
class node_logservice,node_gradlefile toneIndigo
class node_openai toneMint
```

## Components

### API endpoints

- [Chat endpoint](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/ChatBotController.java): `src/main/java/cpre/term/project/Controller/ChatBotController.java`
- [Code analysis API](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/CodeAnalysisController.java): `src/main/java/cpre/term/project/Controller/CodeAnalysisController.java`
- [Code retrieval API](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/CodeController.java): `src/main/java/cpre/term/project/Controller/CodeController.java`
- [Log analysis API](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/LogController.java): `src/main/java/cpre/term/project/Controller/LogController.java`
- [Build metadata API](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/ParseBuildGradleController.java): `src/main/java/cpre/term/project/Controller/ParseBuildGradleController.java`
- [Dependency security API](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java): `src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java`
- [Spring Boot application](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/ProjectApplication.java): `src/main/java/cpre/term/project/ProjectApplication.java`

### Security analysis

- [Java source scanner](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Service/CodeScannerService.java): `src/main/java/cpre/term/project/Service/CodeScannerService.java`
- [Dependency parser](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Service/ParseBuildGradle.java): `src/main/java/cpre/term/project/Service/ParseBuildGradle.java`

### Chat payloads

- [Chat request model](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Model/ChatRequest.java): `src/main/java/cpre/term/project/Model/ChatRequest.java`
- [Chat message model](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Model/ChatMessage.java): `src/main/java/cpre/term/project/Model/ChatMessage.java`
- [Chat response model](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Model/ChatResponse.java): `src/main/java/cpre/term/project/Model/ChatResponse.java`

### Logs and metadata

- [Log service](https://github.com/msaf9/microsecgpt/blob/master/src/main/java/cpre/term/project/Service/LogService.java): `src/main/java/cpre/term/project/Service/LogService.java`
- [Project build.gradle](https://github.com/msaf9/microsecgpt/blob/master/build.gradle): `build.gradle`

### Other components

- **API client**
- **OpenAI API**

## Connections

- API client → Chat endpoint: submits prompt (evidence: `README.md`)
- API client → Code analysis API: requests analysis (evidence: `README.md`)
- API client → Log analysis API: requests log analysis (evidence: `src/main/java/cpre/term/project/Controller/LogController.java`)
- API client → Build metadata API: requests dependencies (evidence: `src/main/java/cpre/term/project/Controller/ParseBuildGradleController.java`)
- API client → Dependency security API: requests vulnerability review (evidence: `src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java`)
- Code analysis API → Java source scanner: reads Java source (evidence: `src/main/java/cpre/term/project/Controller/CodeAnalysisController.java`)
- Code retrieval API → Java source scanner: reads Java source (evidence: `src/main/java/cpre/term/project/Controller/CodeController.java`)
- Build metadata API → Dependency parser: gets build metadata (evidence: `src/main/java/cpre/term/project/Controller/ParseBuildGradleController.java`)
- Build metadata API → Log service: writes request logs (evidence: `src/main/java/cpre/term/project/Controller/ParseBuildGradleController.java`)
- Dependency security API → Dependency parser: parses dependencies (evidence: `src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java`)
- Log analysis API → Log service: reads logs (evidence: `src/main/java/cpre/term/project/Controller/LogController.java`)
- Chat endpoint → Chat request model: builds request (evidence: `src/main/java/cpre/term/project/Controller/ChatBotController.java`)
- Code analysis API → Chat request model: builds request (evidence: `src/main/java/cpre/term/project/Controller/CodeAnalysisController.java`)
- Log analysis API → Chat request model: builds request (evidence: `src/main/java/cpre/term/project/Controller/LogController.java`)
- Dependency security API → Chat request model: builds request (evidence: `src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java`)
- Chat request model → Chat message model: contains messages (evidence: `src/main/java/cpre/term/project/Model/ChatRequest.java`)
- Chat response model → Chat message model: contains message (evidence: `src/main/java/cpre/term/project/Model/ChatResponse.java`)
- Chat endpoint → OpenAI API: sends prompt (evidence: `src/main/java/cpre/term/project/Controller/ChatBotController.java`)
- Code analysis API → OpenAI API: sends analysis (evidence: `src/main/java/cpre/term/project/Controller/CodeAnalysisController.java`)
- Log analysis API → OpenAI API: sends logs (evidence: `src/main/java/cpre/term/project/Controller/LogController.java`)
- Dependency security API → OpenAI API: sends dependencies (evidence: `src/main/java/cpre/term/project/Controller/SecurityVulnerabilitiesController.java`)
- OpenAI API → Chat response model: returns answer
- Dependency parser → Project build.gradle: reads dependencies (evidence: `src/main/java/cpre/term/project/Service/ParseBuildGradle.java`)
