README.md

블록체인을 사용한 NFT 스포츠 티켓 예매 및 후원 서비스, S:tickey

삼성 청년 소프트웨어 아카데미 특화 프로젝트 최우수상 수상 🏆

SSAFY 특화 PJT TEAM 올록블록

목차

1. 웹 서비스 소개
2. 기술 스택
3. 주요 기능
4. 프로젝트 구성도
5. 서비스 화면
6. 개발 팀 소개
7. 개발 기간 및 일정
8. 디렉터리 구조
9. 산출물

✨ 웹 서비스 소개

S:tickey는 프로 스포츠 경기 정보를 제공하여 경기를 티켓팅하고 관리하는 서비스입니다.
S:tickey를 사용하여 프로 스포츠를 즐기는 국내 관람객들에게 암표 거래가 불가능한 공정한 티켓(NFT) 구매 및 사용 환경을 제공합니다.
또한 블록체인 네트워크에 결제 내역과 후원 내역을 저장하여 투명하게 관리합니다.

S:tickey 바로 가기 (서비스 종료)

🛠️ 기술 스택

Frontend

HTML5	CSS3	React	Typescript	Tailwind CSS

React Query	Zustand	Eslint	Stomp js	Axios

Prettier	Vite	Web3js

Backend

Java	Spring	Hibernate	Stomp js	Redis

Swagger	JWT	Spring security	MySQL

BlockChain

Solidity	Truffle	Ganache	Open zeppelin

DevOps

AWS	Docker	Nginx	Jenkins

Tools

Notion	Gitlab	Jira	Mattermost

💡 주요 기능

기능	내용
스포츠 경기 조회	서비스에 등록된 축구, 야구, 농구 경기를 조회하고 해당 경기에 대한 정보를 확인하고 티켓팅할 수 있습니다.
티켓팅	좌석 선점, 대기열, 참가열 기능을 구현하여 사용자에게 원할한 티켓팅 환경을 제공합니다.
알림 서비스	선호 구단을 등록하고, 해당 구단의 경기 예매가 시작되기 전 알림을 받을 수 있습니다. 단체 회원의 경우 회원가입과 후원 글 승인에 대해서 알림을 받을 수 있습니다.
블록체인 결제	이용자가 등록한 메타마스크 지갑과 서비스를 연결하여 티켓을 결제하거나 후원 글에 후원합니다. 구매한 티켓은 NFT로 관리되며 예매에 대한 보상으로 일정량의 Token '꿈' 을 지급합니다.
후원	단체 회원이 후원 글을 작성하고 관리자에게 승인 받은 후원 글에 대해 서비스 사용자는 블록체인 결제를 통해 해당 글에 후원을 하고 이력을 남길 수 있습니다.
티켓 꾸미기	구매한 티켓에 대하여 사용자는 자신이 가진 Token '꿈'을 지불해 티켓을 꾸밀 수 있습니다.
블록체인 조회	블록체인을 통해 이루어진 활동을 기록하여 조회합니다. (결제 내역, 환불 내역, 꿈 내역, 가진 티켓 조회)

📂 프로젝트 구상도

🖥️ 서비스 화면

회원가입	메인 화면

경기 목록	예매 대기열	좌석 선택

결제 완료	티켓 목록	티켓 환불

티켓 꾸미기	티켓 조회

후원	결제 내역	꿈 내역

👨🏻‍💻 개발 팀 소개

FE	FE	FE / Blockchain	BE	BE	BE / INFRA
최민경	강정수	전찬혁	윤희원	최부광	류지윤

🗓️ 개발 기간 및 일정

24.02.19. ~ 24.04.04

📂 디렉터리 구조

Front-end

STICKEY-FRONTEND
📂 src
├─apis
├─assets
│  └─image
│      ├─Carousel
│      ├─Category
│      ├─Ground
│      └─NavigationBar
├─components
│  ├─@common
│  ├─Admin
│  ├─Alarm
│  ├─Book
│  ├─ChangePW
│  ├─FindPW
│  ├─Home
│  ├─Login
│  ├─MyTicket
│  ├─Profile
│  │  ├─Group
│  │  └─User
│  │      ├─Dream
│  │      └─Payment
│  ├─Signup
│  ├─Soccer
│  └─Sponsor
├─hooks
│  ├─Admin
│  ├─Book
│  ├─ChangePW
│  ├─Email
│  ├─FindPW
│  ├─Home
│  ├─Individual
│  ├─Logout
│  ├─Organization
│  ├─Profile
│  └─Sponsor
├─pages
│  ├─Admin
│  ├─Alarm
│  ├─Book
│  │  ├─BookConfirm
│  │  └─BookDetail
│  ├─Home
│  │  ├─BaseBall
│  │  ├─BasketBall
│  │  └─Soccer
│  ├─Login
│  ├─MyTicket
│  │  └─TicketEdit
│  ├─Profile
│  │  ├─Group
│  │  └─User
│  ├─SignUp
│  ├─Splash
│  └─Sponsor
│      ├─SponsorCreatePage
│      └─SponsorDetailPage
├─service
│  ├─Admin
│  ├─Book
│  ├─ChangePW
│  ├─Email
│  ├─FindPW
│  ├─Home
│  ├─IndividualUser
│  ├─Login
│  ├─Logout
│  ├─OrganizationUser
│  ├─Profile
│  ├─Sponsor
│  └─web3
├─stores
└─types
    └─model

Back-end

STICKEY-MAIN
📂 main
├─java
│  └─com
│      └─olbl
│          └─stickeymain
│              ├─domain
│              │  ├─admin
│              │  │  ├─controller
│              │  │  ├─dto
│              │  │  ├─entity
│              │  │  ├─repository
│              │  │  └─service
│              │  ├─game
│              │  │  ├─controller
│              │  │  ├─dto
│              │  │  ├─entity
│              │  │  ├─repository
│              │  │  ├─scheduler
│              │  │  └─service
│              │  ├─notify
│              │  │  ├─controller
│              │  │  ├─dto
│              │  │  ├─entity
│              │  │  ├─repository
│              │  │  └─service
│              │  ├─support
│              │  │  ├─controller
│              │  │  ├─dto
│              │  │  ├─entity
│              │  │  ├─repository
│              │  │  └─service
│              │  └─user
│              │      ├─controller
│              │      ├─dto
│              │      ├─entity
│              │      ├─organization
│              │      │  ├─controller
│              │      │  ├─dto
│              │      │  ├─entity
│              │      │  ├─repository
│              │      │  └─service
│              │      ├─repository
│              │      └─service
│              └─global
│                  ├─auth
│                  ├─config
│                  ├─jwt
│                  ├─result
│                  │  └─error
│                  │      └─exception
│                  └─util
└─resources
    ├─static
    └─templates

STICKEY-WAITING
📂 main
├─java
│  └─com
│      └─olbl
│          └─stickeywaiting
│              ├─config
│              ├─controller
│              ├─dto
│              ├─service
│              └─util
└─resources
    ├─static
    └─templates

📃 산출물

1. 기능 명세서

2. 화면 설계서

3. API 명세서

4. ERD