⚡ Bolt: Hex 문자열 변환 성능 최적화

.jules/bolt.md

@@ -0,0 +1,3 @@
+## 2026-06-28 - Fast Hex String Conversion
+**Learning:** Using `String.format("%02x", b)` inside a loop for converting byte arrays to hex strings is a significant performance bottleneck due to string parsing overhead per byte.
+**Action:** Use `java.util.HexFormat.of().formatHex(bytes)` instead for a massive performance improvement when converting byte arrays to hex strings in Java 17+.

CHANGELOG.md

@@ -0,0 +1,5 @@
+# 변경 사항
+
+## [Unreleased]
+### 성능 개선 (Performance)
+- `DefaultDocumentConversionService` 내부의 `String.format` 루프를 사용하던 비효율적인 Hex 문자열 변환 로직을 `java.util.HexFormat`을 사용하도록 변경하여 성능 크게 최적화

src/main/java/com/clearfolio/viewer/service/DefaultDocumentConversionService.java

@@ -121,12 +121,8 @@ private String contentHash(MultipartFile file) {
             }
 
             byte[] raw = digest.digest();
-            StringBuilder hex = new StringBuilder(raw.length * 2);
-            for (byte b : raw) {
-                hex.append(String.format("%02x", b));
-            }
-
-            return hex.toString();
+            // HexFormat is faster than String.format
+            return java.util.HexFormat.of().formatHex(raw);
         } catch (NoSuchAlgorithmException ex) {
             throw new IllegalStateException("SHA-256 digest unavailable", ex);
         } catch (IOException ex) {