Google Apps Script를 활용한 통장 입출금 조회 자동화

프로젝트명: gas_pjt (Google Apps Script Project)
목표: 각 사용자가 자신의 은행 거래내역을 실시간으로 조회하고,
      자동으로 개인 구글 드라이브에 저장하는 모바일 앱 개발

┌─────────────────────────────────────────────────────────┐
│            Google Apps Script                           │
│  - 액션 라우팅 (Code.gs)                               │
│  - CODEF API 연동 (CODEF.gs)                           │
│  - 구글 시트 관리 (SheetManager.gs)                    │
│  - 유틸리티 함수 (Utils.gs)                            │
└────┬─────────────────────────────────────────────────┬──┘
     │                                                  │
     │ REST API                                   Google API
     │                                                  │
┌────▼──────────────────┐                    ┌────────▼──────┐
│   CODEF API           │                    │ Google Sheets │
│ (은행 거래내역)       │                    │ (사용자별)    │
│                       │                    │               │
│ - 실명계좌 인증       │                    │ - 데이터 조회   │
│ - 거래내역 조회       │                    │ - 데이터 격리 │
└───────────────────────┘                    └───────────────┘

웹페이지 → Apps Script → CODEF API → 은행 시스템
             ↓
         응답 수신
             ↓
웹페이지 ← Apps Script ← 구글 시트 저장 ← 데이터 처리

로그인 정보를 서버에 저장하면?
- 해킹 위험
- 규제 준수 어려움
- 사용자의 신뢰 획득 어려움

은행/계좌 정보는 사용자의 로컬 디바이스에만 저장
→ 서버에 민감한 정보 저장 안 함

배포 설정:
- 실행 주체: "나로 실행"
  → Apps Script가 사용자 권한으로 실행
  → 각 사용자의 드라이브에만 접근 가능
  → 데이터 자동 격리 (사용자 신뢰 획득)

- Apps Script는 사용자 권한으로만 실행
- 중앙(통합) 데이터베이스 없음
- 각 사용자의 드라이브에만 접근

주요 기능:
- HTTP 요청 라우팅
- 액션별 핸들러 분기
- 에러 처리 및 로깅
- JSON 응답 포맷팅

구현된 액션:
- fetchTransactions: 은행 거래내역 조회
- loadTransactions: 저장된 내역 불러오기
- getSheetUrl: 사용자 시트 URL 반환

핵심 기능:
- CODEF API 토큰 발급
- 인증 토큰 캐싱 (효율성)
- 계좌 거래내역 조회
- API 에러 처리

보안 설정:
- 스크립트 속성으로 클라이언트 ID/Secret 관리
- 토큰을 메모리에만 저장 (로그 기록 안 함)
- API 응답 검증

1. 토큰 요청 → CODEF 서버
2. 액세스 토큰 획득 → 캐시
3. 계좌 거래내역 요청 → Bearer 토큰 사용
4. JSON 응답 파싱 → 앱에 반환

핵심 기능:
- 사용자별 구글 시트 생성
- 거래내역 자동 저장
- 중복 데이터 필터링
- 시트 URL 생성

설계 원칙:
- 각 사용자 = 별도 시트 (데이터 격리)
- 자동 생성 및 관리 (사용자 개입 없음)
- 구글 네이티브 기능 활용 (내보내기, 공유 등)

기능:
- 로깅 함수
- JSON 응답 생성
- 타임스탬프 처리
- 에러 메시지 포맷팅

// SheetManager.gs에서 중복 감지
function filterDuplicateTransactions(newTransactions, existingData) {
  const transactionIds = new Set();

  // 기존 데이터의 ID 수집
  existingData.forEach(row => {
    transactionIds.add(row[0]); // 거래 고유ID
  });

  // 새 거래 중 중복 제거
  return newTransactions.filter(tx => {
    return !transactionIds.has(tx.transactionId);
  });
}

// SheetManager.gs에서 자동 생성
function createOrGetSheet() {
  const userEmail = Session.getActiveUser().getEmail();
  const fileName = `입출금현황_${userEmail}_${new Date().getTime()}`;

  // 기존 시트가 있는지 확인
  const folders = DriveApp.getFoldersByName('입출금현황');
  if (folders.hasNext()) {
    const folder = folders.next();
    return folder; // 기존 폴더 사용
  }

  // 없으면 새로 생성
  const spreadsheet = SpreadsheetApp.create(fileName);
  const sheet = spreadsheet.getActiveSheet();

  // 헤더 추가
  sheet.appendRow(['거래일자', '적요', '입금액', '출금액', '잔액']);

  return spreadsheet;
}