Merge branch 'main' of https://github.com/Block-Guard/BlockGuard-server

Author: yeonju73

README.md

@@ -1,39 +1,130 @@
-# BlockGuard-server
-
-본 레포지토리는 **BlockGuard**의 서버 애플리케이션입니다.  
-Spring Boot 기반으로 개발되었으며, AI 서버와 연동하여 사기 유형을 분석하고, 사용자 신고 과정을 단계별로 관리합니다.
+# 🌎 BlockGuard-server
+![img_1.png](img_1.png)
+ AI를 활용한 보이스피싱 사전예방 통합 서비스 **BlockGuard**의 Spring 서버 레포지토리입니다.  
 
 ---
 
-## 📌 ERD (Entity Relationship Diagram)
+## 📌 Package Structure
+```
+├── 📄 Dockerfile
+├── 📄 PULL_REQUEST_TEMPLATE.md
+├── 📄 README.md
+├── 📄 build.gradle
+├── 📂 gradle
+│   └── 📂 wrapper
+│       ├── 📦 gradle-wrapper.jar
+│       └── ⚙️ gradle-wrapper.properties
+├── ⚙️ gradlew
+├── ⚙️ gradlew.bat
+├── 📄 settings.gradle
+└── 📂 src/main/java/com/blockguard/server
+    ├── 🚀 ServerApplication.java
+    ├── 📂 domain
+    │   ├── 📂 admin
+    │   │   └── 📂 api
+    │   ├── 📂 analysis
+    │   │   ├── 📂 api
+    │   │   ├── 📂 application
+    │   │   ├── 📂 dao
+    │   │   ├── 📂 domain
+    │   │   └── 📂 dto
+    │   │       ├── 📂 request
+    │   │       └── 📂 response
+    │   ├── 📂 auth
+    │   │   ├── 📂 api
+    │   │   ├── 📂 application
+    │   │   ├── 📂 domain
+    │   │   ├── 📂 dto
+    │   │   ├── 📂 enhancer
+    │   │   ├── 📂 enums
+    │   │   ├── 📂 infra
+    │   │   └── 📂 interceptor
+    │   ├── 📂 fraud
+    │   │   ├── 📂 api
+    │   │   ├── 📂 application
+    │   │   ├── 📂 dao
+    │   │   ├── 📂 domain
+    │   │   └── 📂 dto
+    │   ├── 📂 guardian
+    │   │   ├── 📂 api
+    │   │   ├── 📂 application
+    │   │   ├── 📂 dao
+    │   │   ├── 📂 domain
+    │   │   └── 📂 dto
+    │   ├── 📂 news
+    │   │   ├── 📂 api
+    │   │   ├── 📂 application
+    │   │   ├── 📂 dao
+    │   │   ├── 📂 domain
+    │   │   ├── 📂 dto
+    │   │   └── 📂 scheduler
+    │   ├── 📂 report
+    │   │   ├── 📂 api
+    │   │   ├── 📂 application
+    │   │   ├── 📂 dao
+    │   │   ├── 📂 domain
+    │   │   └── 📂 dto
+    │   └── 📂 user
+    │       ├── 📂 api
+    │       ├── 📂 application
+    │       ├── 📂 dao
+    │       ├── 📂 domain
+    │       └── 📂 dto
+    ├── 📂 global
+    │   ├── 📂 common
+    │   │   ├── 📂 codes
+    │   │   ├── 📂 entity
+    │   │   └── 📂 response
+    │   ├── 📂 config
+    │   │   ├── 📂 S3
+    │   │   ├── 📂 resolver
+    │   │   └── 📂 swagger
+    │   └── 📂 exception
+    │       ├── 🛠️ BusinessExceptionHandler.java
+    │       └── 🛠️ GlobalExceptionHandler.java
+    └── 📂 infra
+        ├── 📂 crawler
+        ├── 📂 google
+        ├── 📂 gpt
+        ├── 📂 importer
+        ├── 📂 naver
+        │   └── 📂 ocr
+        └── 📂 number
+```
 
-서비스에서 사용하는 주요 도메인 구조를 ERD로 정리했습니다.
 
+## 📌 ERD (Entity Relationship Diagram)
 - [ERD Diagram Link](https://dbdiagram.io/d/BlockGuard_ERD-686d1997f413ba3508d99080)
-  <img width="1920" height="994" alt="image" src="https://github.com/user-attachments/assets/54a18ee7-f831-45a4-b4bb-173986c8708c" />
-
+![img_4.png](img_4.png)
+<details>
+<summary>  테이블 별 용도</summary>
+<div markdown="1">
+
+- **User**: 서비스의 기본 사용자 정보를 저장 (계정, 개인정보, 상태 관리)
+- **Guardian**: 사용자의 보호자(연락망) 정보를 저장, 다수 가능
+- **NewsArticle**: 보이스피싱/사기 관련 뉴스 기사 수집 및 조회용 데이터
+- **FraudPhoneNumber**: 사기 의심 전화번호 저장 및 API 검증 기록
+- **FraudUrl**: 사기 의심 URL 저장 및 감지 시각 관리
+- **UserReportRecord**: 사용자가 진행 중인 신고 프로세스의 전체 레코드
+- **ReportStepProgress**: 신고 프로세스 각 단계의 진행 상황 기록
+- **ReportStepCheckbox**: 단계별 필수/권장 체크박스 항목의 완료 여부 기록
+- **FraudAnalysisRecord**: AI 분석 결과(사기 유형, 점수, 위험도)를 저장
+
+</div>
+</details>
 
 ---
 
 ## 📌 API 명세서
-
-REST API 엔드포인트 및 스펙은 아래 문서를 참고하세요.
-
 - [API 명세서 (Swagger 링크)](https://www.blockguard.shop/swagger-ui/index.html)
-- 여기 API 명세서 노션 문서 추가
+- [API 명세서 (Notion 링크)](https://breezy-index-18b.notion.site/API-253ec5aa3e1a8014a18dc53ee1d1c5c8)
 
 ---
 
-## 📌 아키텍처 다이어그램
-
-서비스 전체 아키텍처 다이어그램입니다.
-
-<img width="1368" height="1002" alt="image" src="https://github.com/user-attachments/assets/a2ab4818-0240-48ef-b9b5-ffb099068bc8" />
+## 📌 Architecture Diagram
 
+- 서비스 전체 아키텍처 다이어그램
+![img_2.png](img_2.png)
 
-구성 요소:
-- AWS EC2: 서버 애플리케이션 컨테이너 실행 (Docker)
-- AWS RDS (MySQL): 영속성 데이터 저장
-- AWS S3: 사용자 업로드 파일 및 리소스 저장
-- AI Server: GPT 모델 기반 사기 유형 분석
-- CI/CD (Docker, GitHub Actions): 자동 빌드 및 배포 파이프라인
+- 서버 아키텍처 다이어그램
+![img_3.png](img_3.png)

img.png

@@ -8,8 +8,10 @@
 import org.springframework.scheduling.annotation.Scheduled;
 import org.springframework.stereotype.Component;
 
+import java.util.EnumSet;
 import java.util.List;
 import java.util.Map;
+import java.util.Set;
 
 @Component
 @Slf4j
@@ -25,7 +27,7 @@ public class NewsSaveScheduler {
             Map.entry(Category.LOAN_FRAUD, List.of("대출 사기", "저금리 대출 사기", "대출 빙자 사기")),
             Map.entry(Category.CARD_IMPERSONATION, List.of("카드사 사칭", "카드사 피싱", "신용카드 사칭")),
             Map.entry(Category.FAMILY_IMPERSONATION, List.of("가족 사칭", "지인 사칭")),
-            Map.entry(Category.EVENT_IMPERSONATION, List.of("경조사 사칭", "경조사 문자 사기", "모바일 청첩장 사기", "부고장 스미싱","온라인 부고장 사기","청첩장 스미싱")),
+            Map.entry(Category.EVENT_IMPERSONATION, List.of("경조사 사칭", "경조사 문자 사기", "모바일 청첩장 사기", "부고장 스미싱", "온라인 부고장 사기", "청첩장 스미싱")),
             Map.entry(Category.PUBLIC_IMPERSONATION, List.of("공공기관 사칭", "국세청 사칭", "경찰 출석 요구 사칭", "검찰 사칭", "과태료 사칭")),
             Map.entry(Category.PART_TIME_SCAM, List.of("알바 사기", "부업 사기", "구인 사기")),
             Map.entry(Category.GOVERNMENT_GRANT_SCAM, List.of("정부지원금 사기", "보조금 사기", "지원금 사칭")),
@@ -37,7 +39,11 @@ public class NewsSaveScheduler {
 
     @Async
     public void crawlingForAdmin() {
-        crawlAll();
+        crawlByCategories(EnumSet.of(
+                Category.VOICE_PHISHING,
+                Category.SMISHING,
+                Category.MESSAGE_VOICE_PHISHING
+        ));
     }
 
     @Async
@@ -47,16 +53,22 @@ public void saveNewsArticles() {
     }
 
     private void crawlAll() {
-        log.info("뉴스 크롤링 스케줄링 시작");
-        KEYWORDS_PER_CATEGORY.forEach((category, keywords) -> {
+        crawlByCategories(KEYWORDS_PER_CATEGORY.keySet());
+    }
+
+    private void crawlByCategories(Set<Category> categories) {
+        log.info("뉴스 크롤링 시작 (targets={})", categories);
+        categories.forEach(category -> {
+            List<String> keywords = KEYWORDS_PER_CATEGORY.getOrDefault(category, List.of());
             for (String keyword : keywords) {
                 try {
                     daumNewsCrawler.fetchNewsFromDaum(keyword, category);
                 } catch (Exception e) {
-                    log.warn("크롤 실패: category={}, keyword={}", category, keyword, e);
+                    log.warn("크롤링 실패: category={}, keyword={}", category, keyword, e);
                 }
             }
         });
-        log.info("뉴스 크롤링 스케줄링 완료");
+        log.info("뉴스 크롤링 완료");
     }
+
 }