SkillLens 베타 리빌딩 — 초기 저장소 실사
원본: projects/skill-lens/00-initial-repository-audit.md
작성일: 2026-11-08
대상: mymyiove/skill-lens
목적: 2026-11-11 베타 시연을 위한 프론트엔드 리빌딩 범위와 IDEBER 개발 환경의 최소 요구사항을 확정한다.
1. 요약
SkillLens는 백엔드부터 다시 만드는 프로젝트가 아니다. 기존 main에 실제 서비스의 API·D1·정적 프론트엔드·배포 자동화·테스트가 존재한다. 별도 zero 브랜치에는 다음 UI의 설계와 화면 프로토타입이 상당량 존재하지만, React 앱은 부품 갤러리와 온보딩 회사 확인 화면 중심이며, 구형 zero/js 흐름은 시드 데이터 기반 시뮬레이션이다.
따라서 가장 현실적인 전략은 다음과 같다.
- 기존
main을 서비스 동작의 기준선으로 보존한다. zero의 IA·화면 흐름·디자인 자산을 재사용 후보로 분석한다.- 실제 API 계약과 연결되지 않은 데모 동작을 구분한다.
- 베타 시연에 필요한 핵심 사용자 여정부터 프론트엔드에 연결한다.
- 운영 배포는 별도 승인 전까지 하지 않는다.
2. 저장소에서 확인한 사실
main 브랜치 — 현재 기본 서비스
- 기본 브랜치:
main - 실사 시점 HEAD:
b7e7ee8acd10c0fe66af122f2354a10e9518d804 - 원격 푸시 시각: 2026-11-06 06:18 UTC
- 저장소 트리: 527개 항목, 재귀 트리 조회
truncated=false - 구현 형태: 루트 HTML +
pages/다중 페이지 프론트엔드,assets/css,assets/js, 단일worker.jsAPI - 주요 크기:
worker.js1,109,565 bytes,index.html114,060 bytes,db/schema.sql33,375 bytes - 테스트: Node 단위 테스트, Wrangler 기반 D1 E2E, UI 스모크, CSP, 핸들러·캐시·스코프 검사 스크립트
- 인프라 설정: Cloudflare Worker
workers/skilllens-api/wrangler.toml, D1skilllens, Pages/Worker GitHub Actions 배포 워크플로
zero 브랜치 — 다음 UI/UX 프로토타입
- 브랜치 HEAD:
bc15fab1790eed843b2f971b3537b7ea6ecc1ba4 - 커밋 시각: 2026-11-06 06:17 UTC
- 저장소 트리: 933개 항목, 재귀 트리 조회
truncated=false zero/에 PC·모바일 CSS, 화면별 JS, 아이콘·이미지 자산과 데모 데이터가 존재한다.zero/app/에는 React 19 + TypeScript + Vite 기반 별도 앱이 있다.- React 앱 화면 등록은 현재
Onboard.tsx의 회사 확인(Company.tsx) 하나이며, 기본 화면은 부품 갤러리다. - 별도
zero/js/에는 관리자·진단 대상자·지원자 여정이 폭넓게 구현되어 있다. 확인된 등록 화면은 관리자 홈 1, 진단 6, 결과 7, 강화 10, 설정 5, 직원 10, 지원자 4개 등이다. - 다만 이 JS의 데이터 계층은
zero/js/data.js의 예시 조직·직무·스킬·1,000명 가상 인원에 기반한다. 화면 코드 주석도 API 연결을 미래/실제 연결 지점으로 표현하며, 일부 액션은 실제 저장 대신 토스트로 시뮬레이션한다. zero/app의 React UI와zero/js의 전체 여정은 같은 완성도의 하나의 앱이 아니다. 이를 혼동해 React 앱이 이미 전체 베타 화면을 갖췄다고 판단하면 안 된다.
3. 현재 자산과 위험 구분
| 영역 | 확인된 자산 | 판단 |
|---|---|---|
| API/업무 로직 | worker.js, API 라우트, 인증·진단·결과·강의·관리자 기능 | 기본 재사용. 변경은 회귀 테스트 근거가 있을 때만 |
| DB | db/schema.sql, D1 테이블과 마이그레이션 경로 | 스키마 재작성 금지. 실제 운영 스키마와 차이는 별도 확인 |
| 기존 프론트 | pages/skill-map, pages/skill-board, pages/skill-trends, pages/sadmin | 기능 기준선·API 호출 참고용 |
| Zero IA/화면 | 관리자·직원·지원자 흐름, 반응형 셸, 화면 설계 | UX·정보 구조·문구·컴포넌트 후보로 활용 |
| Zero 디자인 시스템 | zero/app/ui 토큰·컴포넌트·미리보기, zero/css | 재사용 후보. 실제 화면 적용·접근성·일관성 검증 필요 |
| Zero 데모 데이터 | zero/js/data.js | 제품 데이터로 사용 금지. 화면 목업/시연 데이터로만 취급 |
| React 앱 | 부품 갤러리 + 온보딩 회사 확인 화면 | 확장 기반은 가능하나, 현재 전체 기능 구현 완료 상태 아님 |
| 문서 | README, plan, design-system, security, SRS 등 | 일부 현황 문서는 최신 코드보다 오래됨. 코드와 대조 필요 |
4. 발견된 문서/운영 리스크
docs/STATUS.md상단은 2026-09-02 / worker v2.51.2로 표시되어 현재 저장소 HEAD보다 오래됐다. 현황표와 현재 구현을 그대로 신뢰하지 말고 코드·커밋 기준으로 갱신해야 한다.README.md는 제품 버전 2.52.0을 표시하지만,docs/STATUS.md는 v2.51.2다. 버전 기준 문서가 일치하지 않는다.CLAUDE.md는 zero 작업 시 외부 Claude Artifact를 단일 정본으로 읽도록 지시한다. 저장소 안zero-dashboard/backup.json은 GitHub 파일 조회에서 내용이 비어 반환되었으므로, 해당 백업이 실제로 비어 있는지/바이너리 처리 문제인지 별도 확인이 필요하다. 외부 Artifact의 접근 가능 여부도 현재 실사 범위 밖이다.- 기존 문서에는 운영 배포·시크릿·개인정보 보호를 위한 강한 주의사항이 있다. 베타 리빌딩 중 운영 Worker/D1/고객 메일에 닿는 작업은 금지하고 로컬·Preview 환경을 우선한다.
zero/js의 화면 수와 기능 표현은 실제 API 연결 정도를 의미하지 않는다. 데모 상호작용과 서버 저장/검증을 분리해서 평가해야 한다.
5. 권장 베타 범위
P0 — 반드시 실제 동작해야 하는 여정
- 고객사 관리자 로그인/진입
- 관리자 핵심 홈 및 진단 회차 상태 확인
- 조직·직무·스킬셋/진단 대상 범위 확인
- 진단 대상자 명단 및 진행 상태
- 실무자 초대/진입
- 실무자 스킬 확인·수정·레벨 진단·제출
- 관리자 검토/확정
- 조직 결과 요약·히트맵·부족/공백 스킬
- 개인 결과 확인
P1 — 시연 설득력을 높이는 기능
- 교육 계획·강의 추천 연결
- 인재 검색·채용/공백 스킬 흐름
- 보고서/내보내기
- 슈퍼어드민의 핵심 운영 화면
베타에서 제외하거나 데모 처리 가능한 영역
- 사용 빈도가 낮은 설정/로그 세부 화면
- 실제 고객 데이터가 없어 품질 검증이 불가능한 AI 추천의 과장된 자동화
- 현재 API가 없는 액션
- 운영자 내부용 테스트/진단 도구의 전체 기능
P0/P1의 최종 확정은 실제 시연 대상과 발표 시나리오 확인 후 조정한다.
6. IDEBER 개발 환경 — 이번 주 최소 구성
IDEBER는 독립 플랫폼을 완성하지 않고 SkillLens 프로젝트를 실행·검증하는 데 필요한 얇은 운영 계층부터 만든다.
- Project Brief: 목표, 시연 기준, 금지 범위, 핵심 도메인 규칙
- Repository Map: main/zero 브랜치, 주요 파일, API·DB·화면 연결 관계
- Task Board: P0/P1, 담당 역할, 선행 조건, 완료 정의, 검증 상태
- AI Work Protocol: Claude 주 개발자, 별도 검토 역할, 결과물/변경 파일/테스트 증거 중심 핸드오프
- Preview & QA: 로컬 실행, 화면 캡처, 사용자 여정, 단위/E2E/접근성 점검
- Decision Log: 보존/변경 판단, API 계약 변경, 디자인 결정, 알려진 위험 기록
매 작업마다 전체 문서를 프롬프트에 주입하지 않는다. 프로젝트 개요는 짧게 유지하고, 작업에 필요한 화면·API·규칙·테스트만 선택적으로 제공한다.
7. 다음 실사 작업
- main/zero의 프론트 페이지와 화면 모듈을 대응시킨다.
- 핵심 API 계약(요청·응답·권한)을
worker.js와 프론트 호출부에서 확인한다. zero/js화면별 액션을 실제 API 연결 / 목업 / 미구현으로 분류한다.- P0 사용자 여정의 시안 화면을 선정하고 재사용할 컴포넌트를 결정한다.
- 이 결과로 베타 작업 티켓과 검증 기준을 만든다.
8. 변경 안전 원칙
- SkillLens
main은 현재 서비스 기준선으로 보존한다. - 기존
zero브랜치도 덮어쓰지 않는다. 리빌딩 작업은 별도 작업 브랜치에서 수행한다. - 운영 배포, 운영 D1 마이그레이션, 실제 고객 메일 발송은 명시적 승인 없이는 수행하지 않는다.
- 점수 산식, 필수/확장 가중치, 권한 정책, 개인정보 처리 규칙은 화면 개선과 분리해 보존한다.
- 화면이 완성됐다는 이유만으로 기능 완료로 간주하지 않는다. 실제 API 왕복과 저장 결과까지 검증한다.
이 사이트는 ideber 저장소 projects/skill-lens/ 에서 자동으로 만들어집니다. 고칠 때는 저장소를 고칩니다. 공개 주소이지만 검색엔진에는 나오지 않습니다.