Skip to content

kimjunha1231/JobSecretary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

79 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

JobSecretary : AI 통합 채용 관리 플랫폼

Next.js TypeScript Supabase FSD


1. 프로젝트 소개

JobSecretary는 취업 준비 과정에서 발생하는 플랫폼 파편화 문제(자소서, 공고, 일정 관리의 분산, 이력서, 포트폴리오의 분산)를 해결하기 위한 AI 통합 채용 관리 플랫폼입니다.

사용자는 공고 및 지원현황을 관리하며 흩어져 있는 자기소개서를 태그 기반으로 저장 및 검색하고, AI를 활용해 자기소개서 초안 작성부터 교정, 면접 예상 질문 생성까지 취업 전과정을 효율적으로 관리할 수 있습니다.


2. 핵심 기능

기능 설명
🤖 AI 자소서 솔루션 사용자 경험 데이터 기반 자소서 초안 작성, 문맥 교정, 맞춤형 면접 질문 생성
📊 칸반형 공고 관리 드래그 앤 드롭으로 '작성 중 → 지원 완료 → 면접 → 합격/불합격' 채용 단계 관리
🗂️ 커리어 자산화 태그 기반 자소서 저장·검색, PDF 포트폴리오 변환
🔐 데이터 보호 Supabase RLS 적용, Navigation Guard로 페이지 이탈 시 데이터 손실 방지

3. 기술 스택

Frontend

분류 기술
Framework Next.js 15 (App Router)
Language TypeScript
폼 상태 관리 React Hook Form + Zod
서버 상태 관리 TanStack Query (Optimistic Update)
전역 UI 상태 Zustand
Styling Tailwind CSS, Shadcn/UI

Backend & Infra

분류 기술
BaaS Supabase (PostgreSQL, Auth, RLS)
AI Engine Google Gemini API
에러 모니터링 Sentry
Testing Jest (Unit), Playwright (E2E)
Deployment Vercel

4. 아키텍처

Feature-Sliced Design (FSD) 패턴을 채택하여 기술적 역할이 아닌 비즈니스 도메인 기준으로 코드를 격리했습니다.

.
├── app/                    # Composition Layer (라우팅 및 페이지 조립)
│   ├── api/                # Server Actions & API Routes
│   └── (pages)/            # 페이지 컴포넌트
├── widgets/                # 독립적 UI 블록 (Sidebar, KanbanBoard, ArchiveBoard)
├── features/               # 사용자 상호작용 기능
│   ├── document-kanban/    # 칸반 보드 드래그 앤 드롭
│   ├── document-editor/    # 문서 편집 및 뷰어
│   ├── document-write/     # 자소서 작성 폼
│   ├── document-archive/   # 아카이브 필터링 및 목록
│   ├── ai-assistant/       # AI 교정 기능
│   └── auth/               # 인증 및 동의
├── entities/               # 비즈니스 데이터 모델
│   ├── document/           # 자소서 엔티티 (types, actions, hooks, ui)
│   ├── draft/              # 임시 저장 상태
│   └── user/               # 사용자 프로필
├── shared/                 # 공용 모듈
│   ├── ui/                 # 재사용 UI 컴포넌트
│   ├── config/             # 상수 및 설정
│   ├── lib/                # 유틸리티 함수
│   └── api/                # Supabase 클라이언트
└── middleware.ts           # 인증 미들웨어

5. 성능 최적화

최적화 항목 적용 기술
렌더링 최적화 useMemo, useCallback으로 칸반 드래그 중 불필요한 리렌더 방지
폼 성능 React Hook Form 비제어 컴포넌트로 타이핑 시 리렌더 최소화
번들 최적화 optimizePackageImports, Polyfill Bloat 제거 (browserslist: Chrome 100+)
캐시 활성화 Back-Forward Cache 활성화, Dynamic Import 활용
접근성 aria-label, sr-only, Lighthouse 접근성 점수 개선

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages