datarchive
● ClearSign — 임대차 계약서 위험 분석 AI # 한 줄 소개 농난청인을 위한 전문 문서 변환 서비스입니다.
Core trick
Gemini compares an uploaded lease against a standard contract template, then rewrites flagged clauses into short plain-Korean sentences.
Description
● ClearSign — 임대차 계약서 위험 분석 AI
# 한 줄 소개
농난청인을 위한 전문 문서 변환 서비스입니다. 사진 한 장을 첨부하면 농난청인이 이해하기 쉬운 형태로, 변환하여 "어디가 위험하고, 얼마를 잃을 수 있는지" 즉시 알려주는 AI 입니다.
# 문제
한국 농인의 모어는 한국수어(KSL)입니다. 한국어는 사실상 제2언어이며, 특히
법률 문서의 복문 구조, 한자어 용어, 중첩 조건절은 농인에게 외국어에
가깝습니다. 실제로 농인의 한국어 문해력은 평균 초등 3~4학년 수준으로
보고되며, 임대차 계약서처럼 고밀도 법률 텍스트는 이해가 거의 불가능합니다.
이로 인해 계약 내용을 모른 채 서명하고, 보증금 피해를 입는 사례가 반복됩니다.
ClearSign은 계약서를 촬영하면 Gemini AI가 국토교통부 표준 계약서와 자동
비교하여 위험 조항을 찾고, 예상 손실 금액을 산출합니다. 핵심은 인지언어학
기반 7대 변환 원칙입니다. 복합문을 단문으로 분리하고, 수동태를 능동태로
바꾸고, 모든 문장에 주어를 명시하고, 한자어를 일상어로 풀어쓰고, 조건과
결과를 분리하여 번호를 매깁니다. 이는 특히 수어의 인지 구조 — 시각적이고,
주어-목적어-동사 순서이며, 하나의 문장에 하나의 정보를 담는 특성 — 에 맞춘
설계입니다.
# Solution
- 계약서를 업로드하면 Gemini AI가 국토교통부 표준 계약서와 자동 비교하여:
1. 위험 조항 탐지 — 표준 대비 이탈도 점수 + 예상 손실 금액 산출
2. (중요) 쉬운 한국어 3단계 변환 — 법률 용어를 일상어로 (7대 인지적 변환 원칙
적용)
3. 행동 스크립트 생성 — 집주인에게 바로 말할 수 있는 수정 요청 문구 제공
4. 원본 병행 비교 — 원본 계약서와 분석 결과를 나란히 확인
README excerpt
# ClearSign — 임대차 계약서 위험 분석 AI
> 농인·난청인을 위한 임대차 계약서 위험 분석 서비스
임대차 계약서를 업로드하면 국토교통부 표준 계약서와 비교하여 **위험 조항을 자동 탐지**하고, **쉬운 한국어 3단계 설명**과 **행동 스크립트**를 생성합니다.
| 서비스 링크: https://clearsign-221866319306.asia-northeast3.run.app
## 주요 기능
- **계약서 업로드 & AI 분석** — PDF, 이미지, HTML 등 다양한 형식 지원
- **위험 조항 탐지** — 표준 계약서 대비 이탈도 점수화 (0~100)
- **쉬운 한국어 3단계 변환** — 핵심 설명 → 비유 설명 → 시나리오
- **행동 스크립트 생성** — 위험 조항별 수정 요청 문구 제공
- **전세사기 검색** — Google Search Grounding 기반 지역 사기 이력 조회
- **이해도 검증 퀴즈** — Cloze Test 기반 계약 내용 이해 확인
- **관점 전환 UI** — 임차인/임대인 관점으로 계약서 분석
## 기술 스택
| 구분 | 기술 |
|------|------|
| Backend | FastAPI, Python 3.12 |
| AI | Google Gemini 3 (ADK 3-Agent Pipeline) |
| Frontend | Tailwind CSS, Chart.js, Vanilla JS |
| 배포 | Docker, Google Cloud Run |
## 아키텍처
```
[계약서 업로드]
↓
┌─────────────────────────────┐
│ ADK 3-Agent Pipeline │
│ ┌─────────────────────┐ │
│ │ Agent 1: Parser │───→ 조항 추출
│ │ Agent 2: Analyzer │───→ 위험 분석
│ │ Agent 3: Translator │───→ 쉬운 변환 + 행동 스크립트
│ └─────────────────────┘ │
└─────────────────────────────┘
↓ (폴백 체인)
ADK → 단일 Gemini 호출 → 사전 분석 JSON
```
## 실행 방법
### 로컬 실행
```bash
# 1. 의존성 설치
pip install -r requirements.txt
# 2. 환경변수 설정
cp .env.example .env
# .env 파일에 GEMINI_API_KEY 입력
# 3. 서버 시작
python main.py
```
http://localhost:8080 에서 접속 가능
### Docker
```bash
docker build -t clearsign .
docker run -p 8080:8080 -e GEMINI_API_KEY=your-key clearsign
```
### Cloud Run 배포
```bash
gcloud run deploy clearsign \
--sou