HR Copilot — 기능 요구 사항 정의서 (FRS)

개요

목적

본 문서는 HR Copilot 시스템의 핵심 기능 요구사항을 정의하며, 통합된 계정 구조와 관리자 중심의 운영 프로세스를 기반으로 기능 단위 요구사항을 명시한다.

공통 시스템 규칙 (Base)

코드 기능명 상세 설명 우선순위
FR-00-01 Audit 컬럼 공통 적용 모든 테이블에 created_at, created_by, deleted_at, deleted_by를 적용하여 이력을 추적한다. 상
FR-00-02 논리 삭제 정책 데이터 삭제 요청 시 물리 삭제 대신 deleted_at 컬럼에 일시를 기록하여 보관한다. 상
FR-00-03 상태값 표준화 (Enum) 계정 상태, 지원 상태, 문서 추출 상태 등 주요 상태값을 Enum 형식으로 표준화하여 관리한다. 상
FR-00-04 참조 무결성 유지 각 도메인(지원자, 문서, 질문 등) 간 외래키(FK) 정합성을 엄격히 유지한다. 상

기능 요구 사항 (Functional Requirements)

FR-01 통합 계정 및 권한 관리 (Manager & Auth)

관리자와 일반 사용자를 managers 테이블로 통합하고, 권한(role)을 통해 기능을 제어한다.

코드 기능명 상세 설명 우선순위
FR-01-01 관리자 로그인 및 인증 ID/PW 인증을 수행하며, BCrypt 해시 알고리즘으로 비밀번호를 검증한다. 상
FR-01-02 관리자 전용 계정 생성 최고 관리자가 서비스 사용자의 계정을 직접 생성한다. 상
FR-01-03 역할 기반 권한 부여 계정 생성/수정 시 권한 컬럼(role_type)을 통해 관리자와 일반 사용자를 구분한다. 상
FR-01-04 계정 상태 제어 관리자의 상태를 ACTIVE 또는 INACTIVE로 변경하여 시스템 접근을 차단하거나 허용한다. 상
FR-01-05 사용자 목록 및 상세 조회 등록된 전체 관리자리스트와 특정 계정의 상세 프로필 정보를 조회한다. 상

FR-02 지원자 및 서류 관리 (Candidate & Document)

코드 기능명 상세 설명 우선순위
FR-02-01 지원자 통합 정보 관리 지원자의 인적 사항을 등록 및 수정하고, 지원 진행 상태(apply_status)를 관리한다. 상
FR-02-02 채용 서류 업로드 및 매핑 지원자별 이력서/포트폴리오 파일을 업로드하고 관리한다. 상
FR-02-03 텍스트 추출 및 상태 관리 업로드된 파일에서 텍스트를 추출(OCR/Parsing)하고 성공/실패 상태를 관리한다. 상
FR-02-04 추출 데이터 저장 문서 분석 결과물인 extracted_text를 데이터베이스에 안전하게 저장한다. 상

FR-03 프롬프트 프로필 및 세션 관리 (Prompt Profile & Session)

코드 기능명 상세 설명 우선순위
FR-03-01 프롬프트 프로파일 관리 직무별 분석 전략(Persona)과 출력 스키마(Output Schema)를 프로파일 단위로 관리한다. 상
FR-03-02 분석 세션 생성 특정 지원자와 채용 기준(JD)을 조합하여 독립적인 분석 단위(Session)를 생성한다. 상

FR-04 면접 질문 및 가이드 관리 (Interview Question)

코드 기능명 상세 설명 우선순위
FR-04-01 맞춤형 면접 질문 생성 지원 서류의 특정 섹션을 근거로 역량 검증을 위한 면접 문항을 생성한다. 상
FR-04-02 질문 생성 근거(Rationale) 저장 질문이 도출된 서류 내 근거 문장(Snippet)과 그 이유를 기록하여 신뢰성을 확보한다. 상
FR-04-03 평가 가이드 및 예상 답변 제공 면접관용 답변 가이드라인, 예상 답변, 난이도, 카테고리 정보를 함께 생성한다. 상
FR-04-04 질문 리스트 편집 생성된 질문의 내용을 수정하거나 중요도에 따라 노출 순서(priority)를 조정한다. 중

FR-05 LLM 운영 로그 관리 (Ops & Logging)

코드 기능명 상세 설명 우선순위
FR-05-01 LLM 호출 이력 기록 호출 시 사용한 모델명, 프롬프트 조합, 응답 원문을 저장한다. 상
FR-05-02 토큰 및 비용 추적 호출마다 소비된 토큰량과 환산된 비용 정보를 기록하여 대시보드 기초 자료로 활용한다. 상
FR-05-03 서비스 호출 상태 모니터링 API 호출의 성공/실패 여부를 추적하여 장애 대응 및 재시도 로직의 근거로 사용한다. 상