Skip to content

Commit 6ad9912

Browse files
docs : readme.md 작성 (#28)
* Update README.md --------- Co-authored-by: crocusia <132359536+crocusia@users.noreply.github.com>
1 parent 7d3514a commit 6ad9912

3 files changed

Lines changed: 89 additions & 2 deletions

File tree

README.md

Lines changed: 89 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,89 @@
1-
# nullnullTicket
2-
내일배움캠프 티케팅사이트만들기(2025.05.16~2025.05.26)
1+
# NullNull Ticket
2+
3+
인터파크 티켓을 벤치마킹한 **웹 기반 티켓 예매 서비스**입니다.
4+
사용자는 공연 정보를 조회하고 원하는 좌석을 직접 선택하여 예매할 수 있으며,
5+
관리자는 공연장, 공연 및 회차 정보를 등록 및 관리할 수 있습니다.
6+
7+
## 주요 기능
8+
9+
### 사용자 기능
10+
- 공연 조회 및 회차 확인
11+
- 좌석 선택 및 티켓 예매
12+
- 예매 내역 조회 및 취소
13+
- 카카오 소셜 로그인
14+
15+
### 관리자 기능
16+
- 공연장 및 공연 등록
17+
- 공연 회차 관리
18+
- 좌석 정보 등록 및 수정
19+
20+
### 시스템 특징
21+
- 동시성 제어: 낙관적 락(`@Version`)으로 안정적인 좌석 예매
22+
- 캐싱 전략: Redis로 공연 정보 캐싱, 조회수 초기화 스케줄링
23+
- 대기열 관리: Redis ZSet 기반 큐 시스템
24+
- CI 자동화: GitHub Actions로 빌드 및 테스트 자동화
25+
26+
---
27+
28+
## 와이어프레임
29+
-![와이어 프레임](images/wireframe.png)
30+
31+
---
32+
33+
## ERD & API 명세
34+
-![ERD](images/erd.png)
35+
36+
-[API 명세서](https://www.notion.so/teamsparta/6-1e52dc3ef51480adbe2cc285458c44e2#1e52dc3ef514818e9226ed34c1f3563d)
37+
38+
---
39+
40+
## 기술 스택
41+
42+
| 항목 | 사용 기술 |
43+
|------------|-----------|
44+
| Backend | Spring Boot, JPA, Spring Security |
45+
| DB | MySQL |
46+
| Cache | Redis |
47+
| CI/CD | GitHub Actions |
48+
| Auth | JWT, Kakao OAuth |
49+
50+
---
51+
52+
## 시연 영상
53+
[시연 영상 보기](#)
54+
55+
---
56+
57+
## 트러블슈팅 요약
58+
59+
### 1. 동시성 제어
60+
- 문제: 같은 좌석을 여러 사용자가 동시에 예매할 경우 충돌
61+
- 해결: Redisson 기반 분산락 + AOP 적용
62+
63+
### 2. Redis 캐싱 최적화
64+
- 문제: 공연/회차 조회시 성능 저하
65+
- 해결: Redis 캐시 도입 → 조회 시간 75% 단축
66+
67+
---
68+
69+
## 팀원 소개
70+
71+
| 이름 | 역할 |
72+
|--------|------|
73+
| 오동원 | 결제 시스템, CI 환경 구축 |
74+
| 임지윤 | 인증/인가, 소셜 로그인 |
75+
| 김채진 | 예매 로직 및 데이터 관리 |
76+
| 이희망 | 캐싱, 공연 조회 API |
77+
| 이수빈 | 좌석 및 회차별 좌석 상태, 예매 시스템 |
78+
79+
---
80+
81+
## 프로젝트 기간
82+
2025.05.16 ~ 2025.05.26
83+
84+
---
85+
86+
## Contact
87+
- Email: hello@nullnullticket.com
88+
- Notion, Figma, Wiki 등 협업 자료 링크: [공유 필요 시 추가]
89+

images/erd.png

139 KB
Loading

images/wireframe.png

3.25 MB
Loading

0 commit comments

Comments
 (0)