Skip to content

hohoyoungyoung/gomoku

 
 

Repository files navigation

오목 AI 웹사이트

사용자와 인공지능(AI)이 브라우저 상에서 실시간으로 오목 대결을 펼칠 수 있는 웹 애플리케이션입니다. 단순한 룰 기반 오목부터, 학습형 AI에 이르기까지 다양한 난이도로 사용자의 전략적 사고를 자극합니다.


🎯 프로젝트 목표

  • 사용자가 웹 브라우저에서 오목 AI와 대국할 수 있는 웹사이트를 개발합니다.
  • 오목의 가장 기본 규칙인 5개의 돌을 가로, 세로, 또는 대각선으로 연속으로 놓으면 승리하는 방식만 따릅니다. 다른 규칙(렌주룰, 금지수 등)은 적용하지 않습니다.

✨ 주요 기능

🎮 사용자 인터페이스

  • 직관적인 19x19 오목판 UI (마우스 클릭으로 돌 착수)
  • 게임 상태 표시 (마지막 착수 위치, 승패 결과)
  • 다시하기 / 홈 버튼
  • AI 난이도 선택 옵션 제공
  • 사용자 커스텀 알고리즘 등록 기능 (Pull Request 기반)

🤖 오목 AI

  • 난이도별 AI 착수 전략 제공:
    • 쉬움: 랜덤 착수
    • 보통: 미니맥스 알고리즘
    • 어려움: 사용자의 착수 기록을 학습해 수를 두는 동적 학습형 AI

🌐 웹사이트 구조

  • 프론트엔드: React 기반 UI / 인터랙션 중심 구성
  • 백엔드: Flask Framework를 활용한 AI 로직 및 게임 상태 관리
  • 데이터베이스: MySQL을 통한 사용자 기록 또는 학습 데이터 저장
  • 클라이언트-서버 구조 기반 REST API 통신

🧠 사용자 알고리즘 커스터마이징 지원

사용자가 자신만의 착수 알고리즘을 구현하고 Pull Request로 제출할 수 있습니다.

자세한 내용은 CONTRIBUTING.md를 참고하세요.


🧱 기술 스택

  • Frontend: React.js, HTML/CSS/JS
  • Backend: Flask (Python)
  • Database: MySQL

📅 개발 일정

👉 Notion 타임라인 보러가기


🛠️ 향후 개발 계획

  • PvP 모드 구현 (사용자 간 실시간 대전)
  • 사용자 계정 및 전적 저장 기능
  • 리더보드, AI 대전 랭킹 시스템
  • UI/UX 개선 및 모바일 최적화

📄 프로젝트 문서 및 가이드

👉 전체 기술 문서 보러가기

REST API 명세, 설치 가이드 등 상세 내용은 위 링크에서 확인하세요.


🔗 사용해보기

(배포 URL 예정)

GIT READY TO PLAY

About

Gomoku AI platform with user-contributed bots

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 45.7%
  • JavaScript 37.5%
  • Jupyter Notebook 10.3%
  • CSS 5.4%
  • Mako 0.5%
  • HTML 0.3%
  • Other 0.3%