🛒 OneStop Docs

OneStop 프로젝트의 설계 문서, 정책 문서, API 명세, ERD, 테스트 및 기술 검증 문서를 관리하는 문서 저장소입니다.

OneStop은 쿠팡형 커머스와 판매자 입점형 마켓플레이스를 결합한 하이브리드 이커머스 플랫폼으로, 대규모 트래픽 환경에서의 정합성 보장과 확장 가능한 아키텍처 설계를 목표로 개발되었습니다.

---

📄 핵심 문서

문서	설명
서비스 정책	도메인별 서비스 정책 및 비즈니스 규칙
팀 협업 정책	Git 전략, 코드 리뷰, 브랜치 운영 정책
ERD 설계	데이터베이스 구조 및 관계 설계
API 명세	REST API 명세
도메인 설계	도메인별 설계 문서
비즈니스 플로우	주요 업무 흐름 및 상태 전이
시퀀스 다이어그램	도메인별 시퀀스 다이어그램
ADR	기술 의사결정 기록
성능 검증	부하 테스트 및 성능 검증
테스트 문서	테스트 케이스 및 테스트 전략

---

🚀 핵심 구현 포인트

1. Kafka + Transactional Outbox

• Outbox 패턴 기반 이벤트 발행
• Kafka 비동기 메시징 적용
• 이벤트 유실 방지
• 주문 · 포인트 · 쿠폰 · 알림 이벤트 처리

2. 동시성 제어

• Redis Distributed Lock
• 비관적 락(Pessimistic Lock)
• 낙관적 락(Optimistic Lock)

비즈니스 특성에 따라 적절한 동시성 제어 전략 적용

3. AI Shopping Assistant

• Spring AI Tool Calling
• 상품 검색 API 연동
• 재고 조회 API 연동
• 구조화 출력(JSON Response)

4. AI 리뷰 요약

• 상품 리뷰 자동 요약
• 장점 / 단점 분석
• 구매 추천 정보 생성

5. SSE 실시간 알림

• 주문 상태 변경
• 배송 상태 변경
• 쿠폰 지급
• 포인트 적립

6. Scheduler 기반 자동 처리

• 구독 자동 갱신
• 구독 만료 처리
• 포인트 만료 처리
• 쿠폰 만료 처리

---

🗂️ 문서 구조

documents
├── api
├── architecture
├── business-flow
├── domainDesign
├── erd
├── finOps
├── incidentResponse
├── meetings
├── milestone
├── performanceVerfication
├── policy
├── sequence
├── test
└── troubleshooting

---

🚨 트러블슈팅

구분	설명
팀 트러블슈팅	프로젝트 진행 중 발생한 기술 문제 해결 기록
개인 트러블슈팅	팀원별 문제 해결 및 학습 기록

---

📝 회의록

프로젝트 진행 과정의 의사결정과 논의 내용을 기록합니다.

• 회의록 바로가기

---

📊 운영 및 품질 관리 문서

문서	설명
FinOps	비용 최적화 전략
Incident Response	장애 대응 및 운영 절차
Milestone	프로젝트 일정 및 마일스톤
Test	테스트 케이스 및 커버리지

---

🧠 핵심 기술 키워드

Spring Boot Spring Security JWT Redis Kafka QueryDSL Transactional Outbox Distributed Lock Resilience4j Spring AI AWS EC2 Google Gemini K6 DDD Modular Monolith

---

📅 프로젝트 기간

2026.05.11 ~ 2026.06.24

• Milestone

---

👥 팀원

이름	역할	담당 도메인
정은지	팀장 / DevOps / AI	Admin, Infrastructure, AI
김예은	부팀장 / 문서 관리 / 백엔드 개발	Delivery, Review, Subscription
임호진	백엔드 · 프론트엔드 개발	Auth, User, Seller, Security, Point
정지훈	백엔드 개발 / 테스트	Order, Cart, Payment, Coupon, Point
이중현	백엔드 · 프론트엔드 개발	Product, Category, Search

📌 문서 관리 기준

• 코드와 문서를 분리하여 관리합니다.
• 정책, API, ERD 변경 시 관련 문서를 함께 업데이트합니다.
• ADR을 통해 주요 기술 의사결정 이력을 관리합니다.
• 트러블슈팅은 문제 상황, 원인, 해결 방법, 결과를 기준으로 작성합니다.
• 회의록은 프로젝트 의사결정 이력을 기록하는 용도로 관리합니다.

---

⚖️ License

This documentation is licensed under the MIT License.

See the LICENSE file for details.