- 시작: 2026-10-15 23:58 KST · 마감: 2026-10-16 04:58 KST
- 원본:
ST-ROOKIE-employee-card(feature/learning-lab-sim, 커밋 6bc9fec)을 복사한 로컬 사본. 원격 저장소와 연결하지 않았고 푸시하지 않는다. - 서버: http://localhost:3200 (DB는 이 폴더의
data/사본) - 매 회차: 백로그에서 하나 →
npm test·npm run typecheck→ 화면 확인 → 이 파일에 기록 → 로컬 커밋
- 공정 인과 지도(3D): 제선 → 제강 → 연주 → 압연을 잇는 대표 인과 사슬(용선 온도·규소·황 → 전로 → 출강 온도·과열도 → 연주 → 슬래브 → 압연)을 공장 전체 위에 그리고, 변수 하나를 바꾸면 하류가 차례로 반응
- 사고 사례 갈림길: 장면마다 "여기서 다르게 했다면?" 선택지 → 결과가 바뀌는 흐름
- 인과형 질문 틀: 소크라테스·복습에 "원인 → 결과 → 다음 공정 영향" 질문 단계
- 공장 전체 카메라: 공정을 넘는 흐름을 한눈에 보는 카메라 보기
- 화면 다듬기·버그 수정: 좁은 화면 겹침, 패널 위치, 빈 상태 문구 등
- 실습 기록 연결: 인과 퀴즈·이상 상황 훈련 결과를 저장하고 사원증 XP·배지·xAPI·주간 리그에 반영
- 변수 설명 카드: 인과 지도에서 변수를 누르면 정의·단위·정상 범위·영향 주고받는 변수와 설비로 카메라 이동
- 관리자 시뮬레이터 통계: 운영 콘솔에 실습 사용량·자주 틀리는 인과 연결
- 오늘의 실습 경로: 학습 기록에서 3D 실습으로 이어지는 추천(약한 공정 → 인과 퀴즈·이상 훈련)
- 접근성 점검: 3D 패널 키보드 이동·포커스·읽기 프로그램 문구
- 인과 사슬 따라가기(3D 투어): 인과 지도에서 바뀐 값을 원인 → 결과 순서로 카메라가 설비를 하나씩 따라가며 설명(재생·멈춤)
- 사고 사례 갈림길 3D 재현: 학습 기록의 갈림길에서 고른 선택의 결과를 3D 설비 위에 표시(실제 선택과 비교)
- 틀린 칸 → 튜터 질문: 인과 퀴즈·이상 상황 훈련에서 틀린 연결을 튜터 패널 질문으로 바로 넘기기
- 인과 지도 조건 링크: 지금 슬라이더 조건을 주소로 복사해 다른 사람이 같은 실험을 열기(교육 담당자가 수업 자료로)
- 3D 효과 메모리 점검: 인과 지도·따라가기를 오래 돌릴 때 흐름·링·이름표의 geometry·material·texture가 정리되는지(fx.clear dispose), 프레임 시간
- 틀린 칸만 다시 풀기: 인과 퀴즈 끝 화면에서 틀린 칸만 모아 다시 풀기(같은 길·같은 방향)
- 이상 상황 → 인과 지도 재현: 훈련을 끝내면 그 원인을 인과 지도 조건(set=)으로 열어 하류 공정 반응까지 보기
- 3D 실습 기록 xAPI: 인과 따라가기·갈림길 3D 재현·조건 링크 열기를 xAPI 'experienced'로 남기기
- 거꾸로 추론 퀴즈(진단형): 결과 값이 바뀐 것을 보여 주고 "어떤 원인이 그랬을까?"를 고르는 인과 질문 틀(원인 후보 중 방향까지 맞히기)
- 조건 두 개 나란히 비교: 인과 지도에서 조건 A·B를 저장해 하류 값 차이를 나란히(같은 결과를 내는 다른 원인 보기)
- 공장 전체 물류 흐름: 공장 전체 보기에서 용선 → 용강 → 슬래브 → 코일 흐름을 공정 사이 애니메이션으로
- 갈림길 탐험 기록·배지: 다르게 해 본 갈림길을 저장하고 사원증 배지·XP(하루 상한)
- 3D 이름표 겹침 정리: 가까운 설비 이름표가 겹치면 위아래로 비켜 놓기
- 공정 사이 시간 지연: 인과 지도 따라가기에 '몇 시간 뒤 도착'을 붙여(용선 → 전로 수 시간, 슬래브 → 압연 하루 안팎) 반응이 바로 오지 않음을 보여 주기
- 내 3D 실습 요약(학습 기록): 학습 기록에 인과 퀴즈 정답률·이상 상황 훈련·갈림길 탐험 요약 카드(관리자 통계의 개인판)
- 세 칸 인과 퀴즈(심화): 공정 세 개를 넘는 사슬로 두 번째 퀴즈 단계
- 수업 모드(교육 담당자): 조건 링크 여러 개를 순서대로 넘기는 수업용 슬라이드(인과 지도·따라가기 묶음)
- 전체 회귀 점검: 3D 실습 모드 9개(인과 지도·퀴즈·심화·거꾸로·조업 실험·이상 상황·갈림길·수업·공장 흐름)를 차례로 열어 콘솔 오류·좁은 화면 겹침·빈 상태 문구 확인
- xAPI 기록 화면 정리: 학습 랩 xAPI 목록에 새 실습 종류(인과 퀴즈·훈련·갈림길·3D 살펴봄)를 이름으로 거르고 아이콘 표시
- 한글 조사·문구 점검: '(은)는'·'(이)가' 같은 괄호 조사와 어색한 문장을 화면 문구에서 찾아 고치기
- 데모 기능 안내서: 이번 데모에서 만든 기능을 화면 경로·주소와 함께 정리한 문서(DEMO-GUIDE.md)
- 오개념 → 인과 지도: 학습 기록 '내 오개념'의 개념(루브릭 equipment_ids)과 같은 설비의 인과 지도 변수를 이어 [인과 지도에서 보기]로 열기
- 이름표 위치 계산 비용 줄이기: 매 프레임 offsetWidth 측정(레이아웃 다시 계산)을 글이 바뀔 때만 재도록 캐시, 프레임 시간 비교
- 수업 진행 기록: 수업 단계 열기를 xAPI 'experienced'(lesson 종류)로 남기고 관리자 3D 실습 통계에 수업별 열람 수
- 모든 실습 패널 접기: 인과 지도만 있던 [결과만 보기] 접기를 퀴즈·거꾸로 추론·훈련·갈림길 패널에도(3D를 넓게 보기)
- 사고 사례 갈림길 → 인과 지도: 갈림길의 다른 선택 중 조업 값으로 이어지는 것(예: 습한 고철 → 전로 슬래그·슬로핑)을 인과 지도 조건으로 열기
- 마지막 회귀 점검·최종 정리: 마감 전 전체 모드 한 번 더(오류·겹침·문구·새 패널 키보드·읽기), 안내서(DEMO-GUIDE.md)에 31~43회차 기능과 숫자 갱신
- 인과 지도 '이상 상황 재현' 예시: 인과 지도 예시 줄에 이상 상황 훈련 4종의 원인 조건(냉각로·슬로핑·브레이크아웃·권취 온도)을 바로 넣는 버튼
- 3D 실습 첫 안내: 3D 화면에 처음 들어오면 실행 버튼 묶음 옆에 한 번만 뜨는 안내 말풍선(닫으면 다시 안 뜸, 브라우저 저장)
- 터치 크기 점검: 휴대폰 폭에서 3D 실습 패널의 버튼·슬라이더·변수 줄이 손가락으로 누르기 충분한지(44px) 재고 고치기
- '언제 나타날까?' 시간 질문: 인과 퀴즈 끝에 시간 지연 문제(이 변화가 다음 공정 값에 나타나는 때 — 바로·몇 시간 뒤·하루 안팎) 한 문항
- 거꾸로 추론 기록·통계: 거꾸로 추론 답을 기록(마이그레이션 017)하고 관리자 3D 실습 통계에 정답률·헷갈리는 원인
- 되돌리기 퍼즐(조치 인과): 한 값을 흔들어 범위 밖 값이 생긴 상태에서, 다른 조정 값 하나만 움직여 그 값을 정상 범위로 되돌리기(원인을 직접 못 고칠 때 다른 공정에서 보상하는 판단)
- 훈련 끝 → 다음 실습 추천: 이상 상황 훈련·인과 퀴즈 끝 화면에 오늘의 실습 경로 다음 단계를 한 줄로
- 수업 '현장 판단': 수업 모드에 되돌리기 퍼즐 단계 종류를 넣고, 거꾸로 추론 → 되돌리기 퍼즐 → 세 칸 퀴즈(시간 질문 포함)로 이어지는 세 번째 수업
- 되돌리기 퍼즐 늘리기: 흔드는 크기를 여러 단계(50%·80%·100%)로 바꿔 풀 수 있는 퍼즐을 더 찾고, 쉬운 것(부작용 없이 풀림)부터 내기
- 변수 카드 → 관련 실습: 인과 지도 변수 설명 카드에 이 변수가 나오는 실습(이상 상황 훈련·되돌리기 퍼즐·수업) 바로 가기
- 되돌리기 퍼즐 기록·사원증: 푼 퍼즐을 기록(마이그레이션 018)하고 부작용 없이 푼 퍼즐에 XP(하루 상한)·'보상 판단' 배지, xAPI
- 관리자 되돌리기 퍼즐 통계: 퍼즐별 시도·푼 비율·부작용 없이 푼 비율, 자주 고른 '닿지 않는 값'
- 내 3D 실습 요약 넓히기: 학습 기록 요약 칩에 거꾸로 추론 정답률·되돌리기 퍼즐(부작용 없이 푼 수) 추가
- 오늘의 실습 경로에 거꾸로 추론 반영: 원인 변수의 공정별 거꾸로 추론 정답률을 약한 정도에 넣기
- 수업 마무리: 마지막 단계에서 [수업 마치기] → 단계 제목 요약과 목표를 보여 주고 xAPI 'completed'(수업) 기록, 관리자 통계 '끝까지 간 사람'을 마치기 기준으로
- 마감 정리: 안내서·DEMO-LOG 마지막 갱신, 전체 테스트, 최종 보고
- 서버
backend/src/lab/causal.ts: 변수 20개(조정 6: 코크스비·염기도·출강 온도·주조 속도·재가열 온도·냉각 뱅크)와 연결 17개의 선형 인과 모델. 위상 정렬로 위에서 아래로 계산하고, 정상 범위 밖은 경고.POST /api/lab/causal(모르는 변수는 400). - 3D(
sim-lab.js): 🗺 공정 인과 지도 패널(예시 4개·슬라이더·"무엇이 어떻게 번졌나" 설명·공정별 값). 바뀐 연결은 주황(오름)/파랑(내림) 흐름, 나머지 연결은 옅게, 범위 밖 설비는 붉은 링과 ⚠ 이름표. 🏭 공장 전체 보기 버튼(드론 시점_overviewPose). 버튼 줄을 가로로 바꿔 패널과 겹치지 않게 함. - 확인:
npm test440개(+4,causal.test.ts) 통과, 타입 검사 통과. 3200 서버에서 "출강을 뜨겁게 + 빨리 주조" 예시 → 출강 온도 → 과열도 → 껍질 → 브레이크아웃·중심 편석 → 압연 결함까지 이름표 6개와 경고가 뜸(DOM 확인). 창이 작아 스크린샷 확인은 못 함.
- 콘텐츠: 사고 사례 4건에 갈림길 8개(사례마다 2개). 장면마다 "실제로 일어난 선택" 하나와 안전한 선택 1~2개, 고르면 결과가 나온다(예: CO 가스 — 검지기를 차고 2인 1조로 들어가면 입구에서 경보가 울려 물러남).
- 서버:
incidents.ts스키마에timeline[].branch추가, 실제 선택이 정확히 하나인지 서버 시작 때 검사. 테스트 1개 추가(sim.test.ts). - 화면: 학습 랩 › 사고 사례의 장면마다 🔀 질문과 선택 버튼, 결과 카드(안전 초록·실제 빨강), "다르게 해 본 갈림길 n / m".
- 확인:
npm test441개 통과. 첫 실행은 서버 재시작과 같은.build에 동시에 빌드해 5개가 실패했고, 서버가 뜬 뒤 다시 돌리니 모두 통과(코드 문제 아님 — 다음부터 서버 재시작과 테스트를 겹치지 않게 함). 3200에서 갈림길 2개를 눌러 결과 카드 두 종류가 뜨는 것을 DOM으로 확인.
- 서버
causal.ts: 인과 지도의 연결 두 개로 이어지는 길(노드 3개)을 모두 모아, 공정을 넘는 길을 먼저 고르는 퀴즈 5문제(GET /api/lab/causal/quiz?seed=). 채점은 상태 없이 길 id·처음 방향·몇 번째 칸으로 계수 부호의 곱을 계산(POST /api/lab/causal/quiz/check). 테스트 2개 추가. - 3D(
sim-lab.js): 인과 지도 패널의 [🧩 인과 퀴즈로 확인하기]. "원인 ▲/▼ → ① 결과는? → ② 그러면 다음 공정 값은?"을 한 칸씩 고르면 맞음·틀림과 이유, "같은 방향/반대 방향" 규칙, 3D 흐름·이름표가 그 칸마다 나온다. 받침에 맞는 조사(이/가·은/는, 끝 괄호 제외). - 확인:
npm test443개 통과, 3200에서 1번 문제 두 칸을 풀고 다음 문제로 넘어가는 것까지 DOM으로 확인("고로 슬래그 염기도가 내려가면 → 용선 황 ▲ → 예비처리 탈황 시간 ▲").
- 마이그레이션
014_causal_quiz.sql: 인과 퀴즈 칸마다 고른 답·정답 여부(causal_quiz_answers). 채점 API가 기록한다. - 사원증: 새 기록 종류
causal_correct(칸당 3 XP, 하루 10칸) ·fault_drill(20 XP, 하루 4번), 배지 2개(🧩 인과 탐정 30칸, 🚨 현장 대응 이상 상황 4종). XP 안내에도 추가. 주간 리그는 같은 XP를 쓰므로 자동 반영. - xAPI: 인과 퀴즈 → answered(causal-link), 이상 상황 → completed(점수 scaled).
- 사용자 기록 지우기에 퀴즈 답 포함. 테스트 2개 추가.
- 확인:
npm test444개 통과, 3200 API로 퀴즈 한 칸 + 이상 상황 1회 → XP 800 → 823, 배지 진행 "인과 탐정 1/30 · 현장 대응 2/4"가 사원증 화면에 뜸(DOM).
- 만든 것:
causal.ts의 변수 20개에 설명 문장(desc)을 붙이고, 인과 지도의 공정별 값 줄(조정값 포함 20개)을 누르면 설명 카드가 열린다. 카드에는 뜻·지금/기준/정상 범위, 영향을 주는 값·받는 값(같은/반대 방향과 이유)이 나오고, 연결된 값을 누르면 그 변수로 넘어간다. [3D에서 이 설비 보기]는 그 설비로 카메라를 옮기고, 고른 변수의 설비에는 청록 링이 표시된다. - 확인: API 응답 20개 변수 모두
desc있음. 화면에서 코크스비 → 카드(영향 받는 값: 용선 온도) → 용선 온도로 이동(영향 주는 값 코크스비, 받는 값 용선 규소·전로 고철 투입 여유) → 3D 버튼, JS 오류 없음. typecheck 통과,npm test444/444 통과.
- 만든 것:
backend/src/lab/practice-stats.ts와GET /api/admin/practice-stats?include_demo=(관리자만). 운영 콘솔(admin-ops.html)에 [3D 실습] 탭을 넣었다. 인과 퀴즈(전체·한 칸·두 칸·같은 공정·공정 넘기 정답률, 답 2칸 이상인 헷갈리는 연결 5개), 이상 상황 훈련(시도·사람·평균 점수·한 번에 끝낸 비율·가장 오래 걸린 단계), 사고 사례(평균 점수·가장 많이 틀린 문항)를 보여 준다. 사람별 내용은 내지 않는다. 시연 계정 빼기 버튼이 있다. - 확인: 테스트 1개 추가(단계·약한 문항·한 칸/두 칸·헷갈리는 연결·시연 계정 빼기·신입사원 403). 화면에서 퀴즈 3칸을 넣고 관리자로 탭을 열어 숫자가 API와 같은지, 시연 계정 빼기 → 0칸인지 확인. typecheck 통과,
npm test445/445 통과.
- 만든 것:
backend/src/lab/practice-path.ts와GET /api/lab/practice-path. 내 인과 퀴즈 정답률(그 공정 변수가 지난 칸)과 이상 상황 훈련 최고 점수로 공정별 약한 정도를 재고(안 해 본 실습은 0.6), 가장 약한 공정에 ① 인과 지도 변수(틀린 칸이 가장 많이 지난 변수) → ② 그 공정 위주 인과 퀴즈(/api/lab/causal/quiz?process=) → ③ 그 공정 이상 상황 훈련을 권한다. 학습 기록 [학습 랩] 맨 위에 경로 카드를 넣었고, 링크는 3D 화면?p=공정&lab=map&var=… · lab=quiz&process=… · lab=fault&fault=…로 그 실습을 바로 연다(sim-lab.js가 주소를 읽음). - 확인: 테스트 1개 추가(기록 없음 → 제선, 틀린 제강 칸·낮은 훈련 점수 → 제강과 변수 scrap_pct, 공정 위주 퀴즈). trainee05로 학습 랩을 열어 경로 카드(연주) 확인, 세 링크를 차례로 열어 턴디시 과열도 설명 카드 · 연주 인과 퀴즈(출강 온도 → 턴디시 과열도) · 브레이크아웃 훈련이 바로 열리는 것 확인. typecheck 통과,
npm test446/446 통과.
- 만든 것(
sim-lab.js): 패널 전체 aria-live를 없애고 이름 있는 영역(role=region, 모드별 이름) + 따로 읽어 주는 상태 줄(say)로 바꿈(슬라이더를 움직일 때마다 패널 전체를 읽던 문제). 열면 패널 제목으로 포커스, Esc로 닫고 연 버튼으로 포커스 복귀, 실행 버튼에 aria-expanded·aria-controls, 도구 묶음 role=toolbar. 슬라이더 aria-valuetext(단위 포함). 색으로만 보이던 '정상 범위 밖'을 숨긴 글로도 넣음. 인과 지도 변경 요약·퀴즈 판정·이상 상황 단계별 맞음/틀림을 읽어 줌. 설명 카드는 열면 카드 제목, ✕로 닫으면 그 변수 버튼으로 포커스. 움직임 줄이기 설정이면 흔들림 애니메이션 끔. - 확인:
backend/test/sim-lab-a11y.test.ts(2개). 화면에서 열기 → 제목 포커스, 슬라이더 340→420kg/t valuetext, 상태 줄 "6개 값이 바뀌었어요. 정상 범위 밖: …", 카드 제목 포커스(처음엔 카드가 두 번 그려져 포커스가 빠지는 문제 → 고침), ✕ → 변수 버튼 복귀, Esc → 닫힘·버튼 복귀, 이상 상황 틀린 값 → "아니에요. …" 읽기. typecheck 통과,npm test448/448 통과.
- 고친 것(
sim-lab.js): ① 닫힌 3D 실습 패널이display:flex에 밀려 hidden이 안 먹고 빈 32px 띠로 남던 버그(모든 화면) →.sl-panel[hidden]{display:none}. ② 휴대폰 폭(375px)에서 실행 버튼이 두 줄로 접히는데 패널 아래 끝(662)이 버튼 첫 줄(600692)을 덮어 다른 실습으로 못 넘어가던 문제 → 버튼 묶음 위치를 ResizeObserver로 재서590, 버튼 600~). ③ 2D 보기에서 [공장 전체 보기]가 아무 반응 없던 것 → 이유를 읽어 주고 버튼을 살짝 흔듦.--sl-panel-bottom으로 패널 아래 끝을 맞춤(패널 143 - 확인: 375×812에서 닫힌 패널 display none, 연 패널과 버튼 묶음 안 겹침(버튼 위치 클릭이 버튼에 닿음). 1440×900에서 패널·버튼 묶음 아래에 깔린 v4 요소 없음. 테스트 1개 추가, typecheck 통과,
npm test449/449 통과. - 백로그 11~14를 새로 넣었다.
- 만든 것:
simulateCausal의 이야기 줄에 변수 id·설비·원인 변수(causes)를 붙이고, 을/를 조사 함수(eulReul, 끝 괄호 제외)를 넣었다. 인과 지도 [▶ 인과 따라가기 (n단계)]: 이야기 줄 순서대로 카메라가 그 설비로 가고(공정이 바뀌면 공정도 옮김), 원인 설비 → 이 설비 흐름을 진하게, 지난 단계는 옅게, 지금 설비는 링·이름표(값과 ▲▼). 지금 줄은 테두리, 앞으로 볼 줄은 흐리게, 상태 줄로 단계 설명을 읽어 줌. [다음 ▶]·[■ 그만 보기], 끝나면 공장 전체 보기로 돌아가고 원래 3D 표시로 복구. 값을 바꾸면 따라가기를 멈춤. 이야기 줄 글자 14→15px. - 확인: 테스트(이야기 줄 원인이 앞 줄에 먼저 나오는지, 을/를 5개). 화면에서 '코크스를 줄이면?' → 6단계, 1단계 "코크스비를 290kg/t (-50)로 바꿨어요" 제선, 2단계 용선 온도, 끝에서 제강까지 이동하고 "끝까지 따라왔어요" 뒤 버튼 복귀. 콘솔 오류 없음. typecheck 통과,
npm test450/450 통과.
- 만든 것: 학습 기록 사고 사례의 갈림길에서 선택을 고르면 [🏭 3D 공장에서 이 갈림길 보기] 링크(
?p=공정&lab=incident&scenario=…&at=장면&pick=선택). 3D 화면의 새 패널 '사고 사례 갈림길'(sim-lab.jsincidentPanel): 갈림길까지의 장면 목록(누르면 그 설비로 카메라), 선택지를 바꿔 가며 결과 비교. 3D에는 지난 장면 설비를 옅은 흐름으로 잇고, 다른 선택이면 갈림길 설비에 초록 링 "✓ 다르게 했다면", 실제 선택이면 붉은 링과 이후 장면 설비로 붉은 흐름·마지막 장면 이름표. [실제 선택과 비교] 버튼, 결과는 상태 줄로 읽어 줌. - 확인: 테스트 1개(링크 주소 규칙·패널 연결). 학습 기록에서 '출선구 주변 점검 중 가스 흡입' → 끝까지 보기 → 갈림길 '검지기를 차고 동료와 함께' → 링크 주소 확인 → 3D에서 패널(장면 2개·선택 3개·초록 결과) → 실제 선택과 비교 → 이어진 장면 2개(02:31·02:40). 실제 선택의 결과 문장이 머리와 겹쳐 두 번 읽히던 것을 이어진 장면으로 바꿈. typecheck 통과,
npm test451/451 통과.
- 만든 것: 인과 퀴즈에서 틀린 칸, 이상 상황 훈련에서 틀린 원인·조치 아래에 [🎓 튜터에게 이 연결 묻기]. 누르면
steel-tutor-draft이벤트로 v4 튜터 입력창에 질문을 채우고 튜터 패널을 연다(보내기는 학습자가 눌러야 해서 LLM을 바로 부르지 않음). 질문은 원인·방향·정답 방향을 넣어 만들고(예: "용선 규소(Si)가 내려가면 왜 전로 슬래그량은 내려가나요? …"), 조사는 받침에 맞춘다(이/가·은/는·을/를). 튜터 패널과 3D 실습 패널이 같은 오른쪽이라 실습 패널은 잠시 숨기고, 그 실습 버튼을 다시 누르면 진행 그대로 돌아온다. v4에는 이벤트를 받는 한 줄만 넣었다. - 함께 고침: 창 높이가 낮으면(258px) 패널이 32px로 눌리던 것 → 최소 높이
min(240px, 100vh-100px). - 확인: 테스트 1개(이벤트·두 실습의 버튼·v4가 입력창만 채우고 보내지 않음). 화면에서 퀴즈를 틀리게 고름 → 버튼 → 입력창 문장 확인 → 실습 패널 숨김 → [공정 인과 지도] → 같은 문제(1/5)로 돌아옴. typecheck 통과,
npm test452/452 통과.
- 만든 것: 인과 지도 조건 칸에 [🔗 이 조건 링크 복사]·[🔗 따라가기까지]. 기준과 다른 조정 값만
?p=첫 바꾼 값의 공정&lab=map&set=id:값,…(&tour=1)로 만들어 클립보드에 복사하고, 막히면 주소 칸을 보여 준다. 주소를 열면 set의 값으로 인과 지도를 열고(id는 영문·숫자·_, 값은 숫자만, 10개까지, 범위는 서버가 자름) tour=1이면 인과 따라가기를 바로 시작한다. 기준과 같으면 "담을 값이 없어요"라고 알려 준다. - 확인: 테스트 1개.
set=tap_temp:1690,evil;x:1,coke_rate:abc&tour=1→ 출강 온도 1,690℃만 반영(나쁜 값 무시)·따라가기 자동 시작(3단계 연주까지 진행). 복사 버튼 → 자동 클릭이라 클립보드가 막혀 주소 칸 표시·안내. 링크 공정이 카메라 위치(연주)로 잡히던 것을 첫 바꾼 값의 공정(제강)으로 고침 → 다시 열어 같은 주소 확인. typecheck 통과,npm test453/453 통과. - 백로그 15~18을 새로 넣었다.
- 점검:
createFx의fx.clear가 링·흐름(선·입자)·빛의 geometry·material·텍스처를 dispose하고 이름표 DOM을 지우는지 코드로 확인. 실제 렌더러(renderer.info.memory)로 잼: 시작 geometry 666 · 장면 객체 20 → 인과 지도 열고 예시 30번 바꿈(객체 56, 이름표 6) → 닫으면 객체 20·이름표 0, geometry 678. 늘어난 12는 열기·닫기를 5번 더 해도 678 그대로라 누수가 아니라 공장 전체 보기에서 한 번 올라온 모델로 본다. 인과 따라가기 중간에 닫기 3번: 5초 뒤에도 이름표 0·객체 20·geometry 678, 닫은 뒤 다시 그리지 않음. 인과 지도 켠 채 60fps(2초 측정). - 결론: 고칠 누수 없음. 흐름 입자 텍스처(
dotTex) 1개는 의도대로 계속 쓴다.
- 만든 것: 인과 퀴즈 끝 화면에 [↻ 틀린 칸만 다시 풀기 (n칸)]. 틀린 칸을 길·칸 단위로 모아 같은 길·같은 방향으로 그 칸만 다시 묻는다. 둘째 칸만 틀린 길은 첫 칸의 답을 "지난번에 맞힌 칸"으로 보여 주고 둘째 칸만, 첫 칸만 틀린 길은 첫 칸만 묻는다. 다시 풀기도 끝 화면에서 또 틀린 칸이 있으면 반복할 수 있고, 다 맞히면 "틀렸던 칸을 모두 바로잡았어요!". 점수 요약은 상태 줄로 읽어 준다. 다시 푼 답도 기록되지만 사원증 XP는 하루 상한(10)이 그대로 막는다.
- 확인: 테스트 1개. 화면에서 1차를 모두 '오른다'로 → 5/10, [틀린 칸만 다시 풀기 (5칸)] → "다시 풀기 · 1 / 3" 3개 길에서 정확히 5칸(첫 칸만 틀린 길은 ①만) → 반대로 골라 5/5 → 다시 풀기 버튼 사라짐. typecheck 통과,
npm test454/454 통과.
- 만든 것: 이상 상황 훈련 내용(
content/faults/faults.json)에 선택 필드causal(원인을 인과 지도 조정 값으로): 제선 노 냉각 → 코크스비 290, 제강 슬로핑 → 코크스비 400(용선 규소↑), 연주 브레이크아웃 → 출강 온도 1690·주조 속도 1.6, 압연 권취 온도 낮음 → 냉각 뱅크 15. 파일 검사에서 조정할 수 없는 값·범위 밖 값을 막고, 조치를 맞히면 응답에causal을 준다. 훈련을 끝내면 [🗺 인과 지도에서 하류까지 따라가기] → 그 값으로 인과 지도를 열고 따라가기를 바로 시작. - 확인: 테스트 1개(4개 훈련 모두 재현 값으로 그 공정에 정상 범위 밖 값이 생기고 따라갈 단계 2개 이상, 조치 응답에 causal, 나쁜 값 막기). 화면에서 브레이크아웃 훈련을 끝까지 → 버튼 → 인과 지도(출강 온도 1,690℃·주조 속도 1.60m/분) + 따라가기 1단계 제강. typecheck 통과,
npm test455/455 통과.
- 만든 것:
POST /api/me/lab/xapi에 선택 필드practice(causal-tour·causal-map-link·incident-3d). 있으면 설비 대신 3D 실습으로 기록하고 이름은 서버가 정한다(인과 지도 변수 이름·사고 사례 제목, 없으면 404, 모르는 종류는 400). 저장은practice:<종류>:<id>, 문장의 활동 id는/activities/<종류>/<id>. 3D 화면은 따라가기를 시작할 때, 조건 링크(set=)로 열었을 때, 갈림길 3D를 열었을 때 남긴다(실패해도 화면은 그대로). 학습 랩 xAPI 기록에 '살펴봄'으로 보인다. - 함께 고침: 처음에 링크 종류를
causal-link로 했더니 인과 퀴즈 답 문장의 활동(/activities/causal-link/…)과 겹쳐causal-map-link로 바꿈(확인 중 남은 예전 이름 기록 1개는 데모 DB에만 있음). 설비 살펴봄은 예전 형식(영문·숫자·_) 그대로 검사. - 확인: 테스트 1개(이름·활동 id·404·400·설비 형식·퀴즈 활동과 안 겹침). 화면에서
set=coke_rate:300&tour=1→ "인과 지도 조건 링크 · 코크스비", "인과 따라가기 · 코크스비", 갈림길 3D → "사고 사례 갈림길 3D · 출선구 주변 점검 중 가스 흡입". 없는 사례 id는 "없는 사례예요"만 보이고 기록 안 됨. typecheck 통과,npm test456/456 통과.
- 만든 것:
causal.ts의diagnoseQuiz·checkDiagnose·diagnoseInput과GET /api/lab/causal/diagnose·POST …/diagnose/check. 원인(조정 변수·방향)을 기준에서 끝 쪽으로 80% 움직여 바뀐 하류 값 중 증상 2개(범위 밖·다른 공정·먼 단계 우선)를 고르고, 보기는 정답 + 같은 증상 방향을 만들지 않는 원인 3개(답이 하나). 채점은 고른 원인이 같은 증상을 만들면 맞음, 원인에서 증상까지 이야기와 번진 연결을 준다. 3D 새 패널 '거꾸로 추론': 증상 설비에 링·"증상 · … ▼" 이름표 → 원인 고르기 → 원인 설비 청록 링과 번진 흐름, 틀리면 정답 보기 표시와 [튜터에게 묻기]. 인과 지도 예시 줄과 인과 퀴즈 끝 화면에서 들어간다(?lab=diagnose도 됨). 기록·XP 없는 자가 점검. - 확인: 테스트 1개(씨앗 5개×4문제에서 정답만 맞음, 조정 값이 범위 안·방향 맞음, 조정할 수 없는 변수 null). 화면에서 1번 "사상압연 출구 온도 ▼(범위 밖)·권취 온도 ▼" → 틀린 보기 → 정답 '재가열 온도 내림' 표시·원인~증상 이야기·3D 이름표 3개·튜터 버튼 → 끝 "1 / 4 맞힘". typecheck 통과,
npm test457/457 통과.
- 만든 것: 인과 지도에 '⚖ 두 조건 비교'. [지금 조건을 A로]·[B로]에 담고, 둘 다 있으면 A·B에서 바뀐 하류 값을 표로 나란히(▲▼·값·범위 밖은 붉게, 읽기용 문구). [A 다시 보기]·[B 다시 보기]로 그 조건을 다시 적용. 원인이 다른데 같은 방향으로 움직이는 값이 있으면 "이 값만 보고는 원인을 가를 수 없어요"라고 짚는다.
- 함께 고친 버그: 비교 표에서 '슬로핑(넘침) 위험 -15점'이 '정상 범위 밖'으로 나와 확인해 보니, 조정 값을 끝으로 보내면 위험 점수 4개(슬로핑·브레이크아웃·중심 편석·압연 내부 결함)가 음수, 턴디시 과열도가 -6℃까지 내려갔다(선형 모델).
NodeDef.floor를 두고 5개를 0에서 자름. 이제 위험 0점은 정상, 과열도 0℃는 범위 밖(너무 낮음). - 함께 고친 테스트: 18회차에서 주소 모드 목록에 diagnose를 넣었는데 프론트 패치 전에 테스트를 돌려 소스 검사 1개가 깨진 것을 놓쳤다 → 정규식을 모드 추가에 맞게 고침.
- 확인: 테스트 1개(조정 값 6개를 각 끝·기준으로 보낸 729가지에서 바닥값 아래로 안 내려감). 화면에서 A=코크스비 290, B=출강 온도 1610 → 표 7줄(A는 제선·제강, B는 연주), A 다시 보기 → 290kg/t. API로 코크스비 290·출강 온도 1600 → 슬로핑 0(정상)·과열도 0(범위 밖)·브레이크아웃 0(정상). typecheck 통과,
npm test458/458 통과.
- 만든 것: 실습 패널이 닫혀 있을 때 [🏭 공장 전체 보기]를 누르면 카메라를 공장 전체로 물리고 물질 흐름을 그린다: ① 용선(고로 → 출선구 → 토페도카 → 예비처리 → 전로, 주황) ② 용강(전로 → … → 주형, 노랑) ③ 슬래브(주형 → 2차 냉각 → 교정 → 절단 → 가열로, 붉은 주황) ④ 코일(가열로 → 디스케일러 → 조압연 → 사상압연 → 런아웃 → 권취, 청회색). 물질이 시작하는 설비에 이름표(온도·두께), 권취기에 링, 상태 줄로 한 문장 설명. 다시 누르면 지우고(aria-pressed), 실습 패널을 열면 흐름 표시 상태도 꺼진다. 패널이 열려 있으면 카메라만 물리고 "패널을 닫으면 볼 수 있어요"라고 알려 준다. 앵커 없는 설비는 건너뛰도록 함(지금은 24개 모두 있음).
- 확인: 테스트 1개(경로 설비가 모두 data_v2.js에 있고 물질 경로가 이어짐). 화면: 설비 24개 모두 있음, 흐름 선·입자 39개 추가, 이름표 4개, 다시 누르면 객체 20·이름표 0, 켠 채 인과 지도를 열면 버튼 상태 꺼짐. 첫 시도에서 한 번 홈 화면으로 넘어갔는데 같은 순서를 두 번 다시 해도 재현되지 않아 원인을 확정하지 못했다(토큰은 유효했음, 기록만 남김). typecheck 통과,
npm test459/459 통과.
- 만든 것: 마이그레이션
015_branch_explorations.sql(사용자·사례·장면·선택, 같은 선택은 UNIQUE로 한 번만, 실제 선택 여부).POST /api/lab/incidents/:id/branch {at, pick}(없는 장면·선택 404, 새로 남기면 201·다시면 200, 이 사례에서 골라 본 수/전체 수). 학습 기록 갈림길 버튼과 3D 갈림길 패널에서 고를 때 남긴다. 사원증: 새 기록 종류branch_explored(다른 선택만, 5 XP, 하루 5번 상한), 배지 '🔀 갈림길 탐험가'(다른 선택 10가지), XP 안내에 '갈림길 탐험 5'. xAPI '살펴봄 · 사고 사례 갈림길', 사용자 기록 지우기에 포함. - 확인: 테스트 1개(같은 선택 201→200, 실제 선택은 사원증 기록에서 빠짐, 없는 장면·선택·사례 404, 지우기). 학습 기록에서 CO 가스 사례 갈림길 선택 3개(실제 1·다른 2) → XP 870→880, 배지 0→2/10, counts.branches_explored 2. typecheck 통과,
npm test460/460 통과.
- 만든 것(
sim-lab.jsfx.tick): 화면에 보이는 이름표를 아래(기준점이 낮은 것)부터 놓고, 이미 놓인 이름표와 겹치면 그 이름표 위로 4px 띄워 올린다(놓인 이름표 수만큼만 다시 확인). 매 프레임 다시 맞추므로 카메라를 움직여도 유지된다. - 확인: 1440×900에서 인과 지도(코크스비 280·염기도 0.9·출강 온도 1690·주조 속도 1.8, 이름표 13개)의 겹치는 쌍: 바꾸기 전 17 → 바꾼 뒤 0(같은 화면에서 잠시 되돌려 비교). 공장 전체 흐름 이름표 4개 겹침 0. 다만 창 높이가 258px처럼 아주 낮으면 13개가 다 들어갈 자리가 없어 일부 겹침이 남는다(처음 반복 한도 8 → 놓인 수로 늘림). 테스트 1개, typecheck 통과,
npm test461/461 통과. - 백로그 24~27을 새로 넣었다.
- 만든 것:
causal.ts에 공정 사이 도착 시간(교육용 대략값)LAG_HOURS제선 → 제강 24시간(용선 운송·예비처리), 제강 → 연주 12시간(정련·주조 대기), 연주 → 압연 824시간(슬래브 야드·가열로)과4시간 뒤", 따라가기 이름표와 읽기 문구에도 붙임.arrivalText. 인과 지도 이야기 줄마다arrive(바꾼 값 중 가장 앞 공정 기준, 같은 공정은 '바로'), 맨 아래 설명에 시간 대략값 안내. 화면: 이야기 줄 머리 "4. 제강 · ⏱ 약 2 - 확인: 테스트 1개(바로·2
4·1130·824시간, 이야기 줄이 도착 순서, 출강 온도에서 시작하면 12·926시간). 화면에서 코크스비 290 따라가기 → 13단계 제선(표시 없음), 46단계 "⏱ 약 24시간 뒤", 아래 설명에 안내 문장. typecheck 통과,npm test462/462 통과.
- 만든 것:
GET /api/lab/practice-path응답에summary(인과 퀴즈 칸 수·정답률, 끝낸 이상 상황 훈련 종류·만점 수, 골라 본 갈림길 선택 수/전체 선택 수). 학습 랩 맨 위 '오늘의 실습 경로' 카드 아래에 숫자 칩 3개와 공정별 칸 4개(퀴즈 정답률·훈련 최고 점수, 막대는 1−약한 정도, 오늘 권하는 공정은 주황 테두리). 좁은 화면은 2열. - 확인: 테스트 1개(빈 기록·퀴즈 2칸 중 1·훈련 2종 중 만점 1·갈림길 1). trainee05 화면: "인과 퀴즈 62% · 21칸", "이상 상황 훈련 3 / 4종 · 만점 1", "갈림길 탐험 3 / 17", 공정 칸 4개(제강에 테두리). 학습 기록 레이아웃 테스트(15px·모서리 토큰) 통과. typecheck 통과,
npm test463/463 통과. - 20회차의 "홈 화면으로 넘어감" 원인 찾음: 서버를 다시 켜면 로그인 토큰 서명이 바뀌어 예전 토큰이 무효가 되고, v4가 무효 토큰을 보면 홈으로 보낸다. 내가 새 토큰을 넣기 전에 페이지가 먼저 열렸던 것(앱 버그 아님, 시연 서버 재시작 때만 생김).
- 만든 것:
causalChains(length)(연결을 이어 붙인 길, 변수 3·4개),causalQuiz(…, level)level 2는 세 칸 길에서 공정 3개 이상을 넘는 길을 먼저,checkHop은 칸 1~3으로 일반화(방향 = 원인 방향 × 지난 연결 부호의 곱). 마이그레이션016_causal_quiz_deep.sql: 014의CHECK (hop IN (1, 2))를 넓히려고 표를 새로 만들어 옮김(SQLite는 CHECK를 바꿀 수 없음). API?level=2·칸 3 받기. 화면: 칸 수만큼 차례로 묻도록 일반화(①②③), 다시 풀기는 칸마다 기억한 방향으로 맞힌 칸을 건너뛴다, 튜터 질문은 거쳐 간 변수를 모두 적는다. 두 칸 퀴즈를 다 맞히면 [⬆ 심화: 세 칸 퀴즈], 주소?lab=quiz&level=2. - 확인: 테스트 2개(세 칸 길·공정 3개 먼저·칸 3 정답 부호·칸 4 없음, 마이그레이션 뒤 칸 3 받고 칸 4 막음). 데모 DB 마이그레이션 뒤 기존 답 21칸 그대로. 화면: 1번 "제강 → 다른 공정" ① 턴디시 과열도 ② 슬래브 중심 편석 ③ 압연 내부 결함 위험, 15칸 중 8 → [틀린 칸만 다시 풀기 (7칸)] → 정확히 7칸을 묻고 "① … (지난번에 맞힌 칸)", "③ … (지난번에 맞힌 칸)" 표시 → 7/7. typecheck 통과,
npm test465/465 통과.
- 만든 것: 수업 내용
content/lessons/lessons.json(수업 2개: '공정을 잇는 원인과 결과' 6단계 25분, '증상으로 원인 추론하기' 4단계 15분). 단계 종류는 공장 전체 흐름·인과 지도(조건·따라가기)·인과 퀴즈(심화 포함)·거꾸로 추론·이상 상황 훈련·사고 사례 갈림길, 단계마다 진행자 안내.backend/src/lab/lessons.ts가 형식과 참조(인과 지도 조정 값·범위, 이상 상황 id, 사고 사례 갈림길, 인과 지도 단계의 조건, id 중복)를 검사하고 서버 시작 때 막는다.GET /api/lab/lessons·/:id. 3D 화면?lab=lesson&lesson=…&step=n: 위쪽 수업 막대(수업 이름·시간·단계 제목·진행자 안내, [◀ 이전]·[다음 ▶]·[안내 접기]·[수업 끝내기]), 단계를 넘기면 그 실습을 열고 주소의 step도 바꾼다. 운영 콘솔 [3D 실습] 탭에 '🎓 수업 모드' 카드와 [3D에서 수업 열기]. - 확인: 테스트 2개(참조·나쁜 참조 5종 막기·진행자 안내의 인과 설명이 모델과 맞음 — 재가열 온도↓는 사상압연 출구·권취 온도를 함께, 냉각 뱅크↑는 권취 온도만; HTTP 목록·하나·404). 화면: 1단계 공장 흐름(패널 닫힘·흐름 켜짐) → 2·3단계 인과 지도 → 4 거꾸로 추론 → 5 이상 상황 훈련 → 6 갈림길, 마지막에 [다음] 비활성, [이전] 3번 → 3단계 출강 온도 1,690℃. 운영 콘솔 카드에 수업 2개와 링크. typecheck 통과,
npm test467/467 통과.
- 점검: 1440×900에서 수업 '공정을 잇는 원인과 결과' 6단계(공장 흐름·인과 지도 2·거꾸로 추론·이상 상황·갈림길)와 조업 실험까지 7개 화면을 차례로 열어 패널·수업 막대·이름표 글에 undefined/NaN/[object 없음, 패널과 실행 버튼·수업 막대 겹침 없음, JS 오류 0. 375×812에서 같은 6단계: 실행 버튼과는 안 겹치지만 수업 막대(16
246px)가 실습 패널(143590px)을 덮음. - 고친 것: ① 실습 패널 위 끝을
--sl-panel-top(수업 막대 아래 끝 + 10px, ResizeObserver)로 맞춤(데스크톱 기본 84px, 좁은 화면은 높이 계산에 반영), 좁은 화면에서는 진행자 안내를 접은 채로 시작 → 막대 16173, 패널 183590으로 안 겹침. ② [수업 끝내기] 뒤에도 주소에lab=lesson&step=6이 남아 새로 고침하면 수업이 다시 열리던 것 → 주소를?p=공정으로 되돌리고 패널 위치 값도 지움. - 확인: 테스트 1개, typecheck 통과,
npm test468/468 통과.
- 만든 것:
GET /api/me/lab/xapi에 활동 종류(활동 id의/activities/<종류>/) — 문장마다kind, 동사로 거른 뒤의 종류별 개수kinds,?kind=로 거르기(동사와 함께). 학습 랩 [xAPI 기록]에 동사 칩 아래 '종류로 거르기' 칩 줄(아이콘·이름·개수, 같은 칩을 다시 누르면 풀림), 줄마다 종류 아이콘. 종류 이름: 공정·개념·복습 카드·설비·설계도·인과 퀴즈·이상 상황 훈련·갈림길·인과 따라가기·조건 링크·갈림길 3D. - 확인: 테스트 1개(종류 개수·kind 거르기·동사와 함께·종류 개수 합 = 동사로 거른 수). 처음 쓴 단언 하나는 앞 테스트가 kim 기록을 지워서 성립하지 않아 뺐다. trainee05 화면: 종류 칩 10개("🧩 인과 퀴즈 29", "🗺 인과 따라가기 10", "🔗 조건 링크 6", "🔀 갈림길 3D 4" …), 인과 퀴즈를 누르면 29개 문장만. typecheck 통과,
npm test469/469 통과.
- 점검: 이번 데모에서 쓴 화면·서버 문구에서 괄호 조사('(은)는'·'이(가)' 등) 0개. 값을 끼워 넣은 뒤 고정 조사를 붙인 곳 5개를 찾음: ① 조업 실험 다음 공정 버튼
${공정}으로 따라가 보기→ '연주으로'가 됨 ② 오늘의 실습 경로 이유${공정}이 걸린→ '연주이' ③ 인과 지도 첫 줄 '290kg/t (-50)로'(숫자는 읽는 법에 따라 조사가 달라짐) ④⑤ 내용 검사 오류 문구 '값 ${v}이'. - 고친 것: 서버
josa(word, 받침 있을 때, 없을 때)(ㄹ 받침은 '로', 끝 괄호 제외, 영문은 L·M·N·R만 받침)와 화면euRo. ①은 euRo(연주로·제선으로·열간압연으로), ②는 josa(연주가), ③은 "코크스비를 바꿨어요: 290kg/t (-50)."로 숫자 뒤 조사를 없앰, ④⑤는 "k = v, 범위 밖이에요". - 확인: 테스트 2개(josa 공정 4개·으로/로·ㄹ 받침·괄호·영문, 화면 소스에 고정 조사 없음). API: "코크스비를 바꿨어요: 290kg/t (-50).", "제강이 걸린 인과 퀴즈 정답률이 63%". typecheck 통과,
npm test471/471 통과.
- 만든 것:
DEMO-GUIDE.md— 기능 표(어디서·바로 가는 주소), 기능별 설명(인과 지도·인과형 질문 틀·이상 상황 ↔ 인과 지도·갈림길·공장 흐름·학습 기록/운영·다듬기), 추가 API, 마이그레이션 014~016, 콘텐츠 파일, 교육용 대략값 안내, 확인 방법. - 확인: 표의 주소는 앞 회차들에서 화면으로 연 주소와 같음. typecheck 통과.
npm test첫 실행은 470/471 — 기존 테스트deleteUserData: 보충학습과 실행 기록도 지운다가fetch failed: bad port로 실패(테스트 서버가listen(0)으로 받은 임의 포트가 Node fetch의 차단 포트 목록에 걸림, 이번 변경과 무관). 다시 돌려 471/471 통과. 기록을 먼저 쓰고 실패를 늦게 봐서 이 줄을 고쳐 적는다.
- 만든 것:
causal.tsCONCEPT_VARS(개념 → 인과 지도 변수, final 제선 개념 3개 + 시연 개념 9개)와conceptVars(표에 없으면 개념 설비와 같은 설비의 변수).GET /api/lab/causal/concepts(final 루브릭·시연 개념 목록에서 공정·변수). 학습 기록 [내 오개념]의 각 항목을 펼치면 [🗺 인과 지도에서 이 개념 보기 · n개 값] → 3D 인과 지도에서 첫 변수의 설명 카드로 연다. - 확인: 테스트 1개(표의 개념이 final 루브릭·시연 목록에 있고 변수가 같은 공정, 설비로 찾기, API 12개·냉각과 권취). 처음 표에서 '용선 예비처리'에 제선 변수(용선 황), '2차 정련'에 연주 변수(과열도)를 넣었는데 테스트가 잡아 같은 공정 변수로 고침. 화면: trainee05의 오개념 2개(소결의 목적·냉각과 권취)에 링크, 냉각과 권취 → 압연 '런아웃 냉각 뱅크' 카드. typecheck 통과,
npm test472/472 통과.
- 고친 것(
sim-lab.jsfx.tick): 22회차 겹침 정리가 매 프레임 이름표마다offsetWidth·offsetHeight를 읽었다(위치를 쓴 뒤 읽으면 레이아웃을 다시 계산). 이름표 글은 만든 뒤 바뀌지 않으므로 처음 보일 때 한 번만 재서 캐시. - 확인: 1440×900, 인과 지도 이름표 13개에서 크기 읽기를 세는 계측(offsetWidth/Height 게터 감싸기, 3초): 전 1,569회/초·1.73ms/초 → 후 0회/초·0ms, 60fps 그대로, 겹침 0 그대로. 테스트 단언 1개 추가, typecheck 통과,
npm test472/472 통과.
- 만든 것: xAPI 3D 살펴봄 종류에
lesson(object_id<수업>_<단계>, 이름은 서버가 "수업 · 수업 제목 · 2/6 단계 제목"으로, 없는 수업·단계는 404). 3D 수업 막대가 단계를 열 때마다 남긴다.GET /api/admin/practice-stats에lessons(수업별 연 사람·끝 단계까지 간 사람·단계별 사람 수, 시연 계정 빼기 규칙 그대로). 운영 콘솔 수업 카드에 "연 사람 n명 · 끝 단계까지 m명 · 단계별 1:… 2:…". 학습 랩 xAPI 종류 칩에 '🎓 수업'. - 확인: 테스트 2개(HTTP 이름·404 2종, 통계 2명·끝 1명·단계별 [2,2,1,1,1,1]). 화면: trainee05로 '증상으로 원인 추론하기' 1→4단계 → 관리자 통계 diagnose-drill 1명·끝 1명·단계별 1,1,1,1, xAPI
?kind=lesson4개("수업 · 증상으로 원인 추론하기 · 4/4 심화: 세 칸 인과 퀴즈" …). typecheck 통과,npm test474/474 통과.
- 만든 것(
sim-lab.js): 패널 공통 머리(head)에 [접기]/펴기 — 제목 줄만 남기고 나머지를 숨겨 3D를 넓게 본다(.sl-panel.folded, 진행은 그대로). 훈련 목록 → 훈련처럼 패널을 다시 그려도 접힌 상태를 이어받고, 다른 실습을 열면 푼다. 인과 지도의 [결과만 보기](조건만 숨김)는 그대로 둠. - 확인: 테스트 1개. 화면: 인과 퀴즈 158px → 접기 68px(보이는 자식 1개·버튼 '펴기'·aria-expanded false) → 펴기 158px, 이상 상황 목록에서 접기 68px, 훈련을 열고 접기 '펴기' 유지, 인과 지도를 열면 풀림. typecheck 통과,
npm test475/475 통과. - 백로그 36·37을 새로 넣었다.
- 만든 것: 갈림길 선택에 선택 필드
causal(인과 지도 조정 값). 사례 8개 갈림길 중 조업 값으로 이어지는 것은 연주 브레이크아웃 사례 2곳뿐이라 거기에만 넣음(래들 지연 때 속도 올림 1.7 / 범위 안 1.2, 경고 때 속도 유지 1.7 / 낮춤 1.0). 나머지(가스·젖은 고철·잠금)는 모델에 없는 안전 행동이라 넣지 않음. 파일 검사(조정할 수 없는 값·범위)를loadIncidents에 추가. 3D 갈림길 패널에서 고른 선택에 조건이 있으면 [🗺 인과 지도에서 이 선택 보기 (주조 속도 1.2m/분)] → 그 조건으로 인과 지도와 따라가기. - 확인: 테스트 1개(실제 선택은 브레이크아웃 위험 범위 밖, 다른 선택은 범위 안 — 4개 선택 모두, 나쁜 값 막기). 화면: 경고 갈림길 실제 선택 "주조 속도 1.7", 다른 선택으로 바꾸면 "1.0" → 인과 지도 주조 속도 1.00m/분·브레이크아웃 위험 0점·따라가기 시작. 버튼 값에 단위·자리수 붙임("1" → "1.2m/분"). typecheck 통과,
npm test476/476 통과.
- 만든 것:
GET /api/lab/faults목록에causal(16회차의 원인 조건). 인과 지도 '바로 해 보기' 칸에 '🚨 이상 상황 재현' 줄 — 훈련 4종(제선·제강·연주·열간압연) 버튼을 누르면 그 원인 조건을 넣고 따라가기를 바로 시작한다(훈련을 하지 않아도 원인 → 하류를 볼 수 있게). - 확인: 테스트 단언 1개(목록의 훈련마다 causal). 화면: 버튼 4개, '권취 온도가 목표보다 낮다' → 냉각 뱅크 15개·따라가기 1단계 열간압연. typecheck 통과,
npm test476/476 통과.
- 만든 것(
sim-lab.js): 3D 화면에 처음 들어오면 실행 버튼 위에 한 번만 뜨는 말풍선 "새 3D 실습 · 🗺 공정 인과 지도부터 눌러 보세요…" [인과 지도 열기]·[닫기]. 닫거나 실행 버튼을 누르면 브라우저에 '봤음'을 남겨(st-rookie:sim-lab-hint, 저장 실패는 무시) 다시 안 뜬다. 주소로 실습을 바로 연 경우(?lab=)는 띄우지 않는다. 상태 줄로도 읽어 준다. - 확인: 테스트 1개. 화면: 말풍선 표시 → [인과 지도 열기] → 말풍선 사라짐·저장 1·인과 지도 열림. 258px 높이 창에서 말풍선 위 끝이 -54px로 화면 밖 → 위로 넘치면 화면 위 8px에 붙이도록 고침(8~172px) → [닫기] → 새로 열면 안 뜸. 검사 중 스크립트로
location.href를 바꾼 직후 한 번 홈으로 넘어갔는데, 토큰은 유효했고 브라우저 이동 도구로 다시 열면 12초 동안 그대로라 시험 절차 쪽 경합으로 보고 기록만 남긴다. typecheck 통과,npm test477/477 통과.
- 점검: 375×812에서 인과 지도 패널·실행 버튼의 누르는 곳 높이를 잼 — 패널 버튼 36px(24개), 실행 버튼 42px(4개), 변수 줄 28px(20개), 슬라이더 16px(6개)로 44px 미만.
- 고친 것(
sim-lab.js):@media (pointer: coarse), (max-width: 740px)에서 패널 버튼·보기·변수 줄·계기 줄·실행 버튼·수업 막대·첫 안내 버튼min-height: 44px, 작은 아이콘 버튼min-width: 44px, 슬라이더 높이 44px. 마우스를 쓰는 넓은 화면은 그대로. - 확인: 같은 화면에서 44px 미만 0개(인과 지도·이상 상황 훈련), 실행 버튼 묶음이 커져도 패널(139
586)과 버튼(596692) 안 겹침(9회차 위치 맞춤이 따라감). 테스트 1개, typecheck 통과,npm test478/478 통과.
- 만든 것:
causal.tslagQuiz(두·세 칸 길 중 공정을 넘는 길의 처음·끝 변수, 보기 4개 = 정답 + 다른 시간 문구 3개)·checkLag(두 변수의 공정으로 정답을 다시 계산),GET /api/lab/causal/lag-quiz·POST …/check. 인과 퀴즈 끝 화면에 '⏱ 언제 나타날까?' 한 문항 — 방향 다음에 시간을 묻는다. 답하면 정답 표시, 3D에 원인 → 결과 설비 흐름과 '⏱ 약 n~m시간 뒤' 이름표, 대략값 안내. 기록하지 않는 자가 점검. - 확인: 테스트 1개(씨앗 5개: 공정을 넘음·보기 4개 서로 다름·정답 포함·정답만 맞음, 없는 변수 null). 화면: 퀴즈 끝 → "제선 · 용선 온도를 바꾸면, 제강 · …은 언제 달라질까요?" 보기 4개 → 틀린 답 → "약 2
4시간 뒤 나타나요…", 3D 이름표 "⏱ 약 24시간 뒤". typecheck 통과,npm test479/479 통과.
- 만든 것: 마이그레이션
017_diagnose_answers.sql(문제 = 진짜 원인 키, 고른 원인, 맞았는지).POST /api/lab/causal/diagnose/check가 채점 때 남긴다(사원증 XP 없음). 관리자 3D 실습 통계에diagnose(답 수·사람 수·정답률, 헷갈리는 원인 5개 = 답 2번 이상·정답률 낮은 문제와 그때 가장 많이 고른 다른 원인). 운영 콘솔 [3D 실습]에 '🔍 거꾸로 추론' 카드. 사용자 기록 지우기에 포함. - 확인: 테스트 1개(기록·정답률·헷갈리는 원인 '재가열 온도 ▼ ↔ 런아웃 냉각 뱅크 ▲'·지우기). 서버: trainee05·06으로 답 5개 — 처음 넣은 '출강 온도 ▲' 문제에 '주조 속도 ▲'는 같은 증상(껍질↓·브레이크아웃↑)을 만들어 규칙대로 맞음 처리됨(18회차 설계대로, 시험 입력을 바꿈). 운영 콘솔 카드 "답 5개 · 2명 · 정답률 60%", "출강 온도 ▲ ↔ 많이 고른 답 코크스비 ▼ · 정답 60% · 5번". typecheck 통과,
npm test480/480 통과.
- 만든 것:
causal.tsrebalancePuzzles(조정 값 하나를 끝 쪽 80%로 흔들어 범위 밖이 된 하류 값마다, 다른 조정 값 하나를 간격대로 훑어 정상 범위로 되돌릴 수 있는 것만 퍼즐로 — 지금 모델에서 4개: 출강 온도·주조 속도가 응고 껍질·브레이크아웃 위험을 흔드는 경우)·checkRebalance(조정 값 하나만, 흔든 값은 못 바꿈, 풀렸는지·고른 값이 목표에 닿는지·새로 범위 밖이 된 값 = 부작용).GET /api/lab/causal/rebalance·POST …/check. 3D 패널 '🧰 되돌리기 퍼즐'(인과 지도 예시 줄,?lab=rebalance): 상황(흔든 값·범위 밖 목표) → 움직일 값 고르기(흔든 값을 뺀 조정 값 5개 전부, 닿지 않는 값도 보기에) → 슬라이더 → [이렇게 조치하기] → 결과·부작용·맞바꿈 안내, 3D에 흔들림·목표·조치·부작용 링과 이름표. - 확인: 테스트 1개(퍼즐마다 풀이가 실제로 있음, 보기 = 다른 조정 값 전부, 출강 온도 1680℃일 때 주조 속도 0.9로 풀리지만 주조 속도 자체가 범위 밖 = 부작용, 1.2는 닿지만 부족, 코크스비는 닿지 않음, 두 값·흔든 값은 막음). 처음 테스트는 '주조 속도 1.0이면 풀린다'로 썼는데 모델로 훑어 보니 0.95 이하에서만 풀려 맞바꿈을 확인하는 테스트로 고침. 화면: "연주 · 주조 속도를 1.70m/분으로 바꿀 수밖에…" → 코크스비 → "이어지지 않아요" → 출강 온도 최소 → "✓ 되돌렸어요 15.5mm, 부작용 — 출강 온도 1600℃, 턴디시 과열도 0℃" + 맞바꿈 안내. '1.70m/분로' 조사를 euRo로 고침. typecheck 통과,
npm test481/481 통과.
- 만든 것(
sim-lab.jsnextStep): 인과 퀴즈 끝(시간 질문 아래)과 이상 상황 훈련 끝(점수 아래)에 '다음 추천 · 오늘의 실습 경로(공정)' 한 줄 — 경로 단계 중 지금 실습과 종류가 다르고 끝내지 않은 첫 단계. 누르면 페이지를 다시 열지 않고 같은 3D 화면에서 그 실습(인과 지도 변수 카드·공정 퀴즈·훈련)을 연다. - 확인: 테스트 1개. 화면: 인과 퀴즈 끝 → "다음 추천 · 오늘의 실습 경로(제강) ▶ 인과 지도에서 '출강 온도' 살펴보기" → 누르면 인과 지도·출강 온도 설명 카드. typecheck 통과,
npm test482/482 통과.
- 만든 것: 수업 단계 종류에
rebalance(되돌리기 퍼즐,lessons.ts·수업 막대). 세 번째 수업 '원인을 못 고칠 때의 현장 판단'(20분): ① 주조 속도 1.7 따라가기 ② 거꾸로 추론(같은 증상을 내는 원인이 여럿) ③ 되돌리기 퍼즐(부작용 짚기) ④ 세 칸 퀴즈(끝에 시간 질문). 수업 파일은 저장하며 JSON 들여쓰기만 펼쳐졌고 기존 두 수업 내용은 그대로. - 확인: 테스트 1개(단계 종류 4개, 안내의 '출강 온도↑·주조 속도↑가 같은 증상(껍질↓·브레이크아웃↑)'이 모델과 맞음), 수업 참조 검사 그대로 통과. 화면: 1/4 인과 지도 → 2/4 거꾸로 추론 → 3/4 되돌리기 퍼즐("제강 · 출강 온도를 1,680℃로…") → 4/4 인과 퀴즈. typecheck 통과,
npm test483/483 통과.
- 점검(1440×900): 인과 지도·인과 퀴즈·거꾸로 추론·되돌리기 퍼즐을 차례로 열어 Esc로 닫기, 조업 실험·이상 상황 실행 버튼 열고 닫기 — 열리고 닫힘·주소 이동 없음(Navigation API 기록), 오류 없음. 375×812: 되돌리기 퍼즐·거꾸로 추론 패널 139
586px·실행 버튼 596692px 안 겹침, 가로 넘침 없음, 44px 미만 0개(보기 고른 뒤 포함). - 홈 이동: 이번 점검 첫 실행에서도 화면 크기를 바꾼 직후 홈으로 넘어감. v4에서 홈으로 보내는 코드는 로그아웃(토큰을 지움)뿐인데 토큰이 그대로였고, 같은 순서를 단계마다 기록하며 다시 하면 재현되지 않음. 미리보기 창이 탭을 첫 주소(
/, 서버가 홈으로 보냄)로 되돌린 것으로 보고 안내서 시연 메모에 남김(앱 원인은 찾지 못함). - 안내서(
DEMO-GUIDE.md): 31~43회차 기능(되돌리기 퍼즐·시간 질문·이상 상황 재현 예시·오개념 → 인과 지도·수업 3개·갈림길 → 인과 지도·다음 실습 추천·관리자 수업/거꾸로 추론 통계·접기·첫 안내·터치 크기·이름표 캐시), API 5개, 마이그레이션 017, 테스트 수 483, 시연 메모 추가. - 확인: typecheck 통과,
npm test483/483 통과.
- 만든 것: 흔드는 크기를 3단계(
DISTURB_LEVELS50%·80%·100%)로 바꿔 퍼즐을 찾고(같은 흔든 값·목표는 한 번만), 퍼즐마다clean(부작용 없이 되돌릴 수 있는 값이 있음)을 붙여 쉬운 것부터 정렬. 퍼즐 4개 → 9개(쉬움 4), 열간압연 퍼즐(런아웃 냉각 뱅크 → 권취 온도)이 새로 생김. API?level=easy, 응답에clean. 패널 머리에 '쉬움(부작용 없이 되돌릴 수 있어요)'/'맞바꿈(되돌리면 다른 값이 범위 밖으로…)', [쉬운 퍼즐] 버튼. - 확인: 테스트 수정(퍼즐 8개 이상·쉬운 것 먼저·id 중복 없음, 퍼즐 id에 흔든 값 포함). API: 쉬운 퍼즐 '냉각 뱅크 8개 → 권취 온도 범위 밖'에서 재가열 온도 1170으로 부작용 없이 615℃로 되돌아옴. 화면: 첫 퍼즐 '맞바꿈', [쉬운 퍼즐] → '쉬움 · 주조 속도 1.70m/분 → 브레이크아웃 위험 34점'. 퍼즐 찾기 35ms(서버 처음 한 번). typecheck 통과,
npm test483/483 통과.
- 만든 것:
GET /api/lab/causal/related?var=(그 변수를 원인 조건으로 쓰는 이상 상황 훈련·사고 사례 갈림길 선택·수업 단계, 그 변수를 흔들거나 목표로 하는 되돌리기 퍼즐). 되돌리기 퍼즐?id=로 특정 퍼즐 열기. 인과 지도 변수 설명 카드 아래 '이 값이 나오는 실습' 버튼(🚨 훈련·🧰 퍼즐 최대 3개·🔀 갈림길 선택·🎓 수업 단계) — 같은 화면에서 열고, 수업은 수업 주소로. 카드는 값이 바뀔 때마다 다시 그려지므로 변수별로 한 번만 불러오게 캐시. - 확인: 테스트 1개(주조 속도 → 훈련 1·퍼즐·갈림길·수업 '현장 판단', 권취 온도는 퍼즐 목표, 없는 변수 404). 화면: 주조 속도 카드에 9개(훈련 1·퍼즐 3·갈림길 4·수업 1) → 퍼즐 버튼 → "쉬움 · 주조 속도 1.70m/분 → 응고 껍질 11.0mm" 그 퍼즐이 열림. 갈림길 버튼 글이 길어 24자로 줄임. typecheck 통과,
npm test484/484 통과.
- 만든 것: 마이그레이션
018_rebalance_attempts.sql(퍼즐·움직인 값·값·풀었는지·부작용 없이 풀었는지), 채점 때 기록. 사원증 새 기록 종류rebalance_clean(부작용 없이 푼 퍼즐, 퍼즐마다 처음 한 번, 15 XP, 하루 3번 상한)과 배지 '🧰 보상 판단'(5개), XP 안내 줄, xAPI '끝냄 · 되돌리기 퍼즐', 학습 랩 xAPI 종류 칩, 사용자 기록 지우기 포함. 퍼즐 패널에 부작용 없이 풀면 XP 안내. - 확인: 테스트 1개(기록 3개·같은 퍼즐 두 번 풀어도 사원증 기록 1개·닿지 않는 값은 기록만·지우기). API: trainee05로 쉬운 퍼즐(냉각 뱅크 8 → 권취 온도)을 재가열 온도 1170으로 부작용 없이 풀기 → XP 890→905, 배지 0→1/5. typecheck 통과,
npm test485/485 통과.
- 만든 것:
practiceStats에rebalance(퍼즐별 이름 '흔든 값 ▲▼ → 목표', 시도·사람 수, 푼 비율, 부작용 없이 푼 비율, 목표에 닿지 않는 조정 값 중 가장 많이 고른 것).causal.ts의controlAncestorsOf로 닿는지 판단. 운영 콘솔 [3D 실습]에 '🧰 되돌리기 퍼즐' 카드. - 확인: 테스트 1개(4번 시도 → 푼 50%·부작용 없이 25%·자주 고른 닿지 않는 값 코크스비 2번). 화면: 운영 콘솔 카드 "런아웃 냉각 뱅크 ▼ → 권취 온도 · 자주 고른 닿지 않는 값: 코크스비(1번) · 2번 · 1명 · 풂 50% · 부작용 없이 50%". typecheck 통과,
npm test486/486 통과.
- 만든 것:
practice-path요약에diagnose_answers·diagnose_rate(거꾸로 추론)·rebalance_clean(부작용 없이 푼 퍼즐 수, 같은 퍼즐은 한 번). 학습 기록 [학습 랩] 맨 위 요약 칩 5개로. - 확인: 테스트 수정(빈 요약 필드, 거꾸로 추론 2문제 중 1·같은 퍼즐 두 번 → 1). 화면: trainee05 "인과 퀴즈 57% · 63칸", "이상 상황 훈련 3 / 4종 · 만점 1", "갈림길 탐험 6 / 17", "거꾸로 추론 50% · 2문제", "되돌리기 퍼즐 부작용 없이 1개". typecheck 통과,
npm test486/486 통과.
- 만든 것:
practicePath가 거꾸로 추론 답(017)을 문제의 진짜 원인 변수 공정으로 묶어diagnose_rate를 내고, 풀어 본 공정만 약한 정도에 넣는다(안 풀었다고 약하게 보지 않음). 이유 문장에 '거꾸로 추론 정답률이 n%'. 거꾸로 추론만 해 본 공정에 "아직 안 해 봤어요"가 나오던 조건도 고침. - 확인: 테스트 1개(압연 거꾸로 추론 3문제 모두 틀림 → 압연 약한 정도 오름·경로 공정 압연·이유 문장). 처음엔 이유 문장 조건이 거꾸로 추론을 몰라 테스트가 잡음 → 고침. API(trainee05): "제강이 걸린 인과 퀴즈 정답률이 55%, 거꾸로 추론 정답률이 50%, 이상 상황 훈련은 아직 안 해 봤어요." typecheck 통과,
npm test487/487 통과.
- 만든 것: 수업 막대 마지막 단계에서 [다음] 대신 [🎓 수업 마치기] → 막대 제목 '수업을 마쳤어요 · 수업 제목', 안내에 '오늘 본 것: 1. … 4. …'와 목표, xAPI 수업 살펴봄
<수업>_done(이름 '수업 · 제목 · 마침'). 관리자 통계 수업별reached_last(마지막 단계까지 연 사람)와finished(수업 마치기를 누른 사람)를 나눔, 운영 콘솔 문구도 '마지막 단계까지 n명 · 수업 마침 m명'. - 확인: 테스트 2개 수정·추가(마지막 단계 1명·마침 0명 → 마침 기록 뒤 1명, HTTP 마침 이름·없는 수업 404). 화면: '현장 판단' 4/4 → 버튼 [◀ 이전]·[🎓 수업 마치기]·[안내 접기]·[수업 끝내기] → 마치기 → 제목·요약·xAPI "수업 · 원인을 못 고칠 때의 현장 판단 · 마침". 관리자 통계 field-judgment 마침 1. typecheck 통과,
npm test488/488 통과.
- 안내서(DEMO-GUIDE.md)에 45~51회차 기능(수업 '현장 판단', 퍼즐 단계·쉬움 표시, 변수 카드 → 관련 실습, 퍼즐 기록·XP·'보상 판단' 배지·018, 관리자 퍼즐·수업 마침 통계, 요약 칩, 실습 경로의 거꾸로 추론, 수업 마치기)과 테스트 수 488을 반영.
- 최종 점검: typecheck 통과,
npm test488/488 통과. 화면은 주소 8개(lab=map·quiz(level=2)·diagnose·rebalance·fault·incident·whatif·lesson(field-judgment 3단계))를 차례로 열어 패널 제목이 뜨고 페이지 오류(error·unhandledrejection)가 0개인 것을 확인. 패널의 붉은 글은 모두 '정상 범위 밖' 안내(내용)였고 오류 문구는 없었음. - 추가 점검(04:12~04:13): 학습 기록 › 학습 랩에서 오늘의 실습 경로(제강, 퀴즈 55%·거꾸로 추론 50%)와 요약 칩(거꾸로 추론 50%·2문제, 되돌리기 퍼즐 부작용 없이 1개)이 보이고 페이지 오류 0개. 관리자 운영 콘솔 3D 실습(admin01)에서 수업 3개의 '마지막 단계까지 n명 · 수업 마침 m명'(현장 판단 1·1), 거꾸로 추론 '답 5개 · 2명 · 정답률 60%'가 보이고 페이지 오류 0개.