- 릴리스 버전: 6.0.14
- 빌드 번호: 0622
- 릴리스 날짜: 2026년 2월 27일 (한국시간 기준)
매뉴얼웍스를 업데이트하려면 [소프트웨어 업데이트](#cab7f9b31046730f)를 참고합니다. 5.0 버전에서 6.0 버전으로 업데이트하려면 [매뉴얼웍스 6.0 업데이트 가이드](#34350faf7573f79c)를 참고합니다.
# 릴리스 이후 수정 사항
## 빌드 번호: 0664
- [API로 사용자를 만들 때](#d6f3c047e561315b) 그룹-사용자 매핑 정보를 업데이트하지 않는 문제를 해결했습니다.
## 빌드 번호: 0658
- [문서의 프로젝트를 반환하는 API](#b138db4ff3bfb001)를 추가했습니다.
## 빌드 번호: 0640
- 매뉴얼웍스 빌드를 할 때 소스 코드 난독화를 위해 ProGuard를 사용합니다. 해당 버전의 오류로 새로운 사용자를 만들지 못하는 오류가 있었습니다. **ProGuard 7.8.2 버전**으로 업데이트한 후 다시 빌드를 했습니다.
## 빌드 번호: 0628
- URL로 올린 그림 단락이 보이지 않는 문제를 해결했습니다.
# H2 데이터베이스 지원
자세한 사항은 [매뉴얼웍스, 더 강력해진 H2 데이터베이스로 전환합니다](#0d3aea4ed17c7097)를 참고합니다.
> **H2 데이터베이스를 사용하려면 자바 11 버전 이상**이 필요합니다. 기존 고객은 H2로 마이그레이션을 하기 전까지는 자바 8 버전을 계속 사용할 수 있습니다. 신규 고객도 H2가 아닌 다른 데이터베이스를 사용한다면 자바 8 버전을 사용할 수는 있습니다.
> 하지만 [자바 25 버전을 사용하는 것을 권장](#db880539742f4c8a)합니다.
# UI 설정 메뉴 추가
<관리 | 환경 설정 | UI 설정> 메뉴를 추가했습니다. [28. 콘솔](#6e64c5f531b74f7e)을 사용하지 않고 UI와 관련한 다양한 설정을 할 수 있습니다.
> <관리 | 환경 설정 | 일반 설정> 메뉴에 있는 로고와 시간 형식 설정을 이 메뉴로 옮겼습니다.
# 색상 시스템 도입
매뉴얼웍스는 오랫동안 [Material 색상 시스템](https://m2.material.io/design/color/the-color-system.html)을 사용하고 있었습니다. 여기에 [Tailwindcss 색상 시스템](https://tailwindcss.com/docs/colors)과 Muted 색상 시스템(쓰리래빗츠가 자체적으로 구성)을 추가했습니다. 기본은 Tailwindcss 색상 시스템입니다.
> <관리 | 환경 설정 | UI 설정> 메뉴에서 설정합니다.
# 긴 로고 지원
정사각형 로고뿐만 아니라 1 긴 로고를 사용할 수 있습니다. 이때는 <관리 | 환경 설정 | UI 설정> 메뉴에서 로고 위치를 “Top”으로 설정합니다.
> 2와 같이 로고가 상단 영역의 처음에서 시작하도록 하려면 <관리 | 환경 설정 | UI 설정> 메뉴에서 로고 배경색을 테마 색으로 채우기를 선택합니다.
# 방문 이력 데이터 파일로 전환
데이터베이스 성능 향상 목적으로 방문 이력 데이터를 파일에 저장합니다. **당일은 실시간 데이터 반영을 위해 기존과 동일하게 데이터베이스에 저장**하고, 그 후에 스케줄러를 통해 파일로 옮깁니다.
> 이를 통해 통계 메뉴의 전반적인 성능을 개선했습니다.
다음 순서로 기존 데이터를 마이그레이션합니다.
1. <통계 | 방문 통계> 메뉴로 이동합니다.
2. <1데이터 변환> 링크를 클릭합니다.
1. 마이그레이션이 필요한 2 연도 버튼을 클릭해서 연도별로 데이터 변환을 진행합니다.
> 데이터 공간을 줄이기 위해 아파치 더비를 사용한다면 <관리 | 서버 관리 | 더비> 메뉴로 이동해서 R_VISIT 테이블에 대해 버튼을 클릭합니다. 다른 데이터베이스를 사용한다면 해당 데이터베이스가 제공하는 기능으로 데이터 공간을 절약합니다.
다음을 참고합니다.
- VisitClearScheduler 스케줄러가 당일 제외 최근 5일 동안의 방문 이력을 파일에 저장하고 데이터베이스에서는 삭제합니다.
- 사용자가 <통계 | 방문 통계> 메뉴에서 방문 이력을 조회할 때 해당 날짜(당일 제외)의 방문 이력이 데이터베이스에 존재한다면 방문 이력을 파일에 저장하고 데이터베이스에서는 삭제합니다.
- 방문 이력 보존 기간([VISIT_RETENTION_PERIOD](#5e9b2ed915962fb2))이 지나도 데이터베이스에서는 삭제하지만 해당 날짜의 파일은 삭제하지 않습니다.
# 웹 뷰어
## 장 내용을 마크다운 형식으로 복사하기
ChatGPT와 같은 AI 서비스의 프롬프트에 장 내용을 입력할 수 있도록 1 <마크다운으로 복사> 링크를 클릭해서 장 내용을 마크다운 형식으로 복사합니다. 미리 보기를 할 수도 있습니다.
> 내보내기한 HTML 파일에서는 지원하지 않습니다. 그리고 웹 뷰어 레이아웃에서 **<내용 복사를 막습니다> 옵션**을 선택했을 때는 나타나지 않습니다.
## 장 단위 PDF 내려받기
장 단위로 PDF를 내려받는 링크의 이름을 2장 제목으로 변경했습니다.
## WV_404_FALLBACK 옵션
요청 경로에 해당하는 문서는 존재하지만 장 또는 단락이 존재하지 않으면 404 페이지로 이동합니다. 404 페이지로 이동하지 않고, 문서의 전체 차례를 보여주려면 [28. 콘솔](#6e64c5f531b74f7e)에서 다음 명령어를 실행합니다.
```
set-preference -name WV_404_FALLBACK -value index
```
# 웹 페이지 객체 단락 지원
에디터에서 웹 페이지를 아래와 같이 객체 단락으로 넣을 수 있습니다.
> PDF와 HTML 등을 포함해 내보낼 때는 지원하지 않습니다.
# 만다라트 문서 공개하기
만다라트 문서를 다른 사람과 함께 편집할 수는 없습니다. 하지만 1공개는 할 수 있습니다.
> 함께 댓글을 달 수 있도록 설정할 수 있습니다.
# 자바 라이브러리 업데이트
다음과 같이 자바 라이브러리 버전을 업데이트했습니다.
| 자바 라이브러리 | 기존 버전 | 신규 버전 |
| --- | --- | --- |
| Apache Commons IO | 2.18.0 | 2.21.0 |
| Apache Commons Lang | 3.17.0 | 3.20.0 |
| Apache Commons Text | 1.12.0 | 1.15.0 |
# 수정 사항
- 1라벨 UI를 변경했습니다. 아이콘을 선택하지 않으면 #를 기본으로 붙입니다.
- DateRange에 시작일과 종료일 검증 로직을 추가했습니다.
- 마우스를 올렸을 때 선택한 2 아이콘 이름을 알 수 있도록 변경했습니다.
- <알람> 링크를 포함해 알람을 3리마인더로 변경했습니다.
- 아이콘(Material Symbols) 버전을 2.906 버전으로 업데이트했습니다.
- 이에 따라 더 이상 다음 아이콘을 지원하지 않습니다.
- book_4_spark
- 모두 4,160개의 아이콘을 지원합니다.
- 중복은 모두 제거했습니다.
- [새로 지원하는 아이콘은 다음을 참고](#75db6bb38a3fdc04)합니다.
- 진척 관리에서 열린 것만 보기 토글을 삭제했습니다. 4그리드를 통해 필터할 수 있습니다.
- <로그> 메뉴에서 로그 파일을 마지막으로 수정한 시간을 보여줍니다.
- 라이브러리 메뉴에 설명을 보여주지 않는 옵션을 추가했습니다. 기본으로는 설명을 보여줍니다.
- 그룹과 권한에 사용자를 할당할 때 이름이 같은 사용자를 구분하기 위해 이름과 함께 사용자 아이디를 보여주도록 변경했습니다.
# 해결한 버그
- 전체 문서에서 내용 검색을 할 때 1문서를 제목으로 정렬하지 않는 문제를 해결했습니다.
- 링크로 채널을 넣었을 때 "내부 링크가 잘못되었습니다"가 나타나는 문제를 해결했습니다.
- 에디터에서 웹 페이지 링크가 열리지 않는 문제를 해결했습니다.
- PDF 파일을 만들 때 지정한 PDF 테마와 레이아웃이 저장되지 않는 문제를 해결했습니다.
- API로 사용자를 만들 때 사용자 아이디가 같은 사용자가 만들어지는 문제를 해결했습니다.