Skip to content

README.md

Latest commit

 

History

History
167 lines (108 loc) · 5.1 KB

README.md

File metadata and controls

167 lines (108 loc) · 5.1 KB

노후하우 Client

1. 프로젝트 개요

노후하우(KnowWhoHow)는 시니어 세대를 위한 종합 노후 준비 플랫폼입니다. 복잡한 연금 정보, 금융 상품 정보와 행정 절차에 어려움을 겪는 사용자를 위해 직관적인 UI/UX를 제공하며, 자산 설계부터 상속, 연금 관리, 일자리 찾기까지 노후 생활에 필요한 핵심 서비스를 올인원으로 제공합니다.

2. 주요 기능

  • 🔐 로그인 / 회원가입
    • 일반 로그인 및 카카오 소셜 로그인 지원
    • 휴대폰 본인 인증 및 회원가입 프로세스
  • 💰 자산 설계 (Asset Management)
    • 마이데이터 기반 자산 연동 및 현금 흐름 분석
    • AI 챗봇을 통한 맞춤형 금융 상품 추천
    • 은퇴 목표 설정 및 포트폴리오 진단
    • 목돈 예치/월 저축 시뮬레이션
  • 👴 상속 관리 (Inheritance)
    • 상속 자산 및 가족 구성원에 따른 법정 상속분/유류분 자동 계산
    • 상황별 맞춤형 유산 신탁 상품 추천
    • 디지털 영상 편지(유언) 녹화 및 예약 발송 시스템
  • 📈 연금 관리 (Pension)
    • 퇴직 연금(IRP/DC) 예상 수령액 시뮬레이션
    • 개인 납입액에 따른 세제 혜택(세액 공제) 분석 및 가이드
  • 💼 일자리 찾기 (Job Search)
    • 시니어 맞춤형 채용 공고 리스트 제공 (위치/고용형태 필터링)

3. 기술 스택 (Tech Stack)

Core Framework

  • Next.js 15 (App Router)
  • React 19
  • TypeScript

Styling

  • Tailwind CSS 4
  • Radix UI
  • Framer Motion

State Management & Data Fetching

  • Zustand: 전역 클라이언트 상태 관리 (Auth, User, Asset 등 스토어 분리)
  • TanStack Query (React Query) v5: 서버 상태 동기화 및 캐싱, 비동기 로직 관리

Others

  • Next-PWA: 모바일 웹 앱 경험을 위한 PWA(Progressive Web App) 지원
  • Axios: HTTP 클라이언트 통신

4. 디렉토리 구조

본 프로젝트는 Next.js App Router 구조를 따르며, 도메인 중심 설계를 통해 유지보수성을 극대화했습니다.

src
├── api          # API 호출 함수 모음 (도메인별 분리: auth, asset, ai, etc.)
├── app          # Next.js App Router 페이지 및 레이아웃
│   ├── (auth)              # 로그인/회원가입 관련 그룹
│   ├── (asset-management)  # 자산 관리 관련 그룹
│   ├── (main)              # 메인 대시보드
│   ├── (mydata)            # 마이데이터 연동
│   ├── inheritance         # 상속 서비스
│   ├── pension             # 연금 서비스
│   ├── job                 # 일자리 찾기
│   └── ...
├── components   # 재사용 가능한 UI 컴포넌트 (도메인별 하위 폴더 구분)
│   ├── common   # 공통 컴포넌트 (Button, Input, Modal, etc.)
│   └── ...
├── constants    # 상수 데이터 (메뉴, 옵션 리스트 등)
├── hooks        # 커스텀 훅 (비즈니스 로직 분리)
├── lib          # 유틸리티 라이브러리 설정 (utils.ts 등)
├── stores       # Zustand 스토어 (authStore, userStore 등)
├── types        # TypeScript 타입 정의
└── utils        # 공통 유틸리티 함수 (포맷팅, 계산 로직 등)

5. 상태 관리

효율적인 데이터 흐름을 위해 Client State와 Server State를 명확히 분리하여 관리합니다.

Client State (Zustand)

useAuthStore: 로그인 토큰 및 인증 상태 관리

useUserStore: 사용자 기본 프로필 정보

useMyDataStore: 마이데이터 연동 상태 및 임시 데이터 저장

useInheritanceStore: 상속 설계 프로세스 간 데이터 유지

Server State (React Query)

API 데이터 캐싱

실시간 동기화 (자산 포트폴리오 조회, 추천 상품 비동기 로딩 등)

6. 주요 기술

PWA (Progressive Web App)

next-pwa 적용 → 모바일 웹에서 네이티브 앱 수준의 사용자 경험 제공 + 오프라인 접근성 확보

Optimized Rendering

SSR (Server Side Rendering)

CSR (Client Side Rendering) → 하이브리드 방식 적용으로 초기 로딩 속도 및 SEO 최적화

Security

middleware.ts: 인증 여부 기반 라우트 보호 및 자동 리다이렉션

Content Security Policy (CSP)

next.config.ts 내 보안 설정

외부 도메인(카카오 등) 허용 정책 포함

  1. 배포 정보 (Deployment) 서비스 URL

EC2 Main: https://knowwhohow.site

Vercel: https://fisa-main-project.vercel.app

Environment Variables

.env 파일에서 관리

NEXT_PUBLIC_API_BASE_URL: 백엔드 메인 API 서버 주소

NEXT_PUBLIC_KAKAO_CLIENT_ID: 카카오 소셜 로그인 키

NEXT_PUBLIC_AI_BASE_URL: AI 서버 주소

8. 실행 가이드 (Local Development)

요구 사항 (Prerequisites)

Node.js 18.17.0 이상

npm

설치 및 실행

📦 패키지 설치

npm install

개발 서버 실행

npm run dev

🏗️ 프로덕션 빌드 npm run build npm start