개발일지 ·

NAS 영상 전환과 폴라 리포트

퀘스트큐브의 영상·이미지·자료 파일을 맥미니의 로컬 폴더에서 NAS로 옮겨 전체 체크섬을 대조하고, NAS 연결이 끊기면 로컬에 대신 저장하지 않고 요청을 거절하도록 업로드 서버를 고쳤다. 폴라는 매일 보내는 프로젝트 리포트를 메시지 한 개로 줄였고, 소유자 ID가 봇 자신으로 저장되는 설정 오류를 막았다. Waryong Engine 저장소를 만들고 INKWON WORKS 작업 공간을 Git 저장소로 정리했다.

8개 작업 기록21개 커밋

작업 기록 살펴보기 8

퀘스트큐브7

  • 영상·이미지·자료 41,378개를 NAS로 옮기고 전체 SHA-256 대조
  • NAS 연결이 끊기면 업로드·재생을 503으로 거절하고 로컬 대체 저장 차단
  • 스트림 쓰기 흐름 제어와 저장 전 동기화, 재연결 뒤 변환 검사 재개
  • 재부팅 뒤 NAS 연결과 영상 재생을 확인하는 검사기 준비

영상 파일을 NAS로 옮기고 전부 대조했다

앱·DB·업로드·영상 변환은 맥미니에서 그대로 돌리고, 영상·HLS·이미지·자료 파일만 NAS 공유에 두는 구조로 바꿨다. 공개 주소와 DB에 적힌 상대 경로는 건드리지 않았다. 복사는 기존 NAS 파일을 덮어쓰지 않는 rsync로 했고, 첫 복사가 도는 동안에는 서비스를 유지했다. 마지막 동기화 전에는 신규 쓰기를 503으로 막아 진행 중인 요청과 변환이 0건인 것을 확인했다. NAS에서 직접 계산한 SHA-256이 로컬 원본 41,378개와 모두 일치한 뒤에 저장 경로를 바꿨다.

전환 뒤 검증은 HLS 재생 목록 88개의 종료 표시와 세그먼트 41,085개 참조, 공개 HTTPS 주소의 범위 요청(강의별 시작·중간·끝 27건이 모두 206), 공개 업로드 API로 올린 영상·이미지·PDF의 저장과 새 영상의 HLS 변환이었다고 문서에 적었다. 그 뒤 로컬 복사본 41,378개를 다시 SHA-256으로 확인하고 지워 가용 공간이 약 28.0GB에서 82.6GB로 늘었다.

연결이 끊기면 로컬에 대신 쓰지 않고 거절하기

업로드 서버는 요청마다 SMB 파일시스템인지, 경로가 공유 안에 있는지, 공유 루트의 식별 파일이 고정해 둔 값과 같은지 검사하고, 하나라도 어긋나면 업로드와 재생 API가 503을 돌려주게 했다. 마운트가 없을 때의 로컬 폴더는 비어 있고 권한을 0500으로 두며, 서버는 30초마다 전용 마운트를 다시 연결해 본다. 기존 디스크 공간 검사도 손봤다. 이 검사는 공간을 확인하지 못하면 `ok: true`로 일단 진행했는데, 저장소 확인이 실패하면 쓰기를 거절하도록 `ok: false`로 뒤집었다.

점검용 파일이 있으면 신규 쓰기를 막고, `/storage-status`가 진행 중 요청 수와 변환 대기열, 점검 여부를 돌려준다. 테스트로는 NAS가 없을 때 영상·이미지·자료 업로드와 변환 요청이 모두 503을 받고 대체 폴더가 생기지 않는지, 환경 파일을 두 번 다시 만들어도 NAS 설정이 유지되는지를 추가했다. 처음 쓴 테스트는 자료 업로드 경로를 `/upload-resource`로 적었지만 서버의 실제 경로는 `/upload-file`이어서, 별도 커밋에서 고쳤다.

NAS가 느릴 때 영상 전체가 메모리에 쌓이지 않도록 업로드 본문을 직접 쓰던 부분을 `stream.pipe(writeStream)`으로 바꾸고, 최종 경로로 옮기기 전에 `fsync`로 원격 파일시스템이 데이터를 받았음을 기다리게 했다. 이미지와 첨부 128KB를 올려 바이트가 그대로 보존되는지 보는 테스트도 더했다. 또 NAS가 꺼진 채 업로드 서버가 시작하면 시작 때 한 번만 하던 중단된 HLS 변환 복구 검사가 건너뛰어지고 이후 다시 실행되지 않았다. 연결이 돌아온 뒤 진행 중인 요청과 변환이 없을 때 이 검사를 다시 하도록 바꿨다.

재부팅 검증은 준비까지

전환 문서에는 실제 재부팅과 부팅 직후의 SMB 인증 접근은 이번 작업에서 검증하지 않았다고 적혀 있다. 이를 확인하려고 `prepare-media-boot-check.mjs`를 추가했다. 이 스크립트는 읽기 전용 검증기와, 일회성 시스템 LaunchDaemon을 설치하고 재부팅하는 스크립트를 준비한다. 검증기는 재부팅 뒤 최대 15분 동안 NAS 공유 식별과 로컬 대체 저장 부재, 시스템 서비스, 공개 HTTPS 헬스체크, 레슨별 HLS 연결, 강의별 중간 구간 디코딩, 범위 요청과 썸네일을 검사하고 결과를 `result.json`에 남긴다. 같은 부팅에서 미리 돌린 결과는 `dry-run.json`에 따로 저장해 성공으로 혼동하지 않게 했다.

마지막 커밋은 새 검사를 준비할 때 이전 `result.json`을 이력 파일로 옮기고 원래 파일을 지우도록 고쳤다. 새로 건 검사가 옛 성공 기록을 보여 주지 않게 하려는 변경이다. 실제 재부팅 결과는 이날의 근거에 없다.

upload-server/index.js디스크 공간 검사가 저장소 확인에 실패했을 때의 기본값을 `ok: true`에서 `ok: false`로 바꾼 부분. 공유 확인을 먼저 호출하고, 실패하면 쓰기를 거절한다.당일 커밋 소스 발췌 · 2026-11-16 · a22b2aa
// macOS df는 GNU 옵션(-BM, --output)을 몰라 항상 실패했다. statfs는 리눅스·macOS 모두에서 동작한다.
function checkDiskSpace() {
  try {
    assertMediaStorage();
    const stats = fs.statfsSync(VIDEOS_DIR);
    const freeMB = Math.floor((stats.bavail * stats.bsize) / 1024 / 1024);
    return { ok: freeMB >= MIN_DISK_FREE_MB, freeMB };
  } catch (e) {
    logger.warn("디스크 공간 확인 실패", { error: e.message });
    return { ok: false, freeMB: -1 }; // 저장소 확인 실패는 쓰기를 거절한다.
  }
}

폴라6

  • 프로젝트 리포트를 메시지 한 개로 줄이고 문제 있는 항목을 맨 위로
  • 봇 토큰만 새로 넣는 setup --reconnect 추가
  • 소유자 ID에 봇 자신이 저장되지 않도록 설정 창과 설정 읽기에서 검사
  • Prop Foundry 점검 기준을 워커로 바꾸고 Dawnless 경로·새 아바타 반영

소유자 ID로 봇 자신이 저장되어 DM이 모두 거부됐다

Discord가 애플리케이션 소유자로 봇 계정 자신을 돌려주는 경우가 있었고, 설정 창은 이를 그대로 저장했다. 그러면 실제 소유자의 DM이 모두 거부되고 리포트 DM도 만들 수 없다. README는 이 문제가 11월 16일에 실제로 일어나 고쳤다고 적었다. 설정 창은 자동으로 확인한 소유자가 봇 자신이면 저장하지 않고 본인의 사용자 ID를 입력하라고 안내한다. 이미 그렇게 저장된 설정은 `settings.json`을 읽는 단계에서 소유자가 없는 것으로 보아 `launch`가 설정 창을 다시 열게 했다. 두 경로를 모두 다루는 테스트를 추가했다.

같은 날 봇 토큰만 새로 발급했을 때를 위한 `python -m polar setup --reconnect`도 들어갔다. 저장된 봇 ID와 같은 봇의 토큰만 받고, 저장된 소유자와 설정은 그대로 둔 채 서버 초대 페이지를 건너뛰며, 토큰을 저장한 뒤 폴라를 바로 시작한다. 다른 봇의 토큰을 넣으면 거절하는 테스트가 함께 있다. README에는 Codex 앱 안에서 폴라를 실행하면 데이터 폴더가 따로 생겨 설정·대화·리포트 기록이 둘로 갈라졌던 일을 정리하고, 데이터 폴더를 하나만 쓰도록 적었다.

리포트를 Discord 메시지 하나에 맞추기

이전 리포트는 프로젝트마다 접속·개발·운영 줄을 길게 붙여 메시지 두 개, 약 2,000자로 나갔다. 새 `compose_report`는 문제가 있는 프로젝트를 세부와 함께 맨 위에 두고, 정상인 프로젝트는 한 줄로 줄인다. 한 메시지에 들어가지 않으면 정상 프로젝트의 주소, 그다음 정상 프로젝트의 세부를 차례로 줄이고, 그래도 넘치면 잘라 낸다. 커밋 메시지는 길이가 약 2,000자에서 약 870자로 줄었다고 적었다.

이를 위해 점검 결과를 건강한 상태인지 기억하는 `Finding`과 프로젝트별 `Section`으로 나눠 다시 짰다. Git 현황은 마지막 커밋 날짜·변경 수·원격 대비 상태만 남겼다. 이 PC의 PATH에는 git이 없어서 `POLAR_GIT`, 설정 파일의 `git`, PATH, 표준 설치 폴더 순으로 실행 파일을 찾게 했다. 마나메트릭의 App Store 수집 점검은 11월 13일에 예약 작업을 지웠기 때문에 뺐고, 박사과정 프로젝트의 점검 경로는 구글 드라이브가 아닌 로컬 폴더로 바꿨다. README에는 2026-11-16 기준 전체 테스트 217개 통과로 적었다(11월 4일 기준은 194개).

꺼 둔 컨트롤러가 매번 경고를 냈다

Prop Foundry 점검은 제작 팜 컨트롤러가 남긴 상태 스냅샷을 읽었다. 컨트롤러는 11월 8일부터 일부러 꺼 두었는데, 멈춘 스냅샷 때문에 리포트마다 상태가 오래되었다는 경고와 실행 중이 아닌 노드가 있다는 경고가 났다. 그래서 예약 작업 `Prop-Foundry-Worker`가 실행 중인지를 기준으로 판정하고, 컨트롤러 작업이 켜져 있거나 작업 목록을 읽지 못했을 때만 스냅샷을 보게 했다. 워커 작업이 없거나 실행 중이 아닌 경우, 컨트롤러가 켜져 있는데 스냅샷이 오래된 경우는 여전히 문제로 보고하는 테스트를 추가했다. Dawnless 저장소가 한 단계 아래 폴더로 옮겨져서 리포트의 점검 경로도 바꿨다.

청록빛 오로라가 번지는 남색 밤하늘 위에 별 하나가 빛나고, 가운데에 볼이 분홍빛인 흰곰 얼굴이 놓인 정사각형 아바타
11월 16일 커밋으로 추가된 폴라 봇 아바타 원본(1024×1024). 오로라가 비치는 밤하늘 앞의 흰곰 얼굴이다.커밋에 포함된 원본 · 2026-11-16 · fa6a559
polar/project_reports.py문제가 있는 프로젝트를 맨 위에 두고, 한 메시지에 들어갈 때까지 정상 프로젝트의 표시를 단계적으로 줄이는 리포트 조립 함수.당일 커밋 소스 발췌 · 2026-11-16 · b62da3e
def compose_report(sections: list[Section], now: datetime) -> str:
    """Problems first; shrink healthy projects step by step until one message fits."""
    ordered = sorted(sections, key=lambda item: item.ok)
    broken = sum(not item.ok for item in ordered)
    summary = "모두 정상" if not broken else f"⚠️ 확인 필요 {broken}곳 · ✅ 정상 {len(ordered) - broken}곳"
    title = f"🐻‍❄️ **폴라 · 프로젝트 리포트** · {now:%m/%d %H:%M} KST\n{summary}"

    def build(level: int) -> str:
        blocks = [_render(item, url=level == 0) for item in ordered if not item.ok or level < 2]
        healthy = [item.name for item in ordered if item.ok]
        if level >= 2 and healthy:
            blocks.append("✅ 정상: " + ", ".join(healthy))
        return title + "\n\n" + "\n\n".join(blocks)

    for level in range(3):
        text = build(level)
        if _fits(text):
            return text
    return text[:1800].rstrip() + "\n…(길이 제한으로 일부 생략)"

Waryong Engine3

  • 1990년대 삼국지 전략 RPG를 Swift로 다시 만드는 엔진 저장소 첫 커밋
  • 공용 엔진·macOS 앱(native)과 안드로이드 앱 골격(android) 추가
  • 원작 자료·추출 결과·빌드 산출물은 저장소에서 제외
  • 프로젝트 이름을 Waryong Engine으로 정리하고 게임 자료를 별도 저장소로 분리

코드와 게임 자료를 나눠 올리기

첫 커밋은 `native/`(공용 엔진, macOS 앱, 시험·검증 도구)와 `android/`(같은 엔진을 쓰는 앱)의 파일 164개를 올렸다. 안드로이드 앱은 Mac판 엔진 소스를 SwiftPM 패키지에서 심볼릭 링크로 가리켜 그대로 컴파일하고, 화면만 Kotlin(Jetpack Compose)으로 새로 만든다. android README는 시작 화면부터 대사·선택지, 마을 화면까지는 태블릿에서 확인했고 지도·전투 화면, 소리, 저장·불러오기, 상점은 아직 없다고 적었다.

원작 실행 파일·그림·음악·대사·수치표와 거기서 뽑은 결과는 저장소에 두지 않는다는 원칙을 README와 `.gitignore`에 적었다. 곧이어 README를 더하고 프로젝트 이름과 경로를 Waryong Engine으로 정리했고, 1분 뒤 마지막 커밋에서 게임 자료를 `waryong-resources`로 분리해 원래 자리에는 링크만 남겼다. 이때 `.gitignore`의 `/original/`, `/analysis/` 같은 항목에서 끝 슬래시를 뺐다. 함께 올라간 native README와 원본 자산 복원 기록은 둘 다 원작 전체와 같다고 검증한 것은 아니라고 한계를 적고 있다.

Dawnless1

  • 게임 서버를 server 폴더로, 개인 플레이 에이전트를 agent 폴더로 나눈 구조를 문서에 반영
  • 작업 지침·폴더 안내·프로젝트 경계 문서의 경로 갱신

아이스큐브랩 홈페이지1

  • 지원 서비스에 기업 R&D 조직·연구소 설립 자문 페이지 추가
  • 서비스 상세 페이지에 공식 참고 자료 링크 구역 추가
  • 연구소 인정·세액공제·지원사업 선정은 보장되지 않는다는 안내 포함
  • 홈과 서비스 목록의 지원 서비스 문구에 연구소 설립 자문 반영

INKWON WORKS 작업 공간1

  • 작업 공간을 비공개 Git 저장소로 정리하고 포털을 서브모듈로 연결
  • 개발일지 수집·이미지 변환·검증·발행 도구와 테스트의 보관본 추가
  • 원본 근거·보관 폴더는 Git에서 제외하고 폴더 위치 안내 문서 작성

운영 도구는 보관본으로만 두기

`portal/`은 기존 inkwonworks-portal 저장소의 서브모듈로 연결했다. `tools/devlog/`에는 Windows 작업 PC에서 매일 개발일지를 쓰는 수집·이미지 변환·검증·발행 도구와 테스트를 올렸지만, README는 이것이 운영 파일의 보관본이며 이 폴더에서 예약 작업을 새로 만들지 않는다고 적었다. 날짜별 원본 근거·캡처·검증 자료와 이전 패키지는 비공개 운영 정보가 섞일 수 있어 `.gitignore`로 제외했다.

같은 날 작업 현황 문서에는 개발일지의 2~11월 글을 과정 기록·코드·이미지로 보강한 일과, 새로 넣는 코드를 당일 날짜·파일·SHA·연속 구간으로 검사하는 규칙이 정리됐다. 아래 코드는 그 검사의 핵심인 `added_code_matches`로, 글에 넣은 코드가 당일 diff에서 추가된 줄을 하나 이상 포함한 연속 구간과 정확히 일치하는지 확인한다.

tools/devlog/publish.py개발일지에 넣은 코드가 당일 diff의 변경 후 연속 구간과 일치하는지 확인하는 함수. 삭제된 줄은 제외하고 추가된 줄이 구간 안에 하나 이상 있어야 통과한다.당일 커밋 소스 발췌 · 2026-11-16 · fda9bd4
def added_code_matches(text: str, patch: str) -> bool:
    """Match an exact continuous new-side hunk containing at least one added line."""
    if not isinstance(text, str):
        return False
    wanted = text.splitlines()
    if not 5 <= len(wanted) <= 30:
        return False
    hunks, lines, additions = [], [], set()
    for line in patch.splitlines():
        if line.startswith("@@"):
            if lines:
                hunks.append((lines, additions))
            lines, additions = [], set()
        elif line.startswith("+"):
            additions.add(len(lines))
            lines.append(line[1:])
        elif line.startswith(" "):
            lines.append(line[1:])
        # Removed lines and the no-final-newline marker are absent from the new source.
    if lines:
        hunks.append((lines, additions))
    for lines, additions in hunks:
        for start in range(len(lines) - len(wanted) + 1):
            end = start + len(wanted)
            if lines[start:end] == wanted and additions.intersection(range(start, end)):
                return True
    return False

김인권 작가 홈페이지1

  • 11월 15일 개발일지를 자정 직후 자동 작성해 이미지 2장과 함께 발행
  • 프로젝트 이름표에 Farland Saga Engine 추가

Pixel Study1

  • 제거된 사용자 이름 로그인에 맞춰 계정 통합 테스트 수정
  • 로컬 wrangler dev 프록시의 503을 한 번 재시도

없어진 로그인 경로를 테스트에서 걷어내기

사용자 이름 로그인(`legacy-login`)은 11월 14일에 제거됐는데, 계정·복구 통합 테스트는 아직 그 경로로 옛 계정에 로그인하고 있었다. 테스트를 바꿔 올바른 비밀번호로도 거부되는지 확인하고, 이메일 연결 단계에는 직접 심어 둔 세션으로만 접근하게 했다. 복구 테스트에는 로컬 `wrangler dev`가 거부된 요청 다음 요청에 `Your worker restarted mid-request` 503을 돌려주는 경우가 있어, 그 메시지에 한해 한 번 다시 시도하게 했다. 실제 Worker는 같은 요청에 정상 응답한다고 커밋 메시지에 적혀 있다.

커밋 메시지에는 임시 D1과 모의 메일로 격리해 돌린 결과가 account-email 12/12, accounts.recovery 11/11 통과로 적혀 있다.

출처 · 깃허브 커밋