단축 URL API 개발 과제

14일 오전 3시간 동안 교재의 단축 URL 과제 테스트 문제를 개인별로 풉니다. 문제 요구사항을 먼저 확인하고, 구현 중에는 책의 풀이 코드와 완성된 예제를 최대한 보지 않습니다. 막히면 현재 입력·기대 결과·실제 결과를 정리한 뒤 질문합니다.

14일 수업 자료 · 설계 템플릿 · 프론트 기본 설정 · 프로젝트 README 틀

진행과 범위

교재 CH 13의 요구는 다음과 같습니다. 단축 키는 8글자이며, 같은 원본 URL을 다시 등록해도 새 키를 만들고 이전 키도 계속 동작해야 합니다. 원본 이동 횟수를 기록하고 단축 URL 정보 조회 API를 제공합니다. DB 없이 컬렉션으로 저장하며 적절한 자동 테스트를 작성합니다. 프론트는 선택입니다. 수업 중 추가한 입력 정책과 교재 요구는 구분해서 기록합니다. 저자 공식 예제 저장소의 문제 설명이 근거이며, 수업 중에는 문제 설명만 확인합니다. 책의 해설·완성 코드를 옮기는 방식으로 진행하지 않습니다.

수업 구현 기준

먼저 끝난 교육생 · 선택

본인 API에 연결하는 프론트를 AI로 만들어도 됩니다. 순수 HTML·CSS·JavaScript만 사용하고 외부 라이브러리·프레임워크·CDN은 사용하지 않습니다. 프롬프트는 자율입니다. 입력·결과·복사·이동과 오류 처리를 직접 설계합니다.

src/main/resources/static/에 index.html, styles.css, app.js를 두고 실행 중인 Spring Boot의 http://localhost:실제포트/에서 엽니다. 같은 origin의 상대 경로로 API를 호출합니다. API 경로·메서드·JSON 필드가 자신의 백엔드와 일치하도록 수정합니다. 사용자 URL·오류는 textContent로 표시하고, 링크에도 http/https 정책을 적용합니다.

추가 기능은 문제의 필수 기능을 완료한 뒤 선택합니다. 무엇을 확인할지 QA 체크리스트를 직접 작성합니다. 프론트와 추가 기능은 오전 필수 완료 조건이 아닙니다.

GitHub 제출

공용 저장소를 Fork한 개인 sesac-spring-boot-study의 short-url/에 별도 프로젝트를 둡니다. 기존 프로젝트와 문서를 보존하고 중첩 .git은 넣지 않습니다. 브랜치 이름은 자율입니다. 기존 작업이 필요한 경우 해당 구현이 포함된 브랜치에서 시작합니다.

공용 저장소에 Issue를 작성하고, 개인 Fork의 origin에 Push한 뒤 원본 저장소 main을 base, 개인 Fork 작업 브랜치를 head로 PR을 제출합니다. PR에 변경 내용·실제 테스트 결과·미완료 범위·관련 Issue #번호를 적습니다. 수정은 같은 브랜치에 Push합니다. 강사가 검토 후 병합 없이 PR·Issue를 닫습니다.

short-url/README.md에 실행 방법·API·구현 현황·테스트 결과를 적고 루트 README에 프로젝트 링크를 추가합니다. src·Gradle 설정·Wrapper를 포함하고 build/.gradle/IDE/.env·비밀값·로컬 DB 파일은 제외합니다. .gitignore가 Wrapper JAR를 제외한다면 예외를 추가합니다. AI 프론트를 선택했다면 사용 범위와 직접 수정한 내용을 간단히 남깁니다.