# Jacode 사용자 가이드

이 문서는 Jacode 플랫폼의 일반 사용자를 위한 가이드입니다. 프로젝트 생성부터 AI 코드 생성 기능 활용까지 개발 워크플로우 전반을 다룹니다.

## 1. 시작하기

### 로그인 및 대시보드

Jacode에 로그인하면 메인 대시보드로 이동합니다. 대시보드에서는 다음을 확인할 수 있습니다.

- **최근 프로젝트**: 최근에 작업한 프로젝트 목록
- **시스템 상태**: AI 서비스 연결 상태 및 주요 지표
- **활동 로그**: 최근 수행된 작업 내역

### 프로젝트 생성

새로운 프로젝트를 시작하려면:

1. 대시보드 우측 상단의 **"+ 새 프로젝트"** 버튼을 클릭합니다.
2. 프로젝트 이름과 설명을 입력합니다.
3. 프로젝트가 생성되면 자동으로 에디터 화면으로 이동합니다.

---

## 2. 에디터 사용법 (Editor)

Jacode의 에디터는 VS Code와 유사한 사용자 경험을 제공하는 Monaco Editor를 기반으로 합니다.

### 파일 탐색기

- 좌측 사이드바에서 프로젝트의 파일 트리를 볼 수 있습니다.
- 파일/폴더 생성, 이름 변경, 삭제가 가능합니다.
- 파일을 클릭하면 메인 에디터 영역에 열립니다.

### 코드 편집

- **구문 강조 (Syntax Highlighting)**: 주요 프로그래밍 언어를 지원합니다.
- **자동 완성**: 기본적인 코드 자동 완성을 지원하며, AI가 추가적인 제안을 제공할 수 있습니다.
- **미니맵**: 긴 코드의 개요를 우측에서 확인할 수 있습니다.

---

## 3. AI 기능 활용 (AI Features)

Jacode의 핵심 기능인 AI 코딩 어시스턴트를 활용하는 방법입니다.

### AI 채팅 (Chat)

우측 패널의 'Chat' 탭에서 AI와 대화하며 코딩 도움을 받을 수 있습니다.

- **질문하기**: "이 함수가 무슨 역할을 해?", "React로 로그인 폼 만들어줘" 등 자연어로 질문하세요.
- **컨텍스트 인식**: 현재 열려있는 파일을 자동으로 인식하여 더 정확한 답변을 제공합니다.
- **코드 삽입**: 채팅에서 생성된 코드는 'Insert' 버튼으로 에디터 커서 위치에 바로 삽입할 수 있습니다.

### AI 코드 생성 (Generate)

복잡한 기능을 구현할 때 AI 생성 툴을 사용하세요.

1. 우측 패널의 **Create/Edit** 탭을 선택합니다.
2. **프롬프트 입력**: 구현하고자 하는 기능을 설명합니다. (예: "JWT 인증 미들웨어 작성해줘")
3. **설계 확인 (Blueprint)**: AI가 먼저 구현 계획(Blueprint)을 제시합니다. 내용을 확인하고 수정할 수 있습니다.
4. **코드 생성**: 계획을 승인하면 AI가 실제 코드를 생성합니다.
5. **Diff 보기 & 적용**: 생성된 코드를 기존 코드와 비교(Diff View)하여 변경 사항을 확인한 후 적용(Apply)하거나 거절(Reject)할 수 있습니다.

### 인라인 힌트 & 품질 검사

- 에디터 내에서 문제가 있는 코드나 개선이 필요한 부분에 물결 밑줄이나 전구 아이콘이 표시될 수 있습니다.
- AI가 제안하는 리팩토링이나 버그 수정을 확인하고 적용하세요.

---

## 4. 단축키 (Shortcuts)

- `Ctrl + S`: 저장
- `Ctrl + P`: 파일 빠른 열기
- `Ctrl + Shift + F`: 전체 검색
- `Ctrl + '`: 터미널 열기/닫기 (지원 예정)

## 5. 문제 해결

- **AI 응답이 느린 경우**: 복잡한 작업이나 네트워크 상태에 따라 시간이 소요될 수 있습니다. 상단 상태 표시줄의 로딩 인디케이터를 확인하세요.
- **에러 발생**: 우측 하단의 알림 메시지를 확인하고, 문제가 지속되면 관리자에게 문의하세요.