Quartz 4

포트폴리오 관리 가이드

6 min read

포트폴리오 관리 가이드

✅ 새 프로젝트 추가 체크리스트

1. 프로젝트 문서 작성

  • _templates/프로젝트-템플릿.md 복사
  • 적절한 카테고리 폴더에 배치
  • 프로젝트 기본 정보 작성
    • 제목, 기간, 상태
    • 기술 스택
    • 개요 및 주요 기능
  • 문제/솔루션 명확히 기술
  • 구현 내용 상세 작성
  • 성과 지표 추가
  • 스크린샷/데모 추가 (가능하면)

2. 메인 README 업데이트

  • Portfolio/README.md에 프로젝트 링크 추가
  • 카테고리별로 적절히 배치
  • 최종 업데이트 날짜 수정

3. 기술 스택 업데이트

  • 04-기술스택/기술스택-및-경험.md 업데이트
  • 새로 사용한 기술 추가
  • 숙련도 레벨 조정

4. 태그 관리

  • 일관된 태그 사용
  • 프로젝트 간 연관성 표시

5. Git 커밋

git add .
git commit -m "Add: [프로젝트명] 포트폴리오 추가"
git push

🔄 정기 유지보수

월간 (매월 마지막 주)

  • 진행 중인 프로젝트 상태 업데이트
  • 완료된 프로젝트 성과 지표 추가
  • 깨진 링크 확인 및 수정
  • 기술 스택 숙련도 재평가

분기별 (3개월마다)

  • 전체 포트폴리오 리뷰
  • 오래된 프로젝트 아카이빙 검토
  • 새로운 카테고리 필요성 검토
  • 포트폴리오 구조 개선

프로젝트 완료 시

  • 상태를 “완료” 또는 “운영중”으로 변경
  • 최종 성과 지표 업데이트
  • “배운 점” 섹션 작성
  • 관련 링크 모두 추가
  • 스크린샷/데모 추가

📝 작성 가이드라인

제목 및 설명

  • 명확하고 구체적인 제목 사용
  • 첫 문장에서 핵심 가치 전달
  • 기술 용어는 간단한 설명 추가

문제/솔루션 작성

  • 문제: 구체적인 pain point 명시
  • 솔루션: 어떻게 해결했는지, 왜 그 방법을 선택했는지

기술 스택

  • 주요 기술만 나열 (너무 많으면 희석)
  • 역할별로 그룹핑 (Backend, AI/ML, DevOps 등)

구현 내용

  • 핵심 기능 중심으로 3-5개 항목
  • 가능하면 코드 스니펫 추가
  • 기술적 도전과 해결 과정 포함

성과 지표

  • 정량적 지표 우선 (%, 시간, 개수 등)
  • 비교 기준 명확히 (Before/After)
  • 없으면 정성적 성과라도 기록

🎯 품질 체크리스트

각 프로젝트 문서가 다음을 포함하는가?

  • 명확한 문제 정의
  • 구체적인 솔루션 설명
  • 사용한 기술과 이유
  • 측정 가능한 성과
  • 기술적 도전과 해결
  • 배운 점과 인사이트

가독성

  • 적절한 헤딩 구조 (H2, H3)
  • 간결하고 명확한 문장
  • 불필요한 기술 용어 남발 지양
  • 시각 자료 활용 (스크린샷, 다이어그램)

일관성

  • 모든 프로젝트가 유사한 구조
  • 태그 체계 일관성
  • 날짜 형식 통일
  • 링크 형식 통일

🔍 자주 확인할 사항

링크

# 깨진 링크 확인 (Obsidian에서)
# View > Developer > Toggle developer tools
# Console에서 링크 에러 확인

이미지

  • 모든 이미지가 Portfolio 폴더 내에 있는가?
  • 이미지 경로가 올바른가?
  • 이미지 크기가 적절한가? (너무 크면 로딩 느림)

메타데이터

  • Frontmatter가 올바르게 작성되었나?
  • 태그가 일관되게 사용되었나?
  • 상태가 정확한가?

📊 진행 상황 추적

현재 상태 (수시 업데이트)

TABLE status as "상태", period as "기간", tech_stack as "기술"
FROM "Portfolio"
WHERE file.name != "README"
SORT status ASC, file.name ASC

카테고리별 프로젝트 수

  • 교육기술시스템: [개수]
  • 자동화-DevOps: [개수]
  • AI-ML통합: [개수]
  • 기타: [개수]

🚀 배포 전 최종 체크

  • 모든 프로젝트 링크 동작 확인
  • 개인정보/민감정보 제거 확인
  • 스크린샷에 민감정보 없는지 확인
  • GitHub 저장소 공개 설정 확인
  • README.md 연락처 정보 업데이트
  • 로컬에서 빌드 테스트 (npx quartz build --serve)
  • 모바일 반응형 확인

최종 업데이트: 2025-01-21

Graph View