일단확인 (MVP)
입사 전, 근로조건부터 일단 확인하세요.
채용공고, 오퍼 문자·메일, 근로계약서 중 자료 한 건으로 적힌 근로조건과 원문 근거, '지금 확인할 내용'을 정리하고, 지원·입사 건별 기록으로 남겨 새 안내가 오면 이어서 확인하는 웹앱입니다(PRD v3.1).
문서에 적힌 사실과 원문 근거만 보여 주며, 법률 위반 여부·계약의 효력·기업의 신뢰도·입사 적합성은 판단하지 않습니다.
- 자료 등록 (
#/new, POST /api/analyze + includeCriteria): 문서 유형(채용공고·오퍼·합격 안내·근로계약서)을 고르고 텍스트를 붙여넣거나 사진·PDF를 올립니다(사진·PDF는 S03에서 추출 텍스트를 확인·수정한 수정본만 분석). 두 번째 문서를 요구하지 않습니다.
- 입사조건 기록 (
#/records/:id): 지금 확인할 내용(최대 3건 + 접힌 추가 확인) → 주요 근로조건(자료별 값·원문) → 등록된 안내 자료(등록일) → 필요할 때 하기(새 안내 추가·질문 복사·기록 삭제).
- 새 안내 추가 (
#/records/:id/add): 같은 기록에 자료를 덧붙입니다. 이전 자료의 텍스트·분석·원문은 바꾸지 않고, 항목마다 같은 내용으로 안내됐어요 / 서로 다른 안내가 있어요 / 이번 안내에 새롭게 적혔어요 / 이번 안내에서는 확인되지 않아요 / 서로 비교하기 어려워요 / 분석 확인 불가를 보여 줍니다(public/relate.js, AI 재호출 없음).
- 항목 상세 (
#/records/:id/item/:no): 자료별 세부 기준·원문, 관계 이유, 질문, 내가 기록한 답변(선택 메모, 작성·수정·삭제).
- 내 기록 (
#/records): 기록 목록·삭제·저장 범위 안내. 기록은 브라우저 IndexedDB에만 저장합니다(public/store.js, 저장 후 다시 읽어 확인한 뒤에만 '저장했어요'; 실패하면 '저장되지 않았어요'와 다시 저장).
POST /api/compare(2문서 비교 API)는 남아 있지만 화면에서는 쓰지 않습니다. 비교 규칙은 public/compare-core.js로 옮겨 브라우저(기록의 자료 간 관계)와 서버가 함께 씁니다.
문서별 추출·근거 검증·기재 상태 판정은 점검 기준 v2.2(10개 주제, 32개 세부기준)를 따릅니다.
판정 기준의 단일 원천은 동결 기준표 design-handoff/spec/04_점검기준표_v2.2_동결원문.md입니다.
실행 방법
Node.js 20 이상이 필요합니다. AI 분석은 Google Gemini API 무료 등급(gemini-3.5-flash-lite)을 사용하며, 유료 모델로 자동 전환하지 않습니다.
npm install
# GEMINI_API_KEY 는 서버 환경변수로만 등록합니다 (코드·채팅·브라우저에 넣지 않음).
npm start # 실제 AI 분석, http://localhost:3000
npm run demo # DEMO_MODE=true — 키워드 규칙 데모 (AI 아님)
- 키 발급: Google AI Studio(https://aistudio.google.com/apikey)에서 결제 수단을 연결하지 않은 프로젝트로 발급하면 무료 등급으로만 동작합니다. 결제(billing)를 켜면 유료 요금이 적용될 수 있으니 켜지 마세요.
GEMINI_API_KEY가 없으면 데모로 바뀌지 않고, 분석 요청에 "AI 분석이 아직 설정되지 않았어요" 오류를 안내합니다.- 데모 모드는
DEMO_MODE=true를 명시했을 때만 켜집니다. 데모 결과는 헤더 배지와 결과 화면 안내로 AI 결과와 구분됩니다.
- 무료 사용량 한도(HTTP 429)에 도달하면 "AI 무료 사용량 한도에 도달했어요"를 안내합니다.
이미지·PDF 업로드
- 입력 화면에서 캡처 이미지 최대 5장(JPG·PNG·WebP) 또는 PDF 1개를 올릴 수 있습니다 (파일당 10MB, PDF 10쪽, 스캔된 쪽 5쪽까지). 근로조건 비교에서는 문서 A·B마다 따로 올리고, S-03에서 확인한 텍스트를 그 문서의 내용으로 씁니다(문서마다 입력란·추출 상태·이미지 목록을 따로 유지).
- 여러 장의 이미지는 같은 문서의 연속 캡처로 봅니다. 미리보기·개별 삭제·순서 변경(위로/아래로) 후 '텍스트 추출'을 누르면 정한 순서대로 한국어·영어 글자를 인식해 하나의 편집 가능한 문서로 합칩니다. 일부 이미지가 실패하면 나머지는 합치고 실패한 장을 표시합니다.
- 파일은 브라우저 안에서만 처리하고 서버로 보내지 않습니다. 일반 PDF는 pdf.js로 텍스트를 추출하고, 이미지와 스캔 PDF 쪽은 Tesseract.js로 OCR 합니다.
- OCR 전처리(
public/ocr-prep.js): 작은 칸마다 바탕 밝기를 구해 바탕이 비슷한 영역별로 '흰 바탕 위 검은 글자'로 맞춥니다. 색 배너·버튼의 흰 글자, 다크 모드 화면, 일부만 어두운 배너, 회색 칩·표 머리글을 모두 같은 방식으로 처리합니다(이전에는 어두운 가로줄 전체만 반전해 중간 밝기 배너 글자를 놓치고, 일부만 어두운 배너는 줄 전체가 망가졌습니다). 글자 크기를 재서 작은 글자(저해상도·메신저로 받은 캡처)는 키우고, 표 테두리·버튼 외곽선 같은 긴 직선과 가장자리 잔상을 지우고, 흰 여백을 둡니다.
- 제한적 재인식: 인식 결과에서 신뢰도가 낮은 단어가 있는 줄만(이미지마다 최대 8줄) 전처리 이미지·원본 이미지·1.5배 확대 이미지에서 한 줄씩 다시 읽고, 더 확실한 결과(평균·최저 단어 신뢰도)를 고릅니다. 모든 후보는 같은 이미지에서 실제로 읽은 글자이며, 글자를 추측해 고치지 않습니다. 칸 사이 빈 곳·테두리에서 생긴 기호 조각('_', '|')과 신뢰도 낮은 괄호 조각만 지웁니다.
- 배치에 맞춘 줄 엮기(
public/ocr-layout.js): 정리된 이미지에서 행(가로 빈 띠)과 칸(넓은 세로 빈 곳)을 찾아, 인식된 단어를 위치대로 칸에 넣고 '항목명 + 값의 첫 줄', 값의 나머지 줄 순서로 다시 엮습니다. 표의 아이콘 칸(한글이 없거나 아이콘 크기에 확신이 낮은 칸)은 빼고, 행 가운데의 아이콘은 새 항목의 시작으로 봐서 좌우 2열 목록(복리후생 등)을 한 줄에 하나씩 나눕니다. Tesseract가 두 줄짜리 값 가운데의 항목명을 위아래로 잘라 읽거나(예: '근무시간' → '근' + '=e') 아이콘과 붙여 읽는 문제가 있어, 칸이 여러 개인 행은 칸마다 따로 다시 읽고 전체 인식보다 확실하거나 칸을 더 많이 덮는 결과를 고릅니다(전체 OCR만 / 배치만 / 배치+칸별 OCR 비교는 docs/ocr-accuracy-report.md).
- 결과 평가: 이미지마다 신뢰도와 함께 '확인할 부분'(신뢰도가 낮거나
2O27·202712.31처럼 숫자 사이에 글자가 섞이거나 날짜·시간에 없는 형태의 숫자, 한글 문서에서 신뢰도 낮게 영문으로 읽힌 단어 예: '스낵바' → Addl)와 '일부만 읽힘'(이미지에서 찾은 글자 줄 수보다 읽힌 줄이 크게 적음)을 판단해, 이미지 목록과 안내 문구로 원본과 비교할 곳을 알려 줍니다. 값은 인식한 그대로 보여 주고 고치지 않습니다.
- 정확도 비교:
node scripts/ocr-bench.mjs (가상 채용공고 이미지 17장 test/fixtures/ocr-bench/(생성: scripts/make-ocr-bench-fixtures.mjs)과 실제 서비스에서 오류가 난 오퍼 안내문 캡처 2장 test/fixtures/ocr-real/(이름은 [이름]으로 가려진 이미지, 정답은 원본을 보고 옮겨 적음)). 수정 전후 비교 결과는 docs/ocr-accuracy-report.md에 있습니다.
- 추출 결과는 S-03 추출본 확인 화면에 원본 미리보기와 함께 편집 가능한 텍스트로 보여 주고 자동으로 분석하지 않습니다. '내용 확인하고 분석하기'를 눌렀을 때 확인·수정한 텍스트만 분석 API로 전송됩니다. 결과·상세 화면에는 '추출·확인한 텍스트 기준'임을 표시합니다.
- 직접 입력한 텍스트와 파일에서 추출한 텍스트는 따로 보관합니다. 화면 이동·뒤로 가기·재시도 중에는 이 창의 메모리에 유지되고, 새로고침하거나 창을 닫으면 사라집니다.
- 형식 오류·인식 실패·일부 실패·바꾸기 취소 때 이미 입력한 내용과 이미지 목록은 그대로 둡니다.
- 라이브러리와 언어 데이터는 외부 CDN이 아니라 같은 사이트의 에서 제공합니다 (처음 업로드할 때만 내려받음: PDF 약 2MB, OCR 약 8.5MB). 는 로 에서 복사해 커밋한 파일입니다. Vercel은 빌드 스크립트보다 먼저 을 정적 파일로 수집하므로 빌드 때 생성하지 않고 커밋해 둡니다.
자료 간 비교 규칙 (public/compare-core.js, src/compare.js는 재수출)
- 두 문서를 각각 기존 분석(추출 → 인용 검증 → v2.2 규칙)으로 처리한 뒤, 비교 단계에서는 AI를 다시 부르지 않고 규칙으로만 비교합니다. 문서 순서는 채용공고 → 오퍼 안내 → 근로계약서 단계로 정렬합니다(앞 단계 A, 뒤 단계 B).
- 상태: 동일한 조건 / 달라진 조건 / 새로 추가된 조건(앞 문서에 없고 뒤 문서에 적힘) / 한쪽 문서에서 확인되지 않음 / 비교 불가 · 추가 확인 필요(간략한 오퍼 안내에 없는 조건) / 모호하거나 직접 비교하기 어려움 / 두 문서 모두 확인되지 않음 / 분석 확인 불가 / 해당 없음.
- 한쪽 문서에 없는 조건을 삭제·변경으로 보지 않습니다. '추후 협의'·'회사 내규에 따름' 같은 표현이나 한 문서 안의 서로 다른 값은 구체적인 조건으로 보지 않습니다.
- 금액·시간 등은 두 문서의 산정 단위(연봉·월급·시급, 주·1일)가 같고 값을 하나로 특정할 수 있을 때만 차이를 계산합니다(단위 환산 없음, 세전·세후가 다르면 비교하지 않음). 장소·업무 같은 글은 표기를 정리해 같을 때만 '동일'로 보고, 다르면 같은지 추측하지 않습니다.
- 모든 비교 결과에 두 문서의 검증된 원문 인용(줄 번호)을 붙입니다. 한 문서라도 AI 분석에 실패하면 결과를 만들지 않고 오류로 안내합니다. 비교 1건은 요청 제한에서 분석 2회로 셉니다.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
