[GreenWear 개발일지] 백엔드 API 개발 & 통합 작업 회고록 (2025.07.09)
안녕하세요, 김기성입니다.오늘은 제가 개발 중인 친환경 패션 전자상거래 플랫폼 GreenWear의 백엔드 API 개발과 통합 작업 과정을 기록해둡니다.어찌저찌 스프링 부트 서버까지 띄워두긴 했지만, 그 과정에서 경로 문제와 각종 오류에 막히며 고생했던 하루였네요.
ｇｉｔ주소： https://github.com/saway126/greaenwear
GitHub - saway126/greaenwear Contribute to saway126/greaenwear development by creating an account on GitHub. github.com
📌 프로젝트 소개GreenWear는 친환경 의류를 판매하는 전자상거래 플랫폼입니다.환경 점수, 재활용 함량, 인증 여부 등을 제품 데이터에 담아 지속 가능한 패션의 가치를 전하고자 기획했습니다.
“지속 가능한 패션의 미래를 기술로 만들어간다.”
💻 Frontend: Vue.js 3🖋️ Backend: Spring Boot 3.5.3🗄️ Database: H2 (개발 단계)
✍️ 오늘의 작업 로그１。 백엔드 아키텍처 구축JWT 기반 인증과 Spring Security를 적용해 보안과 인증 체계를 잡았습니다.RESTful API로 회원가입, 로그인, 제품 CRUD, 헬스체크까지 엔드포인트를 설계하고 구현했습니다.２。 데이터 모델링친환경 제품의 특성을 표현할 수 있도록 엔티티 설계를 진행했습니다.
ecoRating, recycledContent, organicCertified, fairTradeCertified 등 환경 관련 필드를 추가
３。 프론트엔드 연동Axios 서비스 계층에 JWT 인터셉터를 붙여 Vue 컴포넌트와 백엔드 API를 연결했습니다.로그인, 회원가입, 제품 목록 API까지 프론트와 연동 완료.
🔧 해결한 문제들Spring Boot 3.x 마이그레이션 이슈
deprecated된 .cors().and() 문법 → .cors(cors -> cors.configurationSource(…))로 변경
JWT 필터 오류
@NonNull 어노테이션 누락으로 컴파일 에러 → 빠르게 수정
Windows PowerShell 명령어 오류
Linux 스타일 명령어(q, &&)를 써서 실행 불가 → PowerShell에 맞는 명령으로 대체
🧨 힘들었던 점이번 작업에서 제일 답답했던 건 커서가 파일 경로나 빌드 경로를 제대로 못 찾는 문제였습니다.Spring Boot 서버는 실행됐지만, 빌드 과정에서 디렉토리 구조를 못 찾거나 null 오류가 터지는 상황이 반복됐습니다.오류 메시지를 검색하고 디렉토리 상태를 하나하나 점검하면서 결국은 원인을 찾았지만,
“AI를 쓰면 더 빨라질 줄 알았는데, 오히려 경로를 못 잡아 답답할 때가 있구나”라는 걸 크게 느꼈던 순간이었습니다.
앞으로는 디렉토리 구조와 파일 경로를 명확히 이해하고, 커서를 “학습”시키는 방법(예: .vscode/settings.json 수정, 터미널 경로 지정)을 따로 연습해야겠다고 다짐했습니다.
🌟 주요 성과✅ Spring Boot 백엔드 API 시스템 구축✅ JWT 인증 체계 적용✅ 프론트(Vue)와 API 연동✅ H2 DB 초기 데이터 설정✅ README 최신화 및 문서화✅ GitHub backend-api-development 브랜치에 푸시 완료
git push -u origin backend-api-development Pull Request 생성:https://github.com/saway126/greaenwear/pull/new/backend-api-development
📊 현재 상태 요약백엔드: 90% 완료 (API 구현 & 테스트 필요)프론트엔드: 80% 완료 (API 연동 코드 완성)데이터베이스: 100% 완료 (H2 DB 구성 & 데이터 세팅)문서화: 100% 완료 (개발일지, README 최신화)
💡 클로드 AI와의 협업 경험이번 백엔드의 초안은 클로드 AI가 작성한 코드로 시작했습니다.빠르게 구조를 잡고 진행할 수 있었지만, 역시 AI가 작성한 코드라서 제가 직접 로직을 이해하고 수정해가며 학습하는 과정이 필요했습니다.AI를 잘 활용하면 생산성이 올라가지만, 결국 이해와 유지보수는 사람의 몫이라는 것을 다시 한번 느꼈습니다.
🌱 배운 점과 회고👍 잘한 점보안을 고려한 JWT 인증 시스템 구축친환경 데이터 모델링을 고민한 점디버깅 과정에서 하나씩 검증하며 차근차근 진행한 점🥲 아쉬운 점초기 환경 설정에 생각보다 시간을 너무 많이 소모경로 문제와 빌드 과정에 대한 이해 부족커서와의 연계 및 학습이 미흡AI가 작성한 코드를 그대로 가져다 쓰기보다는, 이해하고 내 것으로 만드는 연습이 필요하다는 점🔷 개선 방안디렉토리와 경로 구조를 명확히 파악해 커서를 효과적으로 학습시키기.vscode 설정 파일과 빌드 스크립트를 표준화Swagger 도입으로 API 문서화 강화Docker 환경 구성으로 빌드 및 실행 일관성 확보
“지속 가능한 패션의 미래를 만들어가는 여정에서, 기술적 도전은 더 나은 개발자로 성장하게 한다.”
오늘 하루도 성장했습니다.읽어주셔서 감사합니다.
🏷️ 해시태그#GreenWear #개발일지 #회고록 #SpringBoot #VueJS #JWT #H2Database #백엔드개발 #커서학습 #클로드AI #AI코드활용 #지속가능한패션 #김기성개발자