🚀 로스트파티 (LostParty)

🗓️ 개발 기간

• 2024.12 ~ 2025.03

🎮 프로젝트 소개

로스트파티는 게임 로스트아크에서 파티원의 닉네임을 화면 공유 및 OCR 기술을 활용해 감지하고, 이를 블랙리스트 데이터베이스와 비교하여 악성 유저 여부를 검증하고, 파티원의 아이템 정보를 가공하여 제공해주는 웹 서비스입니다.

🖼️ 데모 화면

🗂️ ERD 다이어그램

본 프로젝트에서 사용된 데이터베이스 구조는 아래의 ERD(Entity Relationship Diagram)를 통해 확인할 수 있습니다.

✨ 주요 기능

🔎 1. 닉네임 감지 (OCR)

• 화면 공유를 통해 파티원의 닉네임을 자동으로 감지합니다.
• PaddleOCR를 활용한 OCR 기술로 파티원 닉네임을 추출합니다.

📋 2. 파티원 정보 추출 (API)

• 추출된 닉네임을 통해 LOSTARK API 를 이용하여 제공받은 파티원의 캐릭터 정보를 가공하여 사용자에게 제공합니다.
• LOSTARK에서 제공한 OPENAPI를 사용합니다.

⚠️ 3. 블랙리스트 조회

• 추출된 닉네임이 블랙리스트에 등록된 유저인지 실시간으로 확인합니다.
• 등록된 데이터베이스 기반으로 조회가 가능합니다.

📋 4. 블랙리스트 등록 및 관리

• 사용자가 직접 악성 유저를 블랙리스트에 등록할 수 있습니다.
• 등록된 사용자 목록 검색 및 추가를 할 수 있습니다.

🧮 로스트파티 사용 방법

페이지	이미지	설명
메인화면		서비스의 메인화면으로, 전체적인 UI와 주요 기능을 확인할 수 있습니다.
API키 입력		API 키를 입력하여 인증을 완료하는 페이지입니다.
블랙리스트 페이지		블랙리스트 목록을 확인하고 관리할 수 있습니다.
블랙리스트 작성 및 적용		새로운 블랙리스트를 작성하고 기능을 제공합니다.
인게임 파티 구인창		게임화면을 인식하여 파티 신청자의 닉네임을 추출합니다.
파티원 정보		파티 신청자의 스펙 및 정보를 직관적으로 파악할 수 있습니다.
API 문서		로스트아크 파티 매칭 웹서비스의 API 문서입니다. 닉네임 기반 캐릭터 정보 조회, 블랙리스트 관리 기능 등을 제공합니다.

🏗️ 기술 스택

분야	기술 스택
Frontend	Next.js, TypeScript
Backend	Express.js, Nest.js
Database	MySQL
OCR	PaddleOCR
DevOps	Docker, AWS
Communication	Notion, KakaoTalk

---

📦 설치 및 실행 방법 (개발 환경)

# 1. 프로젝트 클론
git clone https://github.com/HaeSung99/lp_project.git
cd lp_project

# 2. Docker 및 Docker Compose 설치 (설치되어 있지 않은 경우)

# 3. 환경 변수 파일 작성 (.env)
# 예시: .env.dev 또는 .env.prod 파일을 프로젝트 루트에 생성

# 4. Docker Compose로 컨테이너 실행
docker-compose -f docker-compose.dev.yml up --build

🚀 배포 링크

FE (dev)	https://localhost:3000/
BE (dev)	https://localhost:5000/api-docs/

FE (prod)	https://lostparty.com (비용문제로 일시중지)
BE (prod)	비공개

👋🏻 팀원 소개

팀원	담당	프로필	주요 기여 및 핵심 역할
김도환	Python		• PaddleOCR를 활용한 텍스트 추출 로직 구현 • 화면 공유 기반 OCR 프로세스 개발 • 프론트엔드 OCR 연동 구현
최종현	FrontEnd		• 프론트엔드 전반 개발 • 프론트엔드 UI/UX 구현 및 스타일링
김재찬	BackEnd		• 사용자 인증 및 보안 강화를 위한 로그인·로그아웃 기능 구현 (실효성 검토 후 미적용)
성인석	BackEnd		• Dockerfile 작성 및 개발환경 구축 • DB 구조 설계 및 API 연동 • API 및 기능 명세서 작성 • 페이지 구성 설계 및 OpenAPI를 활용한 데이터 재가공 • 팀원 모집 및 프로젝트 관리 (노션 정리 포함)