# harisenthilkumar/talentflow-platform architecture

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

- Interactive diagram: https://gitdiagram.com/harisenthilkumar/talentflow-platform
- Repository: https://github.com/harisenthilkumar/talentflow-platform

## Overview

TalentFlow is a role-based resume-to-job matching platform. Candidates submit resumes, review explainable job matches, route applications through human approval when required, and use follow-up tools; recruiters create jobs, rank candidates, bulk-upload resumes, and send outreach; admins oversee users and platform operations. The React application calls an Express API, which verifies Firebase identity and accesses Supabase data. README documents the scoring, parsing, and optional Gemini capabilities; unsampled implementation details are represented only at the documented subsystem level.

Main entry points: [`src/lib/api.ts`](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/lib/api.ts) (Authenticated API Client), [`server.ts`](https://github.com/harisenthilkumar/talentflow-platform/blob/main/server.ts) (Express API), [`src/App.tsx`](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/App.tsx) (Role-Based App), [`src/context/AuthContext.tsx`](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/context/AuthContext.tsx) (Auth Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; App Shell"]
  node_app["Role-Based App<br/>[App.tsx]"]
  node_auth["Auth Context<br/>[AuthContext.tsx]"]
  node_api_client["Authenticated API Client<br/>[api.ts]"]
  node_firebase_client["Firebase Client<br/>[firebase.ts]"]
end

subgraph group_candidate["Candidate Workspace"]
  node_resume["Resume Intake<br/>[ResumeUploader.tsx]"]
  node_candidate_dash["Candidate Dashboard"]
  node_matching["Job Recommendations"]
  node_approval["Approval Queue<br/>[ApprovalQueue.tsx]"]
  node_applications["Applications<br/>[Applications.tsx]"]
  node_candidate_tools["Candidate Tools<br/>[SkillGap.tsx]"]
  node_cover_letter["Cover Letters<br/>[CoverLetter.tsx]"]
end

subgraph group_recruiter["Recruiter Workspace"]
  node_recruiter_dash["Recruiter Dashboard"]
  node_job_create["Job Creation<br/>[CreateJob.tsx]"]
  node_ranking["Candidate Ranking"]
  node_bulk["Bulk Resume Upload<br/>[BulkUpload.tsx]"]
  node_outreach["Personalized Outreach<br/>[OutreachModal.tsx]"]
end

subgraph group_admin["Admin Workspace"]
  node_admin["Admin Operations<br/>[AdminDashboard.tsx]"]
  node_admin_users["User Management<br/>[Users.tsx]"]
  node_admin_jobs["Job Management<br/>[JobsManagement.tsx]"]
end

subgraph group_backend["API &amp; Data"]
  node_firebase["Firebase Auth"]
  node_scoring["Explainable Scoring<br/>[server.ts]"]
  node_api["Express API<br/>[server.ts]"]
  node_resume_parse["Resume Text Extraction<br/>[server.ts]"]
  node_gemini["Gemini Generation"]
  node_db[("Supabase Postgres")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"routes candidate"| node_candidate_dash
node_app -->|"routes recruiter"| node_recruiter_dash
node_app -->|"routes admin"| node_admin
node_auth -->|"uses"| node_firebase_client
node_firebase_client -->|"authenticates"| node_firebase
node_auth -->|"loads profile"| node_api_client
node_api_client -->|"gets token"| node_firebase_client
node_api_client -->|"sends requests"| node_api
node_candidate_dash -->|"offers upload"| node_resume
node_candidate_dash -->|"fetches dashboard data"| node_api_client
node_matching -.->|"requests matches"| node_api_client
node_resume -.->|"uploads resume"| node_api
node_api -->|"extracts text"| node_resume_parse
node_api -->|"calculates match"| node_scoring
node_api -->|"reads and writes"| node_db
node_scoring -.->|"returns ranked scores"| node_matching
node_approval -.->|"updates decision"| node_api_client
node_applications -->|"fetches applications"| node_api_client
node_candidate_tools -->|"requests skill analysis"| node_api_client
node_cover_letter -->|"requests generation"| node_api_client
node_recruiter_dash -->|"loads jobs and candidates"| node_api_client
node_job_create -->|"creates job"| node_api_client
node_ranking -->|"loads ranked candidates"| node_api_client
node_recruiter_dash -->|"renders uploader"| node_bulk
node_bulk -->|"uploads resumes"| node_api_client
node_ranking -->|"opens composer"| node_outreach
node_outreach -->|"drafts and sends"| node_api_client
node_api -.->|"optionally generates"| node_gemini
node_admin -->|"loads analytics"| node_api_client
node_admin_users -->|"manages accounts"| node_api_client
node_admin_jobs -->|"manages postings"| node_api_client

click node_app "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/App.tsx"
click node_auth "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/context/AuthContext.tsx"
click node_api_client "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/lib/api.ts"
click node_firebase_client "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/lib/firebase.ts"
click node_resume "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/components/ResumeUploader.tsx"
click node_candidate_dash "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/CandidateDashboard.tsx"
click node_matching "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/RecommendedJobs.tsx"
click node_scoring "https://github.com/harisenthilkumar/talentflow-platform/blob/main/server.ts"
click node_approval "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/ApprovalQueue.tsx"
click node_applications "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/Applications.tsx"
click node_candidate_tools "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/SkillGap.tsx"
click node_cover_letter "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/CoverLetter.tsx"
click node_recruiter_dash "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/recruiter/RecruiterDashboard.tsx"
click node_job_create "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/recruiter/CreateJob.tsx"
click node_ranking "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/recruiter/CandidateRanking.tsx"
click node_bulk "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/components/BulkUpload.tsx"
click node_outreach "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/components/OutreachModal.tsx"
click node_admin "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/admin/AdminDashboard.tsx"
click node_admin_users "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/admin/Users.tsx"
click node_admin_jobs "https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/admin/JobsManagement.tsx"
click node_api "https://github.com/harisenthilkumar/talentflow-platform/blob/main/server.ts"
click node_resume_parse "https://github.com/harisenthilkumar/talentflow-platform/blob/main/server.ts"

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_app,node_auth,node_api_client,node_firebase_client,node_user toneBlue
class node_resume,node_candidate_dash,node_matching,node_approval,node_applications,node_candidate_tools,node_cover_letter toneAmber
class node_recruiter_dash,node_job_create,node_ranking,node_bulk,node_outreach toneMint
class node_admin,node_admin_users,node_admin_jobs toneRose
class node_firebase,node_scoring,node_api,node_resume_parse,node_gemini,node_db toneIndigo
```

## Components

### Identity & App Shell

- [Role-Based App](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/App.tsx): `src/App.tsx`
- [Auth Context](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Authenticated API Client](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/lib/api.ts): `src/lib/api.ts`
- [Firebase Client](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`

### Candidate Workspace

- [Resume Intake](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/components/ResumeUploader.tsx): `src/components/ResumeUploader.tsx`
- [Candidate Dashboard](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/CandidateDashboard.tsx): `src/pages/candidate/CandidateDashboard.tsx`
- [Job Recommendations](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/RecommendedJobs.tsx): `src/pages/candidate/RecommendedJobs.tsx`
- [Approval Queue](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/ApprovalQueue.tsx): `src/pages/candidate/ApprovalQueue.tsx`
- [Applications](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/Applications.tsx): `src/pages/candidate/Applications.tsx`
- [Candidate Tools](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/SkillGap.tsx): `src/pages/candidate/SkillGap.tsx`
- [Cover Letters](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/candidate/CoverLetter.tsx): `src/pages/candidate/CoverLetter.tsx`

### Recruiter Workspace

- [Recruiter Dashboard](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/recruiter/RecruiterDashboard.tsx): `src/pages/recruiter/RecruiterDashboard.tsx`
- [Job Creation](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/recruiter/CreateJob.tsx): `src/pages/recruiter/CreateJob.tsx`
- [Candidate Ranking](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/recruiter/CandidateRanking.tsx): `src/pages/recruiter/CandidateRanking.tsx`
- [Bulk Resume Upload](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/components/BulkUpload.tsx): `src/components/BulkUpload.tsx`
- [Personalized Outreach](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/components/OutreachModal.tsx): `src/components/OutreachModal.tsx`

### Admin Workspace

- [Admin Operations](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/admin/AdminDashboard.tsx): `src/pages/admin/AdminDashboard.tsx`
- [User Management](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/admin/Users.tsx): `src/pages/admin/Users.tsx`
- [Job Management](https://github.com/harisenthilkumar/talentflow-platform/blob/main/src/pages/admin/JobsManagement.tsx): `src/pages/admin/JobsManagement.tsx`

### API & Data

- **Firebase Auth**
- [Explainable Scoring](https://github.com/harisenthilkumar/talentflow-platform/blob/main/server.ts): `server.ts`
- [Express API](https://github.com/harisenthilkumar/talentflow-platform/blob/main/server.ts): `server.ts`
- [Resume Text Extraction](https://github.com/harisenthilkumar/talentflow-platform/blob/main/server.ts): `server.ts`
- **Gemini Generation**
- **Supabase Postgres**

### Other components

- **User**

## Connections

- User → Role-Based App: uses (evidence: `README.md`)
- Role-Based App → Auth Context: provides auth (evidence: `src/App.tsx`)
- Role-Based App → Candidate Dashboard: routes candidate (evidence: `src/App.tsx`)
- Role-Based App → Recruiter Dashboard: routes recruiter (evidence: `src/App.tsx`)
- Role-Based App → Admin Operations: routes admin (evidence: `src/App.tsx`)
- Auth Context → Firebase Client: uses (evidence: `src/context/AuthContext.tsx`)
- Firebase Client → Firebase Auth: authenticates (evidence: `README.md`)
- Auth Context → Authenticated API Client: loads profile (evidence: `src/context/AuthContext.tsx`)
- Authenticated API Client → Firebase Client: gets token (evidence: `src/lib/api.ts`)
- Authenticated API Client → Express API: sends requests (evidence: `README.md`)
- Candidate Dashboard → Resume Intake: offers upload (evidence: `src/pages/candidate/CandidateDashboard.tsx`)
- Candidate Dashboard → Authenticated API Client: fetches dashboard data (evidence: `src/pages/candidate/CandidateDashboard.tsx`)
- Job Recommendations → Authenticated API Client: requests matches
- Resume Intake → Express API: uploads resume
- Express API → Resume Text Extraction: extracts text (evidence: `README.md`)
- Express API → Explainable Scoring: calculates match (evidence: `README.md`)
- Express API → Supabase Postgres: reads and writes (evidence: `README.md`)
- Explainable Scoring → Job Recommendations: returns ranked scores
- Approval Queue → Authenticated API Client: updates decision
- Applications → Authenticated API Client: fetches applications (evidence: `src/pages/candidate/Applications.tsx`)
- Candidate Tools → Authenticated API Client: requests skill analysis (evidence: `src/pages/candidate/SkillGap.tsx`)
- Cover Letters → Authenticated API Client: requests generation (evidence: `src/pages/candidate/CoverLetter.tsx`)
- Recruiter Dashboard → Authenticated API Client: loads jobs and candidates (evidence: `src/pages/recruiter/RecruiterDashboard.tsx`)
- Job Creation → Authenticated API Client: creates job (evidence: `src/pages/recruiter/CreateJob.tsx`)
- Candidate Ranking → Authenticated API Client: loads ranked candidates (evidence: `src/pages/recruiter/CandidateRanking.tsx`)
- Recruiter Dashboard → Bulk Resume Upload: renders uploader (evidence: `src/pages/recruiter/RecruiterDashboard.tsx`)
- Bulk Resume Upload → Authenticated API Client: uploads resumes (evidence: `src/components/BulkUpload.tsx`)
- Candidate Ranking → Personalized Outreach: opens composer (evidence: `src/pages/recruiter/CandidateRanking.tsx`)
- Personalized Outreach → Authenticated API Client: drafts and sends (evidence: `src/components/OutreachModal.tsx`)
- Express API → Gemini Generation: optionally generates (evidence: `README.md`)
- Admin Operations → Authenticated API Client: loads analytics (evidence: `src/pages/admin/AdminDashboard.tsx`)
- User Management → Authenticated API Client: manages accounts (evidence: `src/pages/admin/Users.tsx`)
- Job Management → Authenticated API Client: manages postings (evidence: `src/pages/admin/JobsManagement.tsx`)
