> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sifi.life/llms.txt
> Use this file to discover all available pages before exploring further.

# Genie Code Vibe 워크샵

Databricks 환경에서 **Genie Code**와 **AI Dev Kit**을 활용한 Vibe Coding 실습 워크샵입니다.

실제 제품 IoT 데이터 구조를 기반으로, 자연어 프롬프트만으로 데이터 파이프라인부터 AI 에이전트까지 End-to-End로 구축합니다.

> **학습 트랙**: 이 워크샵은 **Genie Code (Track C)** 전용입니다. 모든 실습을 Genie Code Agent Mode로 진행합니다.

### 핸즈온 케이스

| 케이스          | 특징                        | 추천 대상                 | 섹션                                                |
| ------------ | ------------------------- | --------------------- | ------------------------------------------------- |
| **Smart TV** | 텔레메트리 로그 17테이블, 250만건     | TV/미디어 도메인, 사용자 행동 분석 | [Section 4](section-4-smart-tv-handson/01-setup)  |
| **가전 IoT**   | 공기청정기+에어컨 센서 17테이블, 220만건 | 가전/IoT 도메인, 센서 데이터 분석 | [Section 5](section-5-appliance-handson/01-setup) |

> **어떤 케이스를 선택해야 하나요?** 두 케이스의 기술 난이도와 실습 내용은 동일합니다. 소속 조직이나 관심 도메인에 맞는 것을 선택하세요. 확실하지 않으면 **Smart TV**를 추천합니다 (범용적인 텔레메트리 패턴).

### 시작 전 확인

| 경험 수준                | 추천 경로                                                       |
| -------------------- | ----------------------------------------------------------- |
| **Genie Code 처음**    | Section 1 (완전 가이드) → Section 2 → Section 3 → Section 4 or 5 |
| **Genie Code 경험 있음** | Section 3 (환경 구성) → Section 4 or 5 바로 시작                    |

### 타임테이블

* [풀데이 (7시간)](timetable-fullday) — Section 1\~3 + 핸즈온 전체
* [반나절 (4시간)](timetable-halfday) — 핵심 요약 + 핸즈온 집중

***

## 워크샵 구성

### Section 1: Genie Code 완전 가이드

[Genie Code 완전 가이드](section-1-vibe-coding-intro/genie-code/) — 프롬프트 5대 원칙, 꿀팁 20가지, 상황별 템플릿

### Section 2: AI Builder App 배포

[AI Builder App 배포 핸즈온](section-2-ai-builder-app/) — git clone부터 앱 배포, 서비스 프린시펄 권한까지

### Section 3: AI 도구 환경 구성

[AI 도구 환경 구성](section-3-ai-tools-setup/) — 비용 통제 → Claude Code 사용 → AI Dev Kit 설치 → Genie Code 연결

| 단계                                                            | 핵심 메시지                            |
| ------------------------------------------------------------- | --------------------------------- |
| [AI Gateway](section-3-ai-tools-setup/ai-gateway)             | 비용을 통제하면서 AI 도구를 도입할 수 있다         |
| [Claude Code](section-3-ai-tools-setup/claude-code)           | 이 환경에서 Claude Code를 안전하게 쓸 수 있다   |
| [AI Dev Kit 설치](section-3-ai-tools-setup/ai-dev-kit-setup)    | MCP 서버 + Skills로 Databricks를 확장한다 |
| [Genie Code 연결](section-3-ai-tools-setup/genie-code-aidevkit) | 노트북 안에서도 크로스 프로덕트 작업이 가능해진다       |

### Section 4: Smart TV E2E 핸즈온

| 모듈                                                                      | 내용                                                  |
| ----------------------------------------------------------------------- | --------------------------------------------------- |
| [01. 환경 설정](section-4-smart-tv-handson/01-setup)                        | 카탈로그/스키마 생성, Custom Instructions 설정                 |
| [02. 가상 데이터 생성](section-4-smart-tv-handson/02-data-generation)          | Smart TV OS TV 로그 기반 17테이블 250만건                    |
| [03. SDP 파이프라인](section-4-smart-tv-handson/03-sdp-pipeline)             | 데이터 품질, Medallion Architecture, 증분 처리, Expectations |
| [04. 대시보드 & Genie Space](section-4-smart-tv-handson/04-dashboard-genie) | 대시보드 3개, Genie Space 3개, 정확도 고도화                    |
| [05. 에이전트 개발](section-4-smart-tv-handson/05-agent-development)          | KA + Genie Agent + Supervisor Agent + Lakebase(선택)  |

### Section 5: 가전 IoT (공기청정기 + 에어컨) E2E 핸즈온

| 모듈                                                                       | 내용                                                 |
| ------------------------------------------------------------------------ | -------------------------------------------------- |
| [01. 환경 설정](section-5-appliance-handson/01-setup)                        | 카탈로그/스키마 생성, Custom Instructions 설정                |
| [02. 공기청정기 데이터 생성](section-5-appliance-handson/02-air-purifier-data)     | PuriCare IoT 센서 8테이블 — PM2.5, 필터, 에너지              |
| [03. 에어컨 데이터 생성](section-5-appliance-handson/03-air-conditioner-data)    | DUALCOOL/WHISEN IoT 센서 9테이블 — 온도, 컴프레서, 정비         |
| [04. SDP 파이프라인](section-5-appliance-handson/04-sdp-pipeline)             | 가전 IoT 데이터 Medallion Architecture, 데이터 품질          |
| [05. 대시보드 & Genie Space](section-5-appliance-handson/05-dashboard-genie) | 대시보드 3개, Genie Space 3개, 가전 도메인 고도화                |
| [06. 에이전트 개발](section-5-appliance-handson/06-agent-development)          | KA + Genie Agent + Supervisor Agent + Lakebase(선택) |

***

## 사전 요구사항

| 항목                   | 요구사항                             | 확인 방법                                 |
| -------------------- | -------------------------------- | ------------------------------------- |
| Databricks Workspace | Premium 이상, Unity Catalog 활성화    | 워크스페이스 URL 접속 후 로그인 가능 여부             |
| 컴퓨트                  | 서버리스 컴퓨트(Serverless) 접근 권한       | 노트북에서 Compute → "Serverless" 선택 가능 여부 |
| Genie Code           | Agent Mode 활성화                   | 노트북 우측 상단 Genie Code 아이콘이 보이는지        |
| 리전                   | 서울리전 기본, US리전 사용 가능 (Lakebase 등) | 관리자에게 문의                              |

> **처음 Databricks를 접하시는 분**: 걱정하지 마세요! 이 워크샵은 모든 작업을 **Genie Code Agent Mode**로 자연어 프롬프트만으로 진행합니다. SQL이나 Python을 직접 작성할 필요가 없습니다.

***

## 다루는 Databricks 핵심 기능

| #  | 기능                                       | 공식 문서                                                                                                         |
| -- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| 1  | **Unity Catalog**                        | [docs.databricks.com/unity-catalog](https://docs.databricks.com/en/data-governance/unity-catalog/index.html)  |
| 2  | **Delta Lake**                           | [docs.databricks.com/delta](https://docs.databricks.com/en/delta/index.html)                                  |
| 3  | **SDP (Lakeflow Declarative Pipelines)** | [docs.databricks.com/delta-live-tables](https://docs.databricks.com/en/delta-live-tables/index.html)          |
| 4  | **AI/BI Dashboard**                      | [docs.databricks.com/dashboards](https://docs.databricks.com/en/dashboards/index.html)                        |
| 5  | **AI/BI Genie**                          | [docs.databricks.com/genie](https://docs.databricks.com/en/genie/index.html)                                  |
| 6  | **Vector Search**                        | [docs.databricks.com/vector-search](https://docs.databricks.com/en/generative-ai/vector-search.html)          |
| 7  | **Agent Bricks**                         | [docs.databricks.com/agent-bricks](https://docs.databricks.com/en/generative-ai/agent-bricks/index.html)      |
| 8  | **Model Serving**                        | [docs.databricks.com/model-serving](https://docs.databricks.com/en/machine-learning/model-serving/index.html) |
| 9  | **Databricks Apps**                      | [docs.databricks.com/apps](https://docs.databricks.com/en/dev-tools/databricks-apps/index.html)               |
| 10 | **Lakebase** (선택)                        | [docs.databricks.com/database](https://docs.databricks.com/en/database/index.html)                            |
| 11 | **Genie Code**                           | [docs.databricks.com/genie-code](https://docs.databricks.com/en/genie-code/index.html)                        |
| 12 | **AI Dev Kit**                           | [github.com/databricks-solutions/ai-dev-kit](https://github.com/databricks-solutions/ai-dev-kit)              |

***

## 참고 리소스

| 주제                             | URL                                                                                                        |
| ------------------------------ | ---------------------------------------------------------------------------------------------------------- |
| Genie Code + MCP 연결 가이드        | [docs.databricks.com/genie-code/mcp](https://docs.databricks.com/aws/en/genie-code/mcp)                    |
| AI Dev Kit GitHub              | [github.com/databricks-solutions/ai-dev-kit](https://github.com/databricks-solutions/ai-dev-kit)           |
| Genie Code 공식 문서               | [docs.databricks.com/genie-code](https://docs.databricks.com/en/genie-code/index.html)                     |
| Genie Code 프롬프트 팁              | [docs.databricks.com/genie-code/tips](https://docs.databricks.com/en/genie-code/tips.html)                 |
| Genie Code Custom Instructions | [docs.databricks.com/genie-code/instructions](https://docs.databricks.com/en/genie-code/instructions.html) |
| Genie Code Skills              | [docs.databricks.com/genie-code/skills](https://docs.databricks.com/en/genie-code/skills.html)             |
| Genie Code MCP 연결              | [docs.databricks.com/genie-code/mcp](https://docs.databricks.com/en/genie-code/mcp.html)                   |
