# 프로젝트 초기 설정 작업 진행 상황 **작업 날짜**: 2025년 11월 15일 **브랜치**: 20251115-feat-setup **담당자**: PlanitAI 개발팀 --- ## 작업 개요 Gemegg 프로젝트의 초기 설정 및 문서화 작업을 진행했습니다. 제안서 분석을 바탕으로 프로젝트 요구사항을 정리하고, 웹 기반 문서 열람 환경을 구축했습니다. --- ## 완료된 작업 ### 1. 요구사항 분석 및 문서화 #### 1.1 제안서 검토 - **파일 확인** - `files/251107_GemEgg_sugestion_v1.pdf` - PlanitAI 제안서 (11페이지) - `files/line_image.png` - LINE 메시지 스크린샷 - **제안 내용 분석** - 페이즈1 (2025년 11월~12월): 기반 정비 - 경영 대시보드 구축 (freee, 회비Pay, Stripe, LINE 공식 계정, L메시지 통합) - 회계 시스템 운용 최적화 - Google Spreadsheet 기반 KPI 가시화 - 페이즈2 (2026년 1월~6월): AI 활용 사업 성장 - LINE 공식 계정 고도 운용 - AI 영회화 서비스 개발 - 멀티모달 ChatBot 개발 #### 1.2 clarify.md 작성 - **파일 경로**: `/var/www/tkim.planitai.co.jp/gemegg/clarify.md` - **내용** - 데이터 소스 관련 확인 사항 (freee, 회비Pay, Stripe, LINE 등) - 세무 및 회계 관련 확인 사항 - 대시보드 요구사항 - 기술 환경 및 인프라 - 기존 시스템 현황 - 프로젝트 관리 방안 - 비용 관련 사항 - **우선순위**: 높음/중간/낮음으로 분류 #### 1.3 todo.md 작성 - **파일 경로**: `/var/www/tkim.planitai.co.jp/gemegg/todo.md` - **내용** - 페이즈1 상세 작업 목록 - 11월: 요구사항 확정 및 설계 - GemEgg 담당 업무 (세무사 연계, 분개 완료, API 정보 제공) - PlanitAI 담당 업무 (요구사항 정리, 데이터 연계, 설계, 환경 구축) - 12월: 개발 및 구축 - 데이터 수집 시스템 구현 - 대시보드 구현 - 테스트 및 본번 환경 전개 - 페이즈2 작업 계획 - LINE 공식 계정 고도 운용 (1월) - AI 영회화 서비스 개발 (2~3월) - 멀티모달 ChatBot 개발 (3~4월) - 고도화 및 마케팅 (5~6월) ### 2. 웹 환경 구축 #### 2.1 Apache 디렉토리 리스팅 설정 - **목표**: https://tkim.planitai.co.jp/gemegg/ 접속 시 파일 목록 표시 - **작업 내용** - `.htaccess` 파일 생성 - `Options +Indexes` 설정 - `DirectoryIndex disabled` 설정 (index.html 우선순위 제거) - FancyIndexing, HTMLTable 옵션 활성화 - 파일별 설명 추가 - 특정 파일 숨김 설정 (.htaccess, index.html.bak) #### 2.2 파일 정리 및 권한 설정 - **index.html 처리** - `index.html` → `index.html.bak`으로 백업 - 디렉토리 리스팅이 우선 표시되도록 설정 - **권한 수정** ```bash chown -R www-data:www-data gemegg/ chmod 755 gemegg/ chmod 644 gemegg/*.md chmod 755 gemegg/files/ chmod 644 gemegg/files/* ``` #### 2.3 UTF-8 인코딩 문제 해결 - **문제**: .md 파일 직접 접속 시 한글 깨짐 - **원인**: Content-Type 헤더의 charset 미설정 - **해결** - `.htaccess`에 FilesMatch 규칙 추가 ```apache ForceType text/plain AddDefaultCharset UTF-8 ``` - **결과**: .md 파일 접속 시 한글 정상 표시 #### 2.4 Apache 설정 확인 - **VirtualHost 설정** - HTTP: `/etc/apache2/sites-enabled/tkim.planitai.co.jp.conf` - HTTPS: `/etc/apache2/sites-enabled/tkim.planitai.co.jp-le-ssl.conf` - **확인 사항** - `AllowOverride All` 설정 확인 - `Options Indexes` 활성화 확인 - Basic 인증 설정 확인 - autoindex 모듈 활성화 확인 --- ## 기술적 이슈 및 해결 ### 이슈 1: Forbidden 에러 - **증상**: https://tkim.planitai.co.jp/gemegg/ 접속 시 403 Forbidden - **원인**: - 파일 권한 문제 (root 소유, 600 권한) - index.html 파일 존재 - **해결**: - 소유자를 www-data로 변경 - 적절한 권한 설정 (디렉토리 755, 파일 644) - index.html을 index.html.bak으로 변경 ### 이슈 2: 파일 다운로드 시도 - **증상**: 브라우저에서 디렉토리 리스팅 대신 파일 다운로드 시도 - **원인**: DirectoryIndex가 여전히 index.html을 찾으려 함 - **해결**: `.htaccess`에 `DirectoryIndex disabled` 추가 ### 이슈 3: 브라우저 캐시 문제 - **증상**: 설정 변경 후에도 이전 상태 표시 - **해결**: 브라우저 캐시 완전 삭제 (Ctrl+Shift+Delete) ### 이슈 4: Internal Server Error - **증상**: .md 파일 UTF-8 설정 후 500 에러 - **원인**: `ForceType text/plain; charset=utf-8` 구문 오류 - ForceType은 MIME 타입만 인자로 받음 - **해결**: `ForceType text/plain`과 `AddDefaultCharset UTF-8` 분리 --- ## 생성된 파일 목록 ``` /var/www/tkim.planitai.co.jp/gemegg/ ├── .htaccess # Apache 디렉토리 리스팅 및 인코딩 설정 ├── index.html.bak # 백업된 인덱스 파일 ├── files/ │ ├── 251107_GemEgg_sugestion_v1.pdf # 제안서 │ └── line_image.png # LINE 메시지 스크린샷 └── 20251115-feat-setup/ # 2025년 11월 15일 작업 디렉토리 ├── clarify.md # 프로젝트 확인 사항 문서 ├── todo.md # 프로젝트 작업 목록 ├── kaihipay_api_usage.md # 회비페이 API 사용법 ├── stripe_api_usage.md # Stripe API 사용법 ├── freee_api_usage.md # freee API 사용법 ├── L_Message_guide.md # L Message 가이드 ├── JDL_guide.md # JDL 가이드 ├── JDL_api_usage.md # JDL 데이터 연동 구현 ├── request_from_dev_to_pm_20251115.md # PM님께 요청 사항 └── progress.md # 이 파일 ``` ### 3. API 연동 조사 및 문서화 #### 3.1 clarify.md 업데이트 - **작업 일시**: 2025-11-15 14:15 - **업데이트 내용** - freee API 관련 클라이언트 답변 반영 - API 키 및 인증 정보는 Google Sheet에 기록 - 데이터 갱신 시점 명시 (파일 오픈 시, 업데이트 버튼 클릭 시) - 과거 분개 데이터 상태 확인 필요 항목 추가 #### 3.2 회비페이 (Kaihipay) API 문서 작성 - **파일**: `kaihipay_api_usage.md` - **내용** - 회비페이 서비스 개요 및 API Reference 위치 (https://api.kaihipay.jp/api/reference/) - Google Apps Script용 샘플 코드 - 회원 정보 조회 - 결제 내역 조회 - Google Sheet 자동 저장 - 주의사항: 실제 API 사양서 확인 필요 #### 3.3 Stripe API 문서 작성 - **파일**: `stripe_api_usage.md` - **내용** - Stripe API 인증 방법 (Secret Key 사용) - Google Apps Script용 완전한 구현 코드 - 고객 목록 조회 - 결제 내역 조회 (Charges) - 구독 정보 조회 (Subscriptions) - 기간별 데이터 필터링 - Webhook 이벤트 수신 - Google Sheet 자동 저장 및 업데이트 - 주의사항: API 키 보안, Rate Limit, 금액 단위 처리 #### 3.4 freee API 문서 작성 - **파일**: `freee_api_usage.md` - **내용** - OAuth2 인증 구현 (OAuth2 라이브러리 사용) - Google Apps Script용 완전한 구현 코드 - 사업소 정보 조회 - 거래 데이터 조회 - 계정과목 조회 - 분개장 조회 - 과거 분개 상태 확인 기능 - 월차 자동 업데이트 메뉴 - OAuth2 라이브러리 설치 방법 - 주의사항: 인증 필요, Rate Limit, 사업소 ID 확인 #### 3.5 L Message (エルメッセージ) 가이드 작성 - **파일**: `L_Message_guide.md` - **내용** - L Message 서비스 개요 (https://lme.jp/) - L Message는 SaaS 도구로 직접 API 미제공 - LINE Messaging API를 통한 데이터 연동 방법 - Google Apps Script용 LINE API 샘플 코드 - 친구 프로필 조회 - 메시지 발송 - Webhook 이벤트 수신 (메시지, 친구 추가, 차단) - 리치 메뉴 관리 - CSV 내보내기를 통한 데이터 활용 - 주의사항: API 제한, 개인정보 보호 #### 3.6 JDL 가이드 작성 - **파일**: `JDL_guide.md` - **내용** - JDL 제품 개요 (https://www.jdl.co.jp/) - JDL IBEX 시리즈 소개 - API 제공 여부: 공개 REST API 미제공 - 데이터 연동 방법 - CSV 가져오기/내보내기 (주요 방법) - JDL 은행 API 서비스 - Web POSTBOX (세무사 연계) - freee에서 JDL로 데이터 이동 방법 - freee의 JDL 형식 출력 기능 - JDL 가져오기 절차 - 주의사항: 보조과목 매핑, 데이터 형식, 수동 조정 #### 3.7 JDL 데이터 연동 구현 문서 작성 - **파일**: `JDL_api_usage.md` - **내용** - JDL API 미제공 확인 - Google Apps Script로 준자동화 구현 - freee API로 데이터 조회 - JDL CSV 형식으로 변환 - Google Drive에 자동 저장 - 알림 메일 발송 - 계정과목 매핑 테이블 관리 - 월차 자동 실행 트리거 설정 - 데이터 검증 로직 - 제한사항: 수동으로 JDL 가져오기 필요 - 개선 방안: RPA 도구 활용 가능 --- ## 현재 상태 ### 접근 가능한 URL - **디렉토리 리스팅**: https://tkim.planitai.co.jp/gemegg/ - **작업 디렉토리**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/ - **제안서 PDF**: https://tkim.planitai.co.jp/gemegg/files/251107_GemEgg_sugestion_v1.pdf - **LINE 이미지**: https://tkim.planitai.co.jp/gemegg/files/line_image.png **프로젝트 문서들 (20251115-feat-setup/):** - **확인 사항**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/clarify.md - **작업 목록**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/todo.md - **PM 요청사항**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/request_from_dev_to_pm_20251115.md - **진행상황**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/progress.md **API 사용법 문서들:** - **회비페이**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/kaihipay_api_usage.md - **Stripe**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/stripe_api_usage.md - **freee**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/freee_api_usage.md - **L Message**: 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 - **JDL 연동**: https://tkim.planitai.co.jp/gemegg/20251115-feat-setup/JDL_api_usage.md **설계 문서:** - **아키텍처 보고서**: https://docs.google.com/document/d/1WTXNJAyYKDIREgD8UvxAXKnjvFJ0aeAtizGV4WfNmrI/edit?tab=t.0 - Google Sheets 기반 통합 경영 대시보드 구축 및 자동화 아키텍처 보고서 ### 인증 정보 - Basic 인증 적용 중 - 인증 후 모든 파일 접근 가능 --- ## 다음 단계 ### 즉시 필요한 작업 1. **clarify.md의 확인 사항 답변 받기** - 데이터 소스 접속 정보 - 세무사 연계 방침 확정 - 필수 KPI 목록 확정 - 기술 환경 선호도 확인 2. **GemEgg측 작업 진행 확인** - 과거 분개 완료 (10월분까지) - API 키 발급 및 제공 - Google 계정 공유 설정 3. **개발 환경 구축 시작** - 데이터베이스 선정 및 설치 - Python 개발 환경 설정 - Git 저장소 초기화 ### 11월 중 목표 - 요구사항 완전 확정 - 데이터 연계 테스트 - 대시보드 설계 승인 - 개발 환경 완료 --- ## 참고 사항 ### 프로젝트 타임라인 - **2025년 11월**: 요구사항 확정, 설계, 개발 환경 구축 - **2025년 12월**: 개발, 테스트, 본번 환경 전개 - **2026년 1월~6월**: 페이즈2 (AI 활용 기능 개발) ### 예산 - 페이즈1 (2개월): 110,000엔 (소비세 포함) - 페이즈2: 별도 견적 예정 ### 연락처 - **PlanitAI**: info@planitai.co.jp - **전화**: 070-1419-2216 --- ## 변경 이력 | 날짜 | 작업 내용 | 담당자 | |------|-----------|--------| | 2025-11-15 09:00 | 초기 문서화 및 웹 환경 구축 | PlanitAI | | 2025-11-15 14:15 | clarify.md 업데이트 (freee API 답변 반영) | PlanitAI | | 2025-11-15 14:30 | API 연동 조사 및 문서화 (6개 문서 작성) | PlanitAI | | 2025-11-15 16:00 | 디렉토리 구조 변경 (feat-setup-20251115 → 20251115-feat-setup) | PlanitAI | | 2025-11-15 16:15 | Google Sheets 기반 아키텍처 보고서 작성 | PlanitAI | | 2025-11-15 16:20 | todo.md 완료 항목 체크 및 추가 작업 항목 등록 | PlanitAI | --- **최종 업데이트 시각**: 2025-11-15 16:20 (JST) **상태**: 아키텍처 설계 진행 중, 대시보드 구현 준비 단계