v4.0.0: 회원·덱 API, 인증 UI, 프로필 및 레이아웃 통일

Express/SQLite API와 Docker 구성을 추가하고 로그인·덱 저장·공개 덱·관리자·프로필 화면을 구현했다. 결과 화면 저장 UX, 헤더 프로필, 애드센스용 app-shell 레이아웃(1280px) 및 문서를 반영했다.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/history.md

@@ -1,5 +1,25 @@
 # 의사결정 이력
 
+## 2026-06-19 / v4.0.0 구현 완료
+- 배경: 설계 확정 후 회원·API·공유 시스템 1차 구현.
+- 반영: `api/` 백엔드, Docker Compose, 인증/덱/관리자 API, 프론트 신규 페이지 및 헤더 프로필 UI.
+- 배포: NAS Docker + Nginx `/api/`, `/d/` 프록시 필요.
+
+## 2026-06-19 / v4.0.0 덱 공유·API 설계 확정
+- 배경: v3는 덱을 `?cards=<JSON>` URL에 실어 공유했으나 URL이 수천 자로 비대해지고, 옆 프로젝트도 개발 중이라 계약을 새로 잡을 수 있는 시점이다.
+- 결정:
+- URL 쿼리 기반 덱 공유는 **폐기**하고, 공유 코드 + REST API 방식으로 전환한다.
+- **개인 덱**(`share_type=user`): 저장할 때마다 nanoid 8자 고유 코드 발급. 같은 카드 구성이라도 저장자마다 URL이 다르다.
+- **메타 덱·프리셋**(`share_type=preset`): 카드 구성 해시 기반 고정 코드. 동일 구성이면 항상 같은 URL.
+- DB에는 `{number, count, key}`만 저장하고, API 응답 시 `datas/`에서 카드 메타를 lookup하여 합성한다.
+- 작성자, 생성일, 수정일, 조회수, 공개 여부 등 메타데이터를 덱 레코드와 함께 관리한다.
+- 외부 연동(옆 프로젝트) 공식 계약: `GET /api/v1/decks/:shareCode`
+- 프론트는 Vue 전환 없이 정적 HTML + API 호출 + Docker 백엔드로 확장한다.
+- 이유:
+- URL 길이·중복 데이터 문제 해소.
+- 회원 덱 소유권·수정·비공개 설정이 자연스럽다.
+- DB 용량은 덱 본문 기준 건당 수 KB 수준으로 경미하다.
+
 ## 2026-04-19 / v3.1.0 릴리즈 기준 확정
 - 배경: 저장소의 마지막 명시 릴리즈 기록은 `v3.0.1`인데, 메인 화면은 이미 `v3.1`을 노출하고 있어 실제 릴리즈 이력과 화면 표기가 어긋나 있었다.
 - 결정: