[사용 매뉴얼] 문헌연구 자동화 모듈

연구 Q&A

# 문헌연구 자동화

AI가 연구주제와 관련된 국내외 선행연구를 탐색하고, 핵심 논점과 이론적 배경을 요약해 정리해주는 모듈입니다. 논문 작성의 첫 단계인 문헌연구에 소요되는 시간을 크게 단축시켜주며, 정리된 결과는 다음 단계인 연구설계 자동화의 이론적 배경 자료로 그대로 이어집니다.

## 전체 화면 구성

문헌연구 자동화 화면은 별도의 상세 페이지로 이동하는 목록형이 아니라, **한 화면 안에서 카드가 펼쳐지는 방식**으로 구성됩니다.

**① 새 문헌연구 만들기** — 상단의 4개 카드 (AI 문헌 자료 생성 / APA·RIS·SSRA 형식 등록)
**② 내 문헌연구 현황** — 지금까지 만든 문헌연구 목록(카드형)

* 목록에서 카드의 **선택** 버튼을 누르면 그 카드 바로 아래에 **3단계 위저드 패널**이 펼쳐지며, 별도 화면 이동 없이 그 자리에서 문헌 등록 → 분석 → 결과 작성까지 진행합니다.
* 이 외에 슬라이드 패널(수집 자료 확대보기, 분석결과 작성 확대보기)과 모달(공동연구자 관리, 삭제 확인, 일괄 등록, 분석 도구)이 필요할 때 화면 위로 열립니다.

***

## ① 새 문헌연구 만들기

4개의 진입 카드가 있으며, 각각 다른 등록 방식의 패널을 엽니다.

| 카드 | 버튼 | 용도 |
| --- | --- | --- |
| AI 문헌 자료 생성 (점선 테두리) | 생성하기 | AI 도구에서 만든 문헌 자료를 붙여넣어 등록 |
| APA 형식 등록 | 불러오기 | APA 서지형식 `.txt` 파일 업로드 |
| RIS 형식 등록 | 불러오기 | `.ris` 파일 업로드 |
| SSRA 형식 등록 | 불러오기 | SSRA 자체 `.csv` 형식 파일 업로드 |

### AI 문헌 자료 생성 패널

* **연구 주제**: 최대 24자 입력, 실시간 글자 수 표시(18자부터 주황, 24자에서 빨강으로 경고)
* **AI 프롬프트** 버튼(보라색, 별 아이콘): 저장된 프롬프트 템플릿에 입력한 연구 주제를 자동으로 채워 **클립보드에 복사**합니다. 이 프롬프트를 ChatGPT·Claude 등 외부 AI 도구에 붙여넣어 실행하는 방식입니다 — SSRA 내부에서 직접 AI를 호출하지는 않습니다.
* **AI 수집 자료 붙여넣기**: 외부 AI 도구의 결과(마크다운 표 형식)를 붙여넣는 텍스트 영역, **지우기** 버튼으로 초기화
* **항목 옵션**: 연구분류·매개변수·키워드·연구대상·조절변수·근간이론·분석방법·연구모형·연구결과·독립변수·연구한계·종속변수·참고사항 13개 체크박스(기본 전체 선택), **보이기/숨기기**로 접고 펼 수 있음
* **작성확인** 버튼으로 최종 등록, **닫기**로 취소

### APA / RIS / SSRA 형식 등록 패널

* 드래그 앤 드롭 영역(파일을 끌어놓거나 클릭해서 선택), 형식에 따라 허용 확장자가 자동으로 바뀝니다(.txt / .ris / .csv)
* 선택한 파일은 칩(chip) 형태로 표시되며 x 버튼으로 제거 가능
* **파일 등록** 버튼으로 업로드, **닫기**로 취소

> 참고: 언어·출판연도 범위·데이터베이스 출처·논문 수·AI 모델 선택 같은 옵션은 없습니다. 생성 시점에 설정 가능한 항목은 연구 주제(24자), 붙여넣은 AI 텍스트, 13개 항목 옵션이 전부입니다.

***

## ② 내 문헌연구 현황 (목록)

상단에 **총 N건** 배지로 전체 개수를 표시합니다. 별도의 검색·필터·정렬 컨트롤은 없습니다.

각 카드에 표시되는 정보:

* 아이콘: 본인 소유는 문서 아이콘, 공동연구 참여 시에는 사람 아이콘으로 구분
* "문헌 자료" 라벨 + `ID: {번호}` + 등록일
* 공동연구자 아이콘(1인/여러 명 아이콘으로 구분) → 클릭 시 공동연구자 관리 모달
* 제목(비어 있으면 "(제목 없음 - ID:번호)"로 표시)
* **자료 현황** 배지: "문헌수집 N편" — 수집된 논문 수가 실시간으로 갱신됨(별도의 진행중/완료/실패 상태 배지는 없고, 이 편수 표시가 유일한 진행 지표입니다)

카드별 액션 버튼:

* **선택**: 아래에 3단계 위저드 패널을 펼침(펼친 상태에서는 **닫기**로 라벨이 바뀜)
* **삭제**: 삭제 확인 모달을 엽니다
* **연구설계**: 해당 문헌연구를 연동해 연구설계 자동화 화면으로 바로 이동

***

## ③ 3단계 위저드 패널 (카드에서 "선택" 클릭 시 펼쳐짐)

상단 탭으로 STEP 1\~3을 전환하며, 패널 우측 상단 × 버튼으로 전체를 닫을 수 있습니다.

**STEP 1 — 문헌자료 등록**

* 수집된 문헌을 표(Tabulator 그리드)로 보여줍니다
* **문헌자료 일괄 등록** 버튼으로 APA 서지정보/마크다운 표/CSV를 한 번에 최대 100건까지 붙여넣어 등록 가능
* **확대** 버튼으로 전체 화면 폭의 "수집 자료 목록" 패널을 열어 더 넓게 확인·편집(닫기는 **확대 종료**)

**STEP 2 — 문헌자료 분석**

* 분석 도구 메뉴와 3개의 인카드 결과 패널(통계/데이터, 텍스트마이닝, 그래프)로 구성
* 각 결과 패널에는 **전체화면** 토글과 **닫기(×)** 버튼이 있습니다

**STEP 3 — 문헌분석 결과 작성**

* AI가 정리한 이론적 배경/문헌연구 결과 초안이 표시되는 단계입니다
* **오른쪽 슬라이드 패널**로 확대해서 작성할 수 있으며(확대 버튼), 슬라이드 패널에는 자체 **확대**·**닫기(×)** 버튼이 있고 배경을 클릭하거나 Esc 키로도 닫을 수 있습니다

***

## ④ 모달 및 보조 패널

| 모달/패널 | 용도 |
| ----- | --- |
| 공동연구자 관리 | 문헌연구에 공동연구자를 추가·확인 (참여자는 "보기" 전용) |
| 문헌자료 삭제 확인 | 삭제 버튼(위험색) + 취소 버튼 |
| 문헌자료 일괄 등록 | APA/마크다운/CSV 붙여넣기 → 등록 |
| 분석 도구 모달 | 조건검색·빈도·교차·연관분석 등 실행, 설정확인/닫기 버튼 |
| 수집 자료 목록 확대 패널 | STEP 1 표를 전체 폭으로 확대 |
| 분석결과 작성 슬라이드 패널 | STEP 3 결과를 오른쪽에서 확대해 작성 |

***

## ⑤ AI 관련 기능 — 정확히 이해하기

이 화면의 "AI" 기능은 **SSRA 내부에서 직접 AI를 호출하는 방식이 아니라, 프롬프트를 만들어 외부 AI 도구에 전달하고 결과를 다시 붙여넣는 방식**입니다.

1. "AI 프롬프트" 버튼을 눌러 연구 주제가 채워진 프롬프트를 클립보드에 복사
2. ChatGPT, Claude 등 외부 AI 채팅 도구에 붙여넣어 실행
3. AI가 만들어준 결과(마크다운 표 형식)를 SSRA의 "AI 수집 자료 붙여넣기" 칸에 다시 붙여넣어 등록

화면 내에 모델 선택 드롭다운이나 "재생성" 버튼, AI 생성 진행률 표시줄은 없습니다. 로딩 스피너가 보이는 경우는 대부분 일반적인 데이터 조회·분석 실행 대기 상태입니다.

***

## ⑥ 다른 모듈과의 연동

* 각 문헌연구 카드의 **연구설계** 버튼으로 연구설계 자동화 화면으로 바로 이동하며, 해당 문헌연구가 연구설계 자료로 연동됩니다.
* 공동연구자 아이콘을 통해 같은 문헌연구를 여러 명이 함께 관리할 수 있습니다.
* 사용량/한도(예: "30/50건 사용") 같은 표시는 이 화면에는 없으며, 전체 개수만 "총 N건" 배지로 표시됩니다. 서비스별 사용량은 **계정 메뉴 → 사용량 / 한도** 화면에서 확인할 수 있습니다.

***

## 참고