docs(bok): Replace boilerplate docstrings with detailed API documentation (#289)

[yeongseon]

Summary

Closes #289

모든 BokAdapter 메서드의 무의미한 boilerplate docstring을 실제 동작 기반 한국어 문서로 전면 교체했습니다.

Changes

• src/kpubdata/providers/bok/adapter.py의 모든 public/private 메서드 docstring 업데이트
• 각 메서드가 호출하는 BOK ECOS API 엔드포인트 명시
• 매개변수, 반환값, 예외 상황 상세 설명 추가
• ECOS API 호출 형식 (frequency, start_date, end_date 등) 문서화

Quality Gate

• ✅ uv run ruff check . - passed
• ✅ uv run ruff format --check . - passed
• ✅ uv run mypy src - passed
• ✅ uv run pytest - 1009 passed

Example

Before:

def query_records(self, dataset: DatasetRef, query: Query) -> RecordBatch:
    """records을 수행한다."""

After:

def query_records(self, dataset: DatasetRef, query: Query) -> RecordBatch:
    """BOK ECOS API를 호출하여 레코드를 조회한다.

    매개변수:
        dataset: 대상 데이터셋.
        query: 조회 쿼리. start_date, end_date 필수. 주기(frequency)는 선택.

    반환값:
        RecordBatch. items에 조회된 레코드, total_count와 next_page 포함.

    예외:
        InvalidRequestError: start_date 또는 end_date 누락 시.
        AuthError: API 키 인증 실패 시.
        RateLimitError: 호출 한도 초과 시.
        ServiceUnavailableError: BOK ECOS 서비스 점검 중일 때.
    """