Unimation Korea

Uni Total Contents Solution

교육 콘텐츠 제작부터 리소스 관리, 학습 뷰어까지 하나로 연결합니다

/db-architect
🧠
EduResource DB Architect
Gemini AI 기반 교육 리소스 데이터베이스 설계 도구. SLSP 기준으로 교육 콘텐츠 리소스를 체계적으로 구축합니다.
DB Architect 열기
/editor
🎨
Contents Maker
자유 캔버스 모드로 교육 콘텐츠를 직관적으로 편집합니다. 드래그/드롭, 필기인식, 음성 등 인터랙티브 기능을 설정합니다.
콘텐츠 편집기 열기
/viewer
🎮
Activity Viewer
제작된 콘텐츠를 학습자 관점에서 실행하고 테스트합니다. 드래그/드롭, 필기인식, 음성인식 액티비티를 체험합니다.
학습 뷰어 열기
System Monitor
🗄️ Database Overview
로딩 중...
로딩 중...
🌐 Deployment Info
현재 실행 환경 및 GCP 배포 정보
로딩 중...
🔗 SLSP Key Consistency
resources 테이블(Editor) ↔ content_versions 테이블(Viewer) 간 subject 키 비교
검사 중...
⚙️ Edit Mode Consistency
모든 콘텐츠가 freeCanvas 모드인지 확인 (block 모드 잔존 여부)
검사 중...
📦 Version Number Integrity
SLSP별 버전 번호가 순차적인지 확인 (삭제로 인한 갭 검출)
검사 중...
🔄 Data Pipeline Status
Editor → API → DB → Viewer 데이터 흐름 상태
분석 중...
📝 Recent Saves
최근 저장된 콘텐츠 버전 이력
로딩 중...
📐 Content Coverage
Subject × Level별 콘텐츠 제작 진행률
로딩 중...
로딩 중...
🔍 Content Validation
저장된 콘텐츠의 구조적 유효성 검사
검사 중...
🚨 Error Log
API 서버 에러 이력 (인메모리, 최근 50건)
로딩 중...
💡 AI Tools 활용 전략
업그레이드·수정·고도화 시 최적 도구 선택 가이드
🆕 새 기능 추가
/plantdd-guidecode-reviewer
🐛 버그 수정
backend-ops/build-fixsecurity-reviewer
🏗️ 아키텍처 변경
architectplannerrefactor-cleaner
🚀 GCP 배포
backend-opsbuild_deploy.ps1/verify
⚠️ 시스템 부담: 이 페이지는 순수 정적 HTML — API 호출 없음, 성능 영향 없음.
반복 문제 예방: 폰트 CORS 같은 이슈 재발 시 → backend-ops + /build-fix 즉시 투입.
🤖 Specialized Agents ~/.claude/agents/ (12개)
독립 서브프로세스로 실행 — 메인 컨텍스트 보호, 병렬 처리 가능
에이전트역할자동 활성화 시점
backend-ops Express·DB·PM2·Docker·API 라우트, 서버 디버깅 서버 시작/중지, DB 연결, API 에러
build-error-resolver 빌드/TypeScript 에러 최소 diff 수정 빌드 실패, 타입 에러
code-reviewer 코드 품질·보안·유지보수 리뷰 코드 작성/수정 후
security-reviewer OWASP Top 10·인증·입력검증 취약점 탐지 커밋 전, API 작성 후
planner 구현 계획·PRD·아키텍처 설계 문서 생성 복잡한 기능 요청
architect 시스템 설계·확장성·기술 의사결정 아키텍처 변경
tdd-guide 테스트 우선(RED→GREEN→REFACTOR) 80%+ 커버리지 신기능·버그수정
e2e-runner Playwright E2E 테스트 생성·실행·아티팩트 업로드 크리티컬 사용자 플로우
refactor-cleaner 사용하지 않는 코드·중복 제거 (knip, depcheck) 코드 유지보수
doc-updater CODEMAPS·README·문서 업데이트 문서 변경 시
database-reviewer SQL 최적화·스키마·보안·Supabase 모범사례 SQL 작성, 스키마 설계
chief-of-staff 이메일·Slack·메신저 트리아지 및 드래프트 멀티채널 커뮤니케이션
💬 사용법: "backend-ops agent 활용해서 fonts.ts 수정해줘"  |  병렬 실행: 한 메시지에 여러 Agent 동시 투입 가능
Skills — 슬래시 커맨드
이 프로젝트에서 자주 사용하는 /커맨드
개발 워크플로우
/plan /tdd /build-fix /verify /checkpoint /backend /scenario
코드 품질
/code-review /refactor-clean /test-coverage /simplify
멀티모델 협업
/multi-plan /multi-execute /multi-frontend /multi-backend
학습·자동화
/learn /learn-eval /skill-create /schedule /e2e
🧠 학습된 Skills — 프로젝트 특화 패턴
이 프로젝트의 반복 패턴에서 자동 추출된 재사용 지식 (/.claude/skills/learned/)
zustand-freecanvas-patterns Zustand 슬라이스 + Free Canvas 요소 관리 — 셀렉터 무한루프, 히스토리 N+1, 드래그 성능, autoCache 2026-03-18
dragdrop-group-validation 드래그앤드롭 3-레이어 방어 — onDragOver 차단, onDrop 튕겨내기, 엔진 최종 검증, parseDragData 2026-03-18
highlight-border-injection CSS 애니메이션 동적 주입 — injectHighlightStyles, getHighlightStyle, 에디터↔뷰어 공유, 입력값 보안 검증 2026-03-18
canvas-ai-handwriting Canvas 필기 + AI(Gemini) 검증 — 오프스크린 캔버스, 좌표 스케일링, 레이아웃 보존 2026-03-16
react-preview-verification React 앱 preview_eval/snapshot/network 검증 — 스크린샷 없이 E2E 테스트 2026-03-13
💬 새 패턴 추가: /skill-create — git 히스토리 자동 추출  |  /learn — 현재 세션 패턴 저장
🛠️ 반복 이슈 & 해결 레시피
과거 발생 문제 + 올바른 도구 조합 — 동일 문제 재발 시 즉시 참조
🔤 폰트 CORS 깨짐 Cloud Storage 직접 URL에서 @font-face 로드 시 차단
backend-ops → fonts.ts 프록시 /api/fonts/proxy/ 추가 → /build-fixbuild_deploy.ps1
📦 빌드 실패 TypeScript 에러, 누락 타입, import 경로 오류
build-error-resolver agent → /build-fix → 빌드 재검증
🔗 localhost 참조 배포 후 프론트가 localhost:PORT를 호출
→ Grep으로 localhost 전수 검색 → backend-ops 수정 → /verify
🗄️ DB 연결 불안정 Cloud SQL 소켓 미설정, 환경변수 누락
backend-ops → db.ts CLOUD_SQL_CONNECTION_NAME → env.yaml 확인
📁 resources 0건 subject 한글/영문 불일치 (한자 vs hanja)
database-reviewer → subjectVariants() 양방향 매칭 → page fallback 쿼리
🚀 SHORT_SHA 비어있음 cloudbuild.yaml 이미지 태그 비어 빌드 실패
build_deploy.ps1git rev-parse --short HEAD로 명시 전달
🔄 하네스 파이프라인 (Harness Engineering)
Context Reset + Generator/Evaluator 분리 — AI의 자기 평가 실패 방지
📋
Planner
SPEC 설계
⚙️
Generator
구현 + 자체점검
🔍
Evaluator
엄격 검수
합격/재시도
최대 3회
🆕 Context Reset
각 에이전트가 독립 컨텍스트에서 실행 — 장시간 대화의 조급함 방지
🆕 가중 채점 + 자동 반복
디자인 40% + 독창성 30% + 기술 15% + 기능 15% → 7.0+ 합격
🆕 자체 점검 (SELF_CHECK)
Generator가 먼저 자체 검증 후 Evaluator에 전달
🆕 엄격 평가 원칙
"절대 관대하게 보지 마라" — 피드백: 위치+이유+방법 3요소 필수
🤖 서브에이전트 현황 ~/.claude/agents/ (12개)
설치된 에이전트 + 마지막 업데이트 시각
🛡️
security-reviewer
OWASP Top 10 · 취약점 탐지
🔍
code-reviewer
코드 품질 · 유지보수
🏗️
build-error-resolver
빌드/TS 에러 수정
🧪
tdd-guide
테스트 우선 개발
📐
architect
시스템 설계 · 확장성
📝
planner
구현 계획 · PRD
🔧
backend-ops
Express · DB · API
🗄️
database-reviewer
SQL 최적화 · 스키마
🎭
e2e-runner
Playwright E2E 테스트
🧹
refactor-cleaner
데드코드 · 중복 제거
📚
doc-updater
문서 · CODEMAPS
📨
chief-of-staff
커뮤니케이션 트리아지
🎬 Recent Features & Changes
최근 구현된 기능 및 변경사항
🎬 비디오 요소
Free Canvas에 비디오 요소 추가. 로컬 파일 업로드 (200MB, mp4/webm/ogg/mov/avi/mkv).
API: POST /api/resources/upload-video
📐 z-index 관리
bringToFront/sendToBack + 자동 정규화. 컨텍스트 메뉴 & 키보드 단축키 (Ctrl+]/Ctrl+[).
normalizeZIndices: 순서 유지하며 1부터 재할당.
✏️ 필기 UI 통일
DrawingToolbar 공통 컴포넌트. SVG 아이콘 기반 [↩] [🗑] N획 [🔍 분석].
AnalysisPopup: Portal 렌더링 + 등급별 그라데이션 헤더.
⌨️ 키보드 단축키
Ctrl+Z/Y: Undo/Redo | Arrow: 1px 이동 | Shift+Arrow: 10px 이동
정렬/분배: 컨텍스트 메뉴에서 다중 선택 시 사용 가능
🔧 외곽선 통일
에디터 설정값이 미리보기/뷰어에 그대로 반영. 텍스트 영역 기본: 투명 배경 + 테두리 없음.
API Server
Contents Maker
Activity Viewer
Resource DB