Skip to content

Latest commit

 

History

History
112 lines (71 loc) · 10.4 KB

WORKLOG.md

File metadata and controls

112 lines (71 loc) · 10.4 KB

작업 기록

2026-10-14 평가 시험 화면을 학습 기록 체계로 통일하고 포석호를 붙임

  • /exam을 학습 기록(Trainee Dashboard.dc.html)과 같은 토큰·헤더·제목·카드 체계로 다시 입혔다(PROVE & PASS., 통계 카드 묶음, 공정 카드, .card 패널). 망치 로딩 화면(담금질 하기)도 검은 전체 화면 대신 흐린 페이지 위 같은 체계의 카드로 바꾸고, 쇠는 회색·달군 쇠만 호박색(--mid 계열)으로 칠했다. 로직(작업 조회·취소·재연결·답안 초안·Idempotency-Key·일시 정지·로그아웃)은 그대로다.
  • 시험 패널에 포석호(cp-character, 한 개만 만들어 motion만 바꿈)와 흰 말풍선을 넣었다. 반응(정답·거의·아쉬움·핵심 정리)과 질문은 말풍선에, 설명은 '포석호의 설명' 블록에. 동작은 checkpoint-chat.js의 motionFor, 효과음은 tutor-sfx.js(새 발화에 한 번, 토글). 이전 페이지가 버리던 almost·miss 발화도 보여 준다.
  • AI 튜터 패널 머리(학습 기록·v4)에도 포석호를 붙였다(learning-chat.js의 tutorMotionFor: 기다리면 thinking, 스트리밍이면 explain, 보충학습 반응·결과는 motionFor). 테스트 345개 통과.
  • "시험 창이 정적이고 연결이 안 된 것 같다"는 보고의 원인은 모델 속도였다. gemini-3.5-flash-lite가 호출당 1533초(503 high demand)였고 같은 키의 gemini-3.5-flash는 2초였다(시각에 따라 lite도 23초로 돌아온다). 그래서 망치 화면에 지나온 단계 칸(준비 → 답안 채점 → 설명 정리 …)을 더하고 말풍선의 질문 줄을 한 글자씩 적게 해 기다리는 동안에도 화면이 움직이게 했다. 모델 전환은 비용이 늘어 팀 결정으로 남겼다.

2026-10-14 평가 시험 분리와 교육 운영 백엔드

  • 학습 기록 화면의 AI 튜터 안에 있던 이해도 확인 UI를 /exam 별도 페이지(평가 시험)로 분리했다. 처리 중에는 검은 배경에 망치·불꽃 애니메이션과 '담금질 하기', 작업 단계·경과 시간·취소 버튼을 보여 준다. 사용자별 답안 초안과 요청 키를 저장해 새로고침·재연결에서 중복 채점을 막는다.
  • 마이그레이션 010: 시험 작업(대기열·취소·중복 제출 방지), 루브릭 이력, 복습 일정, 교육 그룹·배정, 자료 검수 API를 backend/src/education/에 추가했다. 승인한 자료만 검색·출처에 반영하고 검색·답 저장을 비운다. 관리자용 등록·승인 화면은 아직 없다.
  • 취소한 요청은 시험을 다음 단계로 진행시키지 않는다. 기록 초기화 도구가 시험 이력·복습 외래 키를 먼저 지운다.
  • 이 작업은 Ollama 브랜치 위에서 만들어진 것을 dev 기준으로 옮긴 것이다. 모델 연결부(LLM_PROVIDER)는 dev에 없어 채점 이력의 모델 정보는 Gemini로 적는다.

커밋 본문의 "왜"는 이 파일의 문제/해결에서 가져온다. 새 작업을 하면 위에 추가한다.

2026-10-10 sleek 3D 화면 톤·UI·조명 정리

문제

  • 홈(무채색 + 흰색)에서 로그인 후 3D로 넘어가면 다른 사이트처럼 보였다. 평균 밝기는 비슷했지만(37 vs 33) 채도(0.02 vs 0.60)와 푸른 픽셀 비율(0% vs 85%)이 크게 달랐고, UI 틀은 남색·하늘색이었다.
  • 공정 화면에서 설비가 오른쪽으로 쏠렸다. scene_v3.js의 _resize가 공정 안에서 늘 폭의 10%(최대 170px)를 오른쪽으로 밀었고, 시연 중에는 오른쪽 패널이 3D 위에 겹쳐 떴다.
  • 오른쪽 위 아이콘·왼쪽 공정 메뉴·보기 탭·전체 보기가 흩어져 있었고, 왼쪽 메뉴가 네 공정을 모두 펼쳐 자리를 많이 차지했다. 한글에 모노 글꼴을 써서 이어 풀기 안내의 자간이 벌어졌다.
  • 주변 물체가 공정보다 2~8배 컸다(공정 1단위 ≈ 12m 기준: 가로등 7 ≈ 84m, 나무 ≈ 50m, 건물 높이 중앙값 8 ≈ 96m). 나무는 지름 2m 구라 덩어리처럼 보였다.
  • 밤에 공정만 하얗게 뜨고 주변은 어두웠다. 실제 조명(투광등 4, 밤 키라이트, 구역 조명 2)과 수평선 글로우 원통·가짜 안개·먼 바다 링이 겹쳐 수평선이 층져 보였다.

해결

  • 주변 배경만 채도 60%로 낮추고 공정 색은 유지했다. 공정 화면은 메뉴·패널에 가리지 않는 영역 가운데로 맞춘다(sleek-overview.js의 setupFraming, scene_v3.js는 수정하지 않음).
  • 상단 알약 하나로 UI를 모았다(레퍼런스: Colonia Zacamil). 왼쪽 메뉴는 지금 공정만 보이는 한 줄 캡슐로 올려 시연 시작 때 접히게 했고, 이어 풀기는 인트로 뒤 3.4초 토스트로 바꿨다. 라이트 모드는 우윳빛 그라데이션 캡슐, 선택은 청록 #3f9db4.
  • 건물 높이·나무·가로등을 ×0.5·×0.5·×0.3으로 줄이고, 나무는 잎 그림 평면 4장(아틀라스 1장), 건물은 트림시트 1장을 공유하게 했다.
  • 밤 조명은 굽고 실제 조명은 뺐다: 공정 꼭짓점에 환경광 + 키라이트(그림자 포함, 원래 대비 약 70%), 빈터 옴니 3·투광등 4는 바닥 라이트맵에. 남은 실제 조명은 방향광 1, 하늘빛 2.
  • 바다는 같은 셰이더의 원형 먼 바다(반지름 2.8km)로 통일해 하늘과 또렷하게 갈리게 했다.

남은 일

  • docs/next-steps-sleek.md(3D 이름표 색, 체크포인트 오버레이 통일, 고폴리 에셋 반영 등), 백엔드는 docs/backend-todo.md.
  • Steel Academy v4.dc.html(sleek 페이지를 v4로 이름 변경)과 scene_v3.js 계열은 프론트 담당(viiin2)과 공유한다. /는 v4로 바꿨으니 대시보드의 3D 링크(v3)를 정리한다.

2026-10-07 학습 모드 키워드 카드

문제

  • 이슈 #67에서 제안한 자율형 코치(도구를 골라 반복하는 에이전트 + 연습 문제 채점)는 CLAUDE.md 설계(튜터 1명·모드 2개, 학습 모드는 점수 없음, 질문 은행은 체크포인트용)에서 벗어났다. 은행 질문을 연습에 쓰면 체크포인트에서 같은 문제를 다시 보게 되고, 도구 호출 루프는 질문당 Gemini 호출이 늘어 무료 한도에 자주 걸린다.
  • 그래도 학습자가 개념의 핵심 용어를 정리해 볼 방법은 학습 모드에 없었다.

해결

  • 수민과 합의한 범위로 줄였다: 모드 두 개 유지, 연습 문제 제외, Gemini 1회 유지, 평가 서비스 분리 안 함.
  • 튜터가 같은 응답에서 카드를 띄울 개념만 고르고(keyword_card, final 루브릭 개념 enum), 서버가 루브릭의 answer_terms·용어집·근거 자료로 카드를 채운다. answer_terms에 유출 방지용 다른 공정 용어가 섞인 개념이 있어 coke_reduction만 허용했다.
  • 체크포인트 진행 중에는 카드를 붙이지 않고, 아직 만점이 아닌 개념은 튜터 프롬프트에 넘긴다(엔진 sectionProgress).

남은 일

  • v2·v3 페이지의 카드 템플릿은 프론트 담당 파일이라 따로 작은 PR로 낸다. Gemini 하루 한도가 풀린 뒤 화면에서 카드를 확인한다.
  • 수민: lockLearning()에서 hasKeywordCard·keywordCard를 숨긴다. 카드 개념을 늘릴 때 answer_terms를 같이 확인한다.
  • CLAUDE.md '학습 모드' 절에 키워드 카드 한 줄을 더한다(공용 파일, 작은 PR).

2026-10-03 공정 GLB 4개 교체와 설비 id 노드 연결

문제

  • frontend/3d-demo/models/의 GLB 4개에 EQ_<설비 id> 노드가 없어, v2가 앵커 좌표로만 설비 위치를 잡고 설비를 선택해도 모델에 하이라이트가 붙지 않았다.
  • 레퍼런스 이미지로 다시 만든 공정 모델을 넣으면 scene_v2.js가 내부 단면을 기본 도형 자리에 그렸다.

해결

  • 공정 모델 4개를 다시 만들고 공정마다 설비 6개를 EQ_<설비 id> 노드로 묶었다(data_v2.js의 24개 id와 같음).
  • anchors-v2b.json 네 공정에서 anchors를 빼고, flow·stops로 소재 경로를, interiors로 내부 단면 위치를 지정했다.
  • scene_v2.js가 노드로 연결된 설비의 내부 단면을 interiors 좌표(없으면 노드 경계 상자)에 그리도록 고쳤다.

남은 일

  • CLAUDE.md의 "현재 GLB에는 EQ_<설비 id> 노드가 없고" 문장을 고친다(공용 파일이라 팀과 공유 후).
  • GLB 안 오브젝트가 이름순이라 공정 순서로 다시 묶을지 정한다.

2026-09-30 팀 폴더 구성에 맞춰 파일 재배치

문제

  • 팀에서 backend/, frontend/, llm/, models/ 폴더 구성을 정해 두었지만, 지금까지 작업물은 루트의 src/, web/, source/, data/, prompts/에 흩어져 있었다.

해결

  • 서버·세션·데이터·테스트는 backend/, LLM 호출 코드와 프롬프트는 llm/, 화면은 frontend/(web/, 3D 데모는 steel-academy/), .glb는 models/로 옮겼다.
  • package.json, tsconfig.json은 루트에 두어 npm start, npm test를 그대로 루트에서 실행한다. 빌드 결과는 .build/backend/..., .build/llm/...로 나온다.
  • process.cwd() 기준 경로를 새 위치(backend/data, llm/prompts, frontend/web)로 바꿨다.

2026-09-30 제선 공정 질문형 임시 MVP

문제

  • Claude API 키 발급이 막혀 기존 교육 에이전트 백엔드(src/server.ts, claude-opus-5-5)를 실행할 수 없었다.
  • 3D 교육 화면과 연결할 프론트엔드가 아직 없어 제선·제강·연주·압연 전체 흐름을 확인할 방법이 없었다.
  • tsx 대신 tsc로 .build/에 빌드하자 import.meta.url 기준 경로가 .build/를 가리켜 data/, prompts/를 찾지 못했다.

해결

  • LLM을 Gemini(gemini-3.5-flash-lite)로 바꾸고, 키는 서버의 .env(GEMINI_API_KEY)에만 두도록 했다.
  • 프론트가 준비될 때까지 임시로 제선 한 공정만 다루는 질문 API(POST /api/chat, GET /api/status)와 단일 화면(web/)을 만들었다.
  • 답변 근거는 포스코 홈페이지·뉴스룸 공개 자료 6건(data/ironmaking-sources.json)으로 제한하고, 근거가 없으면 "확인할 수 없음"으로 답하게 했다.
  • src/data.ts, src/agent.ts의 경로를 process.cwd() 기준으로 바꿨다.
  • 기존 Claude 백엔드는 지우지 않고 npm run start:legacy로 따로 실행할 수 있게 남겼다.

남은 일

  • 3D 프론트가 준비되면 제강·연주·압연 공정과 기존 백엔드 연결 여부를 다시 정한다.