개발일지 ·
서비스 소개 확장과 방문자 분석
아이스큐브랩 홈페이지에 기관용 서비스 3개와 직접 운영하는 교육 서비스 소개를 더하고, 홈페이지·퀘스트큐브·해봄에 같은 Google Analytics 측정을 넣었다. IcePack은 에셋 중복과 제목을 정리하고 카탈로그 화면을 새로 만들었으며, 포포리게임에는 새 퍼즐 Quack Out을 등록했다.
10개 작업 기록22개 커밋
작업 기록 살펴보기 10
아이스큐브랩 홈페이지6
- 단기 특강·취업 지원·과정 운영 서비스 3개와 직접 운영 서비스 소개 추가
- 회사 소개서 PDF 내려받기와 JSON-LD 설립 정보 추가
- GA4 행동 이벤트 5종과 개인정보처리방침 통계 항목 추가
서비스 목록에 기관 수요 3개를 더하기
서비스 데이터에 011 단기 특강·워크숍, 012 취업·진로 지원, 013 과정 운영·성과 관리를 추가하고, 관련 포트폴리오 22건의 `relatedServices`에 새 서비스를 연결했다. 문구는 공개 포트폴리오의 수행·운영 기록만 근거로 쓰고 채용·훈련 승인·지원금은 보장하지 않는다고 적었다.
퀘스트큐브·해봄·픽셀스터디는 `src/data/platforms.ts`에 두고 서비스 페이지의 "직접 운영하는 서비스" 섹션과 홈의 링크 띠로 소개했다. 문구는 각 서비스의 공개 화면에서 확인한 범위로 한정했다. 회사 소개서 PDF는 소개 페이지에서 내려받게 했으며, 안내 문구의 파일 크기는 빌드 때 실제 파일에서 읽어 파일과 어긋나지 않게 했다.
방문자 분석을 이벤트까지 넓히고 방침에 적기
`generate_lead`, `profile_download`, `platform_click`, `click_phone`, `click_email` 이벤트를 GA4로 보내도록 하고, 이름·이메일·문의 내용은 어떤 이벤트에도 넣지 않았다. 개인정보처리방침에 "방문 통계 분석" 항목을 추가했다.
이벤트 목록과 GA 관리자에서 할 설정, 하루 방문자 수를 보는 위치는 `docs/analytics.md`에 정리했다. 이 문서는 처음에 서비스 3종에는 분석 태그가 없다고 적었다가 같은 날 뒤 커밋에서 세 서비스가 같은 GA 속성을 쓴다는 내용으로 고쳤다. 같은 문서에는 픽셀스터디가 승인·배포 대기 중인 브랜치에 있다고 적혀 있다. 이 커밋들만으로 실제 GA 보고서에 데이터가 들어온 것은 확인되지 않는다.
IcePack5
- 에셋 중복 293개 삭제와 제목·NAS 파일 이름 2,571건 정리
- 엔진·분류 서랍, 새 카드, 인기·담기 정렬을 갖춘 카탈로그 1단계
- 회원 마지막 접속·일별 접속·로그인 기록과 대시보드 표시
- DB 종료 대기 감독, 앱 실행 분류 변경 등 11월 14일 운영 복구 기록
데이터부터 정리하기
카탈로그 화면이 메타데이터 품질에 기대므로 계획 문서는 데이터 정리를 먼저 두었다. 제목을 정규화해 같은 상품 379묶음을 찾고, 확실하거나 거의 확실한 293개를 DB와 NAS 휴지통에서 지워 에셋이 5,146개에서 4,853개가 됐다. 구버전으로 추정한 93개는 보류했다.
제목은 마켓플레이스 접두어와 엔진 버전 표기를 떼는 규칙(`asset-title.ts`, 테스트 46개)으로 정리했다. NAS 파일·폴더 2,001개와 미리보기 570개의 이름을 "제목 (UE 4.24-4.26)" 형식으로 바꾸고 DB의 제목·엔진 버전·경로를 한 트랜잭션으로 맞췄다. 엔진 버전을 가진 에셋은 20개에서 536개로 늘었고 경로 누락은 0이었다. 두 작업 모두 백업 뒤에 운영에 반영했다.
확장자로 잘못 잘린 미리보기 이름
이름을 바꾼 뒤 UE Asset5 등록에서 미리보기를 찾지 못하는 문제가 있었다. "Pack (UE 4.25)"의 ".25)"를 확장자로 잘라 같은 이름의 이미지와 짝이 맞지 않았던 것이다. 이름 비교에서 알려진 압축·이미지 확장자만 떼도록 고쳐 등록된 미리보기가 388개에서 540개가 됐다. UE Asset5(4.63TB)와 기존 UE Asset 1~4의 중복 판정표, 영문 이름 제안, 8,487건의 NAS 이동 기록과 되돌리기 도구도 문서로 남겼다.
카탈로그 개편과 접속 현황
홈 카탈로그를 앱형으로 바꿨다. 큰 소개 영역을 한 줄로 줄이고, 왼쪽에 엔진과 카테고리 2단계 서랍, 16:10 카드와 NEW 배지, 다운로드 많은 순·많이 담은 순 정렬, 상단의 남은 용량 칩을 넣었다. 다운로드 흐름은 그대로 두었다. 단위 테스트 346개와 E2E 31개가 통과했고 운영 DB 사본에서 데스크톱·모바일 화면과 회원 상태 칩을 확인했다.
회원 접속 현황은 마지막 접속, 날짜별 접속, 로그인 기록을 새 테이블로 남기고 대시보드와 회원 목록에 보여 준다. 기록이 실패해도 로그인과 세션은 유지된다. 단위 테스트 341개와 E2E 31개가 통과했고 운영 백업 사본에서 새 마이그레이션만 적용되는 것을 확인했다.
5일 늦게 기록한 운영 복구
11월 14일에 운영에 이미 적용한 변경을 이날 기록으로 커밋했다. 운영 PostgreSQL이 smart shutdown 요청을 받고 유휴 연결을 기다리며 새 연결을 거부해 홈페이지 500과 상태 API 503이 났고, 재발 방지로 종료 대기가 15초 이어지면 fast 종료를 한 번 하는 DB 감독 도구를 추가했다. `prod:status`는 프로세스 생존이 아니라 앱 계정의 실제 쿼리 성공으로 정상 여부를 판단하도록 바꿨다.
13~21초로 관찰된 로그인 지연은 앱 LaunchDaemon의 ProcessType을 Adaptive에서 Interactive로 바꾼 뒤 0.3~0.8초로 측정됐다고 기록돼 있다.
퀘스트큐브3
- 홈페이지와 같은 GA4 속성을 쓰는 방문자 분석 컴포넌트 추가
- 개인정보처리방침에 방문 통계 분석 항목 추가, 시행일 갱신
- 푸터 소재지 표기와 신고 서류 문구 정정
로그인 앱에서 분석을 보내지 않을 곳 정하기
퀘스트큐브는 로그인 앱이라 `GoogleAnalytics` 컴포넌트는 운영 빌드에서만 동작하고 자동화 브라우저에서는 보내지 않는다. 관리자·강사·로그인·마이페이지·결제 같은 화면과 `token`·`code`·`email` 등이 붙은 주소로 처음 접속할 때는 분석 코드를 불러오지 않고, 첫 조회에는 쿼리 문자열을 뺀 경로만 보낸다. 방침 페이지에는 수집 항목과 함께 이 사실을 적었다.
Playroom2
- 원터치 퍼즐 Quack Out을 카탈로그와 실행 허용 목록에 등록
- 전체 게임 11개, 새 게임 7개로 숫자와 테스트 갱신
- Sites 호스팅 설정을 지우고 Cloudflare Workers만 배포 경로로 정리
새 게임 등록과 배포 확인
카탈로그에 항목을 더하고 `game-snapshots.json`에 원본 커밋을 기록했으며, 정적 숫자와 필터 기대값을 고쳤다. 작업 시작 때 커밋되지 않은 채 남아 있던 Sites 연동 제거 변경은 사용자에게 알린 대로 같은 커밋에 들어갔다.
`popori` Worker에 배포한 뒤 홈, 게임 경로, 대표 이미지가 200이고 없는 경로가 404인 것, 포털 플레이어 안에서 캔버스와 시작 화면이 열리고 콘솔 오류가 없는 것을 확인했다. 배포된 주소에서 끝까지 플레이해 보지는 않았다고 기록돼 있다.

catalog.js카탈로그의 games 배열 끝에 quack-out 항목을 더하는 부분.당일 커밋 소스 발췌 · 2026-11-19 · 6f222a1 tag: '블록 퍼즐', color: 'petal', icon: '❀', isNew: true,
repo: 'https://github.com/ingunbi/petal-blocks', path: './games/petal-blocks/',
keywords: '꽃잎 블록 petal blocks 블록 퍼즐 드래그 끌어서 놓기 줄 지우기 콤보 꽃 캐주얼 block puzzle drag'
},
{
id: 'quack-out', title: 'Quack Out', korean: '꽥꽥 탈출', genre: '퍼즐',
description: '오리를 탭하면 바라보는 쪽으로 쏙! 앞길이 빈 오리부터 골라 연못 밖으로 내보내요.',
controls: '오리를 탭해서 내보내기 · 키보드는 방향키로 고르고 Space로 누르기', time: '1–3분', durationMinutes: 3,
quickControls: '앞이 빈 오리를 탭해요',
tag: '탈출 퍼즐', color: 'quack', icon: '➤', isNew: true,
repo: 'https://github.com/ingunbi/quack-out', path: './games/quack-out/',
keywords: '꽥꽥 탈출 quack out 오리 연못 탈출 화살표 방향 탭 원터치 퍼즐 가족 모자 캐주얼 duck escape arrow'
}
];Quack Out1
- 탭한 방향으로 오리가 빠져나가는 원터치 탈출 퍼즐 첫 버전
- 오리 가족·힌트·별·모자 해금·키보드 조작과 테스트 26개
풀 수 있는 연못만 만들기
오리는 바라보는 쪽으로 헤엄쳐 나가고, 앞에 다른 오리가 있으면 부딪혀 하트가 줄어든다. 연못은 오리를 빼내는 순서를 거꾸로 따라가며 생성해 모든 스테이지가 막다른 길 없이 풀리게 했다. 개발일지에는 포털에 아직 없던 장르를 골랐고, 이름·그림·규칙 세부는 새로 만들었다고 적혀 있다.
해봄1
- 개인정보를 피하는 GA4 방문자 측정 컴포넌트 추가
- 소개 화면 바닥글과 로그인·가입 화면에 사용 안내
토큰이 붙는 주소는 건너뛰기
인증 메일과 재설정 링크에는 일회용 토큰이 붙으므로 해당 경로와 `token`·`code`·`email` 같은 값이 붙은 주소에서는 분석 코드를 불러오지 않게 했다. 개발 환경과 자동화 브라우저에서도 보내지 않고, 첫 조회에는 경로만 보낸다. 해봄에는 별도 개인정보처리방침 페이지가 없어 화면 안내 문구로 알렸다.
app/google-analytics.tsx분석을 켜는 조건과, 불러오지 않을 경로·쿼리 이름을 정하는 부분.당일 커밋 소스 발췌 · 2026-11-19 · e15cb2b// 방문자 분석(Google Analytics 4).
// 홈페이지(www.icecubelab.com)와 같은 측정 ID를 쓰므로 GA 보고서에서 호스트 이름(haebom.icecubelab.com)으로 나눠 본다.
// NEXT_PUBLIC_GA_MEASUREMENT_ID를 빈 문자열로 지정하면 분석을 끈다. 개발·자동화 브라우저에서는 보내지 않는다.
const GA_MEASUREMENT_ID = process.env.NEXT_PUBLIC_GA_MEASUREMENT_ID ?? 'G-YH66PDB4LV';
// 인증 메일·재설정 링크에는 일회용 토큰이 붙으므로 이런 주소에서 처음 접속할 때는 분석 코드를 불러오지 않는다.
const SKIPPED_PATH = /^\/(api|verify-email|reset-password|forgot-password)(\/|$)/i;
const SKIPPED_PARAMS = ['token', 'code', 'state', 'email', 'otp', 'key', 'ticket', 'secret', 'password', 'error'];
export default function GoogleAnalytics() {
useEffect(() => {
if (process.env.NODE_ENV !== 'production' || !GA_MEASUREMENT_ID || navigator.webdriver) return;
if (document.getElementById('ga4-loader')) return;
const { pathname, searchParams } = new URL(window.location.href);INKWON WORKS 포털1
- 휴대폰에서 목록 화면이 좌우로 흔들리던 문제 수정
화면보다 넓던 선택 상자
휴대폰에서 상태·정렬 선택 상자와 보기 전환 버튼이 화면보다 넓어 페이지 전체가 좌우로 밀렸다. 선택 상자는 남은 폭에 맞춰 줄어들며 말줄임표로 잘리게 하고, 보기 전환 버튼은 크기를 유지하게 했다. 실제 기기에서 확인한 기록은 근거에 없다.
web/styles.css모바일 폭에서 선택 상자는 줄어들고 보기 전환은 크기를 지키도록 한 규칙.당일 커밋 소스 발췌 · 2026-11-19 · 8d41320 #add-project { flex-shrink: 0; padding: 0 12px; font-size: 12px; }
.select-tools { flex: 1 1 auto; min-width: 0; gap: 6px; }
.select-tools select { flex: 0 1 auto; min-width: 0; max-width: 100%; min-height: 36px; font-size: 12px; padding: 0 26px 0 10px; background-position: right 7px center; text-overflow: ellipsis; }
.category-tabs { width: 100%; gap: 2px; margin-bottom: 0; }
.category-tab { min-height: 44px; padding: 0 8px; font-size: 13px; }
.view-tools { flex-shrink: 0; padding-bottom: 0; gap: 8px; }
.view-toggle button { width: 36px; height: 30px; }Parallax1
- 갤러리 승인 뒤 태그와 큰 화면용 이미지가 앱에 자동 전달되도록 변경
- 큰 이미지를 Worker의 KV에 보관해 재배포 없이 제공
승인만 하면 끝나게 하기
이전에는 큰 이미지를 만들려면 별도 명령을 실행하고 사이트를 재배포해야 했다. 이제 동기화가 갤러리 카드의 태그(기법 계열·기법·연작, 모델 이름·seed·단계 표시는 제외)를 작품 목록과 함께 보내고, 새 작품의 1440px WebP를 만들어 관객 Worker에 올린다. Worker는 KV에 보관해 기존과 같은 `/curation-large/` 경로로 내보낸다. 손으로 단 검수 태그가 있는 작품은 그대로 두고 없는 작품에만 갤러리 태그를 쓴다.
Python과 Worker 양쪽에 테스트 파일(`test_large_images.py`, `large-cache.test.mjs`)을 추가했다. 이 커밋 기록에는 테스트 실행 결과와 운영 반영 확인이 따로 없다.
INKWON WORKS 작업 공간1
- 포털 서브모듈을 모바일 가로 스크롤 수정 커밋으로 갱신
김인권 작가 홈페이지1
- 11월 18일 개발일지 발행
출처 · 깃허브 커밋