본문 바로가기

포트폴리오48

개발자 문서화 (생각 기록, 협업, 유지보수) 개발 공부를 처음 할 때 저는 코드만 잘 돌아가면 충분하다고 생각했습니다. 문서화는 시간이 남을 때 하는 부가 작업처럼 느껴졌고, README도 형식적으로 적는 정도로 봤습니다. 그런데 몇 달 뒤 제가 만든 코드를 다시 열었을 때, 왜 JWT를 선택했는지, 오류를 어떻게 해결했는지, 어떤 기준으로 구조를 잡았는지 기억나지 않아 당황했습니다. 팀 프로젝트에서도 API 명세나 실행 방법이 정리되지 않으면 같은 질문이 반복되고, 새 팀원이 적응하는 데 시간이 오래 걸렸습니다. 저는 그때 문서화가 단순한 글쓰기가 아니라 개발자의 생각과 문제 해결 과정을 남기는 일이라고 느꼈습니다. 이 글에서는 제 경험을 바탕으로 개발자가 문서화를 잘하면 얻는 장점을 정리해 보겠습니다.개발자 문서화가 내 생각을 기록하는 이유코드.. 2026. 6. 11.
신입 개발자에게 꼭 필요한 Git 협업 (버전관리, 브랜치, 포트폴리오) Git을 처음 배웠을 때 저는 단순히 GitHub에 코드를 저장하는 도구라고 생각했습니다. 하지만 팀 프로젝트를 하면서 Git의 핵심은 저장이 아니라 작업 이력과 협업 흐름을 관리하는 데 있다는 걸 알게 됐습니다. 커밋 메시지를 대충 남기면 나중에 왜 수정했는지 알 수 없었고, 브랜치 없이 작업하면 팀원 코드와 충돌이 생기기 쉬웠습니다. 특히 PR을 통해 내 코드를 설명하고 검토받는 과정은 협업 훈련에 가까웠습니다. 저는 Git이 신입 개발자의 기술 도구를 넘어 작업 태도와 기록 습관을 보여주는 기본기라고 느꼈습니다. 이 글에서는 제 경험을 바탕으로 신입 개발자가 협업을 위해 Git을 꼭 익혀야 하는 이유를 정리해 보겠습니다.신입 개발자에게 꼭 필요한 Git 버전관리, 코드 저장이 아니라 작업 이력입니다.. 2026. 6. 9.
데이터 직무 입문 (지표 이해, 데이터 정제, 실전 팁) 데이터 직무를 처음 준비할 때 저는 통계를 먼저 완벽하게 알아야 한다고 생각했습니다. 평균, 분산, 가설검정 같은 공식부터 붙잡았지만, 실제 데이터를 다뤄보니 더 중요한 것은 데이터가 어디서 생기고 어떤 지표로 해석되는지 이해하는 일이었습니다. 방문자 수가 늘어도 전환율이 떨어지면 좋은 결과가 아닐 수 있고, 결측값이나 중복값을 정리하지 않으면 분석 결과도 흔들릴 수 있었습니다. 저는 통계가 중요하지 않다는 뜻이 아니라, 데이터의 흐름과 지표의 의미를 먼저 알아야 통계도 제대로 활용된다고 느꼈습니다. 이 글에서는 제 경험을 바탕으로 데이터 직무 입문자가 통계보다 먼저 이해하면 좋은 것들을 정리해 보겠습니다.데이터 직무 입문자가 지표 이해부터 해야 하는 이유일반적으로 데이터 직무를 준비한다고 하면 통계부터.. 2026. 6. 9.
IT 개발자 배포란? (로컬 실행, 운영 환경, CI/CD) 배포를 처음 시도했을 때 저는 완성된 코드를 서버에 올리기만 하면 끝이라고 생각했습니다. 하지만 로컬에서 잘 돌아가던 서비스가 서버에서는 환경 변수 누락, 포트 설정, 데이터베이스 연결 문제로 멈추는 경험을 하며 배포가 단순 업로드가 아니라는 걸 알게 됐습니다. 배포는 사용자가 실제로 접속할 수 있는 운영 환경을 만들고, 오류가 생겼을 때 로그를 확인하며, 필요하면 이전 버전으로 되돌릴 수 있어야 하는 과정입니다. 저는 배포 경험을 통해 개발은 코드 작성에서 끝나는 것이 아니라 서비스 운영까지 이해해야 한다고 느꼈습니다. 이 글에서는 제 경험을 바탕으로 배포의 의미와 입문자가 알아야 할 서비스 운영 개념을 정리해 보겠습니다.IT 개발자 배포와 로컬 실행, 뭐가 다를까배포를 처음 접하는 분들 중에는 로컬 .. 2026. 6. 6.
버전 관리 (커밋, GitHub, 협업) 버전 관리를 처음 배웠을 때 저는 단순히 코드를 GitHub에 저장하는 일이라고 생각했습니다. 하지만 프로젝트를 진행하면서 어제 잘 되던 기능이 갑자기 오류를 내고, 이전 코드로 돌아가고 싶은데 어디를 고쳤는지 기억나지 않는 상황을 겪으며 생각이 달라졌습니다. Git은 단순 백업 도구가 아니라 코드가 언제, 왜, 어떻게 바뀌었는지를 기록하는 개발자의 작업 일지였습니다. 특히 커밋 메시지를 대충 남기면 나중에 제 코드조차 이해하기 어려웠습니다. 저는 버전 관리가 개발 실력만큼 중요한 협업 습관이라고 느꼈습니다. 이 글에서는 제 경험을 바탕으로 버전 관리가 왜 개발자에게 필수인지 정리해 보겠습니다.버전 관리와 커밋, 제대로 이해하고 계신가요?버전 관리란 파일이 언제, 어떻게, 왜 바뀌었는지를 체계적으로 추적.. 2026. 6. 5.
데이터 직무 (직무 구분, 취업 준비, 포트폴리오) 데이터 직무를 처음 준비할 때 저는 SQL과 Python만 배우면 충분하다고 생각했습니다. 하지만 채용 공고를 여러 개 비교해 보니 데이터 엔지니어, 데이터 분석가, 데이터 사이언티스트, BI 분석가는 같은 데이터를 다루더라도 맡는 역할이 전혀 달랐습니다. 데이터를 모으고 흐르게 만드는 일, 수치의 원인을 찾는 일, 예측 모델을 만드는 일, 의사결정자가 보기 쉽게 정리하는 일은 각각 다른 역량을 요구했습니다. 저는 이 차이를 모르고 준비하면 스펙은 쌓이지만 방향은 흐려질 수 있다고 느꼈습니다. 이 글에서는 제 경험을 바탕으로 데이터 직무가 왜 세부 역할로 나뉘는지, 그리고 취업 준비 방향을 어떻게 잡아야 하는지 정리해 보겠습니다.데이터 직무 구분이 생긴 이유데이터 직무가 여러 이름으로 나뉘는 이유는 데이.. 2026. 6. 4.