# 프로젝트 진행 프롬프트 기록

## 프로젝트: Google Sheet 재무 대시보드 자동 생성

### 프롬프트 #1: 프로젝트 시작 및 전략 수립

```
오늘의 작업디렉토리는 20251201-create-google-sheet-financial-dashboard 입니다.
작업디렉토리를 만들고 오늘의 작업을 시작합시다.

google sheet 의 doc id 를 parameter로 주면, 이 google sheet에 적당히 재무분석을
하는 dashboard를 작성하는 script 를 만드는 블로그를 작성하려고 한다.

이 여정을 create-google-sheet-financial-dashboard-v1.md ~ *-v10.md 로 단계를
나누어 기록하려고 한다.

전략을 세워라.

적당한 dummy data를 csv로 작성도 필요하다.

AI가 필요하면 vertex AI를 사용한다.
vertex AI 의 설정이 필요하면 /var/www/tkim.planitai.co.jp/blog/20251130-post-money-forward-vertex-ai
의 내용을 참조하라.
```

**결과:**
- strategy.md 작성
- v1~v10 블로그 시리즈 구조 설계
- 더미 데이터 설계

---

### 프롬프트 #2: 차트 시각화 확장 요청

```
차트 시각화에 여러가지 다양한 컴포넌트를 두고 싶다.
차트 시각화를 3개의 버전을 두고 진행해봐.
즉 v12까지 진행해줘
```

**결과:**
- v8: 트렌드 차트 (LINE, AREA, COLUMN, STACKED BAR)
- v9: 비율 차트 (PIE, DONUT, COMBO, WATERFALL)
- v10: KPI 위젯 (SPARKLINE, Gauge, Heatmap, Scorecard, Progress Bar)
- v11: AI 인사이트
- v12: CLI 완성

---

### 프롬프트 #3: 순차 실행 요청

```
v10 까지 순차로 진행해줘
```

**결과:**
- v1~v10 블로그 마크다운 파일 생성
- 모든 TypeScript 소스 코드 생성

---

### 프롬프트 #4: 계속 진행 요청 (v11~v12)

```
네 계속 진행해줘
```

**결과:**
- v11 블로그 및 insights/writer.ts 생성
- v12 블로그 및 index.ts, orchestrator.ts 생성

---

### 프롬프트 #5: 테스트 실행 요청

```
실행해 봅시다.
test용 google sheet의 doc id 는 1v84f3Hk0Wv26sxjuA-nSV7K1MTcS0LVJUDjb-9xfgiY 입니다.
```

**결과:**
- npm 의존성 설치
- 서비스 계정 키 설정
- 권한 오류 발생

---

### 프롬프트 #6: 서비스 계정 권한 부여 확인

```
gemegg@spatial-cargo-456805-u2.iam.gserviceaccount.com 를 편집자로 추가했습니다.
구글 문서 url은 https://docs.google.com/spreadsheets/d/1v84f3Hk0Wv26sxjuA-nSV7K1MTcS0LVJUDjb-9xfgiY/edit?usp=sharing 입니다.
```

**결과:**
- Dashboard 시트 생성 성공
- 12종 차트 + 5종 KPI 위젯 생성
- 9.44초 소요

---

### 프롬프트 #7: Dashboard2 (일본어 종스크롤) 요청

```
dashboard가 잘 만들어 졌는데, 옆으로 많이 생성되어서 횡 스크롤을 해야 합니다.
종 스크롤만 할 수 있도록 배치를 바꾸어 dashboard2 sheet 를 추가해주세요.
여기는 일본어로 작성해주세요.
일본어 폰트도 meiryo 등을 사용해서 professional 하게 추가해주세요
```

**결과:**
- dashboard2/creator.ts 생성
- create-dashboard2.ts 생성
- Dashboard2 시트 생성 (일본어, Meiryo 폰트, 종스크롤 전용)
- 4.88초 소요

---

### 프롬프트 #8: 진행 상황 기록 요청

```
좋습니다. 기록디렉토리에 progress.md 를 업데이트 해주세요.
또 지금까지의 prompts 들을 prompts.md 에 기록해주세요
```

**결과:**
- progress.md 생성
- prompts.md 생성 (현재 문서)

---

## 기술 스택

- **언어**: TypeScript
- **런타임**: Node.js
- **API**: Google Sheets API v4
- **AI**: Vertex AI (Gemini)
- **인증**: Google Service Account (JWT)

## 주요 학습 포인트

1. Google Sheets API batchUpdate로 차트 생성
2. SPARKLINE, REPT 함수로 셀 내 위젯 구현
3. 조건부 서식(gradientRule)으로 히트맵 구현
4. 일본어 폰트(Meiryo) 적용 방법
5. 종스크롤 전용 대시보드 레이아웃 설계

---

**작성일**: 2025-12-01