Update project files

2025-08-07 16:38:53 +09:00
parent e5f0928d0a
commit 5f608d1f23
21 changed files with 2845 additions and 77 deletions
--- a/README.md
+++ b/README.md
@@ -1,3 +1,137 @@
-# AI IMAGE GENERATOR WEB MONITOR
-
-AI 이미지 생성 웹 모니터
+# AI Image Generator Web Monitor
+
+AI 이미지 생성 및 벡터 검색을 위한 웹 인터페이스
+
+## 🛠️ 설치 및 실행
+
+### 1. 환경 설정
+
+```bash
+# Python 3.8+ 필요
+conda activate eyewear
+pip install -r requirements.txt
+```
+
+### 2. 서버 실행
+
+```bash
+python src/web_server.py
+```
+
+### 3. 웹 접속
+
+```
+http://localhost:51003
+```
+
+## ⚙️ 설정 관리
+
+### API 엔드포인트 설정 (`src/common/config.py`)
+
+#### 기본 API URL(DEV3)
+
+```python
+EXTERNAL_API_URL = "http://192.168.200.233:52000/api/services/vactorImageSearch/vit/imageGenerate/imagen/data"
+```
+
+#### 사전 정의된 엔드포인트
+
+```python
+PREDEFINED_ENDPOINTS = [
+    {
+        "name": "벡터이미지 검색(Dev3/Data)",
+        "url": "http://192.168.200.233:52000/api/services/vactorImageSearch/vit/imageGenerate/imagen/data",
+        "description": "Imagen 모델을 사용한 이미지 생성후 Vector 검색 그후 결과 이미지 데이터 return"
+    },
+    {
+        "name": "벡터이미지 검색(Dev2/Data)",
+        "url": "http://192.168.200.232:51000/api/services/vactorImageSearch/vit/imageGenerate/imagen/data",
+        "description": "Imagen 모델을 사용한 이미지 생성후 Vector 검색 그후 결과 이미지 데이터 return"
+    }
+]
+```
+
+#### 서버 설정
+
+- `SERVICE_PORT`: 웹 서버 포트 (기본: 51003)
+- `HOST`: 서버 바인딩 IP (기본: "0.0.0.0")
+- `API_TIMEOUT_SECONDS`: API 타임아웃 (기본: 600초)
+- `DEBUG_MODE`: 디버그 모드 (기본: False)
+
+### 동적 API 변경 사용법
+
+1. **웹페이지 상단의 "API 설정" 클릭**
+2. **사전 정의된 버튼 선택** 또는 **커스텀 URL 입력**
+3. **실시간으로 API 연결 변경됨**
+4. **현재 사용 중인 API가 표시됨**
+
+## 🔧 API 엔드포인트
+
+### 메인 엔드포인트
+
+- `GET /` - 메인 웹 페이지
+- `POST /create` - 이미지 생성 요청
+- `GET /health` - 서버 상태 확인
+- `GET /api-status` - 외부 API 연결 상태
+
+### API 설정 엔드포인트
+
+- `GET /api-endpoints` - 사용 가능한 엔드포인트 목록
+- `POST /change-api-url` - API URL 동적 변경
+- `GET /config` - 프론트엔드 설정 정보
+
+## 📁 프로젝트 구조
+
+```
+src/
+├── common/
+│   └── config.py               # 애플리케이션 설정 (구 settings.py)
+├── config/
+│   ├── __init__.py
+│   └── app_config.py           # 통합 설정 관리
+├── services/
+│   ├── manager.py              # API 통합 관리 (구 api_manager.py)
+│   └── client.py               # 외부 API 호출 (구 image_api_service.py)
+├── static/
+│   ├── css/
+│   │   └── style.css           # CSS 스타일 (CSS 변수 사용)
+│   └── js/
+│       ├── constants.js        # 상수 정의 (구 const.js)
+│       ├── init.js             # 초기화 스크립트
+│       └── modules/
+│           ├── http.js             # HTTP 통신 (구 apiClient.js)
+│           ├── config.js           # API 설정 관리 (구 apiConfigManager.js) ⭐
+│           ├── main.js             # 메인 컨트롤러 (구 imageGenerator.js)
+│           ├── state.js            # 상태 관리 (구 stateManager.js)
+│           └── ui.js               # UI 업데이트 (구 uiManager.js)
+├── templates/
+│   └── index.html              # HTML 템플릿
+└── web_server.py               # FastAPI 웹 서버
+```
+
+## 🐛 문제 해결
+
+### 포트 충돌
+
+```bash
+# 포트 사용 확인
+netstat -an | findstr :51003
+
+# config.py에서 SERVICE_PORT 변경
+SERVICE_PORT = 51004  # 다른 포트로 변경
+```
+
+### API 연결 문제
+
+```bash
+# API 상태 확인
+curl http://localhost:51003/api-status
+
+# 또는 브라우저에서
+http://localhost:51003/api-status
+```
+
+### 개발자 도구 디버깅
+
+- **F12 → 콘솔 탭**: JavaScript 오류 및 API 호출 로그 확인
+- **네트워크 탭**: API 요청/응답 상세 분석