feat: Marketplace 배포를 위한 개인정보 보호와 다국어 UX 보강

[Seongbin-Choo]

문제

외부 전송에 대한 명시적인 동의가 없었음

플러그인은 콘솔 로그와 빌드 정보를 셀프 호스팅 백엔드로 보내고, 정제된 프롬프트를 사용자가 선택한 LLM 제공자에게 전송합니다. 기존 구현에는 사용자가 전송 대상과 데이터를 확인하고 동의하는 절차가 없어 Marketplace 심사와 개인정보 보호 측면에서 보완이 필요했습니다.

한 번의 동의 확인만으로는 비동기 요청을 안전하게 막기 어려움

분석 작업은 백그라운드에서 실행되므로 작업 예약 이후 실제 HTTP 요청 전에 사용자가 동의를 철회하거나 정책 버전이 변경될 수 있습니다. 화면 진입 시 한 번만 확인하면 철회 이후에도 이미 예약된 요청이 전송될 가능성이 있었습니다.

한국어 UI와 사람이 읽는 안내 문구에 대한 결합

UI 문자열이 한국어로 고정되어 있어 Marketplace 심사자와 해외 사용자가 기능을 이해하기 어려웠습니다. 또한 백엔드의 한글 안내 문구를 파싱해 상태를 구분하면 문구 수정이나 다국어화가 클라이언트 동작에 영향을 줄 수 있었습니다.

포트폴리오 목적에 맞는 운영 비용 구조가 필요함

공용 백엔드를 운영하면 도메인, HTTPS, 가동률 및 남용 대응 비용이 지속적으로 발생합니다. 포트폴리오 프로젝트의 범위를 고려해 사용자가 직접 백엔드를 실행하는 셀프 호스팅 방식을 선택했습니다.

판단과 선택

네트워크 요청 직전까지 동의를 이중 확인

분석 작업을 예약하기 전에 동의를 확인하고, 각 HTTP 요청을 보내기 직전에 다시 확인하도록 구성했습니다.

첫 번째 확인은 동의하지 않은 작업의 실행을 막고, 두 번째 확인은 비동기 실행 사이에 발생할 수 있는 동의 철회와 정책 변경을 반영합니다. 단순한 최초 1회 동의 방식은 이 시간 차이를 보호하지 못하므로 사용하지 않았습니다.

사용자는 설정에서 동의를 철회할 수 있으며, 개인정보 처리방침 버전이 변경되면 다시 동의해야 합니다.

셀프 호스팅 백엔드 채택

플러그인 제작자가 사용자 로그를 보관하는 공용 서버를 운영하지 않고, 사용자가 자신의 환경에서 백엔드를 실행하도록 했습니다. 설치 직후 별도 서버 없이 동작하는 편의성은 줄지만 운영 비용과 중앙 서버의 개인정보 보관 위험을 피할 수 있습니다.

설정 방법과 전송되는 데이터는 Marketplace 설명, 개인정보 처리방침 및 리뷰 가이드에 명시했습니다.

영어 기본 UI와 한국어 번역 분리

Marketplace와 IntelliJ 기본 환경에서는 영어를 제공하고, 한국어는 별도 리소스 번들로 분리했습니다. UI 문자열을 코드에서 분리하여 추가 언어를 지원하거나 문구를 수정할 때 동작 로직을 변경하지 않도록 했습니다.

guidanceCode 기반 상태 처리

백엔드가 제공하는 안정적인 guidanceCode를 우선 사용하고, 알 수 없는 코드나 이전 백엔드와의 호환성을 위해 기존 guidance 문구를 fallback으로 유지했습니다.

API 키는 IDE 보안 저장소에 보관

사용자가 입력한 LLM API 키는 IntelliJ PasswordSafe에 저장하며 셀프 호스팅 백엔드로 전송하지 않습니다. 정제된 프롬프트는 사용자가 선택한 LLM 제공자에게 직접 전송됩니다.

변경 내용

• 백엔드 및 LLM 네트워크 요청 전 개인정보 전송 동의 추가
• 요청 직전 동의 재검증, 철회 및 정책 버전 변경 처리
• 영어 기본 UI와 한국어 리소스 번들 구성
• 백엔드 guidanceCode 기반 상태 처리와 하위 호환 fallback 추가
• 라이트·다크 테마용 툴 윈도우 아이콘 추가
• Marketplace 설명, vendor 연락처 및 change notes 보강
• 개인정보 처리방침, Marketplace 등록 문서, 심사 가이드 및 MIT 라이선스 추가
• 배포 버전 1.0.0 적용
• 영어 부정 표현을 사실 주장으로 잘못 감지하던 grounding 경고 수정

검증

• 전체 33개 테스트 통과
• verifyPluginProjectConfiguration 통과
• verifyPluginStructure 통과
• Plugin Verifier에서 IntelliJ IDEA 2026.2.1 호환 판정
• Marketplace ZIP 빌드 성공
• 패키징된 JAR에서 META-INF/LICENSE, 다국어 리소스, 아이콘 및 동의 관련 클래스 포함 확인

운영 및 호환성

• 백엔드는 사용자가 직접 실행하고 플러그인 설정에서 주소를 지정해야 함
• IntelliJ Platform sinceBuild=262 이상 지원
• 플러그인 PR 병합 후 Marketplace 제출용 ZIP에 별도 서명 및 서명 검증 완료