# PM님께 요청 사항 (개발팀 → PM)

**작성일**: 2025년 11월 15일
**작성자**: 개발팀
**프로젝트**: Gemegg 경영 대시보드 구축 (페이즈1)

---

## 요청 배경

페이즈1 개발을 시작하기 위해 클라이언트로부터 다음 정보들이 필요합니다. PM님께서 클라이언트(Gemegg)와 협의하여 제공받을 수 있도록 요청드립니다.

---

## 1. API 키 및 인증 정보 (최우선)

### 1.1 freee API

**필요한 정보:**
- Client ID
- Client Secret
- 사업소ID

**제공 방법:**
- Google Sheet의 'API_Config' 시트에 기록
- 또는 안전한 방법으로 개발팀에 전달

**참고:**
- freee Developers (https://developer.freee.co.jp/) 에서 앱 등록 후 발급
- Callback URL: `https://script.google.com/macros/d/{SCRIPT_ID}/usercallback`
  (Script ID는 개발 시 제공 예정)

### 1.2 회비Pay (Kaihipay)

**필요한 정보:**
- API Key
- API Secret (있는 경우)

**참고:**
- 회비페이에 문의하여 API 접근 권한 및 사양서 요청 필요
- API Reference: https://api.kaihipay.jp/api/reference/

### 1.3 Stripe

**필요한 정보:**
- Secret Key (sk_live_... 또는 sk_test_...)

**참고:**
- Stripe Dashboard > Developers > API keys에서 확인 가능
- 테스트 환경: sk_test_... 사용
- 본번 환경: sk_live_... 사용

### 1.4 LINE 공식 계정

**필요한 정보:**
- Channel ID
- Channel Secret
- Channel Access Token

**참고:**
- LINE Developers Console (https://developers.line.biz/console/)
- LINE Official Account Manager에서 Messaging API 설정 필요

### 1.5 L메시지 (Lメッセージ)

**확인 필요:**
- L메시지 계정 정보
- LINE 공식 계정과의 연동 상태 확인
- 데이터 추출 방법 (CSV 내보내기 가능 여부)

**참고:**
- L메시지는 별도 API가 없으므로 LINE Messaging API 사용
- 또는 L메시지 관리 화면에서 CSV 내보내기

---

## 2. Google Workspace 설정

### 2.1 Google Sheet 준비

**요청 사항:**
- 프로젝트용 Google Sheet 생성
- 개발팀 계정에 편집 권한 부여
- 클라이언트 계정에 열람 권한 부여

**필요한 시트:**
- API_Config (API 키 저장용)
- FreeeDeals (freee 거래 데이터)
- StripeCharges (Stripe 결제 데이터)
- StripeSubscriptions (Stripe 구독 데이터)
- KaihipayPayments (회비페이 결제 데이터)
- LineMessages (LINE 메시지 데이터)
- LineFriends (LINE 친구 데이터)
- AccountMapping (계정과목 매핑)
- Dashboard (통합 대시보드)

### 2.2 Google Apps Script 권한

**요청 사항:**
- Google Apps Script 실행 권한
- 외부 서비스 접근 권한 (UrlFetchApp 사용)
- OAuth2 라이브러리 설치 권한

---

## 3. 세무 및 회계 관련 확인

### 3.1 세무사 연계 방침

**확인 필요 사항:**
- 세무사와의 연계 방침이 확정되었는가?
- freee 계속 사용에 대한 세무사 동의 여부
- freee에서 JDL로의 데이터 전달 주기
  - 제안: 월 1회 (익월 10일까지)
- 세무사가 JDL을 사용하는가?

**관련 문서:**
- 제안서 5페이지: "freee 계속 사용 추천"
- JDL_guide.md: freee → JDL 데이터 이동 방법

### 3.2 과거 분개 완료 일정

**확인 필요 사항:**
- 10월분까지의 분개를 11월말까지 완료 가능한가?
- 분개 담당자는 누구인가?
- 분개 완료 상태를 freee API로 확인 가능한가?

**중요성:**
- 11월 중 과거 분개 완료 시 12월부터 정상적인 대시보드 운영 가능
- 미완료 시 데이터 정확도에 영향

### 3.3 월차 분개 운용 규칙

**확인 필요 사항:**
- 당월분을 익월 10일까지 분개 완료 - 실행 가능한가?
- 분개 담당자 교육이 필요한가?
- 분개 업무 프로세스 문서화 필요 여부

---

## 4. 기존 시스템 및 데이터 현황

### 4.1 생도 관리 시스템

**확인 필요 사항:**
- 현재 생도 관리 시스템이 있는가?
- 있다면 어떤 시스템인가? (Excel, 전용 소프트웨어 등)
- 데이터 추출 가능 여부
- 데이터 형식 및 항목

### 4.2 예약 시스템

**확인 필요 사항:**
- 현재 예약 시스템이 있는가?
- 예약 데이터를 대시보드에 통합할 필요가 있는가?
- 데이터 연동 방법

### 4.3 LINE 운용 현황

**확인 필요 사항:**
- LINE 공식 계정 사용 현황
- 현재 태그 운용 방법
- 월 메시지 발송량
- 자동 응답 설정 여부

---

## 5. 대시보드 요구사항

### 5.1 필수 KPI 우선순위

**확인 필요 사항:**
클라이언트가 가장 중요하게 생각하는 KPI 순서 (1~10위)

**예시 KPI:**
- 월 매출
- 신규 고객 수
- 기존 고객 유지율
- 해약률
- 평균 객단가
- LINE 친구 수
- 메시지 응답률
- 예약률
- 출석률
- 현금 흐름

**요청:**
- 위 항목 중 우선순위 5개 선정
- 추가 희망 KPI가 있으면 제시

### 5.2 데이터 갱신 주기

**확인 필요 사항:**
- 실시간 vs 일별 vs 월별 갱신 중 선호 방식
- 각 데이터 소스별 갱신 주기
  - freee: 제안 - 파일 오픈 시 + 업데이트 버튼
  - Stripe: 제안 - 일 1회 자동
  - 회비Pay: 제안 - 일 1회 자동
  - LINE: 제안 - 파일 오픈 시 + 업데이트 버튼

### 5.3 대시보드 접근 권한

**확인 필요 사항:**
- 대시보드를 열람할 사용자 목록
  - 사장님
  - 경리 담당자
  - 기타
- 각 사용자의 권한 수준 (열람만 vs 편집 가능)
- Google 계정 주소

---

## 6. 기술 환경

### 6.1 서버 및 호스팅

**확인 필요 사항:**
- 현재 서버 환경 활용 (tkim.planitai.co.jp) - 문서 열람용만
- 추가 서버나 클라우드 서비스 필요 여부
- 예산 제약 사항

### 6.2 보안 및 개인정보

**확인 필요 사항:**
- 개인정보 보호 정책 확인
- API 키 관리 방법 (Google Sheet vs 별도 보안 저장소)
- 데이터 백업 주기 및 방법
- 데이터 보존 기간

---

## 7. 프로젝트 관리

### 7.1 커뮤니케이션

**요청 사항:**
- 정기 미팅 주기 설정 (제안: 주 1회)
- 연락 수단 확정 (이메일, LINE, Slack 등)
- 긴급 연락 방법
- 작업 진행 보고 주기

### 7.2 일정

**확인 필요 사항:**
- 11월 마일스톤:
  - 데이터 연계 작업 완료 목표일: 11월 25일?
  - 대시보드 설계 승인 목표일: 11월 30일?
- 12월 마일스톤:
  - 테스트 환경 구축 목표일: 12월 10일?
  - 본번 환경 전개 목표일: 12월 20일?

### 7.3 산출물 확인

**확인 필요 사항:**
- 중간 산출물 확인 희망 여부
- 프로토타입 또는 목업 필요 여부
- 최종 인수 기준

---

## 8. 비용 관련

### 8.1 추가 비용 예상

**클라이언트 확인 필요:**
- Google Workspace 유료 플랜 필요 여부
  - 무료 Google 계정으로 충분할 수 있음
  - 단, 고급 기능이나 용량이 필요하면 유료 전환
- API 이용료
  - freee: API 사용료 확인
  - Stripe: 메시지 종량제
  - LINE: 월 무료 메시지 한도 확인
- 서버/호스팅 비용 (필요 시)

**예상 월 비용:**
- API 이용료: 미정 (클라이언트 사용량에 따라)
- Google Workspace: 0~수천엔 (플랜에 따라)
- 기타: 0원

---

## 9. 즉시 필요한 정보 (우선순위 1)

다음 항목은 개발 시작을 위해 **11월 20일까지** 필요합니다:

### 필수 정보
1. freee API 키 (Client ID, Client Secret, 사업소ID)
2. Stripe API Secret Key
3. Google Sheet 접근 권한
4. 세무사 연계 방침 확정 여부
5. 필수 KPI 5개 선정

### 확인 사항
1. 10월분 분개 완료 예정일
2. 월차 분개 운용 규칙 실행 가능 여부
3. 정기 미팅 일정

---

## 10. 향후 필요한 정보 (우선순위 2)

다음 항목은 **11월 말까지** 확인이 필요합니다:

1. 회비Pay API 키 및 사양서
2. LINE 공식 계정 Channel 정보
3. L메시지 계정 정보
4. 생도 관리 시스템 현황
5. 대시보드 접근 권한자 목록
6. 데이터 갱신 주기 확정

---

## 11. 참고 문서

클라이언트에게 제공 가능한 문서:

1. **clarify.md**: 전체 확인 사항 목록
   - https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/clarify.md

2. **todo.md**: 전체 작업 목록
   - https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/todo.md

3. **API 사용법 문서**: 각 API별 상세 설명
   - freee: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/freee_api_usage.md
   - Stripe: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/stripe_api_usage.md
   - 회비Pay: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/kaihipay_api_usage.md
   - LINE/L메시지: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/L_Message_guide.md
   - JDL: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/JDL_guide.md

---

## 12. 요청 정리

### PM님께 부탁드리는 사항

1. **이 문서를 클라이언트용으로 정리하여 전달**
   - 필요 시 더 간략하게 요약 가능
   - 우선순위에 따라 단계별 요청 가능

2. **즉시 필요한 정보 (섹션 9) 우선 확보**
   - 11월 20일까지 필수

3. **정기 미팅 일정 조율**
   - 제안: 매주 금요일 오전

4. **질문이나 불명확한 사항 피드백**
   - 클라이언트가 이해하기 어려운 부분
   - 추가 설명이 필요한 항목

---

## 13. 개발팀 연락처

**질문이나 확인 사항이 있으시면:**
- 이메일: [개발팀 이메일]
- 연락처: [개발팀 연락처]

**문서 작성자:**
- 개발팀 (PlanitAI)
- 작성일: 2025년 11월 15일

---

## 부록: API 키 제공 템플릿

클라이언트가 API 키를 제공할 때 사용할 수 있는 Google Sheet 템플릿:

| 항목 | 값 | 비고 |
|------|-----|------|
| freee Client ID | | freee Developers에서 발급 |
| freee Client Secret | | freee Developers에서 발급 |
| freee 사업소ID | | freee 관리 화면에서 확인 |
| Stripe Secret Key | | Stripe Dashboard > API keys |
| 회비Pay API Key | | 회비페이에 문의 |
| LINE Channel ID | | LINE Developers Console |
| LINE Channel Secret | | LINE Developers Console |
| LINE Access Token | | LINE Developers Console |

**보안 주의사항:**
- API 키는 절대 공개하지 마세요
- 이메일로 전송 시 암호화된 첨부파일 사용
- 또는 안전한 파일 공유 서비스 사용