# AI 어시스턴트 메뉴 등록 가이드 (VEXPLOR)

AI 어시스턴트는 **VEXPLOR와 같은 서비스/같은 포트**로 동작합니다.  
프론트는 `/api/ai/v1` 로 호출하고, backend-node가 AI 서비스(기본 3100 포트)로 프록시합니다.

## 서비스 기동

- **AI API**: `ERP-node/ai-assistant` 에서 `npm install` 후 `npm start` (포트 3100)
- **backend-node**: `npm run dev` (8080)
- **frontend**: `npm run dev` (9771)

별도 포트/도메인 설정 없이 브라우저에서는 **localhost:9771** 만 사용하면 됩니다.

---

## VEXPLOR 메뉴 URL 목록 (전체 탑재)

대메뉴 예: **AI 서비스** / **AI**  
소메뉴는 아래 표의 **메뉴명**과 **URL**로 등록하면 됩니다. (메뉴명에 "AI", "어시스턴트", "챗봇", "LLM" 포함 시 사이드바에 Bot 아이콘 표시)

### 일반 메뉴

| 메뉴명       | URL (메뉴 관리에 입력할 값)   |
|-------------|-------------------------------|
| AI 채팅     | /admin/aiAssistant/chat       |
| 대시보드    | /admin/aiAssistant/dashboard  |
| API 키 관리 | /admin/aiAssistant/api-keys   |
| API 테스트  | /admin/aiAssistant/api-test   |
| 내 사용량   | /admin/aiAssistant/usage       |
| 대화 이력   | /admin/aiAssistant/history    |
| 설정        | /admin/aiAssistant/settings    |

### 관리자 메뉴

| 메뉴명           | URL (메뉴 관리에 입력할 값)        |
|------------------|------------------------------------|
| 사용자 관리      | /admin/aiAssistant/admin/users     |
| LLM 관리         | /admin/aiAssistant/admin/providers  |
| LLM 사용량 통계  | /admin/aiAssistant/admin/usage-stats |

---

## 등록 순서 예시

1. **대메뉴**: 메뉴명 `AI 서비스`, URL은 비우거나 `#` (자식만 사용할 경우)
2. **소메뉴**: 위 표에서 필요한 것만 추가
   - 예: 메뉴명 `대시보드`, URL `/admin/aiAssistant/dashboard`
   - 예: 메뉴명 `API 키 관리`, URL `/admin/aiAssistant/api-keys`

이렇게 등록하면 VEXPLOR 사이드바에서 각 메뉴 클릭 시 해당 AI 어시스턴트 화면이 열립니다.