# dhanashri58/cloudresume_cc architecture

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

- Interactive diagram: https://gitdiagram.com/dhanashri58/cloudresume_cc
- Repository: https://github.com/dhanashri58/cloudresume_cc

## Overview

CloudResumeAI is a browser-based resume authoring and career-optimization platform. Users authenticate, create and edit tailored resumes, use Gemini for writing and ATS feedback, and export server-rendered PDFs. The frontend routes into resume, template, profile, and AI workflows; the Flask API handles identity and domain requests, with services coordinating persistence, PDF generation, storage, and AI. The README documents cloud identity, private object storage, and observability; some subsystem links below rely on that documentation because their implementation files were not sampled.

Main entry points: [`frontend/src/App.tsx`](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/App.tsx) (React application), [`backend/app/__init__.py`](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/__init__.py) (Flask application), [`frontend/src/services/api.ts`](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/services/api.ts) (API clients), [`backend/app/services/resume_service.py`](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/resume_service.py) (Resume service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_spa["React application<br/>[App.tsx]"]
  node_authui["Sign-in<br/>[LoginPage.tsx]"]
  node_authprovider["Auth provider<br/>[AuthProvider.tsx]"]
  node_dashboard["Resume dashboard<br/>[DashboardPage.tsx]"]
  node_editor["Resume editor<br/>[EditorPage.tsx]"]
  node_templates["Templates<br/>[TemplatesPage.tsx]"]
  node_aiui["AI assistant"]
  node_profileui["Profile<br/>[ProfilePage.tsx]"]
  node_api_client["API clients<br/>[api.ts]"]
end

subgraph group_api["REST API"]
  node_flask["Flask application<br/>[__init__.py]"]
  node_authroutes["Auth routes<br/>[auth.py]"]
  node_resumeroutes["Resume routes<br/>[resumes.py]"]
  node_airoutes["AI routes<br/>[ai.py]"]
  node_profileroutes["Profile routes<br/>[profile.py]"]
  node_authservice["Identity service<br/>[auth_service.py]"]
end

subgraph group_domain["Resume services"]
  node_resume_service["Resume service<br/>[resume_service.py]"]
  node_ai_service["AI service<br/>[ai_service.py]"]
  node_pdf["PDF generation<br/>[pdf_service.py]"]
  node_storage["Object storage<br/>[storage_service.py]"]
end

subgraph group_platform["Data and integrations"]
  node_resume_repo["Resume repository"]
  node_user_repo["User repository<br/>[user_repository.py]"]
  node_resume_model["Resume records<br/>[resume.py]"]
  node_user_model["User records<br/>[user.py]"]
  node_database[("SQL database")]
  node_blobstore[("Private blob store")]
end

node_candidate(("Job seeker"))
node_gemini{{"Google Gemini"}}
node_entra{{"Microsoft Entra ID"}}

node_candidate -->|"uses"| node_spa
node_spa -->|"routes to"| node_authui
node_spa -->|"routes to"| node_dashboard
node_spa -->|"routes to"| node_editor
node_spa -->|"routes to"| node_templates
node_spa -->|"routes to"| node_aiui
node_spa -->|"routes to"| node_profileui
node_authui -->|"uses auth"| node_authprovider
node_authprovider -.->|"authenticates with"| node_entra
node_dashboard -->|"loads resumes"| node_api_client
node_editor -->|"saves resume"| node_api_client
node_editor -->|"requests AI help"| node_aiui
node_aiui -->|"submits prompts"| node_api_client
node_profileui -->|"updates profile"| node_api_client
node_api_client -.->|"calls API"| node_flask
node_flask -->|"registers routes"| node_authroutes
node_flask -->|"registers routes"| node_resumeroutes
node_flask -->|"registers routes"| node_airoutes
node_flask -->|"registers routes"| node_profileroutes
node_authroutes -->|"uses identity"| node_authservice
node_authservice -->|"looks up users"| node_user_repo
node_authservice -.->|"verifies tokens"| node_entra
node_resumeroutes -.->|"delegates resume work"| node_resume_service
node_airoutes -->|"calls AI service"| node_ai_service
node_resume_service -->|"persists resumes"| node_resume_repo
node_resume_service -->|"generates PDF"| node_pdf
node_resume_service -->|"stores files"| node_storage
node_resume_repo -->|"manages records"| node_resume_model
node_user_repo -->|"manages accounts"| node_user_model
node_resume_repo -.->|"reads and writes"| node_database
node_user_repo -.->|"reads and writes"| node_database
node_storage -.->|"stores resume files"| node_blobstore
node_ai_service -.->|"sends prompts"| node_gemini

click node_spa "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/auth/LoginPage.tsx"
click node_authprovider "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/auth/AuthProvider.tsx"
click node_dashboard "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/dashboard/DashboardPage.tsx"
click node_editor "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/editor/EditorPage.tsx"
click node_templates "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/templates/TemplatesPage.tsx"
click node_aiui "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/ai/AIAssistantPage.tsx"
click node_profileui "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/profile/ProfilePage.tsx"
click node_api_client "https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/services/api.ts"
click node_flask "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/__init__.py"
click node_authroutes "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/auth.py"
click node_resumeroutes "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/resumes.py"
click node_airoutes "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/ai.py"
click node_profileroutes "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/profile.py"
click node_authservice "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/auth_service.py"
click node_resume_service "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/resume_service.py"
click node_ai_service "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/ai_service.py"
click node_pdf "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/pdf_service.py"
click node_storage "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/storage_service.py"
click node_resume_repo "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/repositories/resume_repository.py"
click node_user_repo "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/repositories/user_repository.py"
click node_resume_model "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/models/resume.py"
click node_user_model "https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/models/user.py"

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_authui,node_authprovider,node_dashboard,node_editor,node_templates,node_aiui,node_profileui,node_api_client toneBlue
class node_flask,node_authroutes,node_resumeroutes,node_airoutes,node_profileroutes,node_authservice toneAmber
class node_resume_service,node_ai_service,node_pdf,node_storage toneMint
class node_resume_repo,node_user_repo,node_resume_model,node_user_model,node_database,node_blobstore toneRose
class node_candidate,node_gemini,node_entra toneIndigo
```

## Components

### Browser experience

- [React application](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Sign-in](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/auth/LoginPage.tsx): `frontend/src/pages/auth/LoginPage.tsx`
- [Auth provider](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/auth/AuthProvider.tsx): `frontend/src/auth/AuthProvider.tsx`
- [Resume dashboard](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/dashboard/DashboardPage.tsx): `frontend/src/pages/dashboard/DashboardPage.tsx`
- [Resume editor](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/editor/EditorPage.tsx): `frontend/src/pages/editor/EditorPage.tsx`
- [Templates](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/templates/TemplatesPage.tsx): `frontend/src/pages/templates/TemplatesPage.tsx`
- [AI assistant](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/ai/AIAssistantPage.tsx): `frontend/src/pages/ai/AIAssistantPage.tsx`
- [Profile](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/pages/profile/ProfilePage.tsx): `frontend/src/pages/profile/ProfilePage.tsx`
- [API clients](https://github.com/dhanashri58/cloudresume_cc/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### REST API

- [Flask application](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/__init__.py): `backend/app/__init__.py`
- [Auth routes](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/auth.py): `backend/app/routes/auth.py`
- [Resume routes](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/resumes.py): `backend/app/routes/resumes.py`
- [AI routes](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/ai.py): `backend/app/routes/ai.py`
- [Profile routes](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/routes/profile.py): `backend/app/routes/profile.py`
- [Identity service](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`

### Resume services

- [Resume service](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/resume_service.py): `backend/app/services/resume_service.py`
- [AI service](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/ai_service.py): `backend/app/services/ai_service.py`
- [PDF generation](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/pdf_service.py): `backend/app/services/pdf_service.py`
- [Object storage](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/services/storage_service.py): `backend/app/services/storage_service.py`

### Data and integrations

- [Resume repository](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/repositories/resume_repository.py): `backend/app/repositories/resume_repository.py`
- [User repository](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/repositories/user_repository.py): `backend/app/repositories/user_repository.py`
- [Resume records](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/models/resume.py): `backend/app/models/resume.py`
- [User records](https://github.com/dhanashri58/cloudresume_cc/blob/main/backend/app/models/user.py): `backend/app/models/user.py`
- **SQL database**
- **Private blob store**

### Other components

- **Job seeker**
- **Google Gemini**
- **Microsoft Entra ID**

## Connections

- Job seeker → React application: uses (evidence: `README.md`)
- React application → Sign-in: routes to (evidence: `frontend/src/App.tsx`)
- React application → Resume dashboard: routes to (evidence: `frontend/src/App.tsx`)
- React application → Resume editor: routes to (evidence: `frontend/src/App.tsx`)
- React application → Templates: routes to (evidence: `frontend/src/App.tsx`)
- React application → AI assistant: routes to (evidence: `frontend/src/App.tsx`)
- React application → Profile: routes to (evidence: `frontend/src/App.tsx`)
- Sign-in → Auth provider: uses auth (evidence: `frontend/src/pages/auth/LoginPage.tsx`)
- Auth provider → Microsoft Entra ID: authenticates with (evidence: `README.md`)
- Resume dashboard → API clients: loads resumes (evidence: `frontend/src/pages/dashboard/DashboardPage.tsx`)
- Resume editor → API clients: saves resume (evidence: `frontend/src/pages/editor/EditorPage.tsx`)
- Resume editor → AI assistant: requests AI help (evidence: `frontend/src/pages/editor/EditorPage.tsx`)
- AI assistant → API clients: submits prompts (evidence: `frontend/src/pages/ai/AIAssistantPage.tsx`)
- Profile → API clients: updates profile (evidence: `frontend/src/pages/profile/ProfilePage.tsx`)
- API clients → Flask application: calls API (evidence: `README.md`)
- Flask application → Auth routes: registers routes (evidence: `backend/app/__init__.py`)
- Flask application → Resume routes: registers routes (evidence: `backend/app/__init__.py`)
- Flask application → AI routes: registers routes (evidence: `backend/app/__init__.py`)
- Flask application → Profile routes: registers routes (evidence: `backend/app/__init__.py`)
- Auth routes → Identity service: uses identity (evidence: `backend/app/routes/auth.py`)
- Identity service → User repository: looks up users (evidence: `backend/app/services/auth_service.py`)
- Identity service → Microsoft Entra ID: verifies tokens (evidence: `README.md`)
- Resume routes → Resume service: delegates resume work (evidence: `README.md`)
- AI routes → AI service: calls AI service (evidence: `backend/app/routes/ai.py`)
- Resume service → Resume repository: persists resumes (evidence: `backend/app/services/resume_service.py`)
- Resume service → PDF generation: generates PDF (evidence: `backend/app/services/resume_service.py`)
- Resume service → Object storage: stores files (evidence: `backend/app/services/resume_service.py`)
- Resume repository → Resume records: manages records (evidence: `backend/app/repositories/resume_repository.py`)
- User repository → User records: manages accounts (evidence: `backend/app/repositories/user_repository.py`)
- Resume repository → SQL database: reads and writes (evidence: `README.md`)
- User repository → SQL database: reads and writes (evidence: `README.md`)
- Object storage → Private blob store: stores resume files (evidence: `README.md`)
- AI service → Google Gemini: sends prompts (evidence: `README.md`)
