union-arena-deck-builder/docs/update.md

업데이트 이력

2026-03-30 / docs-bootstrap-1

수행 작업

• 프로젝트 루트의 .ai-rules.md와 .cursorrules를 검토하여 문서 운영 규칙을 확인했다.
• 부재하던 docs/ 디렉터리를 생성하고 문서 기본 세트(update.md, todo.md, spec.md, convention.md, history.md, map.md)를 초기 구축했다.
• 정적 사이트 구조를 기준으로 주요 페이지(index.html, cardList.html, result.html)와 보조 스크립트(script/navigation.js, i18n/i18n.js)의 역할을 문서화했다.
• 카드 데이터셋 구조(datas/*.js)와 이미지 경로 규칙(images/<seriesKey>/<fileName>)을 정리했다.
• 이미지 저장소 현황을 점검했다.
• 점검 결과: images/ 디렉터리 약 1.7G, 이미지 파일 약 9,370개, 데이터 파일 52개.
• 대용량 이미지 자산 관리를 위한 Git LFS 도입 검토 사항과 주의점을 문서에 반영했다.

메모

• 현재 저장소에는 docs/가 없었기 때문에 이번 작업은 문서 체계 초기 세팅 성격이 강하다.
• Git LFS는 신규 이미지 유입 관리에는 유효하지만, 저장소 자체를 즉시 가볍게 만들지는 않으므로 히스토리 정리 전략을 별도 검토해야 한다.

2026-03-30 / lfs-migration-1

수행 작업

• images/** 전체를 Git LFS 대상으로 관리하기 위해 .gitattributes를 추가했다.
• 기존 저장소 용량 절감을 목표로 Git LFS 히스토리 마이그레이션을 수행하는 방향으로 결정했다.
• 현재 변경분을 포함한 뒤 전체 히스토리를 재작성하고 강제 푸시하는 절차를 진행한다.

메모

• 이번 작업은 단순 추적 설정이 아니라 과거 커밋까지 다시 쓰는 작업이므로 커밋 해시가 변경된다.
• 원격 반영 시 일반 푸시가 아닌 force-with-lease가 필요하다.
• 마이그레이션 체크아웃 이후 ua27의 추가 이미지와 데이터 보완분이 확인되어 최종 반영 대상에 포함했다.

2026-03-30 / repo-reset-1

수행 작업

• 저장소 용량을 근본적으로 단순화하기 위해 현재 로컬 작업본을 기준으로 새 루트 커밋 하나만 남기는 방향으로 전환했다.
• 기존 Git 히스토리는 원격 main에서는 제거하고, 로컬 백업 브랜치로만 보존하는 방식으로 진행한다.
• images/**는 계속 Git LFS 대상으로 유지한다.
• 새 시작 버전은 v3.0.0으로 정하고, 기존 1.x, 2.x 버전 이력은 새 원격 기준에서 계승하지 않기로 했다.

메모

• 이 작업 후 원격 저장소는 사실상 "현재 스냅샷 기반 새 저장소"처럼 동작한다.
• 과거 커밋 이력, 기존 태그, 옛 해시는 원격 기준으로 더 이상 사용하지 않게 된다.

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 기준으로 이어간다.