# 단축 URL 설계

## 1. 교재 근거와 범위

- 교재/판본:
- 읽은 장·절(페이지는 직접 확인):
- 책에 명시된 필수 요구:
- 수업 추가 필수: 직접 작성한 QA 체크리스트·실제 검증·Git 기록
- 선택: AI 프론트
- 선택 기능:
- 내가 정한 가정과 이유(중복·충돌 등):
- 미해결 질문:

## 2. 사용자 흐름과 선택 화면

원본 URL 입력 → 생성 요청 → 결과 표시/복사 → 링크 클릭 → 원본 이동

순수 HTML·CSS·JavaScript만 사용합니다. 외부 라이브러리·프레임워크·CDN은 사용하지 않습니다.

- 입력 영역/버튼:
- 로딩 중 표시와 버튼 상태:
- 성공 결과와 복사 실패 대안:
- 입력 오류/서버 오류/네트워크 오류:

## 3. 데이터와 책임

| 구성 | 책임 | 다른 구성과 협력 |
| --- | --- | --- |
| 도메인 | 직접 작성 | 직접 작성 |
| Controller | 직접 작성 | 직접 작성 |
| Service | 직접 작성 | 직접 작성 |
| Repository | 직접 작성 | 직접 작성 |

## 4. 실제 API 계약

| 기능 | 메서드·경로 | 입력 | 성공 상태·헤더·본문 | 실패 조건·응답 |
| --- | --- | --- | --- | --- |
| 생성 | 직접 설계 | 직접 설계 | 직접 설계 | 직접 설계 |
| 원본 이동 | 직접 설계 | 직접 설계 | 3xx/Location 정책 명시 | 직접 설계 |

- 요청/성공/오류 JSON 실제 예:
- 생성 응답 Location의 의미(사용한다면):
- 이동 응답 Location의 의미:
- 프론트에서 사용할 상대 경로:
- HTTP/HTTPS URL 제한 정책(수업 권장, 책 명시와 구분):

## 5. 테스트 계획

정상·실패·경계마다 준비/실행/기대 상태·헤더·본문·저장 상태를 작성합니다.

## 6. 구현 순서와 피드백

- 첫 최소 기능:
- 테스트/실패 처리:
- 프론트 연결:
- 동료 피드백과 반영:
