# 단축 URL API 개발 과제

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

[14일 수업 자료](../../2026-11-14/) · [설계 템플릿](./templates/design.md) · [프론트 기본 설정](./templates/frontend-setup.md) · [프로젝트 README 틀](./templates/project-readme.md)

## 진행과 범위

- 문제에서 요구하는 기능·입출력·예외를 정리하고 API와 데이터 구조를 설계합니다.
- 생성과 원본 이동을 먼저 연결한 뒤 문제의 나머지 요구를 구현합니다.
- 직접 QA 체크리스트를 작성하고 테스트와 실제 요청으로 확인합니다.
- 완료 범위·설계 이유·실패를 해결한 과정을 코드와 결과로 설명합니다.

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

## 수업 구현 기준

- 원본 URL을 등록하고 생성된 단축 URL로 실제 원본 주소에 이동할 수 있어야 합니다.
- Controller는 HTTP 입력·응답, Service는 코드 생성과 업무 규칙, Repository는 저장·조회를 담당합니다.
- 메모리 저장소로 시작해도 됩니다. 메모리는 재시작하면 초기화된다는 점을 README에 기록합니다. 이번 문제 풀이에서 DB/JPA 전환은 필수가 아닙니다.
- 수업의 추가 입력 정책은 http/https 스킴의 절대 주소만 허용하는 것입니다. 백엔드에서 원본 페이지를 다운로드하거나 미리보기를 수집하지 않습니다.
- 원본 이동에는 원본 주소를 Location으로 보내는 리다이렉트를 사용합니다. 생성 응답의 Location과 의미를 구분합니다.
- 정상·실패·경계 사례를 직접 고릅니다. QA 체크리스트에 요청·기대·실제 결과를 적고, 중요한 규칙은 자동 테스트로도 확인합니다.

## 먼저 끝난 교육생 · 선택

본인 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 프론트를 선택했다면 사용 범위와 직접 수정한 내용을 간단히 남깁니다.
