아그작(agzak)

하루 운세를 보고 끝나는 것이 아니라,
오늘의 운세를 “강화하고 수집하고 공유하는” 운세 경험 서비스 아그작(agzak) 입니다.

운세 검사 및 공유, 오븐 미니게임, 포춘쿠키 수집, 포춘쿠키 선물, 운세 통계/달력, 랭킹까지 한 번에 제공합니다.

---

1. 프로젝트 개요

• 프로젝트명: 아그작(agzak)
• 한 줄 설명: AI 기반 운세 검사 + 운세 강화 게임 + 포춘쿠키 수집 서비스 + 운세 상호작용 경험(랭킹, 선물, 결과 공유)
• 진행 기간: 2025.10.10 ~ 2025.1.20 (약 6주)
• 진행 형태: SSAFY 13기 2학기 자율 프로젝트
• 팀명: 달려라 마조리카
• 배포 주소: https://www.agzak.co.kr

---

2. 목차

1. 프로젝트 기획 배경
2. 프로젝트 목표
3. 성과
4. 서비스명 & 로고
5. 주요 기능 & 서비스 화면
6. 기술 차별점
7. 확장 가능성
8. 홍보 및 운영 전략
9. 개발 환경
10. 프로젝트 구조
11. 서비스 아키텍처
12. 협업 환경
13. 팀원 소개
14. 프로젝트 산출물
15. 발표 자료
16. 회고

---

3. 프로젝트 기획 배경

운세 서비스는 이미 많지만 대부분 오늘의 운세를 한 번 보고 끝나는 일회성 경험에 그칩니다.

• “오늘 운이 좋다더라” → 잠깐 보고 잊어버림
• 운이 나쁘다는 결과를 보고도 부적 구입과 같은 과금 이외에는 구체적으로 무엇을 할지 연결되지 않음
• 반복해서 사용할 만한 동기(게임성, 수집 요소, 통계, 상호작용)가 부족함

아그작은 이 지점을 문제로 보고,
운세를 게임·수집·통계·소통과 결합해 “오늘 운세를 어떻게 활용할지”까지 연결하는 서비스로 기획했습니다.

---

4. 프로젝트 목표

아그작의 궁극적인 목표는 “운영 가능한 실서비스 수준의 운세 플랫폼” 입니다.
이를 위해 아래 세 가지 세부 목표를 두었습니다.

1. 실제 서비스 운영을 전제로 한 설계와 개발
   • PWA, 반응형, 모니터링, 배포 자동화를 포함한 엔드투엔드 구성
2. 반복 사용을 유도하는 핵심 메커닉 구축
   • 오븐 미니게임, 포춘쿠키 인벤토리, 랭킹, 통계, 선물하기 등
3. 데이터 기반 개선 사이클
   • GA4 + Hotjar를 활용한 실제 사용자 행동 분석

---

5. 성과

• 2025.11.11 ~ 2025.11.25 (약 2주)
• 총 방문자 수: 1,100명+ (Google Analytics 기준)
• 총 가입자 수: 236명+
• 발생한 이벤트 수: 110,000회+
• 누적 게임 횟수: 2,319회+
• 선착순 쿠폰 프로모션 참여 회원 수: 100명+
• 누적 로그 수: 400,000건+

---

6. 서비스명 & 로고

• 서비스명: 아그작(agzak)
  • 쿠키를 한 입 베어 물 때 나는 의성어에서 착안
  • 포춘쿠키가 “아그작 열리는 느낌”과 게임적인 즐거움을 함께 표현
• 메인 디자인: 돼지 캐릭터와 네잎 클로버 모양의 포춘쿠키
  • 복(福)과 재물을 상징하는 돼지 + 네잎 클로버 = 행운과 성공을 상징
• 디자인 콘셉트
  • 픽셀 아트 기반 레트로 게임 감성
  • 양피지, 오븐, 쿠키 등 “오래된 마녀의 집 + 게임 아케이드” 분위기

---

7. 주요 기능 및 서비스 화면

7-1. 운세 검사

• 비로그인
  • 이름, 생년월일, 태어난 시각(모름 선택 가능)을 입력하면 오늘의 운세 제공
• 로그인
  • 회원 정보(태어난 지역, 생년월일, 성별)를 기반으로 원클릭 운세 검사
• 오늘의 운세 점수 + 운세 타입 + 설명 제공
• 잘 맞는 운세 타입 / 주의해야 할 타입 매칭

---

7-2. 운세 강화 – 오븐 미니게임

• 로스트아크 돌 세공을 모티브로 한 운세 아이템 세공 시뮬레이터
• 하루 최대 10회 플레이 (세션 기반 기회 관리)
• 저위험/저보상 ~ 고위험/고보상 난이도 선택
• 성공/실패에 따라 네 가지 운세(사랑, 재물, 건강, 성취 등)가 강화/감소
• 오르거나 내린 각 운세 점수를 기준으로 포춘쿠키 타입 결정

---

7-3. 포춘쿠키 인벤토리

• 게임으로 획득한 포춘쿠키를 최대 50개까지 보관
• 쿠키 사용 시 해당 일자의 운세 점수 강화
• 쿠키 삭제 / 정렬(타입, 점수 등) 기능 제공
• 쿠키 상세에서 강화 내역, 메시지 확인 가능

---

7-4. 운세 통계 & 달력

• 최근 7일 간의 기본 운세 vs 강화 운세를 히스토그램으로 시각화
• 날짜별 운세 타입/점수를 달력의 날짜를 클릭해 한눈에 확인
• 포춘쿠키 사용/강화 이력과 연동된 통계 제공

---

7-5. 랭킹 & 공유

• 강화된 운세 점수를 기준으로 유저 랭킹 제공
• 랭킹 보드에서 상위 유저의 쿠키 타입/점수 확인
• 오늘의 운세/쿠키 결과를 SNS 카드 이미지 형태로 공유

---

7-6. 선물

• 보유한 쿠키를 메시지와 함께 다른 유저에게 선물
• 알림 사이드바를 통하여 선물 목록 확인 및 획득

---

7-6. (확장 예정 기능)

• 달성한 업적에 따른 칭호 부여
• 액운 퇴치 모드 (유저가 설정한 “시험/발표/지출” 등 액운을 캐릭터로 퇴치)
• 알림 기능 (일일 운세 리마인드, 친구 강화 알림)

---

9. 기술 차별점

1. 운세 + 게임 + 수집을 결합한 구조

   • 단순한 운세 조회가 아니라, 강화/수집/랭킹 구조로 재방문 유도

2. PWA 기반 모바일 최적화

   • 설치형 웹앱처럼 홈 화면에서 바로 실행
   • 주요 정적 리소스 캐싱으로 빠른 재접속

3. 도메인 기반 FE 구조

   • adapters, lib, store, pages 등으로 역할 분리
   • 모든 API 호출은 lib 레이어를 통해서만 이루어져 유지보수에 유리

4. 데이터 기반 의사결정

   • GA4 + Hotjar로 페이지별 전환율, 이탈 지점, 스크롤/클릭 패턴 분석
   • 실제 이벤트(오븐 플레이, 쿠키 사용, 공유 버튼 클릭)를 기반으로 기능 개선

(인프라와 백엔드 기술 차별점 추가 정리 필요)

---

10. 확장 가능성

• 운세 타입/쿠키 타입을 확장한 시즌제 이벤트
• 기업/브랜드 협업 쿠키(스폰서 쿠키, 한정판 쿠키) 연계
• 유저 맞춤형 푸시/이메일 알림 기반 리텐션 마케팅을 위한 앱 출시

---

11. 개발 환경

Frontend

• React, TypeScript, Vite
• Zustand, React Router
• Tailwind CSS, shadcn/ui, Recharts
• PWA, GA4, Hotjar

Backend

• Java 17 (JVM)
• Spring Boot 3.5.x
• 내장 Tomcat (Spring Boot Embedded)
• MySQL 9.x
• Redis
• Gradle

AI

• Python 3.x
• FastAPI + Uvicorn
• MySQL

Infra

• Ubuntu 22.04 LTS
• Docker Engine 24.x+
• Docker Compose v2.x+

---

12. 프로젝트 구조

.
├── backend/             # Spring Boot API 서버
├── frontend/
├── scripts/
├── infra/               # Docker, k8s, Helm, ArgoCD 등 인프라 설정
└── exec/                # 요구사항, 화면 설계, ERD, API 명세, 발표자료