akashicrecords/게임 추가 운영
최근 수정 시각: 2026-07-11 00:13:16
1. 무엇을 하는가
새 게임을 추가할 때는 대문 카드용 메타데이터와 게임별 페이지를 함께 만든다. 공개 화면에는 게임 추가 버튼이 없으며, 이 절차는 저장소를 편집하는 운영자용 흐름이다.
2. 기본 흐름
- 게임의 기본 정보와 필요한 자료 범위를 조사한다.
- 단일 정보 페이지로 만들지, 공략·도감·도구를 나눈 허브로 만들지 구성 계획을 정한다.
games/<id>/index.html과 필요한 서브페이지·스타일·이미지 폴더를 만든다.games.json의games배열에 카드 메타데이터 한 항목을 추가한다.- 게임 페이지에 아카식 레코드 대문으로 돌아가는 ← 아카식 레코드 링크를 둔다.
- 정적 서버에서 대문 카드, 미리보기, 게임 페이지, 회귀 링크를 확인한다.
- Cloudflare Pages의 프로덕션 브랜치
main으로 배포한다.
전용 워크플로는 /akashic 또는 게임 페이지 추가 요청으로 조사 → 페이지 구성 계획 → 승인 → 구현 → 이미지 요청 → 피드백 마무리 순서를 밟는다.
3. games.json 작성
카드에 쓰이는 주요 필드는 다음과 같다.
| 필드 | 화면에서 쓰이는 곳 |
|---|---|
id |
games/<id>/ 경로와 카드 식별자 |
title, subtitle |
카드와 미리보기의 게임명 |
genre, platform, tags |
검색·필터와 분류 표시 |
status |
진행중·완료·대기 상태 |
lastPlayed, playtimeHours, progress |
활동 시점·플레이타임·진행도 정렬과 표시 |
notes, tools, guides |
카드와 미리보기의 자료 수 |
coverGradient, coverGlyph, accent |
대문 카드의 시각 구분 |
summary |
카드 미리보기의 소개문 |
상태 값은 playing, completed, waiting 중 하나를 사용한다. 플랫폼 필터는 문자열이 정확히 일치하는 항목만 남기므로 기존 필터 칩과 표기를 맞추는 것이 좋다.
4. 게임 페이지 구성
게임 페이지는 디자인을 자유롭게 잡을 수 있지만 다음 두 가지는 유지한다.
games/<id>/index.html이 첫 진입점이다.- 페이지 어딘가에
<a href="/">← 아카식 레코드</a>형태의 회귀 링크를 둔다.
여러 페이지로 나누는 경우 게임 허브에서 모든 자료를 찾을 수 있는 파일 인덱스를 제공하고, 서브페이지에서도 게임 허브 또는 대문으로 돌아갈 수 있게 한다. 외부 이미지와 생성 이미지의 출처·교체 요청은 게임별 assets/requests/ 문서로 관리할 수 있다.
5. 검수할 것
- 새 카드가 대문에 보이고 검색·상태·플랫폼 조건에서 예상대로 남는가
- 카드를 눌렀을 때 요약과 자료 수가 맞는가
- 게임 페이지 열기가 올바른
games/<id>/로 이동하는가 - 게임 허브의 모든 내부 링크와 ← 아카식 레코드 링크가 동작하는가
- 좁은 화면에서도 핵심 콘텐츠를 읽을 수 있는가