기술 아키텍쳐

현재 기반은 공용 개발 계정 · 사용자와 JD 원문 저장 · 단계별 채용 홈과 JD 분석 복원 · 과제 생성·조정 · 공통 사례와 JD 대조 구조입니다. 별도 JD 실험은 수집·요구 능력 빈도 분석·원문 재검토를 지원하며 제품 DB 연결은 남아 있습니다. 프런트엔드는 로컬 개발 프록시, Railway Nginx 또는 Cloudflare Pages Functions를 통해 같은 주소의 제품 API를 호출합니다. Cloudflare 프록시는 공용 개발 주소의 허용된 API·health 경로만 Railway 공개 게이트웨이로 전달하며 PR 미리보기에서는 API를 차단합니다. /video는 Cloudflare Secret에 YouTube 주소가 없으면 준비 안내를 표시하고, 주소를 설정하면 캐시하지 않는 임시 이동으로 연결합니다. Railway에서는 API 재배포 후 내부 DNS 주소를 다시 확인합니다. 채용 홈은 저장된 채용을 여섯 단계로 나누고 단계별 수치와 확인할 일, 다가오는 마감을 보여주며, 채용 화면은 저장된 JD·요구사항·실제 평가기준과 과제 생성 당시 근거를 복원합니다. 조정 화면은 실제 수정본·관찰 포인트·합성 사례를 표시하며 변경안 생성과 현재안 선택을 연결합니다. 생성 화면에서는 아직 공개하지 않은 과제를 확인 대화상자를 거쳐 삭제하고 저장된 JD 분석으로 다시 생성할 수 있습니다. 이 기능에 필요한 DB 버전 0018은 공용 DB에 적용했습니다. 제품 API의 복구 가능한 오류는 토스트로 알리고 필수 흐름을 막는 오류는 화면별 복구 동작이나 모달로 표시합니다. 개발 Railway에서는 HR CSV 초대·실제 메일 수신·두 지원자 계정 로그인·본인 과제 접근·재발송·과제 시작과 PDF 다운로드를 확인했습니다. Cloudflare 공용 개발 주소는 프록시가 main에 반영된 뒤 같은 흐름을 다시 확인합니다. 채용 홈은 분석 이력 유무와 관계없이 공개 과제를 모집·제출 단계로 안내합니다. 회사 설정 화면의 실제 API 연결과 생성·제출·평가 전체의 배포 환경 검증은 남아 있습니다. 평가 목록과 지원자별 HR 검토 화면은 실제 API에 연결했습니다. 공용 DB의 후속 migration도 적용했지만 새 코드가 배포된 환경에서 이 흐름을 아직 검증하지 않았습니다. 합성 API 응답을 사용한 Chromium 검사는 네 가지 너비에서 통과했고, 일회용 독립 DB에서는 M4·M5·M6 흐름과 migration 재적용을 확인했습니다. 점선은 이후 제품 연결에 필요한 부분이며, 이번에 모두 구현하거나 설정해야 한다는 뜻은 아닙니다.

평가 재설계 표시 경계: 대시보드는 1depth 5 → 2depth 15 → 3depth O/X 질문 45, 질문별 AI·HR 결과 분리, 2depth 원자 저장과 범위 판정을 목표 계약으로 설명합니다. ERD는 2026-09-29(KST)에 공용 개발 DB에서 읽기 전용으로 수집한 ac683cf2bd3d 구조를 표시합니다. 456e57aecbe7 감사 원장과 92e8cae4ac82 평가 구조는 적용됐지만 revision 2 승인과 활성화, 새 코드 배포와 실제 모델 검증은 확인하지 않았습니다.

JD 입력 Playground는 frontend의 /playground/jd-input에서 제공합니다. 입력 탭·검증·샘플·전달 값 표시·초기화를 확인하는 UI 검토 화면이며 실제 수집·PDF 본문 추출·저장·정규화는 호출하지 않습니다. 실행 코드는 frontend의 app/pages/features/shared 구조에 두고, 사용 안내는 docs/sources/UI/09-15-JD-입력-React-컴포넌트-사용안내.md에서 관리합니다.

정확 수정 계약의 실행 경계: 개발 head는 ac683cf2bd3d입니다. 공용 DB 35209c9b455c의 제안·계약 직접 INSERT 차단과 원본 답변 예시·검증된 파일·논리 자료 ID를 보존하는 전용 완료 경계를 유지합니다. 7f3a9c2e6b10에서는 정확 수정의 내용 준비와 자료 준비를 나눕니다. 원본 자료가 없으면 내용만 ready가 될 수 있으며, 파일이 있으면 바이트·해시를 검증해 보존합니다. 4b8e2d6f901c는 대상 ID로 수정 범위를 정하고 제안·HR 계약 확인·실행을 나눕니다. exact는 지정값을, generated는 지정 대상의 생성 지시를 적용합니다. worker protocol 2는 새 실행·완료 경로를 사용하며 구버전 worker와 지원하지 않는 조합은 거부합니다. 새 수정본은 HR이 비교한 뒤 별도로 현재안으로 선택합니다. PR #202에서 범위 지정 패널을 연결하고 자유 문자열 직접 실행 화면 경로를 제거했습니다. 대상별 변경·유지 범위와 자료 처리 계획을 확인하며 충돌하면 최신 상태를 다시 읽습니다. 공용 개발 DB 적용은 마쳤으며 PR #200~#202 코드 배포·실제 JD·PDF 전체 흐름 검증은 남아 있습니다.

PR #200~#202 후속 구현: 회사정보 개발 CLI는 소유자·회사·기존 값을 대조하고 갱신 전 증거를 남깁니다. 입력·증거 부모 폴더는 0700, 파일은 0600으로 관리하며 dry-run은 쓰기를 하지 않습니다. 회사 설정 화면의 API 연결은 별도입니다. 안내문 렌더러는 현재 제목·예상 시간·제출 필수 항목으로 새 PDF를 준비하되 보호된 본문과 기존 ready-material exact 경로의 검사 조건을 유지합니다. 표준 시간 표기 밖의 자연어 문구는 HR 검토가 필요합니다. DB head는 ac683cf2bd3d로 같고 이 후속 작업에 migration 변경은 없습니다. 새 코드의 개발·운영 배포나 실제 PDF 전체 흐름 완료를 확인한 상태는 아닙니다.

HR 검토와 공개: 화면은 내용 준비·자료 준비·현재 내용과 자료에 유효한 HR 승인을 구분합니다. HR은 모든 고정 질문의 근거와 관찰 기회에 판단·사유를 남기고 전체 검토 사유를 저장합니다. 공개 API는 현재 수정본 ID·내용 버전·내용 해시·자료 해시를 다시 비교합니다. 자료 미준비·참조 누락·오래된 승인은 공개를 막고 재확인으로 안내합니다. 평가 화면은 AI 원판정과 HR 적용 판정·텍스트와 시각 근거를 나누고 대기·실행 중·실패·확정 상태를 읽기 전용으로 표시합니다. 채용 홈의 삭제는 정확한 제목 확인·오류 유지·성공 후 목록 갱신을 연결했습니다. DB 삭제와 외부 파일 정리·백업 소거는 별도 상태입니다.

과제 조정 대화 개발 구현: 인증된 대화 API가 최초 JD·현재 과제·최근 대화를 OpenAI에 전달합니다. 브라우저는 바꿀 조건과 유지할 조건을 표시하고, HR이 범위 지정 패널에서 제안을 저장하고 계약을 확인한 뒤 별도로 실행해야 수정본 작업을 등록합니다. 대화만으로 현재안을 바꾸지 않으며, 질문·추천 이력은 페이지 안에서만 유지됩니다. API 서버의 OpenAI 키 설정과 프런트·API의 동시 배포가 필요합니다. 회의록·참고자료와 챗봇 구현 안내에서 상세 경계를 확인합니다.

공용 DB의 로컬 수동 적용: Actions를 사용할 수 없으면 scripts/local-db.py로 암호화 백업과 독립 PostgreSQL 17의 실제 복원 proof를 만든 뒤 기존 정책·잠금·원장으로 적용합니다. 병합된 정확한 main SHA와 비공개 보관 파일을 재검사하고 로컬 출처를 구분합니다. 공용 개발 DB는 백업·독립 복원·dry-run과 적용 전후 검사를 거쳐 ac683cf2bd3d까지 적용했습니다. 서비스 코드 배포와 실제 JD·PDF 전체 흐름은 별도로 확인합니다. ERD는 적용 뒤 읽기 전용으로 수집한 공용 개발 DB 상태를 표시합니다.