# kashishbhutia/ai-career-coach architecture

> Architecture diagram of the GitHub repository kashishbhutia/ai-career-coach, 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/kashishbhutia/ai-career-coach
- Repository: https://github.com/kashishbhutia/ai-career-coach

## Overview

AI Career Coach is a Next.js career-development platform. Users authenticate, provide career details during onboarding, then use personalized dashboard insights, resume building, AI cover letters, and interview preparation. Server actions connect feature workflows to Prisma-backed user and career records; Gemini powers generated content, while Inngest exposes a background industry-insights workflow. The README also describes career recommendations, though the sampled source does not establish their implementation or connections. Relationships for unsampled components are limited to references in the source index.

Main entry points: [`lib/prisma.js`](https://github.com/kashishbhutia/ai-career-coach/blob/main/lib/prisma.js) (Prisma database), [`actions/cover-letter.js`](https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/cover-letter.js) (Cover-letter actions), [`actions/interview.js`](https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/interview.js) (Interview actions), [`app/(main)/onboarding/_components/onboarding-form.jsx`](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/onboarding/_components/onboarding-form.jsx) (Profile onboarding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and Profile"]
  node_auth["Authentication<br/>[page.jsx]"]
  node_onboard["Profile onboarding"]
  node_industries["Industry options<br/>[industries.js]"]
  node_useractions["User actions<br/>[user.js]"]
end

subgraph group_career["Career Guidance"]
  node_dashboard["Career dashboard<br/>[dashboard-view.jsx]"]
  node_dashactions["Dashboard actions<br/>[dashboard.js]"]
  node_insightsjob["Industry insights job<br/>[function.js]"]
  node_recommendations["Career recommendations"]
end

subgraph group_documents["Career Documents"]
  node_resume["Resume builder<br/>[resume-builder.jsx]"]
  node_resumeform["Resume entry form<br/>[entry-form.jsx]"]
  node_resumeactions["Resume actions<br/>[resume.js]"]
  node_covergen["Cover-letter generator"]
  node_coveractions["Cover-letter actions<br/>[cover-letter.js]"]
  node_coverlist["Cover-letter library"]
end

subgraph group_interviews["Interview Preparation"]
  node_interviewpage["Interview preparation<br/>[page.jsx]"]
  node_interviewactions["Interview actions<br/>[interview.js]"]
  node_quiz["Quiz experience<br/>[quiz.jsx]"]
  node_results["Quiz results and stats<br/>[quiz-result.jsx]"]
end

subgraph group_platform["Services and Storage"]
  node_db[("Prisma database<br/>[prisma.js]")]
  node_inngestroute["Inngest endpoint<br/>[route.js]"]
  node_inngestclient["Inngest client<br/>[client.js]"]
end

node_visitor(("Career seeker"))
node_gemini{{"Google Gemini"}}

node_visitor -->|"signs in"| node_auth
node_visitor -->|"provides profile"| node_onboard
node_onboard -->|"offers choices"| node_industries
node_onboard -->|"submits profile"| node_useractions
node_useractions -->|"reads and writes"| node_db
node_dashactions -->|"reads career data"| node_db
node_dashboard -->|"loads insights"| node_dashactions
node_useractions -->|"uses dashboard data"| node_dashactions
node_insightsjob -->|"persists insights"| node_db
node_inngestroute -->|"serves events"| node_inngestclient
node_inngestroute -->|"registers job"| node_insightsjob
node_resume -->|"renders entries"| node_resumeform
node_resume -->|"saves resume"| node_resumeactions
node_resumeactions -->|"reads and writes"| node_db
node_covergen -->|"generates letter"| node_coveractions
node_coveractions -->|"reads and writes"| node_db
node_coveractions -->|"generates content"| node_gemini
node_coverlist -->|"loads and deletes"| node_coveractions
node_interviewpage -->|"loads assessments"| node_interviewactions
node_interviewpage -->|"displays summaries"| node_results
node_interviewactions -->|"reads and writes"| node_db
node_interviewactions -->|"generates questions"| node_gemini
node_quiz -.->|"saves quiz result"| node_interviewactions
node_visitor -.->|"seeks guidance"| node_recommendations

click node_auth "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.jsx"
click node_onboard "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/onboarding/_components/onboarding-form.jsx"
click node_industries "https://github.com/kashishbhutia/ai-career-coach/blob/main/data/industries.js"
click node_useractions "https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/user.js"
click node_dashboard "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/dashboard/_component/dashboard-view.jsx"
click node_dashactions "https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/dashboard.js"
click node_insightsjob "https://github.com/kashishbhutia/ai-career-coach/blob/main/lib/inngest/function.js"
click node_resume "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/resume/_components/resume-builder.jsx"
click node_resumeform "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/resume/_components/entry-form.jsx"
click node_resumeactions "https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/resume.js"
click node_covergen "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/ai-cover-letter/_components/cover-letter-generator.jsx"
click node_coveractions "https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/cover-letter.js"
click node_coverlist "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/ai-cover-letter/_components/cover-letter-list.jsx"
click node_interviewpage "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/interview/page.jsx"
click node_interviewactions "https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/interview.js"
click node_quiz "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/interview/_components/quiz.jsx"
click node_results "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/interview/_components/quiz-result.jsx"
click node_db "https://github.com/kashishbhutia/ai-career-coach/blob/main/lib/prisma.js"
click node_inngestroute "https://github.com/kashishbhutia/ai-career-coach/blob/main/app/api/inngest/route.js"
click node_inngestclient "https://github.com/kashishbhutia/ai-career-coach/blob/main/lib/inngest/client.js"

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,node_onboard,node_industries,node_useractions toneBlue
class node_dashboard,node_dashactions,node_insightsjob,node_recommendations toneAmber
class node_resume,node_resumeform,node_resumeactions,node_covergen,node_coveractions,node_coverlist toneMint
class node_interviewpage,node_interviewactions,node_quiz,node_results toneRose
class node_db,node_inngestroute,node_inngestclient,node_visitor,node_gemini toneIndigo
```

## Components

### Entry and Profile

- [Authentication](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(auth)/sign-in/%5B%5B...sign-in%5D%5D/page.jsx): `app/(auth)/sign-in/[[...sign-in]]/page.jsx`
- [Profile onboarding](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/onboarding/_components/onboarding-form.jsx): `app/(main)/onboarding/_components/onboarding-form.jsx`
- [Industry options](https://github.com/kashishbhutia/ai-career-coach/blob/main/data/industries.js): `data/industries.js`
- [User actions](https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/user.js): `actions/user.js`

### Career Guidance

- [Career dashboard](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/dashboard/_component/dashboard-view.jsx): `app/(main)/dashboard/_component/dashboard-view.jsx`
- [Dashboard actions](https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/dashboard.js): `actions/dashboard.js`
- [Industry insights job](https://github.com/kashishbhutia/ai-career-coach/blob/main/lib/inngest/function.js): `lib/inngest/function.js`
- **Career recommendations**

### Career Documents

- [Resume builder](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/resume/_components/resume-builder.jsx): `app/(main)/resume/_components/resume-builder.jsx`
- [Resume entry form](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/resume/_components/entry-form.jsx): `app/(main)/resume/_components/entry-form.jsx`
- [Resume actions](https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/resume.js): `actions/resume.js`
- [Cover-letter generator](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/ai-cover-letter/_components/cover-letter-generator.jsx): `app/(main)/ai-cover-letter/_components/cover-letter-generator.jsx`
- [Cover-letter actions](https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/cover-letter.js): `actions/cover-letter.js`
- [Cover-letter library](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/ai-cover-letter/_components/cover-letter-list.jsx): `app/(main)/ai-cover-letter/_components/cover-letter-list.jsx`

### Interview Preparation

- [Interview preparation](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/interview/page.jsx): `app/(main)/interview/page.jsx`
- [Interview actions](https://github.com/kashishbhutia/ai-career-coach/blob/main/actions/interview.js): `actions/interview.js`
- [Quiz experience](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/interview/_components/quiz.jsx): `app/(main)/interview/_components/quiz.jsx`
- [Quiz results and stats](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/(main)/interview/_components/quiz-result.jsx): `app/(main)/interview/_components/quiz-result.jsx`

### Services and Storage

- [Prisma database](https://github.com/kashishbhutia/ai-career-coach/blob/main/lib/prisma.js): `lib/prisma.js`
- [Inngest endpoint](https://github.com/kashishbhutia/ai-career-coach/blob/main/app/api/inngest/route.js): `app/api/inngest/route.js`
- [Inngest client](https://github.com/kashishbhutia/ai-career-coach/blob/main/lib/inngest/client.js): `lib/inngest/client.js`

### Other components

- **Career seeker**
- **Google Gemini**

## Connections

- Career seeker → Authentication: signs in
- Career seeker → Profile onboarding: provides profile (evidence: `app/(main)/onboarding/_components/onboarding-form.jsx`)
- Profile onboarding → Industry options: offers choices (evidence: `app/(main)/onboarding/page.jsx`)
- Profile onboarding → User actions: submits profile (evidence: `app/(main)/onboarding/_components/onboarding-form.jsx`)
- User actions → Prisma database: reads and writes (evidence: `actions/user.js`)
- Dashboard actions → Prisma database: reads career data (evidence: `actions/dashboard.js`)
- Career dashboard → Dashboard actions: loads insights (evidence: `app/(main)/dashboard/page.jsx`)
- User actions → Dashboard actions: uses dashboard data (evidence: `actions/user.js`)
- Industry insights job → Prisma database: persists insights (evidence: `lib/inngest/function.js`)
- Inngest endpoint → Inngest client: serves events (evidence: `app/api/inngest/route.js`)
- Inngest endpoint → Industry insights job: registers job (evidence: `app/api/inngest/route.js`)
- Resume builder → Resume entry form: renders entries (evidence: `app/(main)/resume/_components/resume-builder.jsx`)
- Resume builder → Resume actions: saves resume (evidence: `app/(main)/resume/_components/resume-builder.jsx`)
- Resume actions → Prisma database: reads and writes (evidence: `actions/resume.js`)
- Cover-letter generator → Cover-letter actions: generates letter
- Cover-letter actions → Prisma database: reads and writes (evidence: `actions/cover-letter.js`)
- Cover-letter actions → Google Gemini: generates content (evidence: `actions/cover-letter.js`)
- Cover-letter library → Cover-letter actions: loads and deletes (evidence: `app/(main)/ai-cover-letter/_components/cover-letter-list.jsx`)
- Interview preparation → Interview actions: loads assessments (evidence: `app/(main)/interview/page.jsx`)
- Interview preparation → Quiz results and stats: displays summaries (evidence: `app/(main)/interview/page.jsx`)
- Interview actions → Prisma database: reads and writes (evidence: `actions/interview.js`)
- Interview actions → Google Gemini: generates questions (evidence: `actions/interview.js`)
- Quiz experience → Interview actions: saves quiz result
- Career seeker → Career recommendations: seeks guidance
