# umairrrkhan/cadc-project-umair-moni architecture

> Architecture diagram of the GitHub repository umairrrkhan/cadc-project-umair-moni, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/umairrrkhan/cadc-project-umair-moni
- Repository: https://github.com/umairrrkhan/cadc-project-umair-moni

## Overview

UmNi is a React-based multimodal math workspace backed by Spring Boot microservices. The main user journey enters through the client and gateway, then branches into conversational math, image-based solving, and study-note management; authenticated users can also manage accounts and saved work. The graph preserves those product capabilities and the documented service-discovery role. Some subsystem links rely on README or SOURCE INDEX references rather than complete source excerpts; uncertain internal wiring is omitted.

Main entry points: [`umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java`](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java) (Account cleanup), [`note-service/src/main/java/com/umni/note_service/controller/NoteController.java`](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/controller/NoteController.java) (Note operations), [`umni-backend/src/main/java/com/umni/vision/controller/VisionController.java`](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/vision/controller/VisionController.java) (Vision workflow), [`umni-frontend/src/App.js`](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/App.js) (React app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["React workspace"]
  node_spa["React app<br/>[App.js]"]
  node_landing["Landing page<br/>[LandingPage.jsx]"]
  node_chatui["Chat workspace<br/>[TextMode.jsx]"]
  node_visionui["Vision canvas<br/>[VisionMode.jsx]"]
  node_libraryui["Saved library<br/>[LibraryPage.jsx]"]
  node_notesui["Notes screen<br/>[NotesPage.jsx]"]
  node_accountui["Account screens"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_platform["Service platform"]
  node_gateway["API gateway"]
  node_fallback["Gateway fallback"]
  node_registry["Service registry"]
end

subgraph group_core["Core learning service"]
  node_coreapp["Core service"]
  node_auth["Authentication"]
  node_users["User records<br/>[User.java]"]
  node_deletion["Account cleanup"]
  node_chat["Chat sessions"]
  node_chatdata[("Chat persistence")]
  node_deepseek["DeepSeek client"]
  node_vision["Vision workflow"]
  node_visiondata[("Vision records")]
  node_visionstorage["Image storage"]
end

subgraph group_notes["Study notes"]
  node_noteservice["Note service"]
  node_notecontroller["Note operations"]
  node_validation["File validation"]
  node_notedata[("Note metadata")]
  node_notestorage["Note file storage"]
end

node_user(("Learner"))
node_openai{{"OpenAI image API"}}
node_mongodb[("MongoDB")]
node_mysql[("MySQL")]
node_s3[("AWS S3")]

node_user -->|"uses"| node_spa
node_spa -->|"routes to"| node_landing
node_spa -->|"routes to"| node_notesui
node_spa -->|"routes to"| node_libraryui
node_chatui -->|"requests"| node_api
node_visionui -->|"requests"| node_api
node_notesui -->|"requests"| node_api
node_api -->|"sends traffic"| node_gateway
node_gateway -->|"routes to"| node_coreapp
node_gateway -->|"routes to"| node_noteservice
node_registry -.->|"supports discovery"| node_gateway
node_registry -.->|"supports discovery"| node_coreapp
node_registry -.->|"supports discovery"| node_noteservice
node_auth -->|"reads and writes"| node_users
node_auth -->|"invokes"| node_deletion
node_auth -->|"persists users"| node_mongodb
node_chat -->|"stores messages"| node_chatdata
node_chat -->|"requests completion"| node_deepseek
node_chat -->|"persists sessions"| node_mongodb
node_vision -->|"requests solution"| node_openai
node_vision -->|"uploads images"| node_visionstorage
node_vision -->|"saves records"| node_visiondata
node_vision -->|"persists records"| node_mongodb
node_visionstorage -->|"stores images"| node_s3
node_noteservice -.->|"serves requests"| node_notecontroller
node_notecontroller -->|"validates uploads"| node_validation
node_notecontroller -->|"reads and writes"| node_notedata
node_notecontroller -->|"uploads and deletes"| node_notestorage
node_notedata -->|"stores metadata"| node_mysql
node_notestorage -->|"stores files"| node_s3
node_deletion -->|"deletes user data"| node_chatdata
node_deletion -->|"deletes records"| node_visiondata
node_deletion -->|"removes images"| node_visionstorage
node_deletion -.->|"requests note cleanup"| node_notecontroller

click node_spa "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/App.js"
click node_landing "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/LandingPage.jsx"
click node_chatui "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/components/TextMode.jsx"
click node_visionui "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/components/VisionMode.jsx"
click node_libraryui "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/LibraryPage.jsx"
click node_notesui "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/NotesPage.jsx"
click node_accountui "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/userProfilePage.jsx"
click node_api "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/service/api.js"
click node_gateway "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/api-gateway/src/main/java/com/umni/api_gateway/ApiGatewayApplication.java"
click node_fallback "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/api-gateway/src/main/java/com/umni/api_gateway/controller/FallbackController.java"
click node_registry "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/service-registry/src/main/java/com/umni/service_registry/ServiceRegistryApplication.java"
click node_coreapp "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/UmniApplication.java"
click node_auth "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/auth/controller/AuthController.java"
click node_users "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/auth/model/User.java"
click node_deletion "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java"
click node_chat "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/chat/controller/ChatController.java"
click node_chatdata "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/chat/repository/MessageRepository.java"
click node_deepseek "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/common/client/DeepSeekService.java"
click node_vision "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/vision/controller/VisionController.java"
click node_visiondata "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/vision/repository/VisionRepository.java"
click node_visionstorage "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/vision/service/S3StorageService.java"
click node_noteservice "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/NoteServiceApplication.java"
click node_notecontroller "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/controller/NoteController.java"
click node_validation "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/service/FileValidationService.java"
click node_notedata "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/repository/NoteRepository.java"
click node_notestorage "https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/service/S3StorageService.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_spa,node_landing,node_chatui,node_visionui,node_libraryui,node_notesui,node_accountui,node_api toneBlue
class node_gateway,node_fallback,node_registry,node_mongodb,node_mysql,node_s3 toneAmber
class node_coreapp,node_auth,node_users,node_deletion,node_chat,node_chatdata,node_deepseek,node_vision,node_visiondata,node_visionstorage,node_openai toneMint
class node_noteservice,node_notecontroller,node_validation,node_notedata,node_notestorage toneRose
class node_user toneIndigo
```

## Components

### React workspace

- [React app](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/App.js): `umni-frontend/src/App.js`
- [Landing page](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/LandingPage.jsx): `umni-frontend/src/pages/LandingPage.jsx`
- [Chat workspace](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/components/TextMode.jsx): `umni-frontend/src/components/TextMode.jsx`
- [Vision canvas](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/components/VisionMode.jsx): `umni-frontend/src/components/VisionMode.jsx`
- [Saved library](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/LibraryPage.jsx): `umni-frontend/src/pages/LibraryPage.jsx`
- [Notes screen](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/NotesPage.jsx): `umni-frontend/src/pages/NotesPage.jsx`
- [Account screens](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/pages/userProfilePage.jsx): `umni-frontend/src/pages/userProfilePage.jsx`
- [API client](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-frontend/src/service/api.js): `umni-frontend/src/service/api.js`

### Service platform

- [API gateway](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/api-gateway/src/main/java/com/umni/api_gateway/ApiGatewayApplication.java): `api-gateway/src/main/java/com/umni/api_gateway/ApiGatewayApplication.java`
- [Gateway fallback](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/api-gateway/src/main/java/com/umni/api_gateway/controller/FallbackController.java): `api-gateway/src/main/java/com/umni/api_gateway/controller/FallbackController.java`
- [Service registry](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/service-registry/src/main/java/com/umni/service_registry/ServiceRegistryApplication.java): `service-registry/src/main/java/com/umni/service_registry/ServiceRegistryApplication.java`

### Core learning service

- [Core service](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/UmniApplication.java): `umni-backend/src/main/java/com/umni/UmniApplication.java`
- [Authentication](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/auth/controller/AuthController.java): `umni-backend/src/main/java/com/umni/auth/controller/AuthController.java`
- [User records](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/auth/model/User.java): `umni-backend/src/main/java/com/umni/auth/model/User.java`
- [Account cleanup](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java): `umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java`
- [Chat sessions](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/chat/controller/ChatController.java): `umni-backend/src/main/java/com/umni/chat/controller/ChatController.java`
- [Chat persistence](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/chat/repository/MessageRepository.java): `umni-backend/src/main/java/com/umni/chat/repository/MessageRepository.java`
- [DeepSeek client](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/common/client/DeepSeekService.java): `umni-backend/src/main/java/com/umni/common/client/DeepSeekService.java`
- [Vision workflow](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/vision/controller/VisionController.java): `umni-backend/src/main/java/com/umni/vision/controller/VisionController.java`
- [Vision records](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/vision/repository/VisionRepository.java): `umni-backend/src/main/java/com/umni/vision/repository/VisionRepository.java`
- [Image storage](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/umni-backend/src/main/java/com/umni/vision/service/S3StorageService.java): `umni-backend/src/main/java/com/umni/vision/service/S3StorageService.java`

### Study notes

- [Note service](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/NoteServiceApplication.java): `note-service/src/main/java/com/umni/note_service/NoteServiceApplication.java`
- [Note operations](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/controller/NoteController.java): `note-service/src/main/java/com/umni/note_service/controller/NoteController.java`
- [File validation](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/service/FileValidationService.java): `note-service/src/main/java/com/umni/note_service/service/FileValidationService.java`
- [Note metadata](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/repository/NoteRepository.java): `note-service/src/main/java/com/umni/note_service/repository/NoteRepository.java`
- [Note file storage](https://github.com/umairrrkhan/cadc-project-umair-moni/blob/master/note-service/src/main/java/com/umni/note_service/service/S3StorageService.java): `note-service/src/main/java/com/umni/note_service/service/S3StorageService.java`

### Other components

- **Learner**
- **OpenAI image API**
- **MongoDB**
- **MySQL**
- **AWS S3**

## Connections

- Learner → React app: uses
- React app → Landing page: routes to (evidence: `umni-frontend/src/App.js`)
- React app → Notes screen: routes to (evidence: `umni-frontend/src/App.js`)
- React app → Saved library: routes to (evidence: `umni-frontend/src/App.js`)
- Chat workspace → API client: requests
- Vision canvas → API client: requests
- Notes screen → API client: requests (evidence: `umni-frontend/src/pages/NotesPage.jsx`)
- API client → API gateway: sends traffic
- API gateway → Core service: routes to
- API gateway → Note service: routes to
- Service registry → API gateway: supports discovery
- Service registry → Core service: supports discovery
- Service registry → Note service: supports discovery
- Authentication → User records: reads and writes (evidence: `umni-backend/src/main/java/com/umni/auth/controller/AuthController.java`)
- Authentication → Account cleanup: invokes (evidence: `umni-backend/src/main/java/com/umni/auth/controller/AuthController.java`)
- Authentication → MongoDB: persists users
- Chat sessions → Chat persistence: stores messages (evidence: `umni-backend/src/main/java/com/umni/chat/controller/ChatController.java`)
- Chat sessions → DeepSeek client: requests completion (evidence: `umni-backend/src/main/java/com/umni/chat/controller/ChatController.java`)
- Chat sessions → MongoDB: persists sessions
- Vision workflow → OpenAI image API: requests solution
- Vision workflow → Image storage: uploads images (evidence: `umni-backend/src/main/java/com/umni/vision/controller/VisionController.java`)
- Vision workflow → Vision records: saves records (evidence: `umni-backend/src/main/java/com/umni/vision/controller/VisionController.java`)
- Vision workflow → MongoDB: persists records
- Image storage → AWS S3: stores images (evidence: `umni-backend/src/main/java/com/umni/vision/service/S3StorageService.java`)
- Note service → Note operations: serves requests
- Note operations → File validation: validates uploads (evidence: `note-service/src/main/java/com/umni/note_service/controller/NoteController.java`)
- Note operations → Note metadata: reads and writes (evidence: `note-service/src/main/java/com/umni/note_service/controller/NoteController.java`)
- Note operations → Note file storage: uploads and deletes (evidence: `note-service/src/main/java/com/umni/note_service/controller/NoteController.java`)
- Note metadata → MySQL: stores metadata
- Note file storage → AWS S3: stores files
- Account cleanup → Chat persistence: deletes user data (evidence: `umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java`)
- Account cleanup → Vision records: deletes records (evidence: `umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java`)
- Account cleanup → Image storage: removes images (evidence: `umni-backend/src/main/java/com/umni/auth/service/AccountDeletionService.java`)
- Account cleanup → Note operations: requests note cleanup
