app/docs/project_plan.md

# RAG 챗봇 + LocalPCAgent 통합 프로젝트 계획

## 프로젝트 개요

이 프로젝트는 RAG 챗봇 백엔드(Flask 기반)와 LocalPCAgent 제어 인터페이스를 통합하는 것을 목표로 합니다. 사용자는 RAG 챗봇 인터페이스 내에서 LocalPCAgent를 통해 원격으로 PC를 제어할 수 있게 됩니다.

## 완료된 작업

### 1. 장치 서버 연결 기능 개선 (2025-05-02)

- `app-device.js` 파일에서 `connectServer()` 함수 수정:
  - 환경변수에 저장된 URL을 우선적으로 사용하도록 수정
  - 텍스트박스에 입력된 URL 주소는 환경변수 URL 연결 실패 시 백업으로 사용
  - 연결 상태 및 오류 메시지 개선

- `app_device_routes.py` 파일에 새로운 기능 추가:
  - 사용자 지정 URL 저장을 위한 `custom_device_url` 변수 추가
  - URL 관리를 위한 `get_device_url()` 함수 구현
  - `/api/device/connect` 엔드포인트 추가하여 사용자 지정 URL 설정 기능 구현
  - 모든 API 엔드포인트에서 `get_device_url()` 함수를 사용하도록 업데이트

## 예정된 작업

### 1. 추가 UI 개선

- 장치 서버 URL 입력 필드에 기본 텍스트 추가 (예: "환경변수에 저장된 URL 사용, 또는 직접 입력")
- 연결 성공/실패 시 UI 피드백 개선

### 2. 오류 처리 강화

- 오류 메시지 개선 및 더 구체적인 가이드 제공
- 네트워크 오류 발생 시 자동 재시도 기능

### 3. 테스트

- 환경변수 URL 및 사용자 지정 URL 전환 테스트
- 다양한 오류 상황 시뮬레이션 및 복구 테스트

## 기술 스택

- 프론트엔드: JavaScript, HTML, CSS
- 백엔드: Flask (Python)
- 통신: RESTful API
- 장치 제어: LocalPCAgent API