sori.studio/docs/update.md

업데이트 이력

v0.0.37

• 관리자 블록 에디터의 한글 조합 입력 종료 후 Enter 처리 보정.
• 관리자 블록 에디터의 슬래시 메뉴 필터가 한글 조합 완료 뒤 갱신되도록 수정.
• 관리자 블록 에디터에서 ``` 입력 시 코드 블록으로 즉시 변환되도록 추가.
• 관리자 코드 블록 글자색과 caret 색상 보정.
• 관리자 블록 에디터에 블록 핸들 선택, Delete/Backspace 삭제, 드래그 이동 기능 추가.
• 할 일 문서에 블록 핸들 액션 메뉴 후속 작업 추가.
• 기술 명세 현재 버전을 v0.0.37로 갱신.
• 패키지 버전을 0.0.37로 갱신.

v0.0.36

• 할 일 문서에서 완료 또는 현재 기준 불필요한 QA 항목 정리.
• 기술 명세 현재 버전을 v0.0.36으로 갱신.
• 패키지 버전을 0.0.36으로 갱신.

v0.0.35

• 관리자 공통 레이아웃의 기본 내부 패딩 제거.
• 관리자 글 작성/수정 화면에서 좌측 관리자 네비게이션을 숨기도록 수정.
• 관리자 글 작성/수정 폼을 에디터 작업 영역과 우측 설정 패널의 1차 좌우 분할 구조로 수정.
• 게시물 설정 패널 열림/닫힘 너비 전환 애니메이션 추가.
• 관리자 글 작성/수정 화면의 버튼, 입력, 미디어 선택 요소 hover/focus 효과 보강.
• 기술 명세 현재 버전을 v0.0.35로 갱신.
• 패키지 버전을 0.0.35로 갱신.

v0.0.34

• 배포 문서에 개발/운영 DB 분리 검증 절차 추가.
• 로컬 개발 DB 실행 안내에 Docker Desktop과 Colima 기준 병기.
• 할 일에서 개발 DB와 운영 DB 분리 검증 절차 작성 항목 정리.
• 기술 명세 현재 버전을 v0.0.34로 갱신.
• 패키지 버전을 0.0.34로 갱신.

v0.0.33

• 개발 서버 실행 링크 출력을 개발 서버, Admin, Tailwind Viewer 3개 주소로 정리.
• 개발 서버 실행 링크가 Nuxt 출력 URL 대신 프로젝트 고정 포트 43117 기준으로 표시되도록 수정.
• 배포 문서에 로컬 PostgreSQL DB 확인 방법 추가.
• 할 일에서 CloudBeaver PostgreSQL 연결 방식 확정 항목 정리.
• 기술 명세 현재 버전을 v0.0.33으로 갱신.
• 패키지 버전을 0.0.33으로 갱신.

v0.0.32

• 관리자 글 작성/수정 화면의 별도 제목 헤더 제거.
• 관리자 글 작성/수정 폼을 Ghost 스타일 상단 바와 중앙 에디터 구조로 수정.
• 대표 이미지 추가 영역을 에디터 본문 상단으로 이동.
• 게시물 설정 패널을 420px 우측 패널과 토글 구조로 정리.
• 관리자 글 에디터 컬럼을 좌우 32px 패딩 포함 804px로 보정해 실제 본문 폭 740px 유지.
• 블록 에디터 첫 placeholder 문구를 간결하게 수정.
• 패키지 버전을 0.0.32로 갱신.

v0.0.31

• 관리자 글 작성/수정 폼에 미리보기 버튼 추가.
• 저장 전 게시물 입력값을 브라우저 저장소에 담아 새 미리보기 탭으로 전달하도록 추가.
• 관리자 게시물 미리보기 화면 추가.
• 미리보기 화면이 공개 게시물 본문 렌더러와 같은 컴포넌트를 사용하도록 연결.
• 패키지 버전을 0.0.31로 갱신.

v0.0.30

• 게시물 OG 이미지 필드 추가.
• 관리자 글 작성/수정 폼에 OG 이미지 선택, 업로드, 변경, 삭제 기능 추가.
• 공개 게시물 상세 화면에 OG 이미지와 Twitter large image 카드 메타 연결.
• 미디어 라이브러리 사용 현황에 게시물 OG 이미지 사용처 표시 추가.
• 패키지 버전을 0.0.30으로 갱신.

v0.0.29

• 게시물 SEO 메타데이터 컬럼 추가.
• 관리자 글 작성/수정 폼에 SEO 제목, SEO 설명, canonical URL, 검색엔진 노출 제외 설정 추가.
• 관리자 게시물 생성/수정 API가 SEO 값을 저장하도록 수정.
• 공개 게시물 상세 화면에 SEO 제목, description, canonical, robots, 기본 OG 메타 연결.
• 패키지 버전을 0.0.29로 갱신.

v0.0.28

• 관리자 글 작성/수정 폼에 발행 시각 입력 기능 추가.
• 발행 상태에서 미래 발행 시각을 저장하면 예약 발행으로 처리하도록 추가.
• 공개 게시물 목록과 상세 API가 미래 발행 글을 노출하지 않도록 수정.
• 관리자 글 목록에서 발행/예약/초안/비공개 상태 표시를 구분하도록 수정.
• 예약 발행 글은 공개 보기 버튼을 숨기도록 수정.
• 패키지 버전을 0.0.28로 갱신.

v0.0.27

• 미디어 폴더 테이블 추가.
• 관리자 미디어 폴더 목록/생성 API 추가.
• 관리자 미디어 화면을 왼쪽 폴더 트리와 오른쪽 썸네일 갤러리 구조로 수정.
• 미디어 Ctrl/Command 클릭 및 Shift 클릭 복수 선택 기능 추가.
• 선택 미디어를 폴더로 드래그해 일괄 이동하는 기능 추가.
• 미디어 폴더 이동은 실제 파일 경로가 아닌 메타데이터 경로를 갱신하도록 유지.
• 패키지 버전을 0.0.27로 갱신.

v0.0.26

• 미디어 메타데이터 테이블 추가.
• 미디어 URL별 카테고리 저장 기능 추가.
• 관리자 미디어 목록에 카테고리 필터 추가.
• 관리자 미디어 상세 모달에 카테고리 수정 기능 추가.
• 미디어 파일명 변경/삭제 시 메타데이터도 함께 갱신하도록 수정.
• 패키지 버전을 0.0.26으로 갱신.

v0.0.25

• 관리자 블록 에디터에서 빈 문단 placeholder를 마지막 보조 입력 블록에만 표시하도록 수정.
• 네비게이션 항목 데이터베이스 테이블 추가.
• 공개 네비게이션 조회 API 추가.
• 관리자 네비게이션 조회/일괄 저장 API 추가.
• 관리자 메뉴 관리 화면 추가.
• 공개 왼쪽 사이드바 상단/하단 메뉴를 네비게이션 API와 연결.
• 패키지 버전을 0.0.25로 갱신.

v0.0.24

• 관리자 블록 에디터에서 마지막 빈 문단 Enter 입력 시 연속 빈 줄이 유지되도록 수정.
• 사이트 설정 데이터베이스 테이블 추가.
• 공개 사이트 설정 조회 API 추가.
• 관리자 사이트 설정 조회/수정 API 추가.
• 관리자 사이트 설정 화면을 실제 저장 API와 연결.
• 공개 헤더와 오른쪽 사이드바에 사이트 설정 값을 연결.
• 패키지 버전을 0.0.24로 갱신.

v0.0.23

• 관리자 고정 페이지 목록 화면을 실제 API와 연결.
• 관리자 고정 페이지 생성 화면 추가.
• 관리자 고정 페이지 수정 화면 추가.
• 관리자 고정 페이지 생성/수정/삭제 API 추가.
• 고정 페이지 작성 폼에 블록 에디터와 대표 이미지 선택 기능 연결.
• 패키지 버전을 0.0.23으로 갱신.

v0.0.22

• 관리자 블록 에디터 마지막에 클릭 가능한 빈 문단 블록을 항상 유지하도록 수정.
• 빈 마지막 문단 블록은 저장 콘텐츠에 포함하지 않도록 유지.
• 한글 조합 입력 직후 Enter가 새 블록 입력으로 중복 처리되는 문제 보정.
• 관리자 글 저장/수정/삭제 진행 상태를 토스트로 표시하도록 추가.
• 새 글 저장 후 수정 화면으로 이동해도 저장 성공 토스트를 표시하도록 추가.
• 패키지 버전을 0.0.22로 갱신.

v0.0.21

• 관리자 글 작성/수정 폼에 로컬 자동 저장 기능 추가.
• 자동 저장본이 있으면 복원 또는 삭제 안내를 표시하도록 추가.
• 글 저장 성공 시 해당 자동 저장본을 삭제하도록 연결.
• 자동 저장 상태 시간을 글 작성 화면 하단에 표시하도록 추가.
• 패키지 버전을 0.0.21로 갱신.

v0.0.20

• 관리자 블록 에디터에 콜아웃 블록 추가.
• 관리자 블록 에디터에 토글 블록 추가.
• 관리자 블록 에디터에 임베드 블록 추가.
• 공개 본문 렌더러에 콜아웃, 토글, 임베드 마크다운 확장 파싱 추가.
• YouTube 임베드 URL을 공개 화면에서 iframe으로 렌더링하도록 수정.
• 패키지 버전을 0.0.20으로 갱신.

v0.0.19

• 관리자 블록 에디터의 한글 조합 입력 중복 방지 처리 추가.
• 이미지/갤러리 삽입 시 파일명을 alt/caption으로 자동 표시하지 않도록 수정.
• 이미지 블록 alt 입력을 이미지 hover 또는 focus 상태에서만 표시하도록 수정.
• 공개 게시물 카드에 대표 이미지 썸네일 표시 추가.
• ProseImage Wide/Full-width 화면 이탈 보정 작업을 할 일에 기록.
• 패키지 버전을 0.0.19로 갱신.

v0.0.18

• 새 글 작성 화면에서 빈 본문 블록이 생성되지 않던 문제 수정.
• 공개 게시물 목록 경로 /posts 추가.
• 공개 게시물 상세 경로를 /post/:slug 기준으로 추가.
• 기존 /posts/:slug 상세 경로를 /post/:slug로 리다이렉트하도록 수정.
• 공개 태그 목록 경로 /tags 추가.
• 공개 태그 상세 경로를 /tag/:slug 기준으로 추가.
• 기존 /tags/:slug 상세 경로를 /tag/:slug로 리다이렉트하도록 수정.
• 공개 화면과 관리자 미리보기 링크를 단수형 상세 경로 기준으로 정리.
• 패키지 버전을 0.0.18로 갱신.

v0.0.17

• 관리자 글 작성/수정 폼의 대표 이미지 URL 직접 입력을 이미지 선택 UI로 변경.
• 대표 이미지 썸네일, 삭제, 변경, 새 업로드 기능 추가.
• 대표 이미지를 기존 미디어 라이브러리에서 선택할 수 있도록 추가.
• 관리자 미디어 화면을 고밀도 썸네일 갤러리 구조로 변경.
• 미디어 경로, 사용 현황, 용량, 파일명 변경, 삭제 정보를 상세 모달로 이동.
• 패키지 버전을 0.0.17로 갱신.

v0.0.16

• 관리자 미디어 목록에 게시물/페이지 사용 현황 표시 추가.
• 미디어 사용처를 대표 이미지와 본문 위치로 구분해 표시.
• 사용 중인 미디어의 파일명 변경과 삭제를 차단하도록 수정.
• 미디어 검색 대상에 사용 중인 게시물/페이지 제목 추가.
• 패키지 버전을 0.0.16으로 갱신.

v0.0.15

• 관리자 블록 에디터 / 메뉴 항목 제목 색상을 진한 본문색으로 수정.
• 관리자 미디어 목록 API 추가.
• 관리자 미디어 파일명 변경 API 추가.
• 관리자 미디어 삭제 API 추가.
• 관리자 미디어 관리 화면 추가.
• 관리자 사이드바에 미디어 메뉴 추가.
• 글쓰기 이미지/갤러리 블록에서 기존 업로드 미디어 선택 기능 추가.
• 패키지 버전을 0.0.15로 갱신.

v0.0.14

• 관리자 블록 에디터에 단일 이미지 블록 추가.
• 관리자 블록 에디터에 복수 이미지 갤러리 블록 추가.
• 이미지 블록의 기본/와이드/풀사이즈 표시 옵션 추가.
• 관리자 이미지 업로드 API 추가.
• 공개 본문 렌더러에 이미지와 갤러리 렌더링 추가.
• 공개 갤러리 이미지 클릭 시 라이트박스로 크게 보는 기능 추가.
• 업로드 파일이 Git에 포함되지 않도록 public/uploads/ 제외 처리.
• 향후 미디어 라이브러리 관리 기능 범위 정리.
• 패키지 버전을 0.0.14로 갱신.

v0.0.13

• 개발 서버 실행 로그를 프로젝트 전용 링크 요약 출력으로 정리.
• npm run dev가 scripts/dev-server.js를 통해 Nuxt 개발 서버를 실행하도록 수정.
• 패키지 버전을 0.0.13으로 갱신.

v0.0.12

• 관리자 글 제목 입력에서 Enter 입력 시 본문 첫 블록으로 이동하도록 수정.
• 관리자 블록 에디터 본문 글자 색상을 관리자 화면 기준으로 고정.
• 패키지 버전을 0.0.12로 갱신.

v0.0.11

• 관리자 블록 에디터에서 빈 문단 Enter 입력 시 새 빈 블록이 생성되도록 수정.
• 관리자 블록 에디터의 / 명령 메뉴에서 Enter로 선택 항목을 적용하도록 수정.
• 관리자 블록 에디터의 / 명령 메뉴에 위/아래 방향키 선택 이동 추가.
• 관리자 글 에디터 후속 작업 순서 정리.
• 패키지 버전을 0.0.11로 갱신.

v0.0.10

• 관리자 블록 에디터의 contenteditable 입력 중복 문제 수정.
• 관리자 블록 에디터의 / 명령 메뉴가 화면 하단에서 위로 열리도록 수정.
• 빈 블록 placeholder가 활성 블록에만 표시되도록 수정.
• 관리자 글 제목 입력을 본문 흐름 안의 큰 제목 필드로 변경.
• 패키지 버전을 0.0.10으로 갱신.

v0.0.9

• 관리자 글 작성/수정 폼을 textarea 방식에서 블록형 에디터 방식으로 변경.
• 관리자 블록 에디터에 / 명령 메뉴 추가.
• 관리자 블록 에디터에 #, ##, ###, >, - 입력 단축 변환 추가.
• 공개 게시물과 고정 페이지 본문을 마크다운 렌더러에 연결.
• 패키지 버전을 0.0.9로 갱신.

v0.0.8

• 관리자 글 작성/수정 폼에 마크다운 미리보기 탭 추가.
• 관리자 글 작성/수정 폼에 제목, 굵게, 목록, 인용, 코드 문법 삽입 버튼 추가.
• 패키지 버전을 0.0.8로 갱신.

v0.0.7

• 태그 정렬 순서와 색상 코드 필드 추가.
• 태그 표시 필드 마이그레이션 추가.
• 관리자 태그 생성/수정 화면을 개별 페이지로 분리.
• 관리자 태그 목록 화면의 인라인 수정 제거.
• 공개 좌측 사이드바 카테고리를 실제 태그 색상과 정렬 순서 기준으로 연결.
• 관리자 태그 상세 조회 API 추가.
• 관리자 태그 목록 API 추가.
• 관리자 태그 생성 API 추가.
• 관리자 태그 수정 API 추가.
• 관리자 태그 삭제 API 추가.
• 관리자 태그 관리 화면을 실제 API에 연결.
• 관리자 글 삭제 API 추가.
• 관리자 글 목록과 수정 화면에 삭제 액션 추가.
• 관리자 글 작성 API 추가.
• 관리자 글 상세 조회 API 추가.
• 관리자 글 수정 API 추가.
• 관리자 글 작성/수정 공통 폼 추가.
• 관리자 새 글 작성 화면과 수정 화면을 실제 저장 API에 연결.
• 관리자 글 상태를 초안/발행/비공개로 저장할 수 있도록 수정.
• 관리자 접근 미들웨어의 서버 인증 확인 방식 수정.
• 환경 변수 기반 관리자 로그인 기능 추가.
• 관리자 세션 쿠키 인증 유틸리티 추가.
• 관리자 로그아웃 및 세션 조회 API 추가.
• 관리자 글 목록 API와 화면 연결.
• 개발 서버의 #app-manifest 가상 모듈 분석 오류를 피하도록 Nuxt app manifest 실험 기능 비활성화.
• Nuxt 컴포넌트 자동 import 설정을 문서의 컴포넌트명 기준에 맞게 수정.
• 홈, 태그, 게시물, 고정 페이지 공개 화면을 실제 API 데이터에 연결.
• 로컬 PostgreSQL 마이그레이션 실행 스크립트 추가.
• 개발 DB 마이그레이션 npm 명령 추가.
• Homebrew, Docker CLI, Docker Compose, Colima 기반 로컬 컨테이너 실행 환경 구성.
• Docker Compose가 ENV_FILE 값으로 로컬/운영 환경 파일을 선택할 수 있도록 수정.
• 로컬 PostgreSQL 개발 DB 컨테이너 실행 및 시드 데이터 확인.
• Nuxt 개발/프리뷰 스크립트가 .env.development를 명시적으로 읽도록 수정.
• 새 개발 환경에서 Node.js 22 LTS 기준 의존성 설치 및 빌드 검증.
• 로컬 개발 필수 조건 문서의 Node.js 권장 버전 정리.
• 패키지 버전을 0.0.7로 갱신.

v0.0.6

• .env.example의 실제 계정/비밀번호 값을 예시 전용 placeholder로 교체.
• 로컬 개발 전용 .env.development 파일 생성.
• 개발 DB 비밀번호와 관리자 비밀번호를 랜덤 값으로 분리.
• 환경 변수 파일 관리 기준 문서 정리.
• 패키지 버전을 0.0.6으로 갱신.
• 이미 원격에 올라간 비밀번호 사용 여부 점검 항목 추가.

v0.0.5

• PostgreSQL 초기 스키마 마이그레이션 추가.
• 개발용 시드 데이터 SQL 추가.
• Nuxt 서버 API 저장소 계층 추가.
• DATABASE_URL이 있으면 PostgreSQL을 사용하고, 없으면 샘플 데이터를 사용하도록 수정.
• Docker Compose에 PostgreSQL 서비스와 전용 DB 포트 43119 추가.
• 공개 API가 저장소 계층을 통해 게시물, 페이지, 태그를 조회하도록 수정.

v0.0.4

• 헤더 좌측 아이콘을 브랜드 마크에서 메뉴 토글 버튼으로 수정.
• Vue/Nuxt 상태 기반 좌측 사이드바 열기/닫기 기능 추가.
• 메뉴 열림 상태를 localStorage의 MENU_STATE에 저장하도록 추가.
• 메뉴 닫힘 상태에서 공개 레이아웃 그리드가 좌측 사이드바 폭을 제거하도록 수정.

v0.0.3

• Thred 참고 화면 기준 공개 레이아웃 색상 토큰 정리.
• 라이트/다크 모드 CSS 변수 기반 테마 추가.
• 헤더 아래 3단 컬럼 최소 높이를 화면 전체 높이로 수정.
• 좌우 사이드바를 본문과 별개로 전체 높이 패널처럼 표시하도록 수정.
• 홈 화면 히어로, 추천 영역, 최신 글 영역 구조 보강.
• 사이트 헤더 검색 영역과 구독/계정 액션 구조 추가.
• 좌우 사이드바 임시 콘텐츠 구조 보강.
• 로컬 개발/프리뷰 포트 43117 유지.

v0.0.2

• Nuxt 3 프로젝트 기본 실행 구조 추가.
• Tailwind CSS 설정과 전역 Pretendard 기준 스타일 추가.
• 공개 레이아웃, 게시물 레이아웃, 고정 페이지 레이아웃, 관리자 레이아웃 골격 추가.
• 사이트 컴포넌트와 콘텐츠 컴포넌트 초기 골격 추가.
• 홈, 게시물 상세, 태그, 고정 페이지, 관리자 기본 화면 추가.
• Nuxt server/api 기반 백엔드 골격 추가.
• Zod 기반 콘텐츠 스키마와 샘플 API 추가.
• .env.example, Dockerfile, docker-compose.yml, .dockerignore 추가.
• 로컬 개발 포트 43117, NAS Docker 외부 포트 43118 기준 추가.

v0.0.1

• sori.studio 개인 블로그/CMS 방향 정리.
• note.md 원본 기획 기준 문서 재점검.
• Ghost 스타일 관리자와 Thred 스타일 공개 화면 기준 명세 정리.
• Nuxt SSR, JavaScript, JSDoc, Zod, Tailwind CSS 기본 전제 정리.
• Git 원격 저장소와 작성자 기준 문서화.
• 로컬 개발 DB와 NAS 운영 DB 분리 원칙 추가.
• 공개 레이아웃, 콘텐츠 컴포넌트, 관리자 화면 계획 정리.
• pages 전체 화면 표시 기준 정리.
• 배포 가이드에 clone, 개발/운영 환경 변수, NAS 운영 DB 기준 추가.
• 초기 할 일, 배포 초안, 파일-화면 매핑 문서 정리.
• note.md 삭제 정리.
• Git 저장소 초기 기준점 설정 진행.