v1.12 기준 문서 정리

This commit is contained in:
2026-07-29 13:46:11 +09:00
parent 30f7b22340
commit 99af25b8fa
11 changed files with 3222 additions and 3163 deletions

View File

@@ -1,5 +1,10 @@
# 업데이트 요약
## v1.12.0
- v1.11 개발 구간의 글쓰기·미디어·가져오기 안정화와 내부 정리를 묶어 다음 minor 기준점으로 정리했다.
- 상세 작업 이력은 최신 문서와 보관 문서로 분리했다.
## v1.11.0
- v1.10 개발 구간의 보안·백업·미디어 장부·설정 안정화를 묶어 minor 버전으로 정리했다.

View File

@@ -38,6 +38,7 @@
## 문서 (update-log)
- `docs/update-log/`는 블로그 방문자용 업데이트 안내 초안이다.
- `docs/update.md`는 현재 minor와 최신 패치 이력을 중심으로 유지하고, 오래된 상세 이력은 `docs/update-archive.md`에 보관한다.
- v1.1 이후 글은 `안녕하세요.` / `` `sori.studio`입니다. `` 로 시작한 뒤, 버전 요지를 서두에 짧게 적는다. `조금 늦게 정리하는`, `이번 업데이트에서는`, `~한 기록입니다` 같은 표현은 쓰지 않는다.
- 제목은 `sori.studio vX.Y 업데이트 — {짧은 요약}` 형식을 쓴다. 요약은 한 단어가 아니라, 해당 버전의 핵심이 한눈에 들어오도록 짧은 구(대략 4~10자 내외의 의미 단위)로 적는다.
- 제목 바로 아래에 해당 minor(`.0`) 릴리스 날짜를 `YYYY년 M월 D일`로 적는다. 날짜는 `docs/update.md`·`docs/history.md`·`package.json` 버전 반영 시점을 기준으로 한다.

View File

@@ -1,7 +1,7 @@
# 배포 가이드
> v1.11.0은 v1.10 개발 구간을 마감한 minor 릴리스다. 운영 배포 전 `068_csp_violation_aggregates.sql`, `069_media_catalog.sql`, `070_post_import_jobs.sql`을 순서대로 적용하고 미디어 카탈로그는 reconcile 완료 후 `MEDIA_CATALOG_MODE=database` 고정 순서를 지킨다. 게시물 Export·Import·일반 업로드는 디스크·임시 디렉터리 스트리밍을 사용하므로 NAS 앱 컨테이너의 임시 저장 공간과 `public/uploads/exports`, `public/uploads/_import-jobs` 쓰기 권한을 확인한다.
> 로컬 기준 v1.11.128에서 `npm run lint`, `npm test`, `npm run build`, `npm audit` 검증을 통과했다.
> 로컬 기준 v1.12.0에서 `npm run lint`, `npm test`, `npm run build`, `npm audit` 검증을 통과했다.
## 빌드 유형

View File

@@ -1,3 +1,7 @@
## 2026-07-29 v1.12.0 — v1.11 내부 개선 구간을 마감한다
v1.11에서는 에디터·미디어·Import/Export·보안 의존성처럼 패치 단위 개선이 길게 이어졌다. 상세 작업 이력을 한 문서에 계속 누적하면 최신 상태 확인보다 과거 항목 검색 비용이 커지므로, `docs/update.md`는 v1.11 이후의 최신 이력 중심으로 유지하고 v1.10 이하 상세 기록은 `docs/update-archive.md`로 분리한다. 방문자에게 공유할 변화는 v1.11 개발 구간을 묶어 `docs/update-log/v1.12.md`로 별도 정리한다.
## 2026-07-29 v1.11.128 — 이미지 처리 의존성은 검증 가능한 업데이트로 올린다
운영 의존성 audit에서 직접 이미지 처리 경로인 `sharp`와 압축·빌드 전이 의존성인 `tar`, `brace-expansion` 경고가 다시 확인됐다. `sharp`는 업로드·썸네일 생성에 직접 영향을 주므로 단순 버전 변경만 하지 않고 게시물 카드, 본문 표시용, 페이지 커버 WebP를 실제 생성하는 스모크 테스트를 함께 추가한다. `tar`와 `brace-expansion`은 상위 패키지의 다음 릴리스를 기다리는 동안 npm `overrides`로 패치 버전을 고정해 운영 설치 결과가 취약 버전으로 되돌아가지 않게 한다.

View File

@@ -106,6 +106,8 @@
| 파일 | 용도 |
|------|------|
| docs/update.md | 현재 minor와 최신 패치 중심 작업 이력 |
| docs/update-archive.md | v1.10 이하 상세 작업 이력 보관 |
| docs/shortcuts.md | 사이트 단축키, 작성 약어, 슬래시 명령, Markdown 약식 문법 정리 |
| docs/update-log/v1.0.md | 방문자용 업데이트 공지 초안(v0.0~v1.0) |
| docs/update-log/v1.1.md | 방문자용 업데이트 공지 초안(v1.0 개발 구간) |
@@ -114,6 +116,7 @@
| docs/update-log/v1.6.md | 방문자용 업데이트 공지 초안(v1.5 개발 구간) |
| docs/update-log/v1.10.md | 방문자용 업데이트 공지 초안(v1.6~v1.9 개발 구간) |
| docs/update-log/v1.11.md | 방문자용 업데이트 공지 초안(v1.10 개발 구간) |
| docs/update-log/v1.12.md | 방문자용 업데이트 공지 초안(v1.11 개발 구간) |
## Nuxt 모듈

View File

@@ -1,10 +1,5 @@
# sori.studio 할 일
## v1.11 내부 개선
- 문서 구조 정리.
- `docs/update.md` 장기 누적 이력은 최신 작업 중심으로 유지하고 오래된 상세 이력은 역할에 맞게 분리하는 방안 검토.
## 1차 관리자 개발
## 2차 관리자 개발

3159
docs/update-archive.md Normal file

File diff suppressed because it is too large Load Diff

37
docs/update-log/v1.12.md Normal file
View File

@@ -0,0 +1,37 @@
# sori.studio v1.12 업데이트 — 쓰기와 보기 안정화
2026년 7월 29일
안녕하세요.
`sori.studio`입니다.
v1.12에서는 v1.11 개발 구간에서 이어진 글쓰기, 미디어, 목록 화면, 이동 안정성 개선을 하나로 묶었습니다. 화면에서 느껴지는 작은 불편을 줄이고, 많은 글과 이미지를 다루는 과정이 더 자연스럽게 이어지도록 다듬었습니다.
## 달라진 점
- **글쓰기 화면 안정화**
라이브 모드와 소스 모드 사이에서 이미지, 갤러리, 코드 블록, 콜아웃, 목록을 편집할 때 오른쪽 설정 패널이 더 정확하게 현재 위치를 따라가도록 정리했습니다.
슬래시 명령과 한글 입력 중에도 불필요한 텍스트가 남거나 다른 블록 설정이 튀어나오는 상황을 줄였습니다.
- **이미지 표시 너비 개선**
단일 이미지는 전체 너비, 2열 기준, 3열 기준처럼 자주 쓰는 크기를 쉽게 고를 수 있게 했습니다.
선택한 표시 너비가 작성 화면과 실제 보기 화면에 더 일관되게 반영됩니다.
- **미디어 관리 표현 정리**
대표 이미지와 본문 이미지처럼 용도가 분명한 이름으로 미디어 탭을 정리했습니다.
전환 중 잠깐 불필요한 배지가 나타나는 화면 흔들림도 줄였습니다.
- **게시물 가져오기 안정화**
많은 게시물과 이미지를 한 번에 옮길 때 진행 상태를 더 분명하게 확인할 수 있도록 개선했습니다.
같은 글을 다시 가져오는 상황에서도 중복 생성 가능성을 줄이고, 이미지 누락이 생기지 않도록 처리 순서를 보강했습니다.
- **목록과 이동 경험 개선**
페이지 관리 화면을 게시글 화면과 더 비슷한 구조로 맞추고, 공개 목록의 현재 페이지 표시가 더 분명하게 보이도록 조정했습니다.
뒤로 가기나 페이지 이동 후에도 불필요한 무한 로딩이 생기지 않도록 이동 흐름을 다듬었습니다.
- **관리 화면 통계 정리**
방문자와 접속자 표현을 더 자연스럽게 맞추고, 누적 방문자와 디바이스 비율을 한눈에 보기 쉽게 정리했습니다.
- **운영 안정성 개선**
이미지 처리와 의존성 보안 상태를 점검하고, 알려진 취약 의존성이 다시 설치되지 않도록 보강했습니다.
오래 누적된 작업 이력도 최신 기록과 보관 기록으로 나누어 앞으로의 정리 속도를 높였습니다.

File diff suppressed because it is too large Load Diff

4
package-lock.json generated
View File

@@ -1,12 +1,12 @@
{
"name": "sori.studio",
"version": "1.11.128",
"version": "1.12.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "sori.studio",
"version": "1.11.128",
"version": "1.12.0",
"hasInstallScript": true,
"dependencies": {
"@nuxtjs/tailwindcss": "^6.14.0",

View File

@@ -1,6 +1,6 @@
{
"name": "sori.studio",
"version": "1.11.128",
"version": "1.12.0",
"private": true,
"type": "module",
"imports": {