💳 ONCE : 카드 다보유자를 위한 결제 전 최대 할인 카드 추천 AI 챗봇 서비스

"혜택 조건이 너무 복잡하고 애매해서 어떤 카드가 유리한지 모르겠어요."
"여러 개의 카드가 있지만 어떤 카드의 혜택이 좋은지 알 수 없어서 한 개의 카드만 사용해요."

카드 혜택 영리하게 활용하고 계신가요?

여러분이 보유한 카드의 혜택과 이용실적을 분석하여 현명한 소비를 도와드리는 핀테크 서비스 원스입니다.

카드 발급 전 좋은 혜택을 가진 카드를 발급받는 것도 중요하지만, 더 중요한 것은 카드의 혜택 조건을 꼼꼼히 챙겨 똑똑한 소비를 하는 것입니다.
결제 전 어떤 카드를 쓰는 것이 좋을지 고민되신다면, 원스에게 먼저 물어보세요.

여러분의 카드 상품을 분석하여 해당 결제처에서 최대 할인을 제공하는 카드를 한 번에 추천해 드립니다.

Why Once?

✅ 카드 추천 정확도 93.75%, 평균 응답 시간 1.323초의 정확하고 빠른 결제 카드 추천
✅ 주 1회 업데이트 되는 카드 혜택 정보
✅ 앱에 접속하지 않아도 되는, 단골 매장 미리 푸시 알림

About Backend

🛠️ Tech Stack

• Java 17
• Spring Boot 3
• MySQL 8.0.35
• Docker
• OpenAI
• CODEF API

☁️ How to run

1. Clone project

   $ git clone https://github.com/EWHA-LUX/ONCE-BE.git

2. Set environment variable
   2-1. Add src/main/resources/firebase/once-firebase-adminsdk.json
     Download firebase-admin sdk json ► Click here!
   
   2-2. Add src/main/resources/application.properties
   

   # Database
   SPRING_DATABASE_URL=(YOUR_RDS_ENDPOINT)
   SPRING_DATASOURCE_PASSWORD=(YOU_RDS_PASSWORD)
   
   # JWT
   JWT_SECRET_KEY=(YOUR_JWT_KEY)
   
   # S3
   AWS_S3_ACCESSKEY=(YOUR_S3_ACCESSKEY)
   AWS_S3_SECRETKEY=(YOUR_S3_SECRETKEY)
   AWS_S3_BUCKET=(YOUR_S3_BUCKET_NAME)
   AWS_S3_REGION=(YOUR_S3_REGION)
   
   # GPT
   OPENAI_MODEL=(YOUR_GPT_MODEL_ID)
   OPENAI_KEY=(YOUR_OPENAI_API_KEY)
   
   # AES
   AES_ENCRYPTION_KEY=(YOUR_AES_KEY)
   
   # CODEF
   CLIENT_ID=(YOUR_CODEF_CLIENT_ID)
   SECERET_KEY=(YOUR_CODEF_SECERET_KEY)
   ACCESS_TOKEN=(YOUR_CODEF_ACCESS_TOKEN)
   
   # Google Maps
   GOOGLE_CLOUD_API_KEY=(YOUR_GOOGLE_API_KEY)

3. Run OnceApplication.java

🗄️ Once ERD

📁 API Documents

펼쳐 보기

Feature	URI
👤 회원가입	POST /user/signup
👤 아이디 중복 확인	GET /user/duplicate?loginId=아이디
👤 자동로그인	POST /user/auto
👤 로그인	POST /user/login
👤 기기 토큰 저장	POST /user/token
👤 회원 탈퇴	DELETE /user/quit
👤 비밀번호 확인	POST /user/edit/pw
👤 비밀번호 변경	PATCH /user/edit/pw
👤 아이디 찾기	POST /user/find/id
👤 비밀번호 찾기	POST /user/find/pw
👤 내 정보 수정하기 페이지	GET /user/edit
👤 회원 정보 수정	PATCH /user/edit
👤 프로필 이미지 수정(등록)	PATCH /user/edit/profile
👤 카드 등록 1단계 (카드사로 카드 검색)	GET /user/card/search?code=0301,0302
👤 카드 등록 2단계 (카드 이름 검색)	GET /user/card/searchname?name=굿데이&code=0301,0302
👤 카드 등록 3단계 (카드 등록)	POST /user/card
🏠 챗봇 카드 추천	GET /home?keyword=GS25&paymentAmount=10000
🏠 홈 화면 기본 정보	GET /home/basic
🏠 결제 여부 변경	PATCH /home/{chat_id}
🏠 알림 리스트 조회	GET /home/announcement
🏠 알림 상세 조회	GET /home/announcement/{announceId}
🏠 사용자 근처 단골가게 조회	GET /home/gps
🏠 알림 생성 요청	POST /home/announcement
💳 CODEF 보유카드 조회	GET/card/list
💳 CODEF 카드사 연결 현황	GET/card/connect
💳 CODEF 주카드 등록	POST /card/main
💳 CODEF 주카드 실적 조회	GET /card/main/performance
💳 마이월렛 조회	GET /card
💳 주카드 아닌 카드 실적 입력	POST /card/performance
💳 월별혜택조회	GET /card/benefit?month=8
💳 목표 혜택 금액 입력	POST /card/benefitgoal
💟 마이페이지 조회	GET /mypage
💟 챗봇 대화 조회	GET /mypage/chathistory?month=2024-01
💟 카드 목록 조회	GET /mypage/maincard
💟 주카드 해제	PATCH /mypage/maincard/{ownedCardId}
💟 등록 카드 삭제	DELETE /mypage/maincard/{ownedCardId}

👩🏻‍💻 Back-End Contributors

Jimin Yu	Haewon Lee	Chaerin Heo
@jiminnee	@haewonny	@julia-heo