현대 사회는 기후 변화로 인한 자연재해(태풍, 지진, 홍수 등)와 인재 및 사회적 재난(화재, 테러 등)과 같은 다양한 재난에 직면해 있습니다. 이러한 재난 상황에서 신속한 정보 제공과 대처 방법 안내는 피해를 최소화하는 데 필수적입니다.
행정안전부의 안전디딤돌 앱1은 재난 대비와 대응을 위해 개발되었으나, 최신 릴리즈 노트2를 살펴보면 행동 요령 업데이트 외에 버그 수정과 보안 업데이트는 미비하며 UI/UX 개선은 부족한 상황입니다. 사용자 리뷰3에서도 여전히 다수의 버그와 불편 사항이 지적되고 있습니다.
본 프로젝트는 '안전디딤돌' 앱의 한계를 보완하고, 실시간 재난 현황 확인 및 대처 방법 안내 기능을 강화하여 사용자에게 더 나은 서비스를 제공하며, 국가적 재난 대응 시스템의 효율성을 높이기 위해 개발되었습니다.
이 시스템은 사용자가 재난 발생 시 실시간으로 정보를 확인하고, 상황에 맞춘 행동 지침을 제공받을 수 있는 기능을 제공합니다. 기존 앱의 문제점을 해결하고 사용자 경험(UX)을 대폭 개선하여 보다 직관적이고 신속한 재난 대처를 목표로 합니다.
- 실시간 데이터 제공: 공기 질, 재난 메시지, 뉴스 등 다양한 재난 관련 데이터를 실시간으로 제공하여 사용자들이 빠르게 상황을 인지할 수 있도록 합니다.
- 사용자 중심의 UI/UX: 직관적이고 사용하기 쉬운 인터페이스로 재난 상황에서 신속하게 대처할 수 있도록 설계되었습니다.
- 데이터 통합 및 분석: 다양한 공공 데이터 API와의 통합을 통해 신뢰할 수 있는 정보를 사용자에게 제공하고, 상황에 맞는 적절한 대응 방법을 안내합니다.
이 프로젝트는 다양한 데이터를 수집하여 사용자에게 제공합니다. 각 API 모듈은 다음과 같은 기능을 수행합니다:
| API 모듈 | 설명 |
|---|---|
| NationalActionTips API | 재난 상황에 따른 행동 지침을 제공하며, 다양한 파일 형식(PDF, PNG, WEBP)으로 데이터를 반환합니다. |
| Air Quality API | 특정 지역의 공기 질 정보를 OpenAQ API로부터 수집하여 제공하며, 위경도 기반 요청을 지원합니다. |
| Disaster Messages API | 공공 API로부터 재난 메시지 데이터를 수집하고, 사용자 요청에 따라 필터링된 데이터를 반환합니다. |
| News Data API | 최신 재난 관련 뉴스를 수집하고, 사용자 요청에 맞춰 제공하는 기능을 담당합니다. |
| Shelters Data API | 대피소 정보를 수집하여 사용자에게 위치 정보를 포함한 데이터를 제공하며, 실시간 위치 기반 검색을 지원합니다. |
각 API 모듈에 대한 상세한 사용법과 엔드포인트 정보는 해당 폴더의 README 파일에서 확인할 수 있습니다.
이 프로젝트를 사용하기 위해 다음 단계에 따라 설정하세요:
- 환경 변수 설정: 각 API가 요구하는 API 키를
.env파일에 저장합니다. - 데이터베이스 설정: 각 모듈에서 사용하는
db_config.php파일에 데이터베이스 연결 정보를 입력합니다. - 의존성 설치:
composer install명령어를 사용하여 필요한 PHP 패키지를 설치합니다.
본 프로젝트는 오픈 소스 프로젝트로 누구나 기여할 수 있습니다. 개선 아이디어나 버그 수정, 새로운 기능 추가에 대한 기여를 환영합니다.
이 프로젝트는 MIT 라이선스에 따라 배포됩니다. 프로젝트 사용 시 라이선스 조건을 준수해주세요.