# 먼저 읽어 주세요

## 지금 완성된 것

이 폴더는 기존 기술 검증 결과를 건드리지 않고, 채용 담당자가 이해하고 직접 실행할 수 있도록 새로 만든 **제출용 파생 패키지**입니다.

- `agent-reliability-demo/`: GitHub에 올릴 코드와 한국어 README
- `agent-reliability-demo/demo/`: Solar 연결 경로, 웹 서버, 이해하기 쉬운 반응형 화면
- 공개 웹 데모: 설치나 CMD 실행 없이 브라우저에서 바로 체험
- `START_HERE_UPSTAGE_LIVE_DEMO.cmd`: 압축을 푼 Windows 로컬 패키지에서 실행하는 선택 경로
- `agent-reliability-demo/demo_tests/`: 데모 계층 10개 시험
- `agent-reliability-demo/docs/`: 3분 면접 시연과 제출 가이드
- `AGENT_RELIABILITY_PORTFOLIO_KO_R2_20260718.pdf`: Upstage 지원용 8페이지 포트폴리오

## 이 프로젝트를 아주 쉽게 말하면

AI가 지출 문서를 읽는 것까지만 맡고, 실제 기록은 다음 안전장치를 통과한 뒤 코드가 실행합니다.

1. 필수 정보가 다 있는지 확인
2. 사람 승인을 받기 전에는 멈춤
3. 프로그램이 꺼져도 저장된 지점에서 재개
4. 저장 후 응답이 사라져 재시도해도 같은 기록은 한 번만 생성
5. AI의 말이 아니라 저장된 상태와 실행 기록을 독립 검증

그래서 이 결과물은 “챗봇 화면”보다 **agent가 실제 일을 할 때 사고를 막는 제어층**을 보여주는 포트폴리오입니다.

## 가장 쉬운 사용 방법: 공개 웹 데모

1. https://upstage-solar-reliability-demo-20260718.pages.dev/ 를 엽니다.
2. 기본 `공개 데모 키` 모드에서 가상 문서를 입력해 체험합니다.

공개 웹 데모는 CMD 실행, 프로그램 설치, 개인 키 입력이 필요 없습니다.

## Windows 로컬 패키지를 사용하는 경우

1. `UPSTAGE_SOLAR_LOCAL_DEMO_WINDOWS.zip`의 압축을 먼저 완전히 풉니다.
2. 압축을 푼 최상위 폴더의 `START_HERE_UPSTAGE_LIVE_DEMO.cmd`를 더블클릭합니다.
3. Upstage Studio의 `Secret key`를 보안 입력창에 한 번 붙여넣고 Enter를 누릅니다.

그다음 Solar 호출, 승인, 응답 유실 복구, replay, 중복 검사, PASS 영수증, 새 ZIP·SHA 생성, 결과 화면 열기, Windows `Downloads` 저장까지 자동 진행됩니다.

로컬 실행의 Secret key는 보안 입력으로 받아 현재 실행 메모리에서만 사용하며 파일이나 명령 기록에 저장하지 않습니다. 키는 채팅, 코드, PDF, GitHub에 붙여 넣지 않습니다.

## 제출 순서

1. `agent-reliability-demo/`를 새 GitHub 저장소에 올립니다.
2. 공개 웹주소를 확인합니다. 로컬 검증이 추가로 필요할 때만 `START_HERE_UPSTAGE_LIVE_DEMO.cmd`를 실행합니다.
3. GitHub URL을 지원서의 포트폴리오 링크 칸에 적습니다.
4. `AGENT_RELIABILITY_PORTFOLIO_KO_R2_20260718.pdf`를 지원서 PDF 항목에 첨부합니다.
5. 면접에서는 `docs/INTERVIEW_GUIDE_KO.md` 순서대로 90초 시연합니다.

## 현재 판정

- 봉인된 reliability core 기술 증거: **PASS**
- 새 웹 데모·자동 실행기 unit/contract test 10개: **PASS**
- 새 웹 데모 HTTP smoke test: **PASS**
- 포트폴리오 PDF 8페이지 렌더·시각 검수: **PASS**
- 실제 Solar provider E2E: **PASS 영수증 포함**
- 현재 저작 환경의 432개 재실행: PID namespace가 서로 달라 process-hazard 판정이 유효하지 않으므로 새 PASS 증거로 사용하지 않음

## 그대로 복사해서 전달할 문구

“Upstage Solar의 문서 구조화 결과를 fail-closed workflow control plane에 연결한 포트폴리오입니다. AI는 문서를 읽고, 결정론적 통제층이 필수값 검사·사람 승인·checkpoint 복구·재시도·중복 방지를 담당합니다. 저장 후 응답이 유실돼 같은 요청이 다시 와도 실제 기록은 한 번만 남는 흐름을 웹 데모로 확인할 수 있습니다. 봉인된 core는 432개 고유 시험과 Windows/Linux·Python 3.11–3.13 matrix로 검증했으며, 실제 개인정보와 운영 결제 시스템은 사용하지 않았습니다.”
