저장소: octxxiii/gladiatalk 🗡️ Words are your weapons, wisdom your shield - Real-time debate platform with enhanced security

🗡️ GladiaTalk

Words are your weapons, wisdom your shield

글래디에이터 정신으로 토론의 아레나에서 지혜를 겨루는 플랫폼

🌟 프로젝트 개요

GladiaTalk은 실시간 토론과 투표를 통해 지혜를 겨루는 소셜 플랫폼입니다. 사용자들은 다양한 주제에 대해 두 가지 선택지 중 하나를 선택하고, 실시간으로 토론하며 투표를 변경할 수 있습니다.

✨ 주요 기능

• 🔥 실시간 토론: 활발한 토론 환경에서 지혜를 겨루세요
• 🗳️ 투표 시스템: 두 가지 선택지 중 하나를 선택하고 중간에 변경 가능
• 🏆 실시간 랭킹: 챔피언 랭킹 시스템으로 경쟁을 즐겨보세요
• 💰 토론 경제: 토론 코인으로 가시성을 높이고 특별한 기능을 해금
• 🛡️ 안전한 환경: AI 모더레이션과 커뮤니티 가이드라인
• 📱 크로스 플랫폼: 웹, 모바일, 관리자 패널 지원

🏗️ 기술 스택

Backend

• Fastify: 고성능 웹 프레임워크
• tRPC: 타입 안전한 API
• Prisma: 데이터베이스 ORM
• PostgreSQL: 메인 데이터베이스
• Redis: 캐싱 및 실시간 기능
• WebSocket: 실시간 통신

Frontend

• Next.js: 웹 애플리케이션 (PWA)
• React Native: 모바일 애플리케이션
• Tailwind CSS: 스타일링
• TypeScript: 타입 안전성

DevOps & Security

• Docker: 컨테이너화
• Nginx: 리버스 프록시
• Prometheus + Grafana: 모니터링
• Helmet: 보안 헤더
• Rate Limiting: API 보호
• Fail2ban: 무차별 대입 방지

🚀 빠른 시작

필수 요구사항

• Node.js 18+
• npm 또는 yarn
• Docker (선택사항)
• PostgreSQL
• Redis

설치 및 실행

1. 저장소 클론

git clone https://github.com/yourusername/gladiatalk.git
cd gladiatalk

2. 의존성 설치

npm install

3. 환경 변수 설정

cp .env.development .env
# .env 파일을 편집하여 데이터베이스 설정을 구성하세요

4. 데이터베이스 설정

npm run db:generate
npm run db:push
npm run db:seed

5. 개발 서버 시작

npm run dev

Docker를 사용한 실행

# 개발 환경
docker-compose -f docker-compose.dev.yml up

# 프로덕션 환경
docker-compose -f docker-compose.prod.yml up

📁 프로젝트 구조

gladiatalk/
├── apps/
│   ├── web/                 # Next.js 웹 애플리케이션
│   ├── mobile/             # React Native 모바일 앱
│   ├── admin/              # 관리자 패널
│   └── server/             # Fastify API 서버
├── packages/
│   ├── api/                # tRPC API 정의
│   ├── db/                 # Prisma 스키마 및 마이그레이션
│   ├── ui/                 # 공유 UI 컴포넌트
│   └── proto/              # 공유 타입 정의
├── scripts/
│   ├── security-setup.sh   # 보안 설정 스크립트
│   ├── environment-setup.sh # 환경 설정 스크립트
│   └── test-automation.sh  # 테스트 자동화 스크립트
├── nginx/                  # Nginx 설정
├── monitoring/             # 모니터링 설정
└── docs/                   # 문서

🛡️ 보안

GladiaTalk은 엔터프라이즈급 보안을 제공합니다:

시스템 보안

• 방화벽 설정 (UFW)
• SSH 보안 강화
• Fail2ban 무차별 대입 방지
• 정기 보안 업데이트

애플리케이션 보안

• Rate Limiting
• CORS 정책
• 보안 헤더 (Helmet)
• 입력값 검증
• SQL Injection 방지
• XSS/CSRF 방지

모니터링

• 실시간 로그 모니터링
• 보안 이벤트 알림
• 성능 모니터링
• 백업 시스템

📊 모니터링

Prometheus와 Grafana를 사용한 종합 모니터링:

• API 응답 시간
• 오류율 추적
• 시스템 리소스 사용량
• 사용자 활동 분석
• 보안 이벤트 모니터링

🔧 개발 가이드

코드 스타일

• TypeScript 사용
• ESLint + Prettier
• 커밋 메시지 컨벤션
• PR 리뷰 필수

테스트

# 전체 테스트 실행
npm run test

# 테스트 커버리지
npm run test:coverage

# E2E 테스트
npm run test:e2e

배포

# 프로덕션 빌드
npm run build

# Docker 이미지 빌드
docker build -t gladiatalk .

# 배포 스크립트 실행
./scripts/deploy.sh

📈 성능 최적화

• Redis 캐싱
• 데이터베이스 인덱싱
• CDN 사용
• 이미지 최적화
• 코드 스플리팅

🤝 기여하기

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📄 라이선스

이 프로젝트는 MIT 라이선스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

📞 연락처

• 프로젝트 링크: https://github.com/yourusername/gladiatalk
• 이슈 리포트: https://github.com/yourusername/gladiatalk/issues

🙏 감사의 말

• Fastify - 고성능 웹 프레임워크
• tRPC - 타입 안전한 API
• Next.js - React 프레임워크
• Tailwind CSS - CSS 프레임워크
• Prisma - 데이터베이스 ORM

---

GladiaTalk - 지혜의 아레나에서 당신의 무기를 휘두르세요! ⚔️