Skip to content

[๐Ÿ†๏ธ 2025 ๊ฐ•๋ฆ‰์›์ฃผ๋Œ€x๊ฐ•์›๋Œ€ AWS ํ•ด์ปคํ†ค ์šฐ์ˆ˜์ƒ ์ˆ˜์ƒ] ์ฝ”๋“œ๋กœ ๊ฒ€์ฆํ•˜๋Š” ๋‚ด ์ž์†Œ์„œ

Notifications You must be signed in to change notification settings

saa-hackathon-2025/factcheck

Repository files navigation

โญ FactCheck AI

์ž์†Œ์„œ๋‚˜ ์ด๋ ฅ์„œ์˜ ์ฃผ์žฅ, GitHub ์ฝ”๋“œ, ์ฑ„์šฉ๊ณต๊ณ (JD)๋ฅผ AI๊ฐ€ ๊ต์ฐจ ๋ถ„์„ํ•˜์—ฌ
์ง€์›์ž์˜ ๊ธฐ์ˆ  ์‹ ๋ขฐ๋„ยท์ผ๊ด€์„ฑยท์‹ค์ œ ์‹ค๋ ฅ์„ ๊ฒ€์ฆํ•˜๊ณ 
๊ฐœ์ธ ๋งž์ถคํ˜• ์••๋ฐ• ๋ฉด์ ‘ ์‹œ๋ฎฌ๋ ˆ์ด์…˜์„ ์ œ๊ณตํ•˜๋Š” ์„œ๋น„์Šค์ž…๋‹ˆ๋‹ค.

MIT React Gemini Tailwind

๐Ÿ“ ๋ฐœํ‘œ์ž๋ฃŒ โ†—

๐Ÿ“ธ Demo Video โ†—


๐Ÿš€ How to Use

Step 1. Input (์›ํด๋ฆญ ๋ฉด์ ‘ ์ค€๋น„)


Step1 4x

  • ํ™˜๊ฒฝ ์„ค์ •

    • Intern~Senior ๋ ˆ๋ฒจ
    • ํƒ€์ด๋จธ ์„ค์ •
  • ์ฑ„์šฉ๊ณต๊ณ (JD) ์ž…๋ ฅ : ํ…์ŠคํŠธ / URL / ์ด๋ฏธ์ง€ / PDF

  • ์ง€์›์ž ์„œ๋ฅ˜ ์ž…๋ ฅ : Resume / Cover Letter (ํ…์ŠคํŠธยทPDFยทNotion)

  • GitHub Repository ์ž…๋ ฅ

    • ๋ณต์ˆ˜ Repo ์ง€์›
    • Private Repo โ†’ Token ์‚ฌ์šฉ ๊ฐ€๋Šฅ

Step 2. Analysis (์ง„์œ„ ํŒ๋… ๋ฐ ์งˆ๋ฌธ ๋„์ถœ)


Step2 4x

  • 7๋Œ€ ๊ธฐ์ˆ  ์ง€ํ‘œ ์‚ฐ์ถœ
  • ์ทจ์•ฝ์  ๊ธฐ๋ฐ˜ ๋ฉด์ ‘ ์งˆ๋ฌธ ์ถœ๋ ฅ

Step 3. Action (์‹ค์ „ ๋””ํŽœ์Šค & ํ”ผ๋“œ๋ฐฑ)


Step3-1 60x

  • AI ์••๋ฐ• ๋ฉด์ ‘ ์ง„ํ–‰

    • ์‹ค์‹œ๊ฐ„ ํƒ€์ด๋จธ
    • ๊ผฌ๋ฆฌ ์งˆ๋ฌธ

Step3-2 6x

  • ์ตœ์ข… ๋ฆฌํฌํŠธ ํ™•์ธ

    • Logic Score(5์ )
    • Solution Score(5์ )
    • Total 10์  ํ‰๊ฐ€
    • ๊ฐœ์„  Action Items ์ œ๊ณต

โœจ Features

๐Ÿ” 3-Way Cross Verification

์„ธ ์š”์†Œ๋ฅผ ์ฆ๊ฑฐ ๊ธฐ๋ฐ˜์œผ๋กœ ๊ต์ฐจ ๊ฒ€์ฆํ•ฉ๋‹ˆ๋‹ค.

  • Resume / Cover Letter (Text, PDF, Notion URL)
  • GitHub Repository (Multiple Repos supported)
  • Job Description (URL ยท ํ…์ŠคํŠธ ยท ์ด๋ฏธ์ง€ ยท PDF)

๐Ÿ“Š 7-Factor AI Evaluation

๊ตฌํ˜„๋œ 7๊ฐ€์ง€ ํ•ต์‹ฌ ๊ธฐ์ˆ  ์ง€ํ‘œ๋ฅผ ๊ธฐ์ค€์œผ๋กœ ์ •๋ฐ€ ๋ถ„์„ํ•ฉ๋‹ˆ๋‹ค.

  • Architecture
  • Code Quality
  • Problem Solving
  • Tech Proficiency
  • Project Completeness
  • Consistency
  • Growth Potential

๐Ÿงฉ Deep Code Analysis

  • ๋””๋ ‰ํ† ๋ฆฌ ๊ตฌ์กฐ ๋ฐ ํ•ต์‹ฌ ๋กœ์ง ํŒŒ์ผ ์ž๋™ ์„ ๋ณ„
  • ML/Python, Java/Spring, TS/React ๋“ฑ ์ฃผ์š” ์Šคํƒ ์ž๋™ ์ธ์‹
  • README, package.json, requirements.txt ๊ธฐ๋ฐ˜ ๊ธฐ์ˆ  ์Šคํƒ ๋ถ„์„

๐Ÿ“„ Multimodal JD Parsing

  • ํ…์ŠคํŠธ / ์ด๋ฏธ์ง€(JPG, PNG) / PDF / URL
  • OCR ๊ธฐ๋ฐ˜ ํ…์ŠคํŠธ ์ถ”์ถœ ๋ฐ JD ์žฌ๊ตฌ์„ฑ

๐Ÿ’ฌ AI ์••๋ฐ• ๋ฉด์ ‘ (Live Interview Mode)

  • Intern ~ Senior ๋ ˆ๋ฒจ ์งˆ๋ฌธ
  • ๊ผฌ๋ฆฌ ์งˆ๋ฌธ / ์ถ”๊ถ ์งˆ๋ฌธ
  • ๋‹ต๋ณ€ ํšŒํ”ผ ๊ฐ์ง€
  • Time Limit Mode ์ง€์›

๐ŸŒ“ Dark / Light Mode

  • ํ™”๋ฉด ์šฐ์ธก ํ•˜๋‹จ ํ”Œ๋กœํŒ… ๋ฒ„ํŠผ
  • LocalStorage ๊ธฐ๋ฐ˜ ํ…Œ๋งˆ ์ €์žฅ
  • ์ „์ฒด ํŽ˜์ด์ง€ ์‹ค์‹œ๊ฐ„ ์—…๋ฐ์ดํŠธ

๐Ÿ’ก Detailed Features

1. 7-Factor Technical Scoring

  • Architecture: ์„ค๊ณ„ ํŒจํ„ด ๋ฐ ๊ตฌ์กฐ
  • Code Quality: ๋ชจ๋“ˆํ™”ยท๋„ค์ด๋ฐยทํ…Œ์ŠคํŠธ
  • Problem Solving: ์˜ˆ์™ธ ์ฒ˜๋ฆฌ/์•Œ๊ณ ๋ฆฌ์ฆ˜
  • Consistency: ์ž์†Œ์„œ vs ์ฝ”๋“œ ์ผ์น˜๋„
  • Growth Potential: ๋ฆฌํŒฉํ† ๋ง ํ”์  ๋“ฑ

2. Intelligent Interview Feedback

  • Logic Score (5์ )
  • Solution Score (5์ )
  • Zero Score Penalty ์ ์šฉ

3. Adaptive Persona Interview

  • ๋ ˆ๋ฒจ๋ณ„ ์งˆ๋ฌธ ๊นŠ์ด ๋ณ€ํ™”
  • ์„ค๊ณ„ ์˜๋„/ํŠธ๋ ˆ์ด๋“œ์˜คํ”„ ์ง‘์š”ํ•˜๊ฒŒ ๊ฒ€์ฆ
  • Intern ๋ชจ๋“œ์—์„œ๋Š” ํžŒํŠธ ์ œ๊ณต

๐Ÿ—๏ธ Architecture

graph TD
    A[User Input] -->|Resume & JD| B(React Client)
    A -->|GitHub URL| B
    B -->|Tree & Blob Fetch| C[GitHub REST API]
    B -->|Multimodal Request| D[Google Gemini 2.5 Flash]
    C -->|Raw Code| B
    B -->|Context Assembly| D
    D -->|Analysis JSON Result| B
    B -->|AI Chat| E[Pressure Interview Module]
Loading

๐Ÿ› ๏ธ Tech Stack

Category Technologies
Frontend React 19, TypeScript, Vite
Styling Tailwind CSS, Heroicons
AI / LLM Google Gemini 2.5 Flash
Data Fetching GitHub REST API
Parsing PDF/Image โ†’ Base64 Multimodal
State Management React Context API
Architecture Client-Side SPA

๐Ÿ“‚ Project Structure

factcheck-ai/
โ”œโ”€โ”€ public/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ AnalysisResult.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ Header.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ InputForm.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ InterviewChat.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ InterviewFeedback.tsx
โ”‚   โ”‚   โ”œโ”€โ”€ FloatingThemeToggle.tsx
โ”‚   โ”œโ”€โ”€ context/
โ”‚   โ”‚   โ””โ”€โ”€ ThemeContext.tsx
โ”‚   โ”œโ”€โ”€ services/
โ”‚   โ”‚   โ”œโ”€โ”€ geminiService.ts
โ”‚   โ”‚   โ””โ”€โ”€ githubService.ts
โ”‚   โ”œโ”€โ”€ App.tsx
โ”‚   โ”œโ”€โ”€ index.tsx
โ”‚   โ””โ”€โ”€ types.ts
โ”œโ”€โ”€ index.html
โ”œโ”€โ”€ metadata.json
โ”œโ”€โ”€ package.json
โ””โ”€โ”€ vite.config.ts

About

[๐Ÿ†๏ธ 2025 ๊ฐ•๋ฆ‰์›์ฃผ๋Œ€x๊ฐ•์›๋Œ€ AWS ํ•ด์ปคํ†ค ์šฐ์ˆ˜์ƒ ์ˆ˜์ƒ] ์ฝ”๋“œ๋กœ ๊ฒ€์ฆํ•˜๋Š” ๋‚ด ์ž์†Œ์„œ

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •