🏆 KTB-21-Amazing | 내 손으로 만드는 나만의 스토리 미로 게임

KTB-21-Amazing은 사용자가 직접 만들어가는 미로 게임 프로젝트입니다.
플레이어가 선택한 정보에 따라 세계관과 NPC가 동적으로 생성되며, 매번 새로운 경험을 제공합니다.

🚀 이 프로젝트는 GitHub Actions + AWS CodeDeploy를 사용하여 자동화된 배포 시스템을 구축하였습니다.

---

📌 프로젝트 개요

🎯 목표

• 내가 상상한 대로 스토리가 진행되는 미로 게임
• 내가 원하는 방식으로 NPC와 상호작용 가능
• 매번 새로운 환경과 선택지를 제공하여 몰입감 극대화

🕹 게임 플레이 방식

1. 사용자 입력 → 플레이어가 이름, 직업, 분위기, 장소 등을 입력
2. 세계관 생성 → AI가 해당 정보를 기반으로 게임 환경을 동적으로 생성
3. NPC 상호작용 → NPC의 퀴즈를 풀며 진행 (+30초 / -30초)
4. 미로 탈출 도전 → 제한 시간 내 탈출해야 성공!

---

🏗 기술 스택

🎮 프론트엔드

• React.js + Phaser.js → 미로 게임 UI 및 상호작용 구현
• TypeScript → 정적 타입 시스템 적용
• Axios → 백엔드 API 통신

⚙️ 백엔드

• FastAPI → API 서버 개발
• GPT API / DALL·E API / LangChain → AI 기반 게임 콘텐츠 생성

☁️ 클라우드 & 배포

• AWS EC2 → 서버 인프라 호스팅
• AWS CodeDeploy + GitHub Actions → CI/CD 자동화

---

👨‍💻 Members

FrontEnd	Backend	AI	AI	Cloud	Cloud
Jina	Jelly	Milo	Sophie	Mello	Hannah

---

🗺️ 아키텍처

---

📂 리포지토리 구성

리포지토리	설명
fe	프론트엔드 (React + Phaser.js)
be	백엔드 (FastAPI + AI API)

---

🚀 배포 자동화 (CI/CD)

이 프로젝트는 GitHub Actions 및 AWS CodeDeploy를 활용하여 자동으로 배포됩니다.

🔄 배포 프로세스

1. GitHub에 코드 푸시 → main 브랜치 푸시 시 자동 트리거
2. GitHub Actions 실행 → 테스트 및 빌드 수행
3. AWS CodeDeploy 배포 → EC2 서버에 자동 업데이트

---

🎮 게임 시작하기

1. 프론트엔드 실행

   git clone https://github.com/KTB-21-Amazing/fe.git
   cd fe
   npm install
   npm start

2. 백엔드 실행

   git clone https://github.com/KTB-21-Amazing/be.git
   cd be
   pip install -r requirements.txt
   uvicorn main:app --host 0.0.0.0 --port 8000

---

🤝 기여 방법

• Issue 등록 → 버그나 개선점을 이슈로 남겨주세요.
• Pull Request → 기능을 추가하고 싶다면 PR을 제출해주세요.

---

📧 문의

• GitHub Discussions: 프로젝트 Q&A
• 이메일: ktb@example.com