📥 리크루팅 프로세스 자동화 통합 솔루션, 위더스(WITHUS)

🔗 Link : https://withus-ten.vercel.app

• 불필요한 반복 작업 대신 지원자를 살피는데 집중할 수 있도록!
• [공고 - 지원서 취합 - 서류/면접 평가 - 합불 발표]의 모든 과정을 한 곳에서!

📑 목차

• 팀소개 & RnR
• 서비스 개요
  • 1️⃣ 문제 정의 / 경쟁사 분석
  • 2️⃣ 유저 리서치 / 기대 효과
  • 3️⃣ Information Architecture / 비즈니스 모델
• 서비스 기능
• API 명세서
• ERD
• 시스템 아키텍처
• 프론트엔드
• 백엔드

👩‍🍼 팀소개 & RnR

중전마더스

PM의 별명에서 비롯된 팀명으로, 서비스명 ‘위더스(WithUs)’와 라임을 맞춰 유쾌하면서도 따뜻한 팀의 색깔을 담았습니다. ‘중전’처럼 중심을 잡고 서로를 챙기며, ‘마더스’처럼 따뜻하게 사용자 곁에서 진심을 다하는 서비스를 만들겠다는 의지를 담은 이름입니다.

분야	이름	포지션
📋 기획	장수정	PM, 기획 리드, 서비스 기획(서비스 정책 확립, 유저 리서치, 와이어프레임 작성, UX writing)
📋 기획	윤수빈	서비스 기획(서비스 정책 확립, 유저 리서치, 와이어프레임 작성, UX writing)
🎨 디자인	설정원	디자인 리드, UX/UI 디자인, GUI 디자인, 서비스 디자인, 브랜드 디자인
🎨 디자인	김현호	UX/UI 디자인, GUI 디자인, 서비스 디자인, 브랜드 디자인
📲 프론트엔드	이채원	프론트엔드 리드, 화면 UI 구현, 서버 연동
📲 프론트엔드	서유빈	화면 UI 구현, 서버 연동
🖥️ 백엔드	김재관	백엔드 리드, DB 및 API 구축, 서버 배포
🖥️ 백엔드	우은진	DB 및 API 구축, 서버 배포

📮 서비스 개요

1️⃣ 문제 정의 / 경쟁사 분석

2️⃣ 유저 리서치 / 기대 효과

3️⃣ Information Architecture / 비즈니스 모델

💻 서비스 기능

🕹️ API 명세서

Swagger : https://jk-project.site/swagger-ui/index.html

🗂 ERD

🏦 시스템 아키텍처

🌆 프론트엔드

🛠️ 기술 스택

• Language, Framework, Library

  
  • Next.js (App Router) : App Router 기반으로 페이지, 레이아웃, 모달 등 구조적 분리를 명확히 함
  • TypeScript : API 통신, 컴포넌트 Props에 강한 타입을 부여해 안정성 확보
  • vanilla-extract : 디자인 토큰 기반 CSS-in-TypeScript로, color, spacing, typography 등을 type-safe하게 관리
  • Turborepo + pnpm : 모노레포 구조로 앱과 패키지(컴포넌트, 테마, 유틸 등)를 분리, 패키지 간 의존성 명확하게 관리, 병렬 빌드 성능 향상
  • TanStack Query (React Query) : 서버 상태 관리, 요청 중복 제거, 캐싱, SSR/CSR 통합 처리에 최적화

• CI/CD

  
  • Storybook + GitHub Actions : 공통 컴포넌트 변경사항을 PR마다 자동 배포로 시각화하여 디자이너·개발자 협업 간 피드백 사이클 단축

• 협업 툴

  

📜 개발 규칙

• branch naming convention

• commit convention

• issue template

• PR template

🌃 백엔드

🛠️ 기술 스택

• Language, Framework, Library

  
  • Spring Boot : RESTful API 설계 및 빠른 서버 사이드 개발
  • Java 17 : LTS 버전 기반의 안정적인 백엔드 개발
  • QueryDSL : 복잡한 조건의 쿼리를 타입 안정성 있게 처리
  • Gradle : 프로젝트 의존성 및 빌드 자동화

• CI/CD

  
  • GitHub Actions + Docker Compose : 코드 푸시 시 자동 빌드 및 테스트, 로컬 환경과 유사한 컨테이너 기반 배포 구성

• Test

  
  • JUnit : 단위 테스트 및 통합 테스트를 통해 비즈니스 로직의 신뢰성 확보

• Database

  
  • MySQL : 관계형 데이터베이스로 주요 도메인 저장
  • Redis : 토큰 저장 및 캐싱 용도로 사용

• 협업 툴

  

📜 개발 규칙

• branch naming convention

  [branch 유형]/[이슈번호-작업내용] (예: feat/55-login)

• commit convention

  [커밋 유형] : [커밋 메시지] [이슈번호] (예: feat: 로그인 구현 #4)

  feat	새로운 기능 구현
  add	파일 및 코드 추가
  chore	부수적인 코드 수정 및 기타 변경사항
  docs	문서 추가 및 수정, 삭제
  fix	버그 수정(코드 고치기)
  rename	파일 및 폴더 이름 변경
  test	테스트 코드 추가 및 수정, 삭제
  refactor	코드 리팩토링
  setting	ci/cd, 배포 관련, 프로젝트 세팅

• code convention

  • 2-space indent
  • camelCase 변수명
  • PascalCase 클래스명
  • Javadoc 주석 사용

• issue template

  제목 : [유형 별 이모지 (예: ✨)] [구현할 내용]

  ### 📌 Description
  
  ---
  ### ✅ Task
  - [ ] Task 1
  - [ ] Task 2

• PR template

  제목 : [유형 별 이모지 (예: ✨)] [구현한 내용]

  ### ✨ Related Issue
  
  ---
  
  ### 📌 Task Details
  - [x] Task 1
  - [x] Task 2
  
  ---
  
  ### 💬 Review Requirements (Optional)