Unimarc/unimarc/CLAUDE.md

⚠️ 중요: 대화 시작시 이 파일을 반드시 읽으세요!

답변은 가급적이면 한글로!

UniMarc 프로젝트 - Claude 작업 가이드

Claude에게: 대화를 시작할 때마다 이 파일을 먼저 읽어서 프로젝트 컨텍스트를 파악하세요.

프로젝트 개요

• 프로젝트명: UniMarc (도서관 자료 관리 시스템)
• 기술스택: C# WinForms, .NET Framework 4.7.2
• 데이터베이스: MySQL
• 주요기능: 마크 작성, 복본조사, DLS 연동, 도서 정보 관리

데이터베이스 정보

• Server=1.215.250.130;Port=3306;Database=unimarc;uid=root;pwd=Admin21234;

코딩 컨벤션

• 파일명: PascalCase (예: DLS_Copy.cs)
• 클래스명: PascalCase
• 메서드명: PascalCase
• 변수명: camelCase
• 상수명: UPPER_CASE

주요 디렉토리 구조

• /마크/: 마크 관련 폼들
• /납품관리/: 납품 관리 관련 폼들
• /마스터/: 마스터 데이터 관리 폼들
• /홈/: 메인 화면 관련 폼들
• /회계/: 회계 관련 폼들

개발 시 주의사항

1. WebView2 사용 시 async/await 패턴 적용
2. 데이터베이스 연결은 Helper_DB 클래스 사용
3. 에러 처리는 try-catch 블록으로 처리
4. 한글 주석 사용

빌드 및 배포

• Visual Studio 2019 이상 필요
• NuGet 패키지 복원 후 빌드
• WebView2 런타임 필요
• NetFX 프로젝트이므로 dotnet 명령은 사용 불가

MsBuild 실행파일 위치 (경로에 공백이 있으니 쌍따옴표로 감싸야 함)

매개변수 입력할때 platform 은 제거하고 그냥 프로젝트명만 입력

F:(VHD) Program Files\Microsoft Visual Studio\2022\MSBuild\Current\Bin\msbuild.exe

프로젝트 파일명

UniMarc.csproj

도서관 검색기(크롤링) 클래스 작성 가이드

개요

도서관 웹사이트에서 도서 검색 결과를 크롤링하는 클래스들을 구현합니다. 각 도서관 사이트의 특성에 따라 HTTP 방식 또는 Selenium 방식을 선택합니다.

방식 선택 기준

• HTTP 방식: URL이 변경되는 사이트 (GET 파라미터로 검색)
• Selenium 방식: URL이 변경되지 않는 사이트 (POST 폼 제출)

1. HTTP 방식 (GET 요청)

참고 파일: SuncheonLibSearcher.cs

특징:

• HttpClient 사용
• URL 파라미터로 검색
• 빠른 실행 속도
• HttpApiMode = true

주요 구현 포인트:

// URL 구성
var searchUrl = $"{SiteUrl}?search={encodedSearchTerm}&libCode={AreaCode}";

// HTTP 헤더 추가 (500 에러 방지)
request.Headers.Add("User-Agent", "Mozilla/5.0...");
request.Headers.Add("Accept", "text/html,application/xhtml+xml...");

// HTML에서 결과 수 정규식 추출
var patterns = new[] {
    @"총\s*<strong[^>]*class=""cred""[^>]*>(\d+)</strong>\s*건"
};

2. Selenium 방식 (크롤링)

참고 파일: GwangjuCityLibSearcher.cs

특징:

• Selenium WebDriver 사용
• 폼 제출 방식
• 복잡한 UI 상호작용 가능
• HttpApiMode = false

주요 구현 포인트:

// 도서관 선택 (드롭다운)
var libSelect = wait.Until(d => d.FindElement(By.CssSelector("select[name='libCode']")));
var selectElement = new SelectElement(libSelect);
selectElement.SelectByValue(AreaCode);

// 검색어 입력
var searchInput = wait.Until(d => d.FindElement(By.Id("bookSearchQuery")));
searchInput.Clear();
searchInput.SendKeys(searchTerm);

// 검색 버튼 클릭
var searchButton = wait.Until(d => d.FindElement(By.CssSelector("button.bookSearchBtn")));
searchButton.Click();

// 페이지 로딩 대기
await WaitForPageChange(wait);

3. 공통 인터페이스 구현

모든 검색기는 ILibrarySearcher 인터페이스를 구현해야 합니다:

public interface ILibrarySearcher
{
    Task<BookSearchResult> SearchAsync(string searchTerm);
    Task StartDriver(bool showdriver = false);
    void StopDriver();
    string SiteName { get; }
    string SiteUrl { get; }
    bool HttpApiMode { get; set; }
    int No { get; set; }
}

4. Check_copyWD.cs에 등록

새로운 검색기를 만든 후 반드시 Check_copyWD.cs의 생성자에 추가:

// 예시: 완도군립도서관
idx = 1200;
_searchService.AddSearcher(new WandoLibSearcher(idx++, "MA", "완도군립도서관"));
_searchService.AddSearcher(new WandoLibSearcher(idx++, "MB", "노화공공도서관"));

5. 결과 추출 패턴

HTML에서 검색 결과 수를 추출하는 일반적인 패턴들:

var patterns = new[] {
    @"총\s*<strong[^>]*>(\d+)</strong>\s*건",
    @"검색결과\s*총\s*(\d+)\s*건",
    @"<span[^>]*class=""heighlight""[^>]*>(\d+)</span>",
    @"총\s*(\d+)\s*권\(개\)"
};

6. 에러 처리

• 검색 결과 없음: return 0
• 추출 실패: return -1
• 예외 발생: BookSearchResult의 ErrorMessage에 설정

현재 구현된 검색기 목록

1. HTTP 방식: SuncheonLibSearcher, MokpoLibSearcher, GwangsanLibSearcher, YeosuLibSearcher
2. Selenium 방식: GwangjuCityLibSearcher, GoheungLibSearcher, BukguLibSearcher 계열, JeonbukEduLibSearcher

각 방식의 장단점을 고려하여 사이트 특성에 맞는 방식을 선택하여 구현하세요.