Skip to content

CIS

CivicQuest Seoul(고장몬 도감)은 서울에서 흔히 마주치는 보도블록 파손, 고장난 신호등, 통행 방해물 같은 생활 인프라 문제를 ‘서울을 괴롭히는 몬스터’로 재해석해 시민 참여를 끌어올리는 게임형 수집 앱입니다.

Code Video Cerebral Valley

Core trick

Gemini classifies an uploaded photo of infrastructure damage and returns severity and risk scores as structured JSON that sets monster stats.

Tags

vision

Description

CivicQuest Seoul(고장몬 도감)은 서울에서 흔히 마주치는 보도블록 파손, 고장난 신호등, 통행 방해물 같은 생활 인프라 문제를 ‘서울을 괴롭히는 몬스터’로 재해석해 시민 참여를 끌어올리는 게임형 수집 앱입니다. 사용자가 사진을 찍거나 업로드하면 Gemini가 시설물 문제를 판별하고 사회적 불편함·위험도를 구조화된 점수로 반환하며, 한 번의 ‘수집’으로 동일한 귀여운 스타일의 몬스터 이미지와 함께 이름·설명·특징·레벨·스탯·울음소리까지 자동 생성됩니다. 수집된 고장몬은 지도에 발견 위치로 표시되고 도감에서 한눈에 모아볼 수 있어, ‘보고 지나치는 문제’를 ‘재미있게 기록하고 공유해 해결로 이어지게 만드는 문화’로 전환합니다. 나아가 축적된 데이터는 심각도 기준으로 정리되어 빠른 대응을 돕고, 문제가 해결되면 사용자에게 피드백을 전달해 참여의 보람까지 완성합니다.
yhcho0405/DeepMind★ 01 forksTypeScriptCreated Feb 28, 2026 · last push Mar 3, 2026

README excerpt

# 🏙️ CivicQuest Seoul

> **Transforming Urban Issues into Collectible Monsters for a Safer Seoul.** > *A Gamified Civic Engagement Platform built for Gemini 3 Seoul Hackathon*
> 

---

## 🌟 개요 (Overview)

서울의 파손된 보도블록, 고장난 가로등 같은 부서진 공공시설물들은 도시의 인상을 해칠 뿐만 아니라 시민의 안전을 위협합니다. 하지만 기존의 민원 신고 프로세스는 복잡하고 지루하게 느껴져 시민들의 자발적인 참여를 이끌어내는 데 한계가 있습니다.

**CivicQuest Seoul**은 기존의 복잡하고 지루한 민원 프로세스를 '몬스터 수집'이라는 재미있는 퀘스트로 재정의합니다. Google Gemini의 최신 멀티모달 AI 제품군을 활용하여 도시의 결함을 가치 있는 시각적 자산으로 치환하고, 시민들이 즐겁게 참여하는 자발적 도시 안전망을 구축합니다.

## 🔑 Setup & Quick Start

본 프로젝트는 보안을 위해 API Key를 서버에 저장하지 않으며, 사용자의 브라우저 로컬 환경에서 안전하게 구동됩니다.

1. **Repository Clone & Install**
    
    ```bash
    git clone https://github.com/your-username/civicquest-seoul.git
    npm install
    npm run dev
    ```
    
2. **API Key 설정**
    - 앱 실행 후 **Settings**(하단 네비게이션 또는 설정 아이콘) 메뉴 진입
    - [Google AI Studio](https://aistudio.google.com/apikey)에서 발급받은 **Gemini API Key**를 입력
3. **Ready to Scan!** 
    - 이제 카메라로 서울의 문제를 촬영하고 몬스터를 수집하기

---

## 🤖 AI Models Architecture

각 파이프라인의 목적에 최적화된 Google의 최신 모델들을 활용합니다.

| **Purpose** | **Model** | **Description** |
| --- | --- | --- |
| **Analysis** | `gemini-2.5-flash` | 인프라 파손 분석 및 위험도/불편도 데이터 추출 |
| **Image Generation** | `gemini-2.5-flash-image` | 3D 아트토이 스타일의 몬스터 이미지 생성 |
| **TTS (Monster Cry)** | `gemini-2.5-flash-preview-tts` | SSML 기반의 고유 몬스터 울음소리 합성 |

---

## 🛠 핵심 특징 (Core Features)

### 1. 🔍 AI Urban Vision Scanner

- **Real-time Capture:** 브라우저 카메라 및 Geolocation API 연동 제보 시스템
-

Team