# 네이버 단축 URL 자동 처리 가이드

## 개요
네이버 단축 URL(naver.me)에서 식당 정보를 자동으로 추출하는 통합 기능 가이드입니다.
이제 단축 URL 입력 시 자동으로 최적의 식당 정보를 가져옵니다.

## 구현된 기능

### 1. 단축 URL 자동 처리 플로우
1. 단축 URL 리다이렉션
2. Place ID 추출 (10자리 숫자)
3. `pcmap.place.naver.com/restaurant/{ID}/home`에서 한글 텍스트 추출
4. 추출된 상호명으로 네이버 로컬 검색 API 호출
5. Place ID가 일치하는 결과 우선 선택 (없으면 첫 번째 결과)
6. 정확한 식당 정보로 Restaurant 객체 생성

### 2. 주요 메서드

#### NaverApiClient
```dart
// 단축 URL을 최종 URL로 변환
Future<String> resolveShortUrl(String shortUrl)

// Place ID로 한글 텍스트 추출
Future<Map<String, dynamic>> fetchKoreanTextsFromPcmap(String placeId)
```

#### NaverMapParser
```dart
// 단축 URL 전용 향상된 파싱 메서드
Future<Restaurant> _parseWithLocalSearch(
  String placeId,
  String finalUrl,
  double? userLatitude,
  double? userLongitude,
)
```
- 단축 URL 감지 시 자동으로 향상된 파싱 실행
- 로컬 검색 API를 통한 정확한 정보 획득

## 테스트 방법

### 1. 예제 테스트 실행
```bash
# test/naver_short_url_example.dart 파일 수정
# shortUrl 변수에 실제 네이버 단축 URL 입력

# 테스트 실행
flutter test test/naver_short_url_example.dart
```

### 2. 출력 예시
```
========== 네이버 단축 URL 한글 추출 테스트 ==========
입력 URL: https://naver.me/xxxxxx

✓ 리다이렉션 완료
  최종 URL: https://map.naver.com/p/entry/place/1234567890

✓ Place ID 추출 완료
  ID: 1234567890

【한글 텍스트 리스트】
① 맛있는 식당
② 서울특별시 강남구 테헤란로 123
③ 한식
④ 영업시간 월요일
⑤ 전화번호
...

【추가 추출 정보】
📍 JSON-LD 상호명: 맛있는 식당
```

### 3. 앱에서 사용 시
AddRestaurantDialog에서 네이버 URL 입력 시 자동으로 디버깅 로그가 출력됩니다.

## 한글 리스트 분석 방법

### 상호명 찾기
- 보통 리스트 상단(인덱스 0-5)에 위치
- JSON-LD 또는 Apollo State에서 추출된 상호명 우선 확인
- 카테고리나 주소가 아닌 독립적인 이름

### 주소 찾기
- "서울", "경기", "인천" 등 지역명이 포함된 텍스트
- "구", "동", "로", "길" 등의 주소 키워드 포함
- 보통 상호명 다음에 위치

### 기타 정보
- 카테고리: "한식", "중식", "카페" 등
- 영업시간: "영업시간", "오전", "오후" 포함
- 전화번호: 숫자와 하이픈 패턴

## 필터링된 UI 텍스트
다음과 같은 UI 관련 텍스트는 자동으로 필터링됩니다:
- 로그인, 메뉴, 검색, 지도, 리뷰
- 네이버, 플레이스
- 영업시간, 전화번호 (라벨)
- 더보기, 접기, 펼치기
- 기타 일반적인 UI 텍스트

## 주의사항
1. 네트워크 상황에 따라 지연이 발생할 수 있습니다
2. 429 에러(Rate Limit) 발생 시 잠시 후 재시도하세요
3. 웹 환경에서는 CORS 프록시를 통해 요청됩니다

## 네이버 로컬 검색 API 연동

### API 응답 형식
네이버 로컬 검색 API는 **JSON 형식**으로 응답합니다:

```json
{
  "items": [
    {
      "title": "<b>상호명</b>",
      "link": "https://map.naver.com/...",
      "category": "한식>갈비",
      "description": "설명",
      "telephone": "02-1234-5678",
      "address": "서울특별시 강남구",
      "roadAddress": "서울특별시 강남구 테헤란로 123",
      "mapx": "1269784147",
      "mapy": "375665805"
    }
  ]
}
```

### 첫 번째 한글 텍스트로 검색
추출된 한글 텍스트의 첫 번째 항목(상호명으로 추정)을 사용하여 네이버 로컬 검색 API를 호출할 수 있습니다.
이를 통해 정확한 식당 정보를 검증할 수 있습니다.

### 사용 예시
```dart
// 첫 번째 한글 텍스트로 검색
final firstKoreanText = koreanTexts.first;
final searchResults = await apiClient.searchLocal(
  query: firstKoreanText,
  display: 5,
);

// 결과 확인
for (final result in searchResults) {
  print('상호명: ${result.title}');
  print('주소: ${result.roadAddress}');
  print('Place ID: ${result.link}');
}
```

## 아키텍처 개선 사항

### 1. 코드 구조 개선
- **NaverHtmlExtractor**: HTML 파싱 로직을 별도 클래스로 분리
- **중복 코드 제거**: NaverApiClient에서 HTML 파싱 메서드 제거
- **관심사 분리**: API 호출, HTML 파싱, 데이터 처리를 명확히 분리

### 2. 자동화된 처리
- 단축 URL 입력 시 자동으로 최적의 식당 정보 추출
- Place ID 매칭을 통한 정확도 향상
- 사용자 개입 없이 완전 자동 처리

### 3. UI/UX 개선
- AddRestaurantDialog에 JSON 형식으로 결과 표시
- 각 필드 수정 가능
- 시각적으로 개선된 레이아웃

## 향후 개선 방향
1. 머신러닝을 통한 상호명 추출 정확도 향상
2. 더 많은 메타데이터 추출 (리뷰, 평점 등)
3. 오프라인 캐싱 지원
4. 다른 지도 서비스 지원 추가