# venkata-nageswara-bhadri78/codepilot architecture

> Architecture diagram of the GitHub repository venkata-nageswara-bhadri78/codepilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/venkata-nageswara-bhadri78/codepilot
- Repository: https://github.com/venkata-nageswara-bhadri78/codepilot

## Overview

Copilot Backend is a Spring Boot career-assistance API. Its tree indicates account and profile management, resume handling, job tracking and extraction, AI assistance, and job-scoped chat; however, the README says development is in progress and documents no user workflow. The graph therefore highlights these domain capabilities without asserting an end-to-end sequence. Several links are dashed where controller wiring or subsystem interactions are not shown in the excerpts; the job-to-resume scoring and automated extraction internals have direct source evidence.

Main entry points: [`src/main/java/com/developer/copilot/auth/service/AuthService.java`](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/auth/service/AuthService.java) (Authentication), [`src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/service/impl/AutomatedJobExtractionServiceImpl.java`](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/service/impl/AutomatedJobExtractionServiceImpl.java) (Automated extraction), [`src/main/java/com/developer/copilot/ai/service/AiService.java`](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/ai/service/AiService.java) (AI services), [`src/main/java/com/developer/copilot/chatassistant/service/ChatAssistantService.java`](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/chatassistant/service/ChatAssistantService.java) (Chat sessions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; profiles"]
  node_auth_api["Auth API"]
  node_auth["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT tokens<br/>[JwtService.java]"]
  node_user_api["User APIs"]
  node_profile["Profile management"]
  node_resume["Resume parsing"]
end

subgraph group_jobs["Jobs &amp; extraction"]
  node_job_api["Jobs API<br/>[JobController.java]"]
  node_job_service["Job management<br/>[JobService.java]"]
  node_binding["Resume-job scoring"]
  node_manual_extract["Manual extraction"]
  node_auto_extract["Automated extraction"]
  node_page_fetch["Job page fetching"]
  node_ssrf["URL protection"]
  node_extract_pipeline["Extraction pipeline"]
end

subgraph group_assistance["AI &amp; chat"]
  node_ai_api["AI API<br/>[AiController.java]"]
  node_ai_service["AI services<br/>[AiService.java]"]
  node_chat_api["Chat API"]
  node_chat_service["Chat sessions"]
end

subgraph group_platform["Shared platform"]
  node_storage_api["File storage interface"]
  node_object_storage["Object storage"]
end

node_client(("API client"))
node_minio[("MinIO")]
node_mysql[("MySQL")]
node_redis[("Redis")]
node_email["Email service"]
node_ai_provider["AI provider"]

node_client -.->|"sends requests"| node_auth_api
node_auth_api -.->|"handles auth"| node_auth
node_auth -.->|"issues tokens"| node_jwt
node_client -.->|"sends requests"| node_user_api
node_user_api -.->|"manages profiles"| node_profile
node_client -.->|"sends requests"| node_job_api
node_job_api -.->|"manages jobs"| node_job_service
node_binding -->|"loads parsed resume"| node_resume
node_binding -->|"requests scoring"| node_ai_service
node_job_service -.->|"binds resumes"| node_binding
node_client -.->|"submits job text"| node_manual_extract
node_client -.->|"submits job URL"| node_auto_extract
node_auto_extract -.->|"fetches page"| node_page_fetch
node_auto_extract -.->|"validates URL"| node_ssrf
node_ssrf -.->|"permits fetch"| node_page_fetch
node_auto_extract -.->|"extracts fields"| node_extract_pipeline
node_extract_pipeline -->|"runs strategies"| node_extract_pipeline
node_client -.->|"requests AI"| node_ai_api
node_ai_api -.->|"delegates AI work"| node_ai_service
node_client -.->|"sends chat turns"| node_chat_api
node_chat_api -.->|"manages sessions"| node_chat_service
node_chat_service -.->|"continues job chat"| node_ai_service
node_storage_api -->|"implemented by"| node_object_storage
node_object_storage -->|"stores files"| node_minio
node_auth -.->|"persists accounts"| node_mysql
node_chat_service -.->|"persists chat"| node_mysql
node_auth -.->|"uses cache"| node_redis
node_ai_service -.->|"calls model"| node_ai_provider
node_auth -.->|"sends email"| node_email

click node_auth_api "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/auth/controller/AuthController.java"
click node_auth "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/auth/service/AuthService.java"
click node_jwt "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/auth/jwt/JwtService.java"
click node_user_api "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/user/controller/UserController.java"
click node_profile "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/user/service/UserProfileService.java"
click node_resume "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/user/service/ResumeParsingService.java"
click node_job_api "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobs/controller/JobController.java"
click node_job_service "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobs/service/JobService.java"
click node_binding "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobs/service/JobResumeBindingService.java"
click node_manual_extract "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/manualextraction/controller/JobExtractionController.java"
click node_auto_extract "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/service/impl/AutomatedJobExtractionServiceImpl.java"
click node_page_fetch "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/fetch/JobPageFetcher.java"
click node_ssrf "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/security/SsrfProtectionService.java"
click node_extract_pipeline "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/extract/JobExtractionPipeline.java"
click node_ai_api "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/ai/controller/AiController.java"
click node_ai_service "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/ai/service/AiService.java"
click node_chat_api "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/chatassistant/controller/ChatAssistantController.java"
click node_chat_service "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/chatassistant/service/ChatAssistantService.java"
click node_storage_api "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/common/storage/service/FileStorageService.java"
click node_object_storage "https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/common/storage/service/impl/FileStorageServiceImpl.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_auth_api,node_auth,node_jwt,node_user_api,node_profile,node_resume,node_client toneBlue
class node_job_api,node_job_service,node_binding,node_manual_extract,node_auto_extract,node_page_fetch,node_ssrf,node_extract_pipeline,node_minio,node_mysql,node_redis toneAmber
class node_ai_api,node_ai_service,node_chat_api,node_chat_service toneMint
class node_storage_api,node_object_storage toneRose
class node_email,node_ai_provider toneIndigo
```

## Components

### Identity & profiles

- [Auth API](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/auth/controller/AuthController.java): `src/main/java/com/developer/copilot/auth/controller/AuthController.java`
- [Authentication](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/auth/service/AuthService.java): `src/main/java/com/developer/copilot/auth/service/AuthService.java`
- [JWT tokens](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/auth/jwt/JwtService.java): `src/main/java/com/developer/copilot/auth/jwt/JwtService.java`
- [User APIs](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/user/controller/UserController.java): `src/main/java/com/developer/copilot/user/controller/UserController.java`
- [Profile management](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/user/service/UserProfileService.java): `src/main/java/com/developer/copilot/user/service/UserProfileService.java`
- [Resume parsing](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/user/service/ResumeParsingService.java): `src/main/java/com/developer/copilot/user/service/ResumeParsingService.java`

### Jobs & extraction

- [Jobs API](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobs/controller/JobController.java): `src/main/java/com/developer/copilot/jobs/controller/JobController.java`
- [Job management](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobs/service/JobService.java): `src/main/java/com/developer/copilot/jobs/service/JobService.java`
- [Resume-job scoring](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobs/service/JobResumeBindingService.java): `src/main/java/com/developer/copilot/jobs/service/JobResumeBindingService.java`
- [Manual extraction](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/manualextraction/controller/JobExtractionController.java): `src/main/java/com/developer/copilot/jobextraction/manualextraction/controller/JobExtractionController.java`
- [Automated extraction](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/service/impl/AutomatedJobExtractionServiceImpl.java): `src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/service/impl/AutomatedJobExtractionServiceImpl.java`
- [Job page fetching](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/fetch/JobPageFetcher.java): `src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/fetch/JobPageFetcher.java`
- [URL protection](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/security/SsrfProtectionService.java): `src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/security/SsrfProtectionService.java`
- [Extraction pipeline](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/extract/JobExtractionPipeline.java): `src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/extract/JobExtractionPipeline.java`

### AI & chat

- [AI API](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/ai/controller/AiController.java): `src/main/java/com/developer/copilot/ai/controller/AiController.java`
- [AI services](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/ai/service/AiService.java): `src/main/java/com/developer/copilot/ai/service/AiService.java`
- [Chat API](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/chatassistant/controller/ChatAssistantController.java): `src/main/java/com/developer/copilot/chatassistant/controller/ChatAssistantController.java`
- [Chat sessions](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/chatassistant/service/ChatAssistantService.java): `src/main/java/com/developer/copilot/chatassistant/service/ChatAssistantService.java`

### Shared platform

- [File storage interface](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/common/storage/service/FileStorageService.java): `src/main/java/com/developer/copilot/common/storage/service/FileStorageService.java`
- [Object storage](https://github.com/venkata-nageswara-bhadri78/codepilot/blob/main/src/main/java/com/developer/copilot/common/storage/service/impl/FileStorageServiceImpl.java): `src/main/java/com/developer/copilot/common/storage/service/impl/FileStorageServiceImpl.java`

### Other components

- **API client**
- **MinIO**
- **MySQL**
- **Redis**
- **Email service**
- **AI provider**

## Connections

- API client → Auth API: sends requests
- Auth API → Authentication: handles auth
- Authentication → JWT tokens: issues tokens
- API client → User APIs: sends requests
- User APIs → Profile management: manages profiles
- API client → Jobs API: sends requests
- Jobs API → Job management: manages jobs
- Resume-job scoring → Resume parsing: loads parsed resume (evidence: `src/main/java/com/developer/copilot/jobs/service/JobResumeBindingService.java`)
- Resume-job scoring → AI services: requests scoring (evidence: `src/main/java/com/developer/copilot/jobs/service/JobResumeBindingService.java`)
- Job management → Resume-job scoring: binds resumes
- API client → Manual extraction: submits job text
- API client → Automated extraction: submits job URL
- Automated extraction → Job page fetching: fetches page
- Automated extraction → URL protection: validates URL
- URL protection → Job page fetching: permits fetch
- Automated extraction → Extraction pipeline: extracts fields
- Extraction pipeline → Extraction pipeline: runs strategies (evidence: `src/main/java/com/developer/copilot/jobextraction/automatedjobextraction/extract/JobExtractionPipeline.java`)
- API client → AI API: requests AI
- AI API → AI services: delegates AI work
- API client → Chat API: sends chat turns
- Chat API → Chat sessions: manages sessions
- Chat sessions → AI services: continues job chat
- File storage interface → Object storage: implemented by (evidence: `src/main/java/com/developer/copilot/common/storage/service/impl/FileStorageServiceImpl.java`)
- Object storage → MinIO: stores files (evidence: `src/main/java/com/developer/copilot/common/storage/service/impl/FileStorageServiceImpl.java`)
- Authentication → MySQL: persists accounts
- Chat sessions → MySQL: persists chat
- Authentication → Redis: uses cache
- AI services → AI provider: calls model
- Authentication → Email service: sends email
