개발일지 ·

원격훈련 기능과 신고 서류

퀘스트큐브에 원격훈련 운영 기준에 맞춘 하루 학습 상한, 만족도 조사, 진도 독려 기록, 문제은행 무작위 출제를 넣고 원격평생교육시설 신고 서류 초안을 만들었다. 개발일지 실행기는 GitHub에 연결되지 않을 때 기다렸다 다시 시도하도록 고쳤고, 프로젝트 포털은 index.kiminkwon.com 주소와 최근 갱신 탭을 갖게 됐다.

5개 작업 기록20개 커밋

작업 기록 살펴보기 5

퀘스트큐브7

  • 원격훈련 하루 8시간 학습 상한, 만족도 조사 후 평가 응시, 진도 독려 기록 추가
  • 문제은행에서 응시마다 무작위 출제하고 순서를 섞어 스냅샷에 고정
  • 학사 운영 안내 페이지와 질의응답 답변 지연 표시 추가
  • 이용약관 환불 조항을 평생교육법 별표 3 기준으로 보강
  • 원격평생교육시설 신고서 기재안·운영규칙·시설설비현황표·교육과정 안 작성

운영규정 조항을 기능으로 옮기기

훈련 과정은 한국시간 하루 기준으로 학습 인정을 최대 8시간으로 제한하고(운영규정 제19조③2), 만족도 조사를 마친 수강생만 평가에 응시하게 했다(같은 조 ③4). 조사 화면과 이동 안내 페이지를 새로 만들고, 제출 전에는 평가 시작 API가 `survey_required`로 막는다. 관리자 화면에는 진도 미달 수강생 목록과 독려 알림 버튼을 더했다. 독려 이력은 `learning_nudges`에 남기고 같은 수강생에게는 24시간에 한 번만 보낸다. 독려 횟수 기준은 원문을 확인하지 못해 문서에 미확인으로 적었다.

기존 과정은 정책 JSON에 값이 없어도 기본값이 적용되며, 이미 학습이 시작된 훈련 과정에도 상한과 만족도 조건이 새로 적용된다고 `docs/remote-training.md`에 적었다. 이어서 평가는 응시마다 문제은행에서 지정한 수만큼 무작위로 뽑아 순서를 섞고 스냅샷에 고정하게 했다. 훈련 과정은 문제은행이 출제 문항의 3배수 이상이어야 기준을 저장할 수 있다. 이 날의 근거에는 자동 테스트 실행 결과가 없어, 기능을 추가한 것과 운영에서 확인한 것은 구분해 둔다.

현재 상태와 격차를 적은 신고·인증 문서

인증평가 준비표는 기능을 갖췄다는 주장이 아니라 현재 상태와 격차를 적은 표다. 문제은행 무작위 출제 항목은 처음에 ❌였다가 같은 날 구현 뒤 ✅로 바뀌었고, 모사답안 기준 안내와 과제 제출·첨삭은 기능이 없어 ❌로 남아 있다. 2026년 인증평가 신청은 이미 마감돼 2027년도 공고를 기다린다고 적었다.

신고 서류는 오전에 초안 문서로 시작해, 오후에 신고서 기재안·운영규칙·시설설비현황표·체크리스트를 `docs/filing`으로 나눴다. 저녁 커밋에서는 사업자 정보를 반영하고 현재 공개 강좌의 차시 길이로 계산한 교육과정·학습비 안을 더했다. 학습비는 시장 조사로 확정한 값이 아닌 제안이라고 문서에 적혀 있고, 설치자 이름과 주소 등은 공개 문서에 넣지 않는 별도 파일로 뺐다. 이용약관 환불 조항은 평생교육법 별표 3의 환불 기준에 맞춰 고쳤다.

INKWON WORKS 작업 공간4

  • 개발일지 실행기가 GitHub 연결을 기다리고 git pull을 최대 세 번 재시도하도록 수정
  • 포털 서브모듈을 Waryong Engine 카드, index.kiminkwon.com 주소, 최근 갱신 탭 커밋으로 갱신

11월 16일 글이 쓰이지 않은 이유

00:10 실행이 `git pull`에서 `Could not resolve host: github.com`으로 실패했고 다시 시도하지 않아 그날 글이 쓰이지 않았다고 커밋 메시지에 적혀 있다. 실행기는 `github.com:443`에 연결될 때까지 최대 약 10분 기다린 뒤 pull 하고, 실패하면 30초 간격으로 세 번까지 다시 시도하도록 고쳤다. 연결을 끝내 확인하지 못하면 이전처럼 오류로 끝낸다. 이 날의 근거에는 고친 스크립트를 실제 네트워크 장애 상황에서 돌린 기록이 없다.

tools/devlog/Start-DevLog.ps1github.com 443 포트에 연결될 때까지 20초에서 300초까지 간격을 늘리며 기다리는 함수. 끝내 연결하지 못하면 false를 돌려준다.당일 커밋 소스 발췌 · 2026-11-17 · 23c3658
function Wait-ForGitHub([string]$HostName = 'github.com', [int[]]$Delays = @(20, 40, 80, 160, 300)) {
    for ($i = 0; ; $i++) {
        $client = $null
        try {
            $client = [Net.Sockets.TcpClient]::new()
            if ($client.ConnectAsync($HostName, 443).Wait(8000) -and $client.Connected) { return $true }
        } catch { } finally { if ($client) { $client.Dispose() } }
        if ($i -ge $Delays.Count) { return $false }
        Write-Log "$HostName is unreachable; retrying in $($Delays[$i])s ($($i + 1)/$($Delays.Count))"
        Start-Sleep -Seconds $Delays[$i]
    }
}

아이스큐브랩 홈페이지3

  • AI 교육을 서비스 001로 옮기고 AX·직무별 교육 중심으로 정리
  • XR·게임 개발 서비스에 AI 활용 구역을 추가하고 홈 문구와 선정 작업에 생성형 AI 반영
  • 인사이트 글 제목·요약을 두 차례에 걸쳐 다듬음

INKWON WORKS 포털3

  • 비공개 Waryong Engine 카드 추가와 정적 예비 목록의 푸시 날짜 정렬
  • 포털 운영 주소를 index.kiminkwon.com으로 연결
  • 최근 본 탭을 최근 7일 GitHub 푸시 순의 최근 갱신 탭으로 변경

방문 기록 대신 푸시 기록으로

"최근 본" 탭은 이 브라우저에서 눌러 본 프로젝트를 보여 주고 있었다. 이를 최근 7일 안에 GitHub 저장소가 푸시된 프로젝트를 푸시가 최근인 순으로 보여 주는 "최근 갱신" 탭으로 바꿨다. 링크 클릭을 기록하던 `recordVisit`과 방문 기록 정렬을 지우고 `repositoryPushedAt`을 기준으로 거르게 했으며, 목록이 비면 최근 7일 동안 푸시된 프로젝트가 없다는 안내를 보여 준다.

같은 날 앞서 비공개 저장소 waryong-engine을 개발 중 카드로 추가해 프로젝트가 78개가 됐고, 정적 예비 목록의 푸시 날짜 8개를 배포된 `/api/catalog` 값에 맞췄다. 문서에는 배포 뒤 `/api/catalog`, 정적 `catalog.json`, `index.html`의 `data.js` 버전이 같은 revision인지 확인했다고 적혀 있다.

web/app.js저장소가 최근 7일 안에 푸시됐는지 판단하는 함수. 최근 갱신 탭의 필터와 개수 표시가 이 함수를 쓴다.당일 커밋 소스 발췌 · 2026-11-17 · 5b372f1
  const projectDate = (project) => projectGithubUrl(project) || project.repository ? project.repositoryPushedAt : project.siteUpdatedAt;
  const recentlyPushed = (project) => {
    const pushed = Date.parse(project.repositoryPushedAt || '');
    return Number.isFinite(pushed) && Date.now() - pushed <= RECENT_PUSH_DAYS * 86400000;
  };

김인권 작가 홈페이지3

  • 11월 16일 개발일지를 이미지 1장과 함께 발행
  • 개발자 이력서의 Grepp Games·36Litters 직함과 기간 수정

출처 · 깃허브 커밋