일단확인 (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회로 셉니다.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
