# lalit2107/smart-email-assistant architecture

> Architecture diagram of the GitHub repository lalit2107/smart-email-assistant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lalit2107/smart-email-assistant
- Repository: https://github.com/lalit2107/smart-email-assistant

## Overview

##### Project type and purpose
- This is a full-stack AI-powered email assistant that combines:
- A Chrome Extension (email-writer-ext) to inject UI into webmail
- A React frontend (email-writer-react) for tone selection and editing
- A Spring Boot backend (email-writer-sb) that proxies requests to the Gemini API
- Purpose: let end users generate professional/friendly/casual emails via a local Chrome Extension UI, using Google’s Gemini API for AI content generation.

##### File structure
- Top-level folders:
- email-writer-ext: Chrome extension manifest, content script, CSS
- email-writer-react: React SPA (public, src, package.json, Vite config)
- email-writer-sb: Spring Boot service (pom.xml, src/main/java, controller, service, request DTO)
- Patterns & tools:
- Frontend: React + Vite
- Backend: Spring Boot MVC (EmailGeneratorController → EmailGeneratorService → Gemini API)
- Extension: content.js injected into pages, communicates with React UI or directly with backend
- Deployment/config:
- manifest.json defines extension permissions & entry points
- application.properties holds backend configs
- package.json / pom.xml drive builds

##### README for additional insights
- Confirms architecture: React frontend, Spring Boot backend, local Chrome Extension, Gemini API as external service
- Features: tone selection, AI-generated content, local execution with potential cloud extension

a. Main components
1. Chrome Extension
- content.js / content.css running in user’s browser context
- UI trigger (button or popup)
2. React Frontend
- Tone selection UI (hosted locally or served as extension popup iframe)
3. Spring Boot Backend
- REST API endpoints (/generate-email)
- Authentication & request forwarding
4. Gemini API (External Service)
- AI model endpoint
b. Relationships & interactions
- User opens email composer → Extension content script injects “Generate AI Draft” button
- On click, Extension loads React UI
- React UI issues HTTP POST to Spring Boot (/api/email)
- Spring Boot Service builds request → calls Gemini API → receives generated text
- Spring Boot returns AI-generated email to React UI → UI displays in extension overlay → user inserts content
c. Architectural patterns/design principles
- Separation of concerns: Extension vs. UI vs. Business Logic
- MVC in backend: Controller → Service → External API
- SPA pattern in React for dynamic UI
- Loose coupling: backend only knows external API, frontend only knows backend API
d. Key technologies/frameworks
- Chrome Extension APIs (manifest v3, content scripts)
- React + Vite (SPA bundling)
- Spring Boot (REST controllers, dependency injection)
- Gemini API (AI service)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Browser and Extension Context
    Browser["Web Browser"]:::extension
    subgraph "Chrome Extension (email-writer-ext)"
        direction TB
        Manifest["manifest.json"]:::extension
        ContentJS["content.js"]:::extension
        ContentCSS["content.css"]:::extension
    end

    %% React Frontend Layer
    subgraph "React UI (email-writer-react)" 
        direction TB
        MainEntry["src/main.jsx"]:::frontend
        AppJSX["src/App.jsx"]:::frontend
        IndexCSS["src/index.css"]:::frontend
        AppCSS["src/App.css"]:::frontend
        Assets["src/assets"]:::frontend
        IndexHTML["index.html"]:::frontend
        Public["public"]:::frontend
        ViteConfig["vite.config.js"]:::frontend
        PackageJSON_FE["package.json"]:::frontend
    end

    %% Spring Boot Backend Layer
    subgraph "Spring Boot API (email-writer-sb)"
        direction TB
        MainApp["EmailWriterSbApplication.java"]:::backend
        Controller["EmailGeneratorController.java"]:::backend
        Service["EmailGeneratorService.java"]:::backend
        RequestDTO["EmailRequest.java"]:::backend
        AppProps["application.properties"]:::backend
        PomXML["pom.xml"]:::backend
        MVNW["mvnw"]:::backend
        MVNWCMD["mvnw.cmd"]:::backend
        Tests["EmailWriterSbApplicationTests.java"]:::backend
    end

    %% External AI Service
    GeminiAPI["Gemini API"]:::external

    %% Data Flows
    Browser -->|"Loads content script"| ContentJS
    ContentJS -->|"Injects Generate AI Draft button"| Browser
    Browser -->|"User clicks button"| MainEntry
    MainEntry -->|"Renders UI components"| AppJSX
    AppJSX -->|"POST /api/email"| Controller
    Controller -->|"calls generateEmail()"| Service
    Service -->|"sends request to AI model"| GeminiAPI
    GeminiAPI -->|"returns generated text"| Service
    Service -->|"returns text to controller"| Controller
    Controller -->|"200 OK with email body"| MainEntry
    MainEntry -->|"Displays AI-generated draft"| Browser

    %% Click Events - Extension
    click Manifest "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-ext/manifest.json"
    click ContentJS "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-ext/content.js"
    click ContentCSS "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-ext/content.css"

    %% Click Events - React Frontend
    click MainEntry "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-react/src/main.jsx"
    click AppJSX "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-react/src/App.jsx"
    click IndexCSS "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-react/src/index.css"
    click AppCSS "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-react/src/App.css"
    click Assets "https://github.com/lalit2107/smart-email-assistant/tree/main/email-writer-react/src/assets"
    click IndexHTML "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-react/index.html"
    click Public "https://github.com/lalit2107/smart-email-assistant/tree/main/email-writer-react/public"
    click ViteConfig "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-react/vite.config.js"
    click PackageJSON_FE "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-react/package.json"

    %% Click Events - Spring Boot Backend
    click MainApp "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/src/main/java/com/email/writer/EmailWriterSbApplication.java"
    click Controller "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/src/main/java/com/email/writer/app/EmailGeneratorController.java"
    click Service "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/src/main/java/com/email/writer/app/EmailGeneratorService.java"
    click RequestDTO "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/src/main/java/com/email/writer/app/EmailRequest.java"
    click AppProps "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/src/main/resources/application.properties"
    click PomXML "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/pom.xml"
    click MVNW "https://github.com/lalit2107/smart-email-assistant/tree/main/email-writer-sb/mvnw"
    click MVNWCMD "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/mvnw.cmd"
    click Tests "https://github.com/lalit2107/smart-email-assistant/blob/main/email-writer-sb/src/test/java/com/email/writer/EmailWriterSbApplicationTests.java"

    %% Styles
    classDef extension fill:#FDE047,stroke:#333,stroke-width:1px
    classDef frontend fill:#60A5FA,stroke:#333,stroke-width:1px
    classDef backend fill:#34D399,stroke:#333,stroke-width:1px
    classDef external fill:#C084FC,stroke:#333,stroke-width:1px
```
