ONCE-BE

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

🛠️ 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