# bsrikumar855-dot/unbuff architecture

> Architecture diagram of the GitHub repository bsrikumar855-dot/unbuff, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bsrikumar855-dot/unbuff
- Repository: https://github.com/bsrikumar855-dot/unbuff

## Overview

UNBLUFF is a resume-based placement-interview preparation product. Its main loop maps resume claims to role skills, probes and grades answers, then reports evidence-backed readiness and schedules targeted practice and retests. The README documents the assessment/core/language/store architecture; the app excerpt confirms several service registrations. Other capability branches are included from README and the source tree, but their internal calls are not inferred where excerpts do not show them.

Main entry points: [`backend/src/services/assessment.ts`](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/services/assessment.ts) (Assessment service), [`backend/src/app.ts`](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/app.ts) (REST API), [`backend/src/mentor/service.ts`](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/mentor/service.ts) (AI mentor), [`frontend/src/App.tsx`](https://github.com/bsrikumar855-dot/unbuff/blob/main/frontend/src/App.tsx) (Web app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Student experience"]
  node_web["Web app<br/>[App.tsx]"]
end

subgraph group_assessment["Assessment workflow"]
  node_assessment["Assessment service<br/>[assessment.ts]"]
  node_claims["Claim interrogation<br/>[claims.ts]"]
  node_evidence["Evidence guard<br/>[evidence.ts]"]
  node_turns["Turn state machine<br/>[stateMachine.ts]"]
  node_rules["Verdicts and scoring<br/>[rules.ts]"]
  node_report["Readiness report<br/>[report.ts]"]
  node_schedule["Retest schedule<br/>[schedule.ts]"]
  node_llm["Language providers<br/>[provider.ts]"]
end

subgraph group_learning["Preparation tools"]
  node_placement["Placement planner<br/>[service.ts]"]
  node_careers["Career matching<br/>[service.ts]"]
  node_resume["Resume tools<br/>[service.ts]"]
  node_learn["Learning content<br/>[service.ts]"]
  node_code["Code practice<br/>[service.ts]"]
  node_dsa[("DSA catalogue<br/>[catalogue.ts]")]
  node_analytics["Practice analytics<br/>[service.ts]"]
  node_mentor["AI mentor<br/>[service.ts]"]
end

subgraph group_integrations["External insights"]
  node_github["GitHub insights<br/>[service.ts]"]
  node_leetcode["LeetCode insights<br/>[service.ts]"]
end

subgraph group_platform["API and persistence"]
  node_api["REST API<br/>[app.ts]"]
  node_sessionstore[("Session store<br/>[SessionStore.ts]")]
  node_stats[("Analytics stores<br/>[stores.ts]")]
end

node_student(("Student"))

node_student -->|"uses"| node_web
node_web -->|"sends REST"| node_api
node_api -.->|"dispatches"| node_assessment
node_api -->|"mounts routes"| node_claims
node_api -->|"registers service"| node_placement
node_api -->|"registers service"| node_careers
node_api -->|"registers service"| node_github
node_api -->|"registers service"| node_mentor
node_api -->|"registers service"| node_code
node_api -->|"registers service"| node_analytics
node_assessment -->|"serves claims"| node_claims
node_assessment -->|"requests grading"| node_llm
node_assessment -->|"checks quotes"| node_evidence
node_assessment -->|"advances turns"| node_turns
node_assessment -->|"computes verdicts"| node_rules
node_assessment -->|"builds report"| node_report
node_assessment -->|"schedules retests"| node_schedule
node_assessment -->|"reads and writes"| node_sessionstore
node_placement -.->|"plans preparation"| node_student
node_careers -.->|"matches jobs"| node_student
node_resume -.->|"supports resumes"| node_student
node_learn -.->|"provides lessons"| node_student
node_code -->|"uses catalogue"| node_dsa
node_analytics -.->|"uses stores"| node_stats
node_github -.->|"shows insights"| node_student
node_leetcode -.->|"shows insights"| node_student
node_mentor -.->|"coaches"| node_student
node_mentor -.->|"reads analytics"| node_stats

click node_web "https://github.com/bsrikumar855-dot/unbuff/blob/main/frontend/src/App.tsx"
click node_api "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/app.ts"
click node_assessment "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/services/assessment.ts"
click node_claims "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/routes/claims.ts"
click node_evidence "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/evidence.ts"
click node_turns "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/stateMachine.ts"
click node_rules "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/rules.ts"
click node_report "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/report.ts"
click node_schedule "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/schedule.ts"
click node_llm "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/llm/provider.ts"
click node_sessionstore "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/store/SessionStore.ts"
click node_placement "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/placement/service.ts"
click node_careers "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/careers/service.ts"
click node_resume "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/resume/service.ts"
click node_learn "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/learn/service.ts"
click node_code "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/code/service.ts"
click node_dsa "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/dsa/catalogue.ts"
click node_analytics "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/analytics/service.ts"
click node_github "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/github/service.ts"
click node_leetcode "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/leetcode/service.ts"
click node_mentor "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/mentor/service.ts"
click node_stats "https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/analytics/stores.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_web toneBlue
class node_assessment,node_claims,node_evidence,node_turns,node_rules,node_report,node_schedule,node_llm toneAmber
class node_placement,node_careers,node_resume,node_learn,node_code,node_dsa,node_analytics,node_mentor toneMint
class node_github,node_leetcode toneRose
class node_api,node_sessionstore,node_stats,node_student toneIndigo
```

## Components

### Student experience

- [Web app](https://github.com/bsrikumar855-dot/unbuff/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Assessment workflow

- [Assessment service](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/services/assessment.ts): `backend/src/services/assessment.ts`
- [Claim interrogation](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/routes/claims.ts): `backend/src/routes/claims.ts`
- [Evidence guard](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/evidence.ts): `backend/src/core/evidence.ts`
- [Turn state machine](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/stateMachine.ts): `backend/src/core/stateMachine.ts`
- [Verdicts and scoring](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/rules.ts): `backend/src/core/rules.ts`
- [Readiness report](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/report.ts): `backend/src/core/report.ts`
- [Retest schedule](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/core/schedule.ts): `backend/src/core/schedule.ts`
- [Language providers](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/llm/provider.ts): `backend/src/llm/provider.ts`

### Preparation tools

- [Placement planner](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/placement/service.ts): `backend/src/placement/service.ts`
- [Career matching](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/careers/service.ts): `backend/src/careers/service.ts`
- [Resume tools](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/resume/service.ts): `backend/src/resume/service.ts`
- [Learning content](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/learn/service.ts): `backend/src/learn/service.ts`
- [Code practice](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/code/service.ts): `backend/src/code/service.ts`
- [DSA catalogue](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/dsa/catalogue.ts): `backend/src/dsa/catalogue.ts`
- [Practice analytics](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/analytics/service.ts): `backend/src/analytics/service.ts`
- [AI mentor](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/mentor/service.ts): `backend/src/mentor/service.ts`

### External insights

- [GitHub insights](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/github/service.ts): `backend/src/github/service.ts`
- [LeetCode insights](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/leetcode/service.ts): `backend/src/leetcode/service.ts`

### API and persistence

- [REST API](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Session store](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/store/SessionStore.ts): `backend/src/store/SessionStore.ts`
- [Analytics stores](https://github.com/bsrikumar855-dot/unbuff/blob/main/backend/src/analytics/stores.ts): `backend/src/analytics/stores.ts`

### Other components

- **Student**

## Connections

- Student → Web app: uses (evidence: `README.md`)
- Web app → REST API: sends REST (evidence: `README.md`)
- REST API → Assessment service: dispatches
- REST API → Claim interrogation: mounts routes (evidence: `backend/src/app.ts`)
- REST API → Placement planner: registers service (evidence: `backend/src/app.ts`)
- REST API → Career matching: registers service (evidence: `backend/src/app.ts`)
- REST API → GitHub insights: registers service (evidence: `backend/src/app.ts`)
- REST API → AI mentor: registers service (evidence: `backend/src/app.ts`)
- REST API → Code practice: registers service (evidence: `backend/src/app.ts`)
- REST API → Practice analytics: registers service (evidence: `backend/src/app.ts`)
- Assessment service → Claim interrogation: serves claims (evidence: `README.md`)
- Assessment service → Language providers: requests grading (evidence: `README.md`)
- Assessment service → Evidence guard: checks quotes (evidence: `README.md`)
- Assessment service → Turn state machine: advances turns (evidence: `README.md`)
- Assessment service → Verdicts and scoring: computes verdicts (evidence: `README.md`)
- Assessment service → Readiness report: builds report (evidence: `README.md`)
- Assessment service → Retest schedule: schedules retests (evidence: `README.md`)
- Assessment service → Session store: reads and writes (evidence: `README.md`)
- Placement planner → Student: plans preparation
- Career matching → Student: matches jobs
- Resume tools → Student: supports resumes
- Learning content → Student: provides lessons
- Code practice → DSA catalogue: uses catalogue (evidence: `backend/src/code/service.ts`)
- Practice analytics → Analytics stores: uses stores (evidence: `backend/src/analytics/service.ts`)
- GitHub insights → Student: shows insights
- LeetCode insights → Student: shows insights
- AI mentor → Student: coaches
- AI mentor → Analytics stores: reads analytics (evidence: `backend/src/mentor/service.ts`)
