# v3: GemEgg 예실관리 - CSV 데이터 파싱

## CSV 데이터 구조 분석

### 원본 파일 정보

```
파일명: gemegg_monthly_pl_2025-04_2026-03.csv
원본명: 月次推移：損益計算書_株式会社Gemegg
기간: 2025年04月〜2026年03月
단위: 円
```

### 데이터 구조

```
행 1: 타이틀
행 2: 헤더 (월 정보)
     [공백6칸] | 2025-04 | 2025-05 | ... | 2026-03 | 期間累計

행 3~: 손익계산서 항목
```

## 손익계산서 항목 분류

### 매출 섹션
```
売上高
└─ 売上高: 12,852,347円
売上高 計: 12,852,347円
```

### 매출원가 섹션
```
売上原価
└─ 売上原価: 0円
商品売上原価: 0円
```

### 판매관리비 섹션
```
販売管理費
├─ 役員報酬: 2,640,245円
├─ 給料手当: 3,914,688円
├─ 法定福利費: 1,830,146円
├─ 福利厚生費: 52,430円
├─ 広告宣伝費: 781,135円
├─ 交際費: 65,231円
├─ 会議費: 40,859円
├─ 旅費交通費: 556,389円
├─ 通信費: 243,111円
├─ 販売促進費: 1,440円
├─ 消耗品費: 288,632円
├─ 水道光熱費: 51,527円
├─ 支払手数料: 87,157円
├─ 地代家賃: 1,082,400円
├─ 租税公課: 499,370円
├─ 支払報酬料: 464,028円
└─ 雑費: 5,856円
販売管理費 計: 12,604,644円
```

### 손익 섹션
```
売上総損益金額: 12,852,347円
営業損益金額: 247,703円
経常損益金額: 247,703円
税引前当期純損益金額: 247,703円
当期純損益金額: 247,703円
```

## CSV 파싱 로직

### Node.js 구현

```javascript
import { parse } from 'csv-parse/sync';

function parseCSVData(records) {
  const monthRow = records[1]; // 2행: 월 정보
  const months = monthRow.slice(6, 18); // 2025-04 ~ 2026-03

  const data = {};

  records.forEach((row, index) => {
    if (index < 2) return; // 헤더 스킵

    // 항목명 찾기 (첫 번째 비어있지 않은 셀)
    const itemName = row.slice(0, 6).find(cell => cell?.trim());
    if (!itemName) return;

    // 월별 값 추출
    const monthlyValues = row.slice(6, 18).map(val => {
      if (!val) return 0;
      const num = parseInt(val.replace(/,/g, ''), 10);
      return isNaN(num) ? 0 : num;
    });

    data[itemName] = monthlyValues;
  });

  return data;
}
```

### 파싱 결과

```
📊 実績データを解析中...
  ✓ 売上高: 9ヶ月分のデータ
  ✓ 役員報酬: 7ヶ月分のデータ
  ✓ 給料手当: 8ヶ月分のデータ
  ✓ 法定福利費: 7ヶ月分のデータ
  ✓ 広告宣伝費: 8ヶ月分のデータ
  ✓ 地代家賃: 8ヶ月分のデータ
  ✓ 販売管理費 計: 8ヶ月分のデータ
  ✓ 営業損益金額: 9ヶ月分のデータ
  ✓ 当期純損益金額: 9ヶ月分のデータ
```

## 월별 데이터 상세

| 월 | 매출 | 판관비 | 영업이익 |
|----|------|--------|----------|
| 2025-04 | ¥1,267,940 | ¥1,459,770 | -¥191,830 |
| 2025-05 | ¥1,123,488 | ¥1,183,956 | -¥60,468 |
| 2025-06 | ¥2,098,684 | ¥2,168,075 | -¥69,391 |
| 2025-07 | ¥2,055,387 | ¥1,968,866 | ¥86,521 |
| 2025-08 | ¥1,479,307 | ¥1,748,424 | -¥269,117 |
| 2025-09 | ¥1,456,027 | ¥1,491,421 | -¥35,394 |
| 2025-10 | ¥1,828,281 | ¥1,356,284 | ¥471,997 |
| 2025-11 | ¥1,534,158 | ¥1,227,848 | ¥306,310 |
| 2025-12 | ¥9,075 | ¥0 | ¥9,075 |

## 다음 단계

v4에서는:
- 시트 레이아웃 상세 설계
- 수식 연결 구현
- 조건부 서식 적용

---

**작성일**: 2025-12-05
**상태**: 완료
**다음**: v4 - 시트 레이아웃 설계