# azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation architecture

> Architecture diagram of the GitHub repository azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation
- Repository: https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation

## Overview

AI Career Companion is a web application for resume analysis, internship discovery, and interview and career support. The main journey runs from account access and resume upload through profile extraction and internship matching, then into ATS/skill-gap review, application tracking, and preparation tools. The FastAPI app serves the frontend and registers the API routers; the sampled upload handler invokes extraction, regex and AI parsing, and merge services. The README documents additional AI features whose detailed implementation is not fully shown here, so those are represented at the router level. Relationships reflect excerpts or README workflow statements.

Main entry points: [`resume_parser/routes/upload.py`](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/routes/upload.py) (Resume Upload API), [`resume_parser/app.py`](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/app.py) (FastAPI Application), [`routers/internships.py`](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/internships.py) (Internship and Career API), [`routers/auth.py`](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/auth.py) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and API"]
  node_frontend["Career Dashboard<br/>[app.js]"]
  node_api["FastAPI Application<br/>[app.py]"]
end

subgraph group_identity["Accounts and Profiles"]
  node_auth["Authentication<br/>[auth.py]"]
  node_profiles["User Profiles<br/>[users.py]"]
  node_security["Token Security<br/>[security.py]"]
end

subgraph group_resume["Resume Analysis"]
  node_resume_upload["Resume Upload API<br/>[upload.py]"]
  node_file_parser["Document Text Extraction<br/>[file_parser.py]"]
  node_regex["Regex Extraction<br/>[regex_parser.py]"]
  node_llm_parser["AI Profile Extraction<br/>[llm_parser.py]"]
  node_merge["Profile Merge<br/>[merge.py]"]
end

subgraph group_career["Career Intelligence"]
  node_candidate["Candidate Profile"]
  node_internship_api["Internship and Career API<br/>[internships.py]"]
  node_matcher["Internship Matching"]
  node_embeddings["Text Embeddings"]
  node_vector_store[("Internship Vector Index<br/>[vector_store.py]")]
  node_policy_rag["Policy Retrieval<br/>[policy_rag.py]"]
  node_career_tools["Career and Interview Tools<br/>[internships.py]"]
  node_internship_data["Internship Catalog<br/>[internships.json]"]
end

subgraph group_persistence["Application Data"]
  node_db_connection["Database Session<br/>[connection.py]"]
  node_db_models[("User and Resume Records<br/>[models.py]")]
end

node_job_seeker(("Job Seeker"))
node_gemini{{"Gemini AI Service"}}

node_job_seeker -->|"uses"| node_frontend
node_api -->|"serves"| node_frontend
node_api -->|"registers routes"| node_auth
node_api -->|"registers routes"| node_profiles
node_api -->|"registers route"| node_resume_upload
node_api -->|"registers routes"| node_internship_api
node_auth -->|"opens sessions"| node_db_connection
node_auth -->|"queries users"| node_db_models
node_auth -->|"hashes credentials"| node_security
node_profiles -->|"opens sessions"| node_db_connection
node_profiles -->|"reads and updates"| node_db_models
node_profiles -->|"verifies tokens"| node_security
node_resume_upload -->|"extracts text"| node_file_parser
node_resume_upload -->|"extracts fields"| node_regex
node_resume_upload -->|"extracts profile"| node_llm_parser
node_resume_upload -->|"merges results"| node_merge
node_llm_parser -->|"requests extraction"| node_gemini
node_internship_api -->|"requests matching"| node_matcher
node_matcher -->|"uses profile"| node_candidate
node_matcher -->|"queries index"| node_vector_store
node_matcher -.->|"uses catalog"| node_internship_data
node_vector_store -->|"creates embeddings"| node_embeddings
node_policy_rag -->|"embeds queries"| node_embeddings
node_internship_api -->|"retrieves policy context"| node_policy_rag
node_internship_api -->|"provides tools"| node_career_tools
node_job_seeker -->|"uploads resume"| node_resume_upload
node_job_seeker -->|"requests career support"| node_internship_api
node_job_seeker -->|"uses preparation tools"| node_career_tools

click node_frontend "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/frontend/app.js"
click node_api "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/app.py"
click node_auth "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/auth.py"
click node_profiles "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/users.py"
click node_security "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/utils/security.py"
click node_db_connection "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/database/connection.py"
click node_db_models "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/database/models.py"
click node_resume_upload "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/routes/upload.py"
click node_file_parser "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/file_parser.py"
click node_regex "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/regex_parser.py"
click node_llm_parser "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/llm_parser.py"
click node_merge "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/merge.py"
click node_candidate "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/candidate_profile.py"
click node_internship_api "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/internships.py"
click node_matcher "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/internship_matcher.py"
click node_embeddings "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/embedding_service.py"
click node_vector_store "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/vector_store.py"
click node_policy_rag "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/policy_rag.py"
click node_career_tools "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/internships.py"
click node_internship_data "https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/data/internships.json"

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_frontend,node_api toneBlue
class node_auth,node_profiles,node_security toneAmber
class node_resume_upload,node_file_parser,node_regex,node_llm_parser,node_merge toneMint
class node_candidate,node_internship_api,node_matcher,node_embeddings,node_vector_store,node_policy_rag,node_career_tools,node_internship_data toneRose
class node_db_connection,node_db_models,node_job_seeker,node_gemini toneIndigo
```

## Components

### Web and API

- [Career Dashboard](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/frontend/app.js): `frontend/app.js`
- [FastAPI Application](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/app.py): `resume_parser/app.py`

### Accounts and Profiles

- [Authentication](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/auth.py): `routers/auth.py`
- [User Profiles](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/users.py): `routers/users.py`
- [Token Security](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/utils/security.py): `utils/security.py`

### Resume Analysis

- [Resume Upload API](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/routes/upload.py): `resume_parser/routes/upload.py`
- [Document Text Extraction](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/file_parser.py): `resume_parser/services/file_parser.py`
- [Regex Extraction](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/regex_parser.py): `resume_parser/services/regex_parser.py`
- [AI Profile Extraction](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/llm_parser.py): `resume_parser/services/llm_parser.py`
- [Profile Merge](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/merge.py): `resume_parser/services/merge.py`

### Career Intelligence

- [Candidate Profile](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/candidate_profile.py): `resume_parser/services/candidate_profile.py`
- [Internship and Career API](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/internships.py): `routers/internships.py`
- [Internship Matching](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/internship_matcher.py): `resume_parser/services/internship_matcher.py`
- [Text Embeddings](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/embedding_service.py): `resume_parser/services/embedding_service.py`
- [Internship Vector Index](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/vector_store.py): `resume_parser/services/vector_store.py`
- [Policy Retrieval](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/resume_parser/services/policy_rag.py): `resume_parser/services/policy_rag.py`
- [Career and Interview Tools](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/routers/internships.py): `routers/internships.py`
- [Internship Catalog](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/data/internships.json): `data/internships.json`

### Application Data

- [Database Session](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/database/connection.py): `database/connection.py`
- [User and Resume Records](https://github.com/azra-24/ai-career-companion-agent-for-internship-matching-and-interview-preparation/blob/main/database/models.py): `database/models.py`

### Other components

- **Job Seeker**
- **Gemini AI Service**

## Connections

- Job Seeker → Career Dashboard: uses (evidence: `README.md`)
- FastAPI Application → Career Dashboard: serves (evidence: `resume_parser/app.py`)
- FastAPI Application → Authentication: registers routes (evidence: `resume_parser/app.py`)
- FastAPI Application → User Profiles: registers routes (evidence: `resume_parser/app.py`)
- FastAPI Application → Resume Upload API: registers route (evidence: `resume_parser/app.py`)
- FastAPI Application → Internship and Career API: registers routes (evidence: `resume_parser/app.py`)
- Authentication → Database Session: opens sessions (evidence: `routers/auth.py`)
- Authentication → User and Resume Records: queries users (evidence: `routers/auth.py`)
- Authentication → Token Security: hashes credentials (evidence: `routers/auth.py`)
- User Profiles → Database Session: opens sessions (evidence: `routers/users.py`)
- User Profiles → User and Resume Records: reads and updates (evidence: `routers/users.py`)
- User Profiles → Token Security: verifies tokens (evidence: `routers/users.py`)
- Resume Upload API → Document Text Extraction: extracts text (evidence: `resume_parser/routes/upload.py`)
- Resume Upload API → Regex Extraction: extracts fields (evidence: `resume_parser/routes/upload.py`)
- Resume Upload API → AI Profile Extraction: extracts profile (evidence: `resume_parser/routes/upload.py`)
- Resume Upload API → Profile Merge: merges results (evidence: `resume_parser/routes/upload.py`)
- AI Profile Extraction → Gemini AI Service: requests extraction (evidence: `resume_parser/services/llm_parser.py`)
- Internship and Career API → Internship Matching: requests matching (evidence: `routers/internships.py`)
- Internship Matching → Candidate Profile: uses profile (evidence: `resume_parser/services/internship_matcher.py`)
- Internship Matching → Internship Vector Index: queries index (evidence: `resume_parser/services/internship_matcher.py`)
- Internship Matching → Internship Catalog: uses catalog
- Internship Vector Index → Text Embeddings: creates embeddings (evidence: `resume_parser/services/vector_store.py`)
- Policy Retrieval → Text Embeddings: embeds queries (evidence: `resume_parser/services/policy_rag.py`)
- Internship and Career API → Policy Retrieval: retrieves policy context (evidence: `routers/internships.py`)
- Internship and Career API → Career and Interview Tools: provides tools (evidence: `README.md`)
- Job Seeker → Resume Upload API: uploads resume (evidence: `README.md`)
- Job Seeker → Internship and Career API: requests career support (evidence: `README.md`)
- Job Seeker → Career and Interview Tools: uses preparation tools (evidence: `README.md`)
