권장 정리 방식 — 로컬 PC에서 아래처럼 정리한 뒤 폴더째 올리면 모든 정보가 자동 인식됩니다.
파일명 형식: 유형_연도_교수명_제목.pdf (유형: 논문·사업계획서·연구노트·특허)

배성환/                      ← 교수명 폴더
├── 논문_2024_배성환_탄소나노튜브 복합소재 연구.pdf
├── 사업계획서_2022_배성환_마이크론급 소재 사업화.pdf
├── 특허_2025_배성환_특허등록증_제10-2799xxx호.pdf
└── 지난자료/                ← 하위 폴더도 모두 인식
    └── 논문_2013_배성환_금속 세라믹 접합.pdf

1. 문서 등록 → 폴더 선택을 누르거나, 탐색기에서 교수명 폴더를 업로드 영역으로 드래그합니다.
2. 업로드 대기 목록에서 교수명·유형·연도가 자동으로 채워졌는지 확인합니다. 파일명의 밑줄 규칙에서 인식하며, [논문][2024]제목.pdf 대괄호 태그 방식도 지원합니다.
3. 교수명이 비어 있으면(빨간 테두리) 직접 입력하거나 "교수명 일괄 지정"을 사용하세요.
4. 이미 등록된 파일(교수명+파일명 동일)은 자동으로 건너뜁니다 — 새 파일만 추가된 폴더를 통째로 다시 올려도 안전합니다. 목록에 등록됨 표시가 붙고, 다시 올리려면 "이미 등록된 파일도 다시 업로드"를 체크하세요.
5. 업로드 시작을 누르면 진행률이 표시되고, 실패한 파일(❌)만 목록에 남아 재시도할 수 있습니다.

• 업로드된 문서가 검색에 반영되기까지 수 분 ~ 수십 분이 걸립니다 (Vertex AI Search 색인).
• 문서 목록의 "색인 중" 표시는 색인 상태 갱신 버튼을 눌러야 실제 상태로 바뀝니다.
• 업로드 시 AI(Gemini)가 문서 내용에서 제목·저자·핵심기술을 추출합니다. 폴더/파일명에서 인식한 교수명·유형·연도가 있으면 그 값이 우선합니다.
• 파일명에 사번을 넣지 마세요. 문서 제목은 사용자 검색 화면에 그대로 노출되므로, 사번 형태의 숫자(7자리 = 임용연도 4자리 + 등록순서 3자리, 예: 2005019)가 파일명에 포함되면 업로드가 거부됩니다. 폴더명이 "사번(이름)" 형태인 경우 프로필이 등록되어 있으면 자동으로 이름·사번으로 정규화되고, 프로필이 없으면 등록 안내와 함께 거부됩니다.

• 문서 관리 탭은 처음 열 때 색인 중인 문서만 표시합니다 (문서가 많아져도 빠르게 열리도록). 전체 목록은 [전체 문서 불러오기]를 누르면 조회됩니다.
• 문서 관리 탭 상단의 현황 트리에서 상위부서 → 학과 순으로 펼쳐 교수별 문서 수를 확인할 수 있습니다. 교수명을 클릭하면 그 교수의 문서만 서버에서 가져와 아래 목록에 표시되고, 다시 클릭하거나 ✕ 버튼을 누르면 기본 화면(색인 중 문서)으로 돌아갑니다. 사번이 연결되지 않은 문서는 같은 이름이라도 별도 행으로 표시되므로, 연결 누락을 찾는 데 활용하세요.
• 문서 관리 탭의 수정에서 파일명(표시용)·연구자·유형·연도를 고칠 수 있습니다. 연구자 변경은 사번 프로필 기준으로 선택합니다 (학과 | 이름 (사번) 형식) — 동명이인도 사번으로 정확히 구분됩니다. 미상 문서를 교수에게 연결하려면 연구자 관리 탭에서 프로필을 먼저 등록하세요.
• 문서-사번 일괄 연결: 연구자 관리 탭의 [🔗 문서-사번 일괄 연결]은 사번 없이 이름만 있는 기존 문서를 이름이 정확히 일치하는 사번 프로필에 자동 연결합니다. 연구자명에 사번이 박혀 있는 문서(예: 1998289(한상보))도 사번으로 인식해 연결하고, 문서의 연구자명을 프로필의 이름으로 정리해 줍니다. 동명이인은 안전을 위해 건너뛰므로 문서 관리 탭에서 수동으로 지정하세요. 폴더/PDF 업로드 시에도 교수명이 사번 프로필 한 명과 일치하면 자동으로 사번이 연결됩니다.
• 삭제는 저장소·검색 색인에서 함께 제거되며 되돌릴 수 없습니다.
• 연구자 검색: 연구자 관리 탭 상단의 사번·교수명 검색 상자에 입력하면 일치하는 교수만 남고 소속 부서·학과가 자동으로 펼쳐집니다. 동명이인은 사번으로 정확히 구분됩니다.
• 프로필 검색 색인: 프로필을 등록/수정하면 소속·전공·연구분야·보유 문서 키워드가 검색 색인에 자동 등록되어, 실적 문서가 없는 교수도 사용자 검색에 노출됩니다 (검색 결과에는 "프로필 일치"로 구분 표시되며, 논문 등 실적이 일치한 교수가 항상 위에 나옵니다). 엑셀로 연구분야를 일괄 갱신했거나 문서를 많이 올린 뒤에는 [🔍 프로필 검색 색인 재생성]을 누르고, 수 분 뒤 바로 옆의 [📶 색인 상태 갱신]으로 색인 완료를 확인하세요. 이메일·비고는 개인정보 보호를 위해 색인에 포함하지 않습니다.
• 🌌 키워드 지도(성좌): [🌌 키워드 지도 생성/갱신]을 누르면 문서 키워드를 Gemini가 의미 기준으로 대분류→세부→키워드 3단계로 묶어, 사용자 검색 페이지의 [연구 키워드 성좌] 탐색에 반영됩니다. 문서 키워드는 항상 최신이지만 군집화는 무거운 작업이라 이 버튼으로만 갱신되며, 새 키워드가 쌓이면 성좌 페이지 상단에 "반영 대기" 표시가 뜹니다. 첫 생성 전에는 부서 기준 구조적 지도가 임시로 표시됩니다.
• 연구자 관리 탭에서 프로필(사번·소속·직급·전공·이메일·연구분야)을 등록하면, 사용자 페이지에서 연구자 카드 클릭 시 상세 정보로 표시됩니다. 프로필의 이름은 문서의 연구자명과 정확히 일치해야 연결됩니다. 현황표의 수정 버튼으로 기존 프로필을 고칠 수 있습니다.
• 엑셀 일괄 업로드: 연구자 관리 탭의 [📄 엑셀 일괄 업로드]로 교원데이터 양식(.xlsx — 헤더: 사번·이름·현상위부서·현부서·직급·연구(관심)분야·전공·소개·비고)을 올리면 전체 교원 프로필이 한 번에 등록됩니다. 사번이 고유 키이므로 같은 사번은 갱신(Upsert)되고, 같은 파일을 다시 올려도 중복이 생기지 않습니다. 수기로 입력해 둔 이메일·연구분야·소개는 엑셀의 빈 칸이 덮어쓰지 않습니다. 주민등록번호 등 개인식별정보가 발견된 행은 자동 차단됩니다.

• 통계 관리 탭 상단에서 최소 관련도(%)를 저장하면, 그 미만의 검색 결과는 사용자에게 노출되지 않습니다. 0% = 전부 표시 (기본값).
• 결과 노출 개수: 사용자 검색 결과에 보여줄 연구자 수를 1~10명 사이에서 정할 수 있습니다 (기본 5명). 저장 즉시 다음 검색부터 적용됩니다.
• 설정은 저장 즉시 다음 검색부터 적용됩니다 (재배포 불필요). 변경 이력은 활동 로그에 기록됩니다.
• 사용 팁: 평가셋 실측 결과 정답인데 관련도 점수가 0%인 경우가 실제로 존재하므로, 기본값 0%(전부 표시) 유지를 권장합니다. 문서가 충분히 쌓인 뒤 backend/eval 평가 결과의 정답/오답 점수 분포를 근거로 조정하세요. 너무 높이면 정답이 잘려나갑니다.
• AI 검색어 확장 / AI 리랭킹: 검색 설정의 두 토글로 켜고 끕니다. 확장은 기업 구어체 문의를 학술용어·영문으로 넓혀 재현율을 높이고, 리랭킹은 Gemini가 후보를 기술 수요 적합도 순으로 재정렬해 검색 카드에 추천 근거 한 문장을 표시합니다. AI 오류 시 자동으로 기본 검색으로 동작하므로 검색이 중단될 걱정은 없습니다.

• 통계 관리: 총 검색 횟수, 일별 검색 추이(14일), 문서 유형 분포, 인기 검색어, 활동 로그를 확인합니다.
• 회원가입 신청: 등록되지 않은 새로운 관리자가 Google 로그인하면 가입 신청 화면이 뜹니다. 이름, 소속 부서, 가입 신청 사유를 작성하여 제출하면 승인 대기 상태가 됩니다.
• 관리자 및 권한 관리 (super_admin 전용): 최고관리자는 승인 대기 목록에서 신규 가입 신청을 승인하거나 반려(삭제)할 수 있습니다. 또한, 전체 관리자 목록에서 타 관리자 계정의 역할 권한(admin / super_admin)과 상태(approved / pending / suspended)를 직접 조정할 수 있습니다.
• 새 관리자는 Google 로그인이 허용된 테스트 사용자로도 등록되어 있어야 합니다 (GCP 콘솔 > OAuth 동의 화면).

• 바로가기: 실서비스의 검색 화면, 관리자 페이지, API 상태 확인 링크뿐만 아니라 Google Cloud 콘솔의 다양한 핵심 관리 도구(Cloud Run, Cloud Build, Firestore, Storage, Vertex AI, OAuth 자격증명 설정)로 원클릭 이동할 수 있습니다.