# divyanka17-gt/skillbridge architecture

> Architecture diagram of the GitHub repository divyanka17-gt/skillbridge, 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/divyanka17-gt/skillbridge
- Repository: https://github.com/divyanka17-gt/skillbridge

## Overview

SkillBridge connects a candidate’s past experience to current, job-specific evidence that she controls, then lets employers review it without a readiness score. The candidate workflow is résumé upload and AI extraction, human review, target-job selection and skill-gap analysis, optional practice, evidence-profile sharing, and employer review or invitation. Employer job posting and requirement review form a parallel path into candidate discovery. The graph reflects README-described capabilities; several action and page implementations were not sampled, so their links are documented rather than inferred from code.

Main entry points: [`src/app/candidate`](https://github.com/divyanka17-gt/skillbridge/tree/main/src/app/candidate) (Candidate workspace), [`src/lib/db.ts`](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/db.ts) (PostgreSQL data), [`src/app/actions/resume.ts`](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/resume.ts) (Résumé extraction and review), [`src/app/employer`](https://github.com/divyanka17-gt/skillbridge/tree/main/src/app/employer) (Employer workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and shell"]
  node_auth_ui["Login and registration<br/>[page.tsx]"]
  node_auth_service["Authentication<br/>[auth.ts]"]
end

subgraph group_candidate["Candidate evidence"]
  node_candidate_pages["Candidate workspace"]
  node_resume_flow["Résumé extraction and review<br/>[resume.ts]"]
  node_profile_service["Profile building and sharing<br/>[build-profile.ts]"]
  node_target_jobs["Target jobs<br/>[targets.ts]"]
  node_practice_tasks["Practice task library<br/>[library.ts]"]
  node_share_links["Share links and activity<br/>[share.ts]"]
  node_public_profile["Shared profile view<br/>[page.tsx]"]
end

subgraph group_employer["Employer hiring"]
  node_discovery["Candidate discovery<br/>[load.ts]"]
  node_employer_pages["Employer workspace"]
  node_job_requirements["Job requirements<br/>[requirements.ts]"]
end

subgraph group_shared["Shared domain services"]
  node_ai_extract["AI extraction<br/>[gemini.ts]"]
  node_gap_analysis["Skill-gap analysis<br/>[gap-engine.ts]"]
  node_grading["Sandbox grading<br/>[grade.ts]"]
  node_invitations["Invitation exchange<br/>[invitations.ts]"]
  node_database[("PostgreSQL data<br/>[db.ts]")]
  node_pdf_storage[("Private résumé storage<br/>[storage.ts]")]
end

node_candidate_user(("Candidate"))
node_employer_user(("Employer"))
node_piston{{"Piston runner"}}
node_gemini{{"Gemini API"}}

node_candidate_user -->|"signs in"| node_auth_ui
node_employer_user -->|"signs in"| node_auth_ui
node_auth_ui -.->|"authenticates"| node_auth_service
node_auth_service -->|"checks credentials"| node_database
node_candidate_user -->|"uses"| node_candidate_pages
node_candidate_pages -->|"uploads résumé"| node_resume_flow
node_resume_flow -->|"requests extraction"| node_ai_extract
node_ai_extract -->|"calls"| node_gemini
node_resume_flow -->|"saves reviewed data"| node_database
node_resume_flow -->|"stores PDF"| node_pdf_storage
node_candidate_pages -->|"selects targets"| node_target_jobs
node_candidate_pages -->|"views gaps"| node_gap_analysis
node_gap_analysis -.->|"uses skill data"| node_database
node_candidate_pages -->|"chooses task"| node_practice_tasks
node_candidate_pages -->|"submits work"| node_grading
node_grading -->|"runs code"| node_piston
node_grading -.->|"records results"| node_database
node_candidate_pages -->|"builds evidence profile"| node_profile_service
node_profile_service -.->|"loads profile data"| node_database
node_candidate_pages -->|"configures sharing"| node_share_links
node_share_links -->|"creates access token"| node_public_profile
node_employer_user -->|"manages hiring"| node_employer_pages
node_employer_pages -->|"reviews requirements"| node_job_requirements
node_job_requirements -->|"extracts requirements"| node_ai_extract
node_employer_pages -->|"searches candidates"| node_discovery
node_discovery -.->|"loads candidates and jobs"| node_database
node_employer_pages -->|"invites candidate"| node_invitations
node_candidate_pages -->|"accepts or declines"| node_invitations
node_invitations -.->|"stores invitation state"| node_database
node_employer_user -->|"views shared profile"| node_public_profile

click node_auth_ui "https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/login/page.tsx"
click node_auth_service "https://github.com/divyanka17-gt/skillbridge/blob/main/src/auth.ts"
click node_candidate_pages "https://github.com/divyanka17-gt/skillbridge/tree/main/src/app/candidate"
click node_resume_flow "https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/resume.ts"
click node_ai_extract "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/ai/gemini.ts"
click node_profile_service "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/profile/build-profile.ts"
click node_target_jobs "https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/targets.ts"
click node_gap_analysis "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/skills/gap-engine.ts"
click node_practice_tasks "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/tasks/library.ts"
click node_grading "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/grading/grade.ts"
click node_share_links "https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/share.ts"
click node_public_profile "https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/p/%5Btoken%5D/page.tsx"
click node_discovery "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/discovery/load.ts"
click node_employer_pages "https://github.com/divyanka17-gt/skillbridge/tree/main/src/app/employer"
click node_job_requirements "https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/requirements.ts"
click node_invitations "https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/invitations.ts"
click node_database "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/db.ts"
click node_pdf_storage "https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/storage.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_auth_ui,node_auth_service toneBlue
class node_candidate_pages,node_resume_flow,node_profile_service,node_target_jobs,node_practice_tasks,node_share_links,node_public_profile toneAmber
class node_discovery,node_employer_pages,node_job_requirements,node_gemini toneMint
class node_ai_extract,node_gap_analysis,node_grading,node_invitations,node_database,node_pdf_storage toneRose
class node_candidate_user,node_employer_user,node_piston toneIndigo
```

## Components

### Identity and shell

- [Login and registration](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Authentication](https://github.com/divyanka17-gt/skillbridge/blob/main/src/auth.ts): `src/auth.ts`

### Candidate evidence

- [Candidate workspace](https://github.com/divyanka17-gt/skillbridge/tree/main/src/app/candidate): `src/app/candidate`
- [Résumé extraction and review](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/resume.ts): `src/app/actions/resume.ts`
- [Profile building and sharing](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/profile/build-profile.ts): `src/lib/profile/build-profile.ts`
- [Target jobs](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/targets.ts): `src/app/actions/targets.ts`
- [Practice task library](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/tasks/library.ts): `src/lib/tasks/library.ts`
- [Share links and activity](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/share.ts): `src/app/actions/share.ts`
- [Shared profile view](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/p/%5Btoken%5D/page.tsx): `src/app/p/[token]/page.tsx`

### Employer hiring

- [Candidate discovery](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/discovery/load.ts): `src/lib/discovery/load.ts`
- [Employer workspace](https://github.com/divyanka17-gt/skillbridge/tree/main/src/app/employer): `src/app/employer`
- [Job requirements](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/requirements.ts): `src/app/actions/requirements.ts`

### Shared domain services

- [AI extraction](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/ai/gemini.ts): `src/lib/ai/gemini.ts`
- [Skill-gap analysis](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/skills/gap-engine.ts): `src/lib/skills/gap-engine.ts`
- [Sandbox grading](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/grading/grade.ts): `src/lib/grading/grade.ts`
- [Invitation exchange](https://github.com/divyanka17-gt/skillbridge/blob/main/src/app/actions/invitations.ts): `src/app/actions/invitations.ts`
- [PostgreSQL data](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Private résumé storage](https://github.com/divyanka17-gt/skillbridge/blob/main/src/lib/storage.ts): `src/lib/storage.ts`

### Other components

- **Candidate**
- **Employer**
- **Piston runner**
- **Gemini API**

## Connections

- Candidate → Login and registration: signs in (evidence: `README.md`)
- Employer → Login and registration: signs in (evidence: `README.md`)
- Login and registration → Authentication: authenticates
- Authentication → PostgreSQL data: checks credentials (evidence: `src/auth.ts`)
- Candidate → Candidate workspace: uses (evidence: `README.md`)
- Candidate workspace → Résumé extraction and review: uploads résumé (evidence: `README.md`)
- Résumé extraction and review → AI extraction: requests extraction (evidence: `README.md`)
- AI extraction → Gemini API: calls (evidence: `README.md`)
- Résumé extraction and review → PostgreSQL data: saves reviewed data (evidence: `README.md`)
- Résumé extraction and review → Private résumé storage: stores PDF (evidence: `README.md`)
- Candidate workspace → Target jobs: selects targets (evidence: `README.md`)
- Candidate workspace → Skill-gap analysis: views gaps (evidence: `README.md`)
- Skill-gap analysis → PostgreSQL data: uses skill data
- Candidate workspace → Practice task library: chooses task (evidence: `README.md`)
- Candidate workspace → Sandbox grading: submits work (evidence: `README.md`)
- Sandbox grading → Piston runner: runs code (evidence: `README.md`)
- Sandbox grading → PostgreSQL data: records results
- Candidate workspace → Profile building and sharing: builds evidence profile (evidence: `README.md`)
- Profile building and sharing → PostgreSQL data: loads profile data
- Candidate workspace → Share links and activity: configures sharing (evidence: `README.md`)
- Share links and activity → Shared profile view: creates access token (evidence: `README.md`)
- Employer → Employer workspace: manages hiring (evidence: `README.md`)
- Employer workspace → Job requirements: reviews requirements (evidence: `README.md`)
- Job requirements → AI extraction: extracts requirements (evidence: `README.md`)
- Employer workspace → Candidate discovery: searches candidates (evidence: `README.md`)
- Candidate discovery → PostgreSQL data: loads candidates and jobs
- Employer workspace → Invitation exchange: invites candidate (evidence: `README.md`)
- Candidate workspace → Invitation exchange: accepts or declines (evidence: `README.md`)
- Invitation exchange → PostgreSQL data: stores invitation state
- Employer → Shared profile view: views shared profile (evidence: `README.md`)
