# 11. User Required Actions

이 문서는 운영 배포와 실제 사용 전에 사용자가 직접 결정하거나 제공해야 하는 필수 작업만 정리한다. 개발자가 대신 진행할 수 있는 코드 수정, 배포, 테스트 항목은 제외한다.

## 1. 운영 인증 방식 결정

현재 관리자 화면은 MVP용 고정 로그인 값을 사용한다.

- ID: `flownco`
- PASS: `flownco`

운영 전에는 다음 중 하나를 결정해야 한다.

- 기존 사이트 회원/관리자 인증과 연결
- 별도 관리자 계정 체계 생성
- 세션/JWT 기반 관리자 인증 도입

## 2. 운영 DB 선택

SaaS 웹에서 들어온 모든 데이터는 백엔드에 저장되어야 한다. 운영 전 사용할 DB를 확정해야 한다.

- PostgreSQL
- MySQL/MariaDB
- SQLite
- 기타 운영 DB

DB가 확정되면 개발자는 현재 Prisma/SQL 모델을 기준으로 마이그레이션과 연결 설정을 맞출 수 있다.

## 3. 운영 서버 저장소 정책 결정

업로드 원본 파일, 페이지 이미지, 썸네일, PDF 출력물을 어디에 보관할지 결정해야 한다.

- 서버 로컬 암호화 저장
- Object Storage
- 내부 NAS 또는 별도 파일 서버
- 개발 단계 한정 로컬 저장

## 4. Local Agent 실행 PC 또는 내부 서버 지정

Local LLM 백엔드는 사용자 PC 또는 내부 서버에서 실행된다. 실제 테스트에 사용할 장비를 정해야 한다.

필수 확인 항목:

- Local Agent를 실행할 PC/서버
- 접속 가능한 IP 또는 도메인
- 포트 번호, 기본 `8787`
- 방화벽 허용 여부
- GPU 사용 가능 여부

## 5. Agent Token 운영값 확정

Local Agent 접속 token은 임시값을 그대로 쓰면 안 된다.

필수 작업:

- 운영용 Agent Token 생성
- 웹 설정 화면에 입력
- Local Agent 실행 옵션에 동일 token 적용
- token을 문서, 채팅, 로그에 평문 공유하지 않기

## 6. LLM 모델 선택

MVP 기본 모드는 외부 LLM API를 사용하지 않는다. 사용할 로컬 모델을 선택해야 한다.

선택 후보:

- HyperCLOVA X SEED Vision-Instruct-3B local
- HyperCLOVA X SEED Text-Instruct-1.5B local
- DeepSeek-R1-Distill-Qwen-7B local
- Ollama 또는 LM Studio 테스트 모델

외부 DeepSeek API, OpenAI API, Anthropic API, 외부 CLOVA Studio API는 기본 모드에서 사용하지 않는다. DeepSeek API provider를 실제로 쓰려면 별도 운영 승인, 개인정보·원본 이미지·OCR 텍스트 전송 정책 검토, 환경변수 변경을 사용자가 명시적으로 승인해야 한다.

## 7. 실제 시험지 샘플 제공

인식 품질을 검증하려면 실제 테스트용 시험지 샘플이 필요하다.

필수 조건:

- 개인정보가 제거된 샘플 우선 사용
- 최대 5장 이하 PDF 또는 이미지
- 인쇄 문제, 손글씨 풀이, 첨삭 위치가 포함된 자료
- 가능하면 정답/채점 기준 별도 제공

## 8. 관리자 운영자 지정

관리자 페이지에서 모든 프로젝트, 업로드 파일, 인식 결과, 승인 이력, 출력 이력, AuditLog를 조회할 수 있다.

필수 결정:

- 관리자 권한을 줄 사람
- 교사 권한을 줄 사람
- 조회만 가능한 VIEWER가 필요한지 여부
- 운영 중 데이터 export 권한을 누가 가질지

## 9. 공개 페이지 문구 승인

다음 공개 페이지의 문구는 외부 방문자가 볼 수 있으므로 최종 승인해야 한다.

- `/solutions/exam-annotation`
- `/solutions/exam-annotation/research`
- `/solutions/exam-annotation/technology`

특히 다음 원칙 문구는 제품 정책으로 반복 표시된다.

```text
인식하지 못한 것은 추론하지 않는다.
추론한 것은 확정하지 않는다.
승인된 첨삭만 출력한다.
```

## 10. 운영 배포 일정 승인

운영 반영 전 최종 승인할 항목:

- 배포 날짜와 시간
- 백업 보관 위치
- 테스트 담당자
- 문제 발생 시 롤백 여부
- 공개 메뉴 노출 시점

## 사용자가 하지 않아도 되는 작업

다음은 개발자가 계속 처리할 수 있다.

- 코드 수정
- 문서 보강
- 테스트 스크립트 실행
- 서버 배포
- wrapper 라우트 연결
- 연구내용 페이지 반영
- API smoke test
- ExportGuard 회귀 테스트