v0.0.0

.dockerignore

@@ -0,0 +1,35 @@
+.git
+.github
+.gitignore
+.idea
+.vscode
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+env/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+coverage.xml
+tests/
+test-sites/
+docs/
+*.md
+.env
+.env.*
+data/
+*.db
+*.db-journal
+*.db-wal
+*.db-shm
+*.log
+logs/
+node_modules/
+.DS_Store
+Dockerfile
+.dockerignore
+.pre-commit-config.yaml
+Makefile

.env.example

@@ -0,0 +1,81 @@
+# ---- App ----
+APP_NAME="LinClean Open API"
+APP_VERSION="0.1.0"
+ENVIRONMENT=local
+DEBUG=true
+
+# ---- Server ----
+HOST=0.0.0.0
+PORT=8000
+LOG_LEVEL=INFO
+LOG_JSON=false
+
+# ---- CORS (JSON list) ----
+CORS_ORIGINS=["http://localhost:3000"]
+
+# ---- Database (SQLite) ----
+# Relative paths are resolved against the project root.
+SQLITE_PATH=data/linclean.db
+DB_ECHO=false
+
+# ---- Google Safe Browsing ----
+# Leave empty to disable GSB lookups in /api/v1/check.
+GSB_API_KEY=SECRET_KEY
+GSB_CLIENT_ID=linclean
+GSB_CLIENT_VERSION=0.1.0
+GSB_TIMEOUT_SECONDS=5.0
+
+# ---- URLhaus ----
+URLHAUS_RECENT_CSV_URL=https://urlhaus.abuse.ch/downloads/csv_recent/
+URLHAUS_ONLINE_CSV_URL=https://urlhaus.abuse.ch/downloads/csv_online/
+URLHAUS_REFRESH_INTERVAL_SECONDS=3600
+URLHAUS_DOWNLOAD_TIMEOUT_SECONDS=60.0
+
+# ---- Scheduler / URLhaus sync ----
+# 스케줄러 켜면 URLHAUS_REFRESH_INTERVAL_SECONDS 주기로 CSV 동기화 실행.
+# 부팅 시 1회 동기화는 URLHAUS_SYNC_ON_STARTUP 로 제어. 로컬/CI 에서 비활성화 가능.
+SCHEDULER_ENABLED=true
+URLHAUS_SYNC_ON_STARTUP=true
+
+# ---- RDAP ----
+RDAP_BOOTSTRAP_URL=https://rdap.org/domain/
+RDAP_TIMEOUT_SECONDS=5.0
+RDAP_CACHE_TTL_SECONDS=604800
+RDAP_NEW_DOMAIN_THRESHOLD_DAYS=30
+
+# ---- Scoring ----
+SCORE_WEIGHT_GSB=50
+SCORE_WEIGHT_URLHAUS=50
+SCORE_WEIGHT_RDAP=20
+SCORE_MALICIOUS_THRESHOLD=50
+# 1~3단계 합산이 이 값 이상이면 콘텐츠 정적 분석(네트워크·AI 비용)을 건너뛴다.
+SCORE_DANGER_THRESHOLD=61
+
+# ---- Content Analysis (4단계) ----
+CONTENT_FETCH_TIMEOUT_SECONDS=8.0
+CONTENT_FETCH_CONNECT_TIMEOUT_SECONDS=3.0
+CONTENT_FETCH_MAX_BYTES=2097152
+CONTENT_EXTERNAL_LINK_RATIO_THRESHOLD=0.8
+
+# 페치 실패 가중치 — timeout/connect_error/http_error 같은 도달 실패에만 적용.
+# not_html / too_large / unexpected_redirect 는 정상 컨텐츠·파이프라인 이슈로 보고 가산 없이 시그널만.
+SCORE_WEIGHT_CONTENT_FETCH_FAILED=10
+
+# ---- AI Provider ----
+# auto   : OPENAI_API_KEY 있으면 OpenAIProvider, 없으면 NullAIProvider
+# openai : 강제 openai (키 없으면 NullAIProvider 로 폴백 + 경고)
+# null   : 비활성 (규칙 점수만 사용)
+AI_PROVIDER=auto
+
+# ---- OpenAI ----
+# 비워두면 NullAIProvider — 규칙 기반 점수만 사용.
+# 모델은 OpenAI 채팅 계열이면 전부 호환 (gpt-4o-mini / gpt-4o / gpt-4.1-mini 등). 교체는 OPENAI_MODEL 한 줄.
+OPENAI_API_KEY=
+OPENAI_MODEL=gpt-4o-mini
+OPENAI_TIMEOUT_SECONDS=10.0
+OPENAI_MAX_OUTPUT_TOKENS=300
+
+# ---- Spring 통신 ----
+# secrets.token_hex(32) 로 생성한 사전 공유 키. Spring 과 동일한 값 설정 필수.
+INTERNAL_API_KEY=REPLACE_ME
+SPRING_INTERNAL_URL=http://localhost:8080

.github/ISSUE_TEMPLATE/기능-개발.md

@@ -0,0 +1,24 @@
+---
+name: 기능 개발
+about: 새로운 기능을 추가하거나 수정
+title: "[FEATURE] 기능 개발"
+labels: "✨ Feature"
+assignees: 
+
+---
+
+## 기능 추가/수정
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 구현할 기능에 대한 설계를 마쳤는가?
+- [ ] 테스트 코드를 작성했는가?
+- [ ] API 명세서(Swagger 등)를 업데이트했는가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/기타-업무.md

@@ -0,0 +1,23 @@
+---
+name: 기타 업무
+about: 프로덕션 코드가 바뀌지 않고 개발 로직과 상관 없는 가벼운 일들
+title: "[CHORE] 기타 업무"
+labels: "🗑 chore"
+assignees: 
+
+---
+
+## 기타 업무
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 어떤 목적으로 수행되는 작업인지 명확히 작성했는가?
+- [ ] 이 작업이 다른 개발 환경에 영향을 주지 않는가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/리팩토링.md

@@ -0,0 +1,24 @@
+---
+name: 리팩토링
+about: production 코드를 리팩토링
+title: "[REFACTOR] 리팩토링"
+labels: "🔧 Refactor"
+assignees: 
+
+---
+
+## 리팩토링
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 로직의 가독성이 좋아졌는가?
+- [ ] 단일 책임 원칙(SRP)을 잘 따랐는가?
+- [ ] 기존 테스트가 모두 통과하는가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/문서-작성-및-코드-수정.md

@@ -0,0 +1,24 @@
+---
+name: 문서 작성 및 수정
+about: 도큐먼트/문서화 업데이트
+title: "[DOCS] 문서 작성 및 수정"
+labels: "📄 Docs"
+assignees:
+
+---
+
+## 문서 추가/수정
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 문서의 내용이 최신 코드를 반영하고 있는가?
+- [ ] 오타나 잘못된 링크는 없는가?
+- [ ] 기술 용어가 일관되게 사용되었는가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/버그-수정.md

@@ -0,0 +1,24 @@
+---
+name: 버그 수정
+about: 버그를 고침
+title: "[FIX] 버그 수정"
+labels: "🐞 Bugfix"
+assignees:
+
+---
+
+## 버그 수정
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 버그가 발생하는 원인을 분석했는가?
+- [ ] 버그가 재현되는 테스트 코드를 작성했는가?
+- [ ] 수정 사항이 기존 기능에 영향을 주지 않는지 확인했는가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/빌드-관련.md

@@ -0,0 +1,24 @@
+---
+name: 빌드 관련
+about: 빌드 관련 수정, 모듈 설치 또는 삭제 등
+title: "[BUILD] 빌드 관련"
+labels: "🛠 Build"
+assignees: 
+
+---
+
+## 빌드 관련 수정
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 의존성이 올바르게 추가/삭제 되었는가?
+- [ ] 로컬 환경에서 빌드(./gradlew build)가 성공하는가?
+- [ ] 환경 변수나 설정 파일(.properties, .yml)의 변경이 필요한가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/시급한-버그-수정.md

@@ -0,0 +1,24 @@
+---
+name: 시급한 버그 수정
+about: 시급한 버그를 고침 - 현 production에 critical
+title: "[HOTFIX] 버그 수정"
+labels: "🐞 HOTFIX"
+assignees: 
+
+---
+
+## 시급한 버그 수정
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 버그를 재현할 수 있는 테스트 코드를 작성했는가?
+- [ ] 해결책이 기존 코드의 다른 기능에 영향을 주지 않는가?
+- [ ] 로그나 에러 메시지를 충분히 확인했는가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/코드-형태-변경.md

@@ -0,0 +1,24 @@
+---
+name: 코드 형태 변경
+about: 주석, 프리티어 등 기능의 영향없이 코드 모양새만 변경되는 경우
+title: "[STYLE] 코드 형태 변경"
+labels: "💄 Style"
+assignees:
+
+---
+
+## 코드 형태 변경
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 비즈니스 로직에 영향이 없는가?
+- [ ] 정해진 코드 스타일 가이드를 준수했는가?
+- [ ] 불필요한 주석이나 공백을 제거했는가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/ISSUE_TEMPLATE/테스트-코드.md

@@ -0,0 +1,24 @@
+---
+name: 테스트 코드
+about: 테스트 코드 추가 및 업데이트
+title: "[TEST] 테스트"
+labels: "✅ Test"
+assignees:
+
+---
+
+## 테스트 코드 추가/수정
+
+### 설명
+
+<!-- 간단한 설명을 작성합니다. -->
+
+### 🗒 체크리스트
+
+- [ ] 테스트 케이스가 모든 엣지 케이스를 포함하는가?
+- [ ] 테스트가 독립적으로 실행 가능한가?
+- [ ] 테스트 코드의 네이밍이 이해하기 쉬운가?
+
+### 참고자료
+
+<!-- 참고할 정보나 링크를 작성합니다. -->

.github/pull_request_template.md

@@ -0,0 +1,19 @@
+# 요약
+<!--해당 PR에 대한 설명 혹은 이미지등을 넣어주세요. -->
+
+# 연관 이슈 및 Close 할 이슈 작성
+(fix #일이삼)
+<!--이슈 번호를 적어주세요(예시: fix #123). -->
+
+-- PR 시 다음과 같이 작성
+#123
+
+close #123
+
+# Pull Request 체크리스트
+
+## TODO
+
+- [ ] 최종 결과물을 확인했는가?
+- [ ] 의미 있는 커밋 메시지를 작성했는가?
+