Skip to content

Conversation

@WonJuneKim
Copy link
Contributor

@WonJuneKim WonJuneKim commented Dec 27, 2025

💡 작업 내용

  • 지원 플로우 리뉴얼 (Funnel 구조 활용)
  • 지원 목록 페이지 퍼블리싱
  • 지원 목록 상세 페이지 퍼블리싱
  • API 호출 부 및 쿼리 키, 커스텀 훅 리뉴얼

💡 자세한 설명

  • 변경점이 매우 매우 큽니다..! 핵심 사항 몇가지로 정리해서 설명드리겠습니다.

Funnel 구조 도입

  • @use-funnel 을 사용하여 지원하기 플로우를 리뉴얼하였습니다.
  • 기존 state가 잘 관리되지 않던 문제를 해결하였고, 보다 직관적으로 플로우를 파악하실 수 있습니다.

Apply 도메인 API 리펙토링

  • Factory 패턴을 사용하여 query key와 option을 제어하도록 변경하였습니다.
  • 단일 API에 대해 파생되는 커스텀 훅이나 쿼리 옵션들을 보다 효율적으로 정돈하고자 해당 작업을 수행했습니다.
  • Zod 스키마를 기반으로 API 응답 타입을 검증하도록 변경하였습니다. (apply라는 도메인은 검증이 필수 - 중요한 정보이기 때문)

Apply 공통

  • 지원 플로우에서 사용하는 화면끼리 공유하는 부분이 많다고 파악되어 별도의 Apply 전용 Layout을 생성하였습니다.
  • 이 플로우에서는 독립적인 Suspense와 Fallback을 가진 AsyncBoundary를 사용하도록 변경하였습니다.
  • 실질적으로 Suspense 와 Errorboundary를 같이 선언하여 커스텀 훅이나 컴포넌트 내부에서는 항상 데이터가 있음을 보장합니다.

공통

  • 레거시 코드를 정리하였습니다.
  • 라우팅 경로가 일부 수정되었습니다.

📗 참고 자료 (선택)

📢 리뷰 요구 사항 (선택)

  • 기능이 잘 작동하는지 확인부탁드립니다!
  • 현재 일부 API 에러로 해결되면 다시 노티드리겠습니다.

✅ 셀프 체크리스트

  • 머지할 브랜치 확인했나요?
  • 이슈는 close 했나요?
  • Reviewers, Labels, Projects를 등록했나요?
  • 기능이 잘 동작하나요?
  • 불필요한 코드는 제거했나요?

closes #293

- 지원 플로우에 funnel 구조 도입을 위함
- 불필요한 옵셔널 props 제거
- 타입 가드를 제거하고 런타임에서 직접 검사할 수 있는 방식
- current 유무에 따라 Step의 렌더링을 결정
- jobFamily가 있다면 데이터 객체를 사용
- 지원 플로우, 핀 재설정, 이어서 작성하기 플로우 모두 공통적으로 사용하는 컴포넌트
- 타이머와 같은 부수적인 로직은 커스텀 훅으로 전환
- 불필요하게 선언된 외부 의존성 컴포넌트 제거
- 순수 함수를 통해 명시적으로 상태를 드러내기 위함
- JSX 내에서 getter 함수의 가독성 저하 문제 해결
- 개인정보 수집 및 이용 동의
- 회비 및 보증금 납입 정책 동의
- CheckBoxGroup 추가
- validation 조건(정책)을 명시적으로 선언
- mutation 호출 시 불필요한 isPending 값 제거(다음 Step으로 이동하기 때문)
- InputArea를 사용하는 TextQuestionField
- TextField를 사용하는 UrlQuestionField
@WonJuneKim WonJuneKim self-assigned this Dec 27, 2025
@WonJuneKim WonJuneKim added ✨feature 구현, 개선 사항 관련 부분 👩🏻‍💻frontend 프론트엔드 작업 labels Dec 27, 2025
@vercel
Copy link

vercel bot commented Dec 27, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
ject-official-web-site-client-web Ready Ready Preview, Comment Dec 28, 2025 7:42am

@kimdonggu42
Copy link
Member

고생하셨습니다! 지금 일정이 빠듯한 것 같아서 아직 자세히 확인은 못 했는데 먼저 approve 후에 확인해 보겠습니다!

- 브라우저 마다 다르게 적용되는 속성 제거
- relative일 때도 같은 위치에 적용하기 위함
  - ContinueWritingFunnel에서 URL 파라미터 대신 /apply/status API로 실제 상태 확인
  - 이미 제출 완료/이어서 작성할 내용이 없는 경우 안내 후 리다이렉트
  - tempSavedStep URL 파라미터 및 관련 prop 제거
@WonJuneKim WonJuneKim merged commit cfdf247 into dev Dec 28, 2025
4 of 5 checks passed
@WonJuneKim WonJuneKim deleted the feat/293-apply-new-verifying branch December 28, 2025 07:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

✨feature 구현, 개선 사항 관련 부분 👩🏻‍💻frontend 프론트엔드 작업

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

feat: 이메일 인증 플로우 구현(U/Apply/New/Verifying)

3 participants