본문으로 건너뛰기
개인 프로젝트

개인 포트폴리오 웹사이트

Next.js와 Supabase로 경력·프로젝트를 관리하는 포트폴리오를 개발하고, Vercel 자동 배포와 사용자 도메인을 연결했습니다.

참여 기간
2026.09 – 진행 중
담당 역할
개인 프로젝트 기획·설계·개발·배포
  • Next.js
  • React
  • TypeScript
  • Tailwind CSS
  • Supabase
  • PostgreSQL
  • Vercel

핵심 기여

  • Next.js 서버 컴포넌트와 조회 서비스를 분리해 프로필·경력·프로젝트 데이터 연결
  • MDX 콘텐츠를 PostgreSQL로 이전하고 회사 경력과 프로젝트의 관계 설계
  • Supabase RLS 기반 공개 조회 제어와 Markdown HTML 정제 적용
  • Vercel Git 자동 배포 및 사용자 도메인·DNS 연결

프로젝트 개요

회사 경력과 프로젝트 경험을 웹으로 공개하고, 향후 직접 콘텐츠를 편집할 수 있는 개인 포트폴리오를 구축했습니다. React·Vite 경험을 바탕으로 Next.js의 서버 컴포넌트와 배포 구조를 학습하며 개발했습니다.

주요 작업

1. 페이지와 컴포넌트 역할 분리

라우팅과 서버 데이터 조회는 app, 페이지 조합은 views, 도메인 기능은 features, 공통 레이아웃과 내비게이션은 common으로 나누었습니다. 회사 경력과 프로젝트 상세를 별도 경로로 구성하고 사이드바로 연결했습니다.

2. MDX에서 PostgreSQL로 콘텐츠 이전

초기에는 MDX로 프로젝트를 정리했으나 관리자 편집을 고려해 콘텐츠를 DB로 이전했습니다. 프로필, 회사 경력, 프로젝트를 테이블로 분리하고 회사 경력과 프로젝트를 1:N 관계로 연결했습니다. 개인 프로젝트는 회사 FK 없이 구분합니다.

기존 프로젝트 5개의 메타데이터와 본문을 이전하고 원본과 저장값을 대조했습니다. MDX 파일은 원본 자료로 보존하며 화면에서는 DB 데이터를 조회합니다.

3. 서버 조회와 공개 범위 제어

서버 컴포넌트가 조회 서비스를 호출해 Supabase 데이터를 화면에 전달하도록 구성했습니다. 사용 여부와 노출 여부가 모두 Y인 행만 조회하도록 RLS를 설정하고, 회사 프로젝트는 연결된 경력의 공개 상태도 확인합니다. 일반 사용자의 DB 쓰기는 차단했습니다.

4. Markdown 상세 본문 렌더링

DB 본문은 실행 가능한 MDX로 처리하지 않고 Markdown으로 렌더링합니다. HTML 정제를 적용하면서 접기·펼치기를 유지하고, 페이지 제목과 본문의 H1이 중복되지 않도록 처리했습니다.

5. 배포와 검증

Vercel에 Git 저장소를 연결하고 환경변수를 등록해 배포했습니다. 사용자 도메인의 DNS A·TXT 레코드 설정과 소유권 확인을 거쳐 운영 주소를 연결했습니다.

프로필·경력의 실제 DB 조회와 화면 바인딩, 프로젝트 상세와 접기 영역, 존재하지 않는 경로의 404 응답을 검증했습니다. lint와 프로덕션 빌드도 확인했습니다.

개발 방식

AI 코딩 도구를 활용해 구현과 검증을 진행했습니다. 콘텐츠 관리 방식, 화면 구성, 테이블 정의와 공개 정책을 단계적으로 검토하며 개발했습니다.

향후 개선

  • Supabase Auth 기반 관리자 로그인과 관리자 권한 검사
  • 프로필·회사 경력·프로젝트 편집 화면
  • 서버 리전과 응답 시간 측정, 콘텐츠 캐시 정책 검토

관리자 인증·편집과 성능 최적화는 아직 구현 성과에 포함하지 않습니다.

링크

← 경력 요약으로