v3.1.2: add ua53, ua50

datas/ua04.js

@@ -2083,7 +2083,7 @@ export const cardList = [
         trigger: null,
     },
     {
-        imgSrc: '/ua04/PC01BT_IMS-3-A07.png',
+        imgSrc: '/ua04/PC01BT_IMS-3-AP07.png',
         Number: 'PC01BT/IMS-3-A07',
         count: 0,
         key: false,

datas/ua27.js

@@ -942,7 +942,7 @@ export const cardList = [
     },
     {
         imgSrc: '/ua27/EX13BT_GIM-2-059.png',
-        Number: 'EX13BT/GIM-2-058',
+        Number: 'EX13BT/GIM-2-059',
         count: 0,
         key: false,
         color: 'Red',

datas/ua30.js

@@ -660,7 +660,7 @@ export const cardList = [
         trigger: null,
     },
     {
-        imgSrc: '/ua30/EX11BT_ARK-2-05_p1.png',
+        imgSrc: '/ua30/EX11BT_ARK-2-050_p1.png',
         Number: 'EX11BT/ARK-2-050',
         count: 0,
         key: false,

datas/ua37.js

@@ -1321,7 +1321,7 @@ export const cardList = [
         trigger: null,
     },
     {
-        imgSrc: '/ua37/UA37BT_FMA-1-AP01_s.png',
+        imgSrc: '/ua37/UA37BT_FMA-1-AP01_p1.png',
         Number: 'UA37BT/FMA-1-AP01',
         count: 0,
         key: false,

datas/ua38.js

@@ -1061,7 +1061,7 @@ export const cardList = [
         trigger: null,
     },
     {
-        imgSrc: '/ua38/UA38BT_WBK-1-AP01_s.png',
+        imgSrc: '/ua38/UA38BT_WBK-1-AP01_p1.png',
         Number: 'UA38BT/WBK-1-AP01',
         count: 0,
         key: false,
@@ -1081,7 +1081,7 @@ export const cardList = [
         trigger: null,
     },
     {
-        imgSrc: '/ua38/UA38BT_WBK-1-AP02_s.png',
+        imgSrc: '/ua38/UA38BT_WBK-1-AP02_p1.png',
         Number: 'UA38BT/WBK-1-AP02',
         count: 0,
         key: false,
@@ -1101,7 +1101,7 @@ export const cardList = [
         trigger: null,
     },
     {
-        imgSrc: '/ua38/UA38BT_WBK-1-AP03_s.png',
+        imgSrc: '/ua38/UA38BT_WBK-1-AP03_p1.png',
         Number: 'UA38BT/WBK-1-AP03',
         count: 0,
         key: false,

datas/ua44.js

@@ -1683,27 +1683,6 @@ export const cardList = [
         rarity: 'PR',
         trigger: 'FINAL',
     },
-    // UAPR - AP
-    // {
-    //     imgSrc: '/ua44/UAPR_EVA-AP01.png',
-    //     Number: 'UAPR/EVA-AP01',
-    //     count: 0,
-    //     key: false,
-    //     color: '',
-    //     parallel: false,
-    //     rarity: '',
-    //     trigger: null,
-    // },
-    // {
-    //     imgSrc: '/ua44/UAPR_EVA-AP02.png',
-    //     Number: 'UAPR/EVA-AP02',
-    //     count: 0,
-    //     key: false,
-    //     color: '',
-    //     parallel: false,
-    //     rarity: '',
-    //     trigger: null,
-    // },
 ];
 
 

datas/ua45.js

@@ -1271,8 +1271,8 @@ export const cardList = [
         trigger: null,
     },
     {
-        imgSrc: '/ua45/UA45BT_TLR-1-A07.png',
-        Number: 'UA45BT/TLR-1-A07',
+        imgSrc: '/ua45/UA45BT_TLR-1-AP07.png',
+        Number: 'UA45BT/TLR-1-AP07',
         count: 0,
         key: false,
         color: 'AP',

docs/codex-handoff.md

@@ -0,0 +1,61 @@
+# Codex Handoff Guide
+
+## 목적
+- 이 문서는 다른 작업 환경이나 다른 Codex 세션에서 프로젝트를 이어받더라도 같은 품질 기준으로 작업하기 위한 운영 기준서다.
+- 특히 이 저장소는 정적 HTML/JS 프로젝트이면서 카드 데이터와 이미지 자산 비중이 크기 때문에, "코드 수정"보다 "데이터-번역-이미지 일치"가 더 중요하다.
+
+## 현재 기준 릴리즈
+- 현재 작업 기준 버전: `v3.1.0`
+- 이번 릴리즈 핵심 반영:
+- `ua51` 시리즈 추가
+- `ua49` 누락 병렬 이미지 보강
+- 다국어 시리즈명 추가
+- 버전 표기 및 문서 체계 정리
+
+## 다음 작업자에게 반드시 전달할 것
+- 이 프로젝트는 빌드 시스템 중심 앱이 아니라 `index.html`, `cardList.html`, `result.html` 3개 페이지가 직접 동작하는 정적 사이트다.
+- 신규 시리즈를 추가할 때는 항상 아래 3가지를 한 세트로 본다.
+- `datas/<series>.js`
+- `images/<series>/`
+- `i18n/translations.ko.json`, `i18n/translations.ja.json`, `i18n/translations.en.json`
+- 이미지 자산은 `images/**` 전체가 `Git LFS` 대상이다. 대용량 이미지가 일반 Git 객체로 들어가지 않게 주의한다.
+- `cardList.html`은 `?series=<seriesKey>` 값을 기준으로 `./datas/${seriesKey}.js`를 동적 import 한다. 즉, 시리즈 키 불일치가 있으면 화면에서 바로 깨진다.
+- 카드 이미지 렌더링은 최종적으로 `images/${seriesKey}/${fileName}` 규칙을 사용하므로, `imgSrc`에는 파일명 기준 일관성이 중요하다.
+- 릴리즈 버전이 바뀌면 최소한 아래 두 곳은 함께 맞춘다.
+- `index.html`의 `<title>` 및 상단 배지
+- `docs/spec.md`, `docs/update.md`, 필요 시 `docs/history.md`
+
+## 품질 기준
+- 신규 시리즈 반영 시 데이터 파일만 추가하고 번역 키를 빼먹지 않는다.
+- 카드 번호(`Number`) 그룹과 실제 파일명 규칙이 시리즈 키와 일치해야 한다.
+- 병렬 카드(`parallel: true`)는 일반 카드와 같은 카드 번호를 공유하되 이미지 파일만 다르게 유지한다.
+- `trigger`는 `null`, `COLOR`, `FINAL`, `SPECIAL`만 사용한다.
+- AP 카드의 `color`는 `AP`를 사용한다.
+- 릴리즈 전에 `git diff --stat`으로 변경 범위를 보고, 데이터/번역/이미지 중 빠진 축이 없는지 확인한다.
+
+## 작업 절차
+1. 변경 요청이 신규 시리즈 추가인지, 기존 시리즈 수정인지 먼저 구분한다.
+2. 관련 `datas/*.js`와 `images/<series>/` 상태를 확인한다.
+3. `i18n/translations.*.json`에 시리즈명 또는 UI 문구 변경이 필요한지 확인한다.
+4. 화면에서 버전 표기를 바꿔야 하는 성격의 변경인지 판단한다.
+5. `docs/update.md`에 이번 반영 내용을 남긴다.
+6. 릴리즈성 변경이면 `docs/history.md` 또는 이 문서에도 기준 변화를 남긴다.
+7. 커밋 전 `git status`, `git diff --stat`, 필요한 경우 간단한 구문 체크를 수행한다.
+
+## 릴리즈 전 체크리스트
+- `datas/<series>.js`가 실제로 import 가능한 형식인지 확인
+- `images/<series>/` 파일이 데이터의 `imgSrc`와 대응되는지 확인
+- `translations.ko/ja/en`에 시리즈 키가 모두 존재하는지 확인
+- 버전 표기가 문서와 UI에서 일치하는지 확인
+- `images/**`가 계속 LFS로 잡히는지 확인
+- 커밋 메시지에 릴리즈 의도가 드러나는지 확인
+
+## 커밋 메시지 가이드
+- 릴리즈 커밋 예시: `v3.1.0: add ua51 series and handoff docs`
+- 수정 커밋 예시: `fix: add missing ua49 parallel images`
+- 되돌림 커밋 예시: `revert: restore original card list interactions`
+
+## 주의할 점
+- 이 저장소는 이미지 비중이 매우 크다. 원격 업로드 전에 대용량 변경이 의도된 것인지 다시 확인한다.
+- 현재 문서 체계는 `docs/update.md`가 작업 로그, `docs/history.md`가 의사결정, `docs/spec.md`가 구조 명세 역할을 맡는다.
+- 후속 작업자가 빠르게 맥락을 잡게 하려면, "무엇을 바꿨는지"보다 "왜 같이 바꿔야 하는지"를 문서에 남기는 편이 더 중요하다.

docs/history.md

@@ -1,5 +1,14 @@
 # 의사결정 이력
 
+## 2026-04-19 / v3.1.0 릴리즈 기준 확정
+- 배경: 저장소의 마지막 명시 릴리즈 기록은 `v3.0.1`인데, 메인 화면은 이미 `v3.1`을 노출하고 있어 실제 릴리즈 이력과 화면 표기가 어긋나 있었다.
+- 결정:
+- 이번 반영분을 `v3.1.0`으로 정의하고, 화면 표기와 문서 표기를 같은 버전으로 통일한다.
+- 이후 버전 증가는 `docs/update.md`에 먼저 기록한 뒤 화면 표기와 함께 반영한다.
+- 이유:
+- 외부 협업자나 후속 Codex 작업자가 "현재 배포 기준이 무엇인지" 즉시 판단할 수 있어야 한다.
+- 자산 중심 정적 프로젝트 특성상 코드보다 데이터/이미지 변경이 잦기 때문에, 명시 릴리즈 기준이 없으면 누락 여부를 추적하기 어렵다.
+
 ## 2026-03-30 / 문서 체계 초기화
 - 배경: 프로젝트 루트에 AI 작업 규칙은 있었지만 `docs/` 실체가 없어 규칙과 실제 운영 상태가 분리되어 있었다.
 - 결정: 규칙 문서가 요구하는 핵심 문서 6종을 먼저 생성하고, 이후 변경 시 이 파일들을 기준 문서로 유지한다.

docs/spec.md

@@ -1,7 +1,7 @@
 # 기술 명세
 
 ## 1. 프로젝트 개요
-- 프로젝트명: `UADECK V3.1 - Union Arena Deck Builder`
+- 프로젝트명: `UADECK V3.1.0 - Union Arena Deck Builder`
 - 형태: 정적 HTML/CSS/JavaScript 기반 덱 빌더
 - 패키지 의존성: `tailwindcss`, `@tailwindcss/cli`
 - 빌드 산출 스타일: `style/output.css`

docs/update.md

@@ -1,5 +1,20 @@
 # 업데이트 이력
 
+## 2026-04-19 / v3.1.0
+
+### 수행 작업
+- `datas/ua51.js`를 추가해 `ua51` 시리즈 데이터를 등록했다.
+- `images/ua51/`에 `나 혼자만 레벨업` 카드 이미지 자산을 반영했다.
+- `images/ua49/`에 누락되어 있던 `마도정병의 슬레이브` 병렬 카드 이미지를 보강했다.
+- `i18n/translations.ko.json`, `i18n/translations.ja.json`, `i18n/translations.en.json`에 `ua51` 시리즈명을 추가했다.
+- `index.html`과 `docs/spec.md`의 버전 표기를 `v3.1.0`으로 통일했다.
+- 다음 작업자가 동일한 기준으로 이어받을 수 있도록 `docs/codex-handoff.md`를 작성했다.
+
+### 메모
+- 이번 릴리즈는 신규 시리즈(`ua51`) 반영과 누락 자산 보강이 핵심이다.
+- 배포 전에는 `datas/<series>.js`, `images/<series>/`, `i18n/translations.*.json` 세 축이 모두 맞물렸는지 반드시 함께 확인해야 한다.
+- 이미지 자산은 계속 `Git LFS` 대상으로 유지한다.
+
 ## 2026-03-30 / docs-bootstrap-1
 
 ### 수행 작업
@@ -38,3 +53,15 @@
 ### 메모
 - 이 작업 후 원격 저장소는 사실상 "현재 스냅샷 기반 새 저장소"처럼 동작한다.
 - 과거 커밋 이력, 기존 태그, 옛 해시는 원격 기준으로 더 이상 사용하지 않게 된다.
+
+## 2026-03-30 / v3.0.1
+
+### 수행 작업
+- 일부 시리즈 데이터의 잘못된 이미지 경로를 실제 파일명 기준으로 수정했다.
+- `ua04`, `ua30`, `ua37`, `ua38`, `ua45`의 `imgSrc` 오기입을 정정했다.
+- `ua44`에서 더 이상 사용하지 않는 주석 처리된 `UAPR/EVA-AP01`, `UAPR/EVA-AP02` 항목을 제거했다.
+- 누락되어 있던 이미지 파일 `images/ua08/UAPB_BLC-AP01.png`, `images/ua09/UAPR_BTR-AP03.png`를 반영했다.
+
+### 메모
+- 이번 반영은 카드 데이터와 실제 이미지 파일 간의 불일치를 줄이는 목적이다.
+- 버전 태그 체계는 `v3.x` 기준으로 이어간다.

i18n/translations.en.json

@@ -124,7 +124,11 @@
         "ua46": "Kagurabachi",
         "ua47": "Tokyo Ghoul",
         "ua48": "Kingdom",
-        "ua49": "Chained Soldier"
+        "ua49": "Chained Soldier",
+        "ua51": "SOLO LEVELING",
+        "ua52": "𝚃𝚑𝚎 𝙴𝚖𝚒𝚗𝚎𝚗𝚌𝚎 𝚒𝚗 𝚂𝚑𝚊𝚍𝚘𝚠",
+        "ua53": "Chainsaw Man",
+        "ua50": "InuYasha"
     },
     "uapr": "UNION ARENA"
 }

i18n/translations.ja.json

@@ -117,7 +117,11 @@
         "ua46": "カグラバチ",
         "ua47": "東京喰種トーキョーグール",
         "ua48": "キングダム",
-        "ua49": "魔都精兵のスレイブ"
+        "ua49": "魔都精兵のスレイブ",
+        "ua51": "俺だけレベルアップな件",
+        "ua52": "陰の実力者になりたくて！",
+        "ua53": "チェンソーマン",
+        "ua50": "犬夜叉"
     },
     "uapr": "UNION ARENA",
     "CardList": {

i18n/translations.ko.json

@@ -113,7 +113,11 @@
         "ua46": "카구라바치",
         "ua47": "도쿄 구울",
         "ua48": "킹덤",
-        "ua49": "마도정병의 슬레이브"
+        "ua49": "마도정병의 슬레이브",
+        "ua51": "나 혼자만 레벨업",
+        "ua52": "어둠의 실력자가 되고 싶어서!",
+        "ua53": "체인소 맨",
+        "ua50": "이누야샤"
     },
     "uapr": "UNION ARENA",
     "CardList": {