콘텐츠로 이동

기술 스택

서버는 Spring Boot API예요. 아래 표는 cowork server/build.gradle 기준이고, 버전은 그 파일에 적힌 값이에요. 버전을 적지 않은 것은 Spring Boot가 버전을 정해요.

Webcraft 백엔드 지침이 전제로 삼는 것이에요.

라이브러리 버전 하는 일
Java 21 언어(Gradle 툴체인)
Spring Boot 4.1.1 Web MVC, Security, Validation, WebSocket 스타터
jOOQ 3.21.6 SQL을 타입 있는 Java 코드로 쓰기. 코드 생성기와 런타임 버전을 같게 맞춰요
Flyway Spring Boot가 정함 스키마 마이그레이션

기본은 SQLite 파일 하나예요(org.xerial:sqlite-jdbc). 개발할 때는 server/data/에, 배포 이미지에서는 /var/lib/cowork/에 파일이 생겨요. 업무 DB와 따로, 시스템 현황의 활동·오류 기록을 담는 로그 DB 파일을 하나 더 둬요.

테스트도 SQLite를 써요. 서버를 띄우는 테스트는 테스트 프로필(src/test/resources/application-test.properties)로 컨텍스트마다 build/test-db/ 아래에 새 DB 파일을 만들어요. ./gradlew integrationTest는 integration 태그가 붙은 테스트를, ./gradlew test는 그 밖의 테스트를 돌려요.

앱 기능에 따라 넣거나 빼는 것이에요. 아래는 cowork의 기능을 위해 들어 있어요.

라이브러리 버전 cowork에서 하는 일
AWS SDK for Java(S3) BOM 2.46.7 파일 저장. 사전 서명 주소로 브라우저가 바로 올리고, 로컬에서는 컴퓨터 폴더에 저장해요
Apache POI(poi-ooxml) 5.4.1 보고서를 엑셀 파일로 내보내기
commonmark(GFM 확장 포함) 0.31.0 Markdown 문서를 본문 편집기의 JSON으로 가져오기
MCP Java SDK 2.1.0 에이전트가 붙는 MCP 서버(/api/mcp)
Spring Boot Mail 스타터 Spring Boot가 정함 로그인 인증 코드 메일
도구 버전 하는 일
Lombok Spring Boot가 정함 생성자·접근자 코드 줄이기
springdoc-openapi 3.1.1 OpenAPI 문서(/api/openapi) 만들기
Spotless 플러그인 8.8.0 서식 고치기(palantir-java-format)
Checkstyle 13.8.0 이름·import·결함 패턴 규칙
SpotBugs 플러그인 6.5.9 바이트코드의 결함 패턴 찾기
ArchUnit 1.4.2 테스트 의존성으로 들어 있어요
JUnit Spring Boot가 정함 테스트

검사를 어떻게 돌리는지는 린트와 코딩 스타일에 있어요.