# umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai architecture

> Architecture diagram of the GitHub repository umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai
- Repository: https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai

## Overview

Email Writer combines a Gmail-facing browser extension with a Spring Boot API that generates professional replies through Gemini. The user clicks the extension’s AI Reply button; it reads the email, posts its content and tone to the API, and inserts the returned text into the compose box. The controller delegates generation to a service, which builds a prompt from the request and calls Gemini. Source excerpts show this main flow; configuration and other unsampled behavior are not expanded.

Main entry points: [`email-writer extension/content.js`](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer%20extension/content.js) (AI Reply Button), [`email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java`](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java) (Generation Endpoint), [`email-writer/src/main/java/com/email/email_writer/EmailGeneratorService.java`](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailGeneratorService.java) (Reply Generator), [`email-writer/src/main/java/com/email/email_writer/EmailRequest.java`](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailRequest.java) (Email Request)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["Gmail Extension"]
  node_extension_button["AI Reply Button<br/>[content.js]"]
  node_email_reader["Email Reader<br/>[content.js]"]
  node_reply_inserter["Reply Inserter<br/>[content.js]"]
end

subgraph group_api["Reply API"]
  node_api_controller["Generation Endpoint"]
  node_email_request["Email Request<br/>[EmailRequest.java]"]
end

subgraph group_generation["Reply Generation"]
  node_generator["Reply Generator"]
end

node_user(("Gmail User"))
node_gmail["Gmail UI"]
node_gemini["Gemini API"]

node_user -->|"clicks"| node_extension_button
node_gmail -->|"provides email"| node_email_reader
node_extension_button -->|"reads email"| node_email_reader
node_extension_button -->|"posts request"| node_api_controller
node_api_controller -->|"accepts body"| node_email_request
node_api_controller -->|"delegates to"| node_generator
node_generator -->|"builds prompt from"| node_email_request
node_generator -->|"sends prompt"| node_gemini
node_api_controller -->|"returns reply"| node_extension_button
node_extension_button -->|"passes reply"| node_reply_inserter
node_reply_inserter -->|"inserts reply"| node_gmail

click node_extension_button "https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer%20extension/content.js"
click node_email_reader "https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer%20extension/content.js"
click node_reply_inserter "https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer%20extension/content.js"
click node_api_controller "https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java"
click node_email_request "https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailRequest.java"
click node_generator "https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailGeneratorService.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_extension_button,node_email_reader,node_reply_inserter,node_user,node_gmail toneBlue
class node_api_controller,node_email_request toneAmber
class node_generator,node_gemini toneMint
```

## Components

### Gmail Extension

- [AI Reply Button](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer%20extension/content.js): `email-writer extension/content.js`
- [Email Reader](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer%20extension/content.js): `email-writer extension/content.js`
- [Reply Inserter](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer%20extension/content.js): `email-writer extension/content.js`

### Reply API

- [Generation Endpoint](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java): `email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java`
- [Email Request](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailRequest.java): `email-writer/src/main/java/com/email/email_writer/EmailRequest.java`

### Reply Generation

- [Reply Generator](https://github.com/umar-sheik-8610/-smart-email-assistant-project-using-spring-boot-spring-ai/blob/main/email-writer/src/main/java/com/email/email_writer/EmailGeneratorService.java): `email-writer/src/main/java/com/email/email_writer/EmailGeneratorService.java`

### Other components

- **Gmail User**
- **Gmail UI**
- **Gemini API**

## Connections

- Gmail User → AI Reply Button: clicks (evidence: `email-writer extension/content.js`)
- Gmail UI → Email Reader: provides email (evidence: `email-writer extension/content.js`)
- AI Reply Button → Email Reader: reads email (evidence: `email-writer extension/content.js`)
- AI Reply Button → Generation Endpoint: posts request (evidence: `email-writer extension/content.js`)
- Generation Endpoint → Email Request: accepts body (evidence: `email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java`)
- Generation Endpoint → Reply Generator: delegates to (evidence: `email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java`)
- Reply Generator → Email Request: builds prompt from (evidence: `email-writer/src/main/java/com/email/email_writer/EmailGeneratorService.java`)
- Reply Generator → Gemini API: sends prompt (evidence: `email-writer/src/main/java/com/email/email_writer/EmailGeneratorService.java`)
- Generation Endpoint → AI Reply Button: returns reply (evidence: `email-writer/src/main/java/com/email/email_writer/EmailGeneratorController.java`)
- AI Reply Button → Reply Inserter: passes reply (evidence: `email-writer extension/content.js`)
- Reply Inserter → Gmail UI: inserts reply (evidence: `email-writer extension/content.js`)
