신입사원 학습 현황을 조회하는 관리자 전용 화면. 조회만 한다(수정·삭제·응시 없음). 신입사원 통계와 개념별 통계 모두 실제 API를 쓴다. 화면이 API를 부르지 못하면 샘플로 표시한다.
- 화면:
frontend/login_ui/Admin Dashboard.dc.html - 데이터:
frontend/login_ui/admin_data.js(loadAdminData():/api/admin/trainees,/api/admin/concepts/loadAiSummary():/api/admin/ai-summary) - 명세(JSON): admin-spec.json
- 근거: CLAUDE.md '계정과 관리자'·'오개념 기록'·'점수 규칙', docs/auth-api.md '관리자 통계'
npm start후http://localhost:3000/login- 로그인 화면에서 관리자 탭 →
admin01(비밀번호DEMO_PASSWORD, 기본steel-2026-demo) - 로그인하면 같은 주소(
My Page.dc.html)에 관리자 대시보드가 바로 보인다(신입사원은Trainee Dashboard.dc.html).
직접 주소는 /login_ui/Admin%20Dashboard.dc.html. 파일을 브라우저에서 바로 열거나 로그인하지 않으면 API를 못 불러 오류 문장이 보인다(헤더 배지 연결 오류). 샘플로 바뀌지 않는다.
- 목표는 지금 화면을 실데이터로 마무리하는 것이다. 새 기능은 아래 '남은 작업'의 최소 보강만 한다.
- 관리자는 조회만 한다. 강제 해금, 기록 초기화, 계정 관리는 만들지 않는다(재응시 409·점수 규칙을 우회하는 경로가 생긴다).
- 오개념은 사람별 개수에 더해 개념별 개수까지 보여 준다. 사용자 id·답변 원문·오개념 설명은 넣지 않는다. CLAUDE.md '오개념 기록'의 "관리자 화면에는 사람별 개수만"을 바꾸는 결정이므로 팀에 공유하고 CLAUDE.md를 작은 PR로 고친다.
GET /api/admin/concepts는 viiin2가backend/src/admin/에 작은 PR로 만들기로 했고, #37(신입사원·관리자 대시보드)에서 구현됐다(backend/src/admin/concept-stats.ts). 관리자 라우터는ironmaking-server.ts에서 붙이므로app.ts는 건드리지 않는다. 수빈 담당 테이블(concept_results,misconceptions)을 읽기만 하므로 PR 전에 수빈에게 알린다.
| 영역 | 보여 주는 것 | 데이터 |
|---|---|---|
| 요약 숫자 | 신입사원 수 · 전 과정 수료 · 평균 이해도 · 미해결 오개념 | trainees |
| AI 요약 · 보강할 내용 | 오답률 높은 개념을 Gemini가 1~2문장으로 정리, 근거 개념 이름, 생성 시각 | ai-summary |
| 오답률 높은 개념 | 첫 답변이 정답이 아닌 비율 TOP 8, 공정 필터, 틀림/부분/힌트 막대 | concepts |
| 전 과정 수료 | 4개 공정 모두 통과한 사람, 평균 이해도, 재도전 횟수 | trainees |
| 확인이 필요한 사람 | 재도전 필요 · N일 미접속 · 오개념 많음 · 미시작 | trainees |
| 섹션별 진행 | 공정별 통과/미통과, 평균 이해도, 평균 시도 | trainees |
| 신입사원 명단 | 공정별 이해도·시도, 잠김, 진도, 오개념 수, 마지막 학습, 상태. 상태 필터·검색·정렬 | trainees |
라이트/다크 전환은 헤더 오른쪽 버튼.
| 요청 | 상태 | 설명 |
|---|---|---|
GET /api/admin/trainees |
구현됨 | 신입사원별 섹션 이해도·통과·시도·오개념 개수·마지막 학습일 (auth-api.md) |
GET /api/admin/concepts |
구현됨 | 개념별 첫 판정 분포·미해결 오개념 수(backend/src/admin/concept-stats.ts). ?section=으로 공정 선택 |
GET /api/admin/ai-summary |
구현됨 | 오답률 높은 개념 상위 5개의 집계 숫자로 만든 1~2문장 요약(backend/src/admin/ai-summary.ts, llm/src/admin-summary.ts, 프롬프트 llm/prompts/admin-summary.md) (auth-api.md) |
모두 Authorization: Bearer <token>(st-rookie-token), admin만. 아니면 403 ADMIN_ONLY.
{ "concepts": [
{ "section": "ironmaking", "concept_id": "coke_reduction", "name": "고로에서 코크스의 역할",
"asked": 9, "partial": 2, "wrong": 4, "assisted": 1, "final_wrong": 2, "open": 3 }
] }- 집계:
concept_results⨝attempts(state = 'completed', trainee만). 첫 질문의verdict기준. 구현은 첫 시도(kind = 'first')만 센다. 처음 제안은 재도전 시도 포함이었다(아래 '정할 것'). final_wrong: 재확인 후에도 0점(recheck_verdict = 'wrong').open: 이 개념의 미해결 오개념 수(전체 합).- 답변 원문·오개념 설명·사용자 id는 넣지 않는다.
section이 섹션 4개가 아니면400 INVALID_SECTION. 체크포인트 테이블이 없으면{ "concepts": [] }.name: 화면에 쓸 개념 이름. 실제 체크포인트의concept_id는 루브릭 개념 id(sinter_purpose,coke_reduction,blast_furnace_hot_metal)라서 설비 id가 아니므로, 서버가 지금 final 루브릭의 개념name을 붙인다. 루브릭에 없는 id(시연 기록의 설비 id, 바뀐 개념)는name이 없고, 화면은data_v2.js설비 이름, 그것도 없으면 id를 보여 준다.
- 통과 기준: 이해도 80%.
- 개념 오답률 =
(partial + wrong + assisted) / asked. 내림차순, 같으면wrong많은 순. - 잠김: 앞 섹션이 없거나 미통과면 뒤 섹션은
잠김. - 상태(위에서부터 먼저 맞는 것):
| 상태 | 조건 |
|---|---|
| 수료 | passed_sections === 4 |
| 재도전 필요 | 끝냈지만 passed = false인 섹션이 있음 |
| 진행 중 | 기록 있는 섹션이 하나 이상 |
| 미시작 | 모든 섹션 null |
- 확인이 필요한 사람: 재도전 필요 > 3일 이상 미접속(수료 제외) = 미해결 오개념 3개 이상(수료·재도전 제외) > 미시작.
- 오개념은 개수만 본다. 내용·답변 원문은 본인 마이페이지에서만 보인다.
- AI 요약은 개념별 집계 숫자와 공정·개념 이름만 Gemini에 보낸다. 답변 원문·오개념 설명·사용자 id·이름은 보내지 않는다(테스트
backend/test/admin-ai-summary.test.ts로 확인). - 사번은 관리자 화면에만 표시한다.
| 상태 | 표시 |
|---|---|
| 불러오는 중 | 헤더 불러오는 중… |
| API 하나라도 실패(로그인 안 함, 401·403, 서버 꺼짐) | 배지 연결 오류, 오류 문장 표시. 샘플로 바뀌지 않는다 |
| 둘 다 성공 | 배지 DB 데이터 |
checkpoint_data: false |
계정 목록만, 모든 칸 미응시 |
| AI 요약 실패(키 없음, 연결 실패, 429) | 카드에 이유와 "아래 '오답률 높은 개념'을 참고" 안내. 다른 영역은 영향 없음(loadAiSummary()를 따로 부름) |
| AI 요약할 오답 기록 없음 | "아직 요약할 오답 기록이 없습니다." |
frontend/login_ui/
Admin Dashboard.dc.html 화면(템플릿 + class Component). support.js가 실행
admin_data.js loadAdminData() (두 API 호출, 샘플 없음), loadAiSummary() (AI 요약, 실패해도 예외 없음)
My Page.dc.html 로그인 후 역할별 대시보드를 iframe으로 표시
Trainee Dashboard.dc.html 신입사원 화면(/api/me/dashboard)
- 공정·설비 이름은
data_v2.js의PROCESSES에서 가져온다. 저장소에서는 import 경로를../3d-demo/data_v2.js로 맞춘다.
백엔드 (#37 ssoyoum 구현, 명세 보완)
-
backend/src/admin/에GET /api/admin/concepts(위 형식,name은 '정할 것'으로 남김).requireUser, requireAdmin은 trainees와 같다. -
backend/test/admin.test.ts에 추가: 401·403, 첫 판정 분포, 진행 중 시도 제외, trainee만 집계, 응답에 원문·사용자 id 없음. -
docs/auth-api.md'관리자 통계'에 concepts를 추가한다.
프론트 (Admin Dashboard.dc.html, admin_data.js)
- 개념 이름은 API의
name을 먼저 쓰고, 없을 때만 설비 이름으로 찾는다. - 하단 문구를 "기록은 DB 데이터, 교육 내용은 샘플"로 바꿈 (#37). 샘플 데이터가 없어져 문구를 나눌 필요가 없다.
- 실패하면 샘플로 바뀌지 않고 오류 문장을 보여 준다 (#37).
- 토큰이 없거나
401이면/login으로 보낸다.403(trainee)은 아래 '정할 것'에 따른다.
최소 보강 (선택)
- 마지막 학습일에 학습 모드 대화(
learning_turns)도 반영한다. 지금은 체크포인트 시도(attempts)만 봐서 학습 모드만 한 사람이 '미접속'으로 잡힌다.trainee-stats.ts변경이다.
- AI 요약 기간: 지금은 '오답률 높은 개념'과 같은 전체 기간 집계다. "이번 주"로 자를지 (교육 담당)
-
GET /api/admin/concepts담당자: viiin2, 작은 PR (위 '결정') → #37에서 구현됨 - 개념 오답률에 재도전 시도를 넣을지(처음 제안) 첫 시도만 셀지(지금 구현)
- 개념별 오개념 개수 노출: 보여 주기로 결정, 팀 공유와 CLAUDE.md 반영 대기
- 개념 이름은 서버가 루브릭
name으로 붙인다. 설비 연결(equipment_ids, 수빈 담당)은 3D 하이라이트용으로 따로 진행한다. - 미접속 경고 기준 3일 (교육 담당)
- trainee가 대시보드 주소로 직접 들어올 때
/login으로 보낼지 (프론트) - 명단 CSV 내보내기 필요 여부 (교육 담당)