Merge branch 'develop'

# Conflicts:
#	.github/workflows/deploy.yml
#	Dockerfile

Author: deveunhwa

.gitignore

@@ -37,6 +37,10 @@ out/
 ### VS Code ###
 .vscode/
 
-### H2 DB file ###
+# Ignore H2 database files
 *.mv.db
-*.trace.db
+*.trace.db
+
+#secret yml#
+application-secret.yml
+/src/main/resources/firebase/firebase_service_key.json

README.md

@@ -1 +1,80 @@
-# WEB1_2_Child-Learn_BE
+# 아이주주 ![아이주주 3](https://github.com/user-attachments/assets/89cd492b-92fe-46ef-b7f2-319e8df4c400)
+ 
+![프로젝트이미지](https://github.com/user-attachments/assets/6e0bdf74-a374-4c70-952d-fc22e0ba3413)
+
+## 🍀 프로젝트 소개
+아이주주는 초등학생들이 돈과 투자의 기본 개념을 쉽고 재미있게 배울 수 있도록 설계된 모의투자 학습 플랫폼입니다.
+
+[🔗 기획서](https://www.notion.so/13f336d06fda80d4a0dfc9e9ac30e96b?pvs=4)
+[🔗 디자인](https://www.figma.com/design/HfCXjOdS1CcDWLJbhci0dI/%EC%95%84%EC%9D%B4%EC%A3%BC%EC%A3%BC-%EC%99%80%EC%9D%B4%EC%96%B4%ED%94%84%EB%A0%88%EC%9E%84?node-id=0-1&t=WB1ZEVppjZTp8DY5-1)
+[🔗 프론트 깃허브](https://github.com/prgrms-web-devcourse-final-project/WEB1_2_Child-Learn_FE)
+[🔗 백엔드 깃허브](https://github.com/prgrms-web-devcourse-final-project/WEB1_2_Child-Learn_BE)
+[🔗 아이주주 바로가기](http://ijuju.site)
+
+### 개발기간 : 2024/11/18 ~ 2024/12/09
+
+<br>
+
+
+## 🍀 주요 기능
+> **주식 그래프**
+- **그래프 및 데이터 제공:** 종목별 투자 그래프와 비유적 설명이 담긴 뉴스레터 제공
+- **AI 맞춤형 정보:** API로 실시간 데이터 수집 및 맞춤형 뉴스 아티클 제공
+- **랜덤성과 현실성:** 랜덤 알고리즘과 실제 경제 데이터를 혼합해 재미있고 현실감 있는 그래프 변화 제공
+
+> **미니게임**
+
+아이들의 흥미를 유발하고, 학습 효과를 극대화하기 위한 다양한 미니게임
+- **카드 뒤집기**: 투자 관련용어를 게임으로 개념 이해.
+- **금융 퀴즈:** 돈, 저축, 투자 관련 퀴즈를 통해 기본 개념 이해.
+- **로또:** 간단한 확률 게임으로 투자와 위험의 개념 이해.
+
+> **상점**
+- 게임 및 주식투자를 통하여 획득한 포인트로 상점기능 제공.
+- 상점에서 자신만의 아바타를 꾸밀 수 있는 아이템 제공.
+- 여러가지 아이템으로 흥미 제공.
+
+<br>
+ 
+## 🍀 개발 환경 및 기술 스택
+### 통합 시스템 아키텍처
+![통합 시스템 아키텍처](https://github.com/user-attachments/assets/f6ddd958-6a68-4305-84c3-3e6f8098633f)
+
+<br>
+
+## 🍀 개발 문서
+<details>
+  <summary>ERD</summary>
+</details>
+<details>
+  <summary>아키텍처</summary>
+
+![백엔드 서버 아키텍처](https://github.com/user-attachments/assets/f96d2c88-223c-47b4-a673-ac613be39063)
+
+</details>
+<details>
+  <summary>요구사항 명세서</summary>
+
+[🔗 요구사항 명세서](https://foggy-move-190.notion.site/67c1e522ca8047d98094580d9bdc8f87?pvs=74)
+</details>
+<details>
+  <summary>API 명세서</summary>
+
+[🔗 API 명세서](https://foggy-move-190.notion.site/API-b44b55ec93c9478c9a25c9f75150b773?pvs=73)
+</details>
+
+## 🍀 팀 소개
+
+### FRONTEND
+|                           👑 이희주                           |                           📋 박우현                           |                  류민주                  |
+|:----------------------------------------------------------:|:----------------------------------------------------------:|:-------------------------------------:|
+|                       FE TeamLeader                        |                             PM                             |               Git_Admin               |
+|          [tree0000](https://github.com/tree0000)           |         [hjlee2778](https://github.com/hjlee2778)          | [minij02](https://github.com/minij02) |
+| ![](https://avatars.githubusercontent.com/u/141895600?v=4) | ![](https://avatars.githubusercontent.com/u/144092849?v=4) | ![](https://avatars.githubusercontent.com/u/135093109?v=4)|
+
+### BACKEND
+|              👑 임지은               |                    신은화                    |               최재형                |                   이수빈                   |                   박찬서                   |
+|:---------------------------------:|:-----------------------------------------:|:--------------------------------:|:---------------------------------------:|:---------------------------------------:|
+|     BE TeamLeader & AWS_Admin     |                 Git_Admin                 |            Developer             |                Developer                |                Developer                |
+| [1mjay](https://github.com/1mjay) | [deveunhwa](https://github.com/deveunhwa) | [Preta3418](https://github.com/Preta3418) | [subbb-in](https://github.com/subbb-in) | [chanspar](https://github.com/chanspar) |
+|               ![](https://avatars.githubusercontent.com/u/84836677?v=4)               |                   ![](https://avatars.githubusercontent.com/u/180101230?v=4)                   |              ![](https://avatars.githubusercontent.com/u/161911738?v=4)               |                  ![](https://avatars.githubusercontent.com/u/48655473?v=4)                  |                  ![](https://avatars.githubusercontent.com/u/87303538?v=4)                  |

build.gradle

@@ -24,27 +24,73 @@ repositories {
 }
 
 dependencies {
+    // jpa
     implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
+
+    // SMTP
     implementation 'org.springframework.boot:spring-boot-starter-mail'
+    // security
     implementation 'org.springframework.boot:spring-boot-starter-security'
+    testImplementation 'org.springframework.security:spring-security-test'
+
+    // JWT
+    implementation 'io.jsonwebtoken:jjwt-api:0.12.3'
+    runtimeOnly 'io.jsonwebtoken:jjwt-impl:0.12.3', 'io.jsonwebtoken:jjwt-jackson:0.12.3'
+
+
+    // validation
     implementation 'org.springframework.boot:spring-boot-starter-validation'
+
+    // spring web
     implementation 'org.springframework.boot:spring-boot-starter-web'
+
+    // lombok
     compileOnly 'org.projectlombok:lombok'
+    annotationProcessor 'org.projectlombok:lombok'
+
+    // devtools
     developmentOnly 'org.springframework.boot:spring-boot-devtools'
+
+    // DB
     runtimeOnly 'com.h2database:h2'
     runtimeOnly 'com.mysql:mysql-connector-j'
-    annotationProcessor 'org.projectlombok:lombok'
+    implementation 'mysql:mysql-connector-java:8.0.33'
+
+    // test
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
-    testImplementation 'org.springframework.security:spring-security-test'
     testRuntimeOnly 'org.junit.platform:junit-platform-launcher'
 
     // Querydsl
     implementation 'com.querydsl:querydsl-jpa:5.0.0:jakarta'
     annotationProcessor "com.querydsl:querydsl-apt:${dependencyManagement.importedProperties['querydsl.version']}:jakarta"
     annotationProcessor "jakarta.annotation:jakarta.annotation-api"
     annotationProcessor "jakarta.persistence:jakarta.persistence-api"
+
+    // WebSocket + STOMP
+    implementation 'org.springframework.boot:spring-boot-starter-websocket'
+
+    // Redis
+    implementation 'org.springframework.boot:spring-boot-starter-data-redis'
+
+    // MongoDB
+    implementation 'org.springframework.boot:spring-boot-starter-data-mongodb'
+
+    //OAuth2.0
+    implementation 'org.springframework.boot:spring-boot-starter-oauth2-client'
+
+    // Spring Cache - caffeine
+    implementation 'org.springframework.boot:spring-boot-starter-cache'
+    implementation 'com.github.ben-manes.caffeine:caffeine'
 }
 
 tasks.named('test') {
     useJUnitPlatform()
 }
+
+tasks.withType(JavaExec) {
+    jvmArgs += ['--add-opens', 'java.base/java.io=ALL-UNNAMED']
+}
+
+test {
+    jvmArgs += ['--add-opens', 'java.base/java.io=ALL-UNNAMED']
+}

src/main/java/com/prgrms/ijuju/IjujuApplication.java

@@ -2,7 +2,11 @@
 
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
+import org.springframework.scheduling.annotation.EnableScheduling;
 
+@EnableScheduling
+@EnableJpaAuditing
 @SpringBootApplication
 public class IjujuApplication {
 

src/main/java/com/prgrms/ijuju/domain/article/component/AdvTrendAnalyzer.java

@@ -0,0 +1,101 @@
+package com.prgrms.ijuju.domain.article.component;
+
+import com.prgrms.ijuju.domain.article.data.DailyTrend;
+import com.prgrms.ijuju.domain.article.data.Trend;
+import com.prgrms.ijuju.domain.stock.adv.advstock.entity.AdvStock;
+import org.springframework.stereotype.Component;
+
+import java.time.Instant;
+import java.time.LocalDate;
+import java.time.ZoneId;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * Adv 같은 경우는 timeStamp 로 이루어져 있으며, 한시간 봉으로 데이터가 이루어져 있습니다
+ * 데이터 분석을 위해서 모든 데이터를 전부 "하루" 단위로 변경합니다
+ */
+@Component
+public class AdvTrendAnalyzer {
+
+
+    public List<Trend> analyzeTrends(AdvStock advStock) {
+        Map<LocalDate, List<Double>> groupedData = groupByDate(advStock.getTimestamps(), advStock.getClosePrices());
+
+        List<DailyTrend> dailyTrends = calculateDailyTrends(groupedData);
+
+        return calculateCompositeTrends(dailyTrends, advStock.getSymbol());
+    }
+
+    // 한 시간 단위 데이터를 일 단위로 묶음
+    // AdvStock 은 timeStamps 로 구분되어 있기에, LocalData 로 변환할 과정이 필요하기에 생성된 메소드 입니다
+    private Map<LocalDate, List<Double>> groupByDate(List<Long> timestamps, List<Double> closePrices) {
+        Map<LocalDate, List<Double>> groupedData = new HashMap<>();
+
+        for (int i = 0; i < timestamps.size(); i++) {
+            LocalDate date = Instant.ofEpochMilli(timestamps.get(i)).atZone(ZoneId.systemDefault()).toLocalDate();
+            groupedData.computeIfAbsent(date, k -> new ArrayList<>()).add(closePrices.get(i));
+        }
+
+        return groupedData;
+    }
+
+
+    private List<DailyTrend> calculateDailyTrends(Map<LocalDate, List<Double>> groupedData) {
+        List<DailyTrend> dailyTrends = new ArrayList<>();
+
+        for (Map.Entry<LocalDate, List<Double>> entry : groupedData.entrySet()) {
+            List<Double> dailyPrices = entry.getValue();
+            double startPrice = dailyPrices.get(0);
+            double endPrice = dailyPrices.get(dailyPrices.size() - 1);
+
+            double percentageChange = ((endPrice - startPrice) / startPrice) * 100;
+            String trendType = determineTrendType(percentageChange);
+
+            dailyTrends.add(new DailyTrend(entry.getKey(), trendType, percentageChange));
+        }
+
+        return dailyTrends;
+    }
+
+    private String determineTrendType(double percentageChange) {
+        if (percentageChange > 2.0) return "UP";
+        if (percentageChange < -2.0) return "DOWN";
+        return "STABLE";
+    }
+
+
+    private List<Trend> calculateCompositeTrends(List<DailyTrend> dailyTrends, String symbol) {
+        List<Trend> trends = new ArrayList<>();
+
+
+        if (dailyTrends.size() >= 3) {
+            trends.add(new Trend("SHORT_TERM",
+                    calculateTrendDescription(dailyTrends.subList(0, Math.min(3, dailyTrends.size()))), symbol));
+        }
+
+
+        if (dailyTrends.size() >= 7) {
+            trends.add(new Trend("MID_TERM",
+                    calculateTrendDescription(dailyTrends.subList(0, Math.min(7, dailyTrends.size()))), symbol));
+        }
+
+
+        trends.add(new Trend("LONG_TERM", calculateTrendDescription(dailyTrends), symbol));
+
+        return trends;
+    }
+
+
+    private String calculateTrendDescription(List<DailyTrend> dailyTrends) {
+
+        long upCount = dailyTrends.stream().filter(d -> d.getTrendType().equals("UP")).count();
+        long downCount = dailyTrends.stream().filter(d -> d.getTrendType().equals("DOWN")).count();
+
+        if (upCount > downCount) return "UP";
+        if (downCount > upCount) return "DOWN";
+        return "STABLE";
+    }
+}

src/main/java/com/prgrms/ijuju/domain/article/component/MidTrendAnalyzer.java

@@ -0,0 +1,39 @@
+package com.prgrms.ijuju.domain.article.component;
+
+import com.prgrms.ijuju.domain.article.data.Trend;
+import com.prgrms.ijuju.domain.stock.mid.entity.MidStockPrice;
+import org.springframework.stereotype.Component;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Component
+public class MidTrendAnalyzer {
+
+    public List<Trend> analyzeTrends(List<MidStockPrice> prices, String midName) {
+        List<Trend> trends = new ArrayList<>();
+
+        // 3일 기준
+        trends.add(new Trend("SHORT_TERM", calculateTrend(prices, 3), midName));
+
+        // 1주 기준
+        trends.add(new Trend("MID_TERM", calculateTrend(prices, 7), midName));
+
+        // 2주 기준
+        trends.add(new Trend("LONG_TERM", calculateTrend(prices, 14), midName));
+
+        return trends;
+    }
+
+    private String calculateTrend(List<MidStockPrice> prices, int days) {
+        if (prices.size() < days) return "INSUFFICIENT_DATA";
+
+        double startPrice = prices.get(prices.size() - days).getAvgPrice(); // 시작 가격
+        double endPrice = prices.get(prices.size() - 1).getAvgPrice();      // 종료 가격
+        double percentageChange = ((endPrice - startPrice) / startPrice) * 100;
+
+        if (percentageChange > 2.0) return "UP";
+        if (percentageChange < -2.0) return "DOWN";
+        return "STABLE";
+    }
+}

src/main/java/com/prgrms/ijuju/domain/article/contant/DataType.java

@@ -0,0 +1,5 @@
+package com.prgrms.ijuju.domain.article.contant;
+
+public enum DataType {
+    ADVANCED, MID
+}

src/main/java/com/prgrms/ijuju/domain/article/controller/ArticleController.java

@@ -0,0 +1,50 @@
+package com.prgrms.ijuju.domain.article.controller;
+
+import com.prgrms.ijuju.domain.article.scheduler.ArticleScheduler;
+import com.prgrms.ijuju.domain.article.service.ArticleService;
+import lombok.RequiredArgsConstructor;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+import java.util.List;
+import com.prgrms.ijuju.domain.article.entity.Article;
+import com.prgrms.ijuju.domain.article.contant.DataType;
+
+
+
+
+@RestController
+@RequestMapping("/api/v1/articles")
+@RequiredArgsConstructor
+public class ArticleController {
+
+    private final ArticleService articleService;
+    private final ArticleScheduler articleScheduler;
+
+
+    @GetMapping("/{type}")
+    public ResponseEntity<List<Article>> getArticlesByType(@PathVariable DataType type) {
+        List<Article> articles = articleService.findArticlesByType(type);
+        return ResponseEntity.ok(articles);
+    }
+
+
+    @GetMapping("/detail/{id}")
+    public ResponseEntity<Article> getArticleById(@PathVariable Long id) {
+        Article article = articleService.findArticleById(id);
+        return ResponseEntity.ok(article);
+    }
+
+    //디버깅 용도
+    @GetMapping
+    public ResponseEntity<List<Article>> getAllArticles() {
+        List<Article> articles = articleService.findAllArticles();
+        return ResponseEntity.ok(articles);
+    }
+
+    //디버깅 용도
+    @PostMapping("/manage-articles")
+    public ResponseEntity<String> executeManageArticlesScheduler() {
+        articleScheduler.manageArticles();
+        return ResponseEntity.ok("스케쥴러 기능이 강제로 실행되었습니다.");
+    }
+}