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