PR #184: improve: cleanup internal APIs, fix UTF-8 truncation, and update UI docs

항목	내용
PR	#184
병합일	2026-03-21
영향 범위	Go internal packages, Docs, Helm chart

변경 사항

• aero_info.go의 패키지 내부 전용 함수 5개를 unexport 처리
• truncateUTF8() 함수 추가 -- 멀티바이트 문자를 깨뜨리지 않고 에러 메시지를 안전하게 truncation (한국어 텍스트 손상 방지)
• enrichStatusWithAerospikeInfo에서 3개의 별도 Aerospike 클라이언트 연결을 1개로 통합 (성능 개선)
• 미사용 코드 제거: TransientError 타입, NewValidation(), deprecated DeleteOrphanedPVCs, ParseImageVersion/CompareVersions
• TestTruncateUTF8 테스트 추가 (한국어 문자 경계 테스트 포함)
• UI 가이드 문서 업데이트: Cluster List, Edit Dialog, Config Drift 섹션 추가

기술적 세부사항

UTF-8 안전 truncation

Kubernetes status 메시지의 길이 제한으로 인해 에러 메시지를 truncation해야 하는 경우가 있다. 기존에는 바이트 단위로 단순 자르기를 수행하여 멀티바이트 문자(한국어 등)의 중간에서 잘리는 문제가 발생했다. truncateUTF8() 함수는 UTF-8 문자 경계를 존중하여 안전하게 truncation한다.

클라이언트 연결 통합

enrichStatusWithAerospikeInfo 함수에서 node info, namespace info, set info를 각각 별도 연결로 조회하던 것을 단일 연결로 통합하여 네트워크 오버헤드를 줄였다.

코드 정리

internal/errors, internal/storage, internal/utils 패키지에서 미사용 코드를 제거하였다. 특히 version.go의 ParseImageVersion/CompareVersions와 관련 테스트 80줄, pvc.go의 DeleteOrphanedPVCs 28줄이 완전히 삭제되었다.

영향

• 한국어 등 멀티바이트 문자가 포함된 상태 메시지가 안전하게 처리됨
• Aerospike 클라이언트 연결 수가 1/3로 감소하여 reconcile 성능 개선
• 내부 API 표면이 축소되어 유지보수성 향상
• 10개 Go 패키지 테스트 전체 통과