🌠 포티(Poti)

원하는 굿즈만 쏙 덕후들을 하나로 잇는 공간

🔢 목차

프로젝트 설명
서비스 목표
주요 기능
아키텍쳐
기술 및 아키텍쳐 선정
컨벤션 규칙 및 브랜치 전략
팀원별 역할 분담
폴더링

🎥 프로젝트 설명

포티는 원하는 멤버만 선택해 구매하고 싶은 덕후를 위한, 맞춤형 굿즈 공동구매 서비스입니다.

🎤 서비스 목표

• 흩어진 분철 정보와 불투명한 참여 현황을 필터 기능과 거래 상태바로 정리해, 원하는 분철을 빠르고 투명하게 참여할 수 있도록 돕는 서비스

📍 주요 기능

1. 최애 기반 온보딩 : 최애 아티스트를 수집합니다. 사용자의 최애 아티스트가 반영된 추천 컨텐츠를 노출시킵니다.
   

2. 홈 : 추천 알고리즘에 기반해 사용자의 최애에 기반한 굿즈를 추천받고, 하루마다 바뀌는 랜덤 굿즈를 확인합니다.
   

3. 굿즈 리스트 : 원하는 굿즈의 분철팟만 깔끔하게 모아보고, 자신의 기준에 맞춰 필터링된 분철팟을 탐색합니다.
   

4. 분철팟 상세 : 분철팟에 대한 상세 정보를 확인합니다. 또 모집자의 모집 내역과 리뷰 등의 정보를 확인해 신뢰도를 제고하여 안전한 거래를 가능하게 만듭니다.
   

5. 분철 참여 : 간단한 정보 입력만으로 원하는 분철에 참여합니다.
   

6. 분철팟 등록 : 표준화된 등록 과정으로 고민없이 분철팟 등록이 가능합니다.
   

⚙️ 시스템 아키텍쳐

⚙️ 기술 및 아키텍처 선정

• Backend Core
  
• Language - Java 21 (LTS)
  
• Framework - Spring Boot 3.5.9
  
• Data & Persistence
  
• Database - MySQL 8.4.3
  
• ORM - Spring Data JPA
  
• Query - QueryDSL 5.0
  
• Infrastructure & Performance
  
• Cache - Redis (ElastiCache)
  
• Storage - AWS S3 (Presigned URL)
  
• Web Server - Nginx
  
• CI/CD - Docker Compose, GitHub Actions
  
• Image Build - Jib
  
• Monitoring - Dozzle
  
• AI & External Service
  
• AI - OpenAI API
  
• Alert - Discord Webhook
  

❗ 컨벤션 규칙 및 전략

컨벤션: Convention
협업 전략 & 그라운드 룰: Branch Strategy

👤 팀원별 역할 분담

임채륜	박시현
분철 관리자 기타	유저 참여자 후기

🗂️ 폴더링

DDD의 핵심 철학인 Bounded Context를 반영하여 도메인형 패키지 구조를 채택했습니다.

src/main/java/org/sopt/poti
├── 📂 global                  # 공통 커널 & 횡단 관심사
│   ├── config                 # 설정 (Security, QueryDSL, Redis)
│   ├── common                 # 공통 응답/유틸 (ApiResponse, BaseEntity)
│   ├── error                  # 예외 처리 (GlobalExceptionHandler)
│   ├── external               # 인프라 계층 (Infrastructure Layer)
│   │   ├── s3                 # AWS S3 구현체
│   │   ├── discord            # Discord Webhook 구현체
│   │   └── kakao              # Kakao OAuth 구현체
│   └── security               # 인증/인가 (JwtFilter, UserPrincipal)
│
├── 📂 domain                  # 핵심 비즈니스 로직
│   ├── 📂 user                # [회원] 도메인 컨텍스트
│   │   ├── controller         # (Interfaces) 요청 처리
│   │   ├── service            # (Application) 유즈케이스 구현
│   │   └── entity             # (Domain) User 엔티티
│   │
│   ├── 📂 groupbuy            # [분철 모집] 도메인 컨텍스트
│   │   ├── controller
│   │   ├── service            # 상태 변경 로직 오케스트레이션
│   │   ├── repository         # (Infrastructure) 데이터 접근
│   │   └── entity             # GroupBuyPost(Root), GroupBuyOption
│   │
│   ├── 📂 order               # [주문] 도메인 컨텍스트
│   │   ├── service            # 입금 확인 로직
│   │   └── entity             # Order(Root), OrderItem
│   │
│   ├── 📂 delivery            # [배송] 도메인 컨텍스트
│   │   └── entity             # Delivery
│   │
│   ├── 📂 artist              # [아티스트] 도메인 컨텍스트
│   │   └── entity             # Artist, Member
│   │
│   └── 📂 auth                # [인증] 도메인 컨텍스트
│       ├── controller
│       └── service
│
└── PotiApplication.java