저장소 지도

최신 안정판 Image 0.3.0 릴리스 기준

0.3.0 릴리스에는 Gradle 프로젝트 15개가 있다. 9개는 Maven 좌표로 배포하고, 5개는 실행 예제이며, 1개는 벤치마크 프로젝트다. 프로젝트 디렉터리와 Gradle 경로, 아티팩트 이름이 항상 같지는 않으므로 릴리스의 settings.gradle.kts를 정확한 목록으로 삼는다.

플랫폼과 기반

Image BOM은 이미지 라이브러리 아티팩트 8개의 버전을 맞춘다.
불변 이미지 처리는 Scrimage와 Java2D를 쓰는 JVM 기반 모듈이다. CAPTCHA, OCR, Ktor, Spring Boot와 libvips API의 테스트 이미지가 이 모듈을 사용한다.

기능과 프레임워크

CAPTCHA는 챌린지 생성과 검증 규칙을 맡는다.
OCR은 Tess4J/Tesseract를 ImmutableImage에 연결한다.
Ktor 라우트는 썸네일과 CAPTCHA 엔드포인트를 제공한다.
Spring Boot는 저장소, CDN, 상태 점검과 메트릭을 구성한다.

Native 처리

Vips API는 VipsImage, VipsRuntime, 포맷, 작성기와 수명 주기 규칙을 정의한다.
Java 21 JVips는 JNI로 공통 API를 구현한다.
Java 25 FFM은 Foreign Function and Memory API로 구현한다.

공통 API가 애플리케이션 대신 백엔드를 고르거나 초기화하지는 않는다. 측정된 마이그레이션 요구가 없다면 런타임 구현은 하나만 배포한다.

학습하고 측정하기

워크숍 5개는 JVM 기본 처리, Ktor 이미지/CAPTCHA, Ktor OCR, Spring Boot 스토리지, Spring Boot OCR을 다룬다. 벤치마크 프로젝트는 처리와 I/O 경로를 비교하지만 라이브러리로 배포하지 않는다.

프로젝트를 이름순으로 읽기보다 학습 경로에서 목적에 맞는 순서를 고르는 편이 빠르다.

배포본 다이어그램

아래 그림은 0.3.0 배포본의 README 자산을 해당 배포 커밋에서 직접 불러옵니다. 이후 SNAPSHOT이 아니라 이 매뉴얼 버전의 구조와 실행 흐름을 보여 줍니다. 미리보기를 누르면 같은 배포 커밋의 SVG 원본이 열립니다.

Bluetape4k Image 아키텍처

배포본 README: README.ko.md

Bluetape4k Image 개요