포트폴리오의 ‘완성도’는 화면이 화려한 정도만 뜻하지 않습니다. 다른 사람이 결과물을 열고 설명을 이해하며 기본 기능을 다시 실행할 수 있는지가 중요합니다. 네 영역으로 나눠 점검하세요.
기능
대표 사용자 흐름이 끝까지 동작하고, 빈 입력·오류·데이터 없음 상태가 처리되는지 확인합니다. 구현하지 않은 기능을 목업 화면으로 보여 준다면 예시임을 명확히 표시하세요.
문서와 테스트
프로젝트 목적, 본인 기여, 실행 명령, 필요한 환경, 테스트 방법을 README에 적습니다. GitHub README 안내를 참고하고, 안내를 따라 새로운 환경에서 실행해 보세요. 자동 테스트가 없다면 수동 확인 절차를 기록합니다.
보안과 공개 범위
비밀 키, 토큰, 고객·팀의 비공개 자료가 저장소나 화면 캡처에 없는지 확인합니다. 오류 로그에 개인 정보가 보이지 않는지도 살핍니다. 비공개 저장소를 포트폴리오 링크로 적었다면 검토자가 열 수 없습니다.
접근성과 유지
휴대전화와 키보드로 핵심 기능을 시험하고 입력 폼에 레이블과 오류 설명을 넣습니다. W3C 폼 접근성 가이드를 참고하세요. 오래된 라이브러리, 깨진 링크, 만료된 배포 환경도 점검합니다.
모든 항목을 한 번에 완벽하게 만들기보다 남은 한계를 공개하고 우선순위를 정하세요. 증상별 수정 방법은 포트폴리오 문제 진단에서 이어집니다.