# nguyenhoangnam-1410/email-assitant architecture

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

- Interactive diagram: https://gitdiagram.com/nguyenhoangnam-1410/email-assitant
- Repository: https://github.com/nguyenhoangnam-1410/email-assitant

## Overview

##### Project type and purpose
- This is a full-stack AI Email Adjustment Assistant consisting of:
- A Spring Boot backend (Java) exposing a REST API
- A React frontend (JavaScript/Vite/Material-UI) running in a browser
- A Google Chrome Extension (manifest.json + content script) that integrates directly into Gmail
- Purpose: take raw email text + tone/context, call an AI service to rewrite or refine the email, and return the enhanced content to the user via web UI or in-Gmail toolbar.

##### File structure
- Top-level directories:
- mail-writer (Spring Boot service)
- mail-writer-react (React web application)
- mail-writer-ext (Chrome Extension)
- Backend (mail-writer):
- src/main/java/com/mail/writer/app – MVC layers (EmailGeneratorController, EmailGeneratorService, EmailRequest)
- application.properties – server port, CORS settings
- Frontend (mail-writer-react):
- public + index.html – entry page
- src – React components (App.jsx, main.jsx, assets, CSS)
- vite.config.js – dev server config (port 5173)
- Extension (mail-writer-ext):
- manifest.json – permissions, background scripts
- content.js + content.css – Gmail DOM injection, “AI Update” button

##### README for additional insights
- Confirms tech stack: Spring Boot, React, Vite, Material UI, Axios/Fetch, Chrome Extension APIs
- Explains runtime ports (8080 backend, 5173 frontend) and extension setup steps
- Describes features: tone selection, context input, real-time enhancement in-Gmail

##### Detail without overcomplication
- Logical component (UI, extension, controller, service, external AI)
- How data flows from user input → API → AI → back to user

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% React Web UI
    subgraph "React Web UI" 
        direction TB
        RI["React UI\n(localhost:5173)"]:::frontend
        idx["index.html"]:::frontend
        mainjs["src/main.jsx"]:::frontend
        appjsx["src/App.jsx"]:::frontend
        appcss["src/App.css"]:::frontend
        idxcss["src/index.css"]:::frontend
        assets["src/assets/"]:::frontend
        vite["vite.config.js"]:::frontend
        pkg["package.json"]:::frontend
    end

    %% Chrome Extension
    subgraph "Chrome Extension" 
        direction TB
        ExtN["Chrome Extension"]:::extension
        mf["manifest.json"]:::extension
        cjs["content.js"]:::extension
        cc["content.css"]:::extension
    end

    %% Spring Boot API
    subgraph "Spring Boot API" 
        direction TB
        API_N["Spring Boot API\n(localhost:8080)"]:::backend
        app["MailWriterApplication.java"]:::backend
        ctrl["EmailGeneratorController.java"]:::backend
        srv["EmailGeneratorService.java"]:::backend
        req["EmailRequest.java"]:::backend
        cfg["application.properties"]:::backend
    end

    %% External AI Service
    AI["AI Service"]:::external

    %% Flows
    RI -->|POST /generate| ctrl
    ExtN -->|POST /generate| ctrl
    ctrl -->|calls Service| srv
    srv -->|invoke AI| AI
    AI -->|response| srv
    srv -->|returns text| ctrl
    ctrl -->|JSON response| RI
    ctrl -->|JSON response| ExtN

    %% Click Events
    click app "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer/src/main/java/com/mail/writer/MailWriterApplication.java"
    click ctrl "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer/src/main/java/com/mail/writer/app/EmailGeneratorController.java"
    click srv "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer/src/main/java/com/mail/writer/app/EmailGeneratorService.java"
    click req "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer/src/main/java/com/mail/writer/app/EmailRequest.java"
    click cfg "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer/src/main/resources/application.properties"

    click idx "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-react/index.html"
    click mainjs "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-react/src/main.jsx"
    click appjsx "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-react/src/App.jsx"
    click appcss "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-react/src/App.css"
    click idxcss "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-react/src/index.css"
    click assets "https://github.com/nguyenhoangnam-1410/email-assitant/tree/main/mail-writer-react/src/assets/"
    click vite "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-react/vite.config.js"
    click pkg "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-react/package.json"

    click mf "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-ext/manifest.json"
    click cjs "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-ext/content.js"
    click cc "https://github.com/nguyenhoangnam-1410/email-assitant/blob/main/mail-writer-ext/content.css"

    %% Styles
    classDef frontend fill:#D0E8FF,stroke:#0366d6,color:#0366d6
    classDef backend fill:#D0FFD0,stroke:#228B22,color:#228B22
    classDef extension fill:#FFE0B2,stroke:#FF8C00,color:#FF8C00
    classDef external fill:#FFDDAA,stroke:#DAA520,color:#DAA520
```
