v1.12.32 로컬 개발 DB 복구 절차 정리

docs/deploy-reference.md

@@ -116,7 +116,7 @@ npm run dev
 colima start
 
 # 개발 DB 컨테이너 실행
-ENV_FILE=.env.development docker compose --env-file .env.development up -d sori-studio-db
+ENV_FILE=.env.development docker compose -p sori-studio -f docker-compose.yaml --env-file .env.development up -d sori-studio-db
 
 # 개발 DB 마이그레이션 실행
 npm run db:migrate:dev
@@ -128,7 +128,16 @@ docker exec sori-studio-db pg_isready -U sori_studio -d sori_studio
 docker exec sori-studio-db psql -U sori_studio -d sori_studio -c 'SELECT count(*) AS posts_count FROM posts;'
 ```
 
-> 지난 버전 마이그레이션을 아직 적용하지 않았다면 `062_site_settings_display_counts.sql`부터 `069_media_catalog.sql`까지 순차 적용되어야 한다. 앱 재기동 전에 운영 DB 마이그레이션을 먼저 완료한다. 일반 배포에서는 `npm run db:migrate:prod` 또는 NAS 컨테이너 내부 마이그레이션 명령이 이 순서를 자동 처리한다.
+### 로컬에서 `ECONNREFUSED 127.0.0.1:43081`이 발생할 때
+
+Docker Desktop을 실행한 뒤, 프로젝트 폴더의 터미널에서 아래 블록을 실행한다. 기존 DB 볼륨을 연결해 멈췄거나 사라진 DB 컨테이너를 다시 실행한다. 개발 서버가 이미 켜져 있다면 먼저 해당 터미널에서 `Ctrl+C`로 종료한다.
+
+```bash
+ENV_FILE=.env.development docker compose -p sori-studio -f docker-compose.yaml --env-file .env.development up -d sori-studio-db &&
+npm run dev
+```
+
+개발 코드에 새 SQL이 추가된 경우에는 `npm run db:migrate:dev`로 개발 DB의 미적용 파일을 적용한다. 단순 컨테이너 복구만으로는 마이그레이션을 다시 실행할 필요가 없다.
 
 ### 확인 주소
 

docs/update.md

@@ -1,5 +1,12 @@
 # 업데이트 이력
 
+## v1.12.32
+
+- 로컬 DB 연결 거부 원인을 Docker Desktop 정상 실행·개발 DB 컨테이너 부재로 확인.
+- 기존 개발 DB 볼륨을 재연결해 컨테이너 복구 및 앱 계정 읽기 접속 검증 진행.
+- 기존 게시물 294개·마이그레이션 72개·Import/Export 테이블 보존 확인.
+- 로컬 DB 실행 명령에 Compose 파일·프로젝트명 명시 및 연결 거부 복구 명령 추가.
+
 ## v1.12.31
 
 - 프로젝트 폴더·배포·테스트·인증·업로드·DB 주요 경로 점검 진행.

package-lock.json

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

package.json

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