# v1: 프로젝트 소개 및 Node.js/TypeScript 환경 설정

안녕하세요! 이번 블로그 시리즈에서는 회계 서비스인 **Freee**의 데이터를 **Google Sheets**로 가져오고, **Vertex AI (Gemini)** 를 사용하여 데이터를 분석 및 가공한 후, 다시 Google Sheets에 업데이트하는 자동화 스크립트를 TypeScript로 처음부터 만들어보는 과정을 다룹니다.

총 10개의 파트로 나누어 진행되며, 이번 첫 번째 파트에서는 프로젝트의 목표를 이해하고 개발에 필요한 Node.js 및 TypeScript 환경을 설정합니다.

## 사전 준비물

시작하기 전에, 컴퓨터에 [Node.js](https://nodejs.org/) (npm 포함)가 설치되어 있어야 합니다.

## 1단계: Node.js 프로젝트 초기화

먼저, 프로젝트를 위한 디렉토리를 생성하고 해당 디렉토리에서 다음 명령어를 실행하여 Node.js 프로젝트를 시작합니다. `package.json` 파일이 생성되며, 이 파일은 프로젝트의 정보와 의존성을 관리합니다.

```bash
npm init -y
```

## 2단계: TypeScript 및 관련 라이브러리 설치

TypeScript를 사용하기 위해 필요한 라이브러리들을 개발용 의존성(`--save-dev`)으로 설치합니다.

- `typescript`: TypeScript 컴파일러
- `ts-node`: TypeScript 코드를 컴파일 과정 없이 바로 실행해주는 도구
- `@types/node`: Node.js의 타입 정의를 제공

```bash
npm install typescript @types/node ts-node --save-dev
```

## 3단계: TypeScript 설정 파일 생성

다음 명령어를 실행하여 TypeScript 설정 파일인 `tsconfig.json`을 생성합니다.

```bash
npx tsc --init
```

생성된 `tsconfig.json` 파일에서, 필요에 따라 아래와 같이 몇 가지 옵션을 수정하거나 주석을 해제할 수 있습니다. 예를 들어, 컴파일된 JavaScript 파일이 저장될 `outDir`과 소스 코드 위치인 `rootDir`을 지정할 수 있습니다.

```json
{
  "compilerOptions": {
    "target": "es2016",
    "module": "commonjs",
    "outDir": "./dist",
    "rootDir": "./src",
    "strict": true,
    "esModuleInterop": true
  }
}
```

## 4단계: 환경 변수 관리를 위한 `dotenv` 설치

API 키와 같은 민감한 정보를 코드에서 분리하여 관리하기 위해 `dotenv` 라이브러리를 설치합니다.

```bash
npm install dotenv
```

이 라이브러리는 `.env` 파일에 저장된 환경 변수를 코드에서 `process.env` 객체를 통해 접근할 수 있게 해줍니다.

## 5단계: 기본 파일 구조 생성

프로젝트의 기본 구조를 아래와 같이 설정합니다. 우리는 이미 `.env` 파일을 만들었고, 이제 소스 코드를 담을 `src` 디렉토리와 그 안에 `index.ts` 파일을 생성했습니다.

```
/20251126-googlesheet-vertexai-freee-script
|-- /src
|   |-- index.ts
|-- .env
|-- package.json
|-- tsconfig.json
```

---

여기까지 프로젝트의 기본적인 뼈대를 완성했습니다. 다음 **v2** 포스트에서는 Google Sheets API에 연결하기 위한 인증 설정을 진행하겠습니다.