🌎 BlockGuard-server

AI를 활용한 보이스피싱 사전예방 통합 서비스 BlockGuard의 Spring 서버 레포지토리입니다.

---

📌 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 (Entity Relationship Diagram)

• ERD Diagram Link

테이블 별 용도

• User: 서비스의 기본 사용자 정보를 저장 (계정, 개인정보, 상태 관리)
• Guardian: 사용자의 보호자(연락망) 정보를 저장, 다수 가능
• NewsArticle: 보이스피싱/사기 관련 뉴스 기사 수집 및 조회용 데이터
• FraudPhoneNumber: 사기 의심 전화번호 저장 및 API 검증 기록
• FraudUrl: 사기 의심 URL 저장 및 감지 시각 관리
• UserReportRecord: 사용자가 진행 중인 신고 프로세스의 전체 레코드
• ReportStepProgress: 신고 프로세스 각 단계의 진행 상황 기록
• ReportStepCheckbox: 단계별 필수/권장 체크박스 항목의 완료 여부 기록
• FraudAnalysisRecord: AI 분석 결과(사기 유형, 점수, 위험도)를 저장

---

📌 API 명세서

• API 명세서 (Swagger 링크)
• API 명세서 (Notion 링크)

---

📌 Architecture Diagram

• 서비스 전체 아키텍처 다이어그램

• 서버 아키텍처 다이어그램