Project "CareBool"

CAREBOOL - 화재 예방 및 보험 정보 플랫폼

🔥 화재로부터 당신의 삶을 지키는 스마트한 선택

Version License Build Status Test Status

🌐 Live Demo주요 기능시작하기📖 배포 가이드기여하기


📋 목차

🎯 프로젝트 소개

CAREBOOL은 AI 기반 화재 예측과 맞춤형 보험 추천을 제공하는 종합 플랫폼입니다. 실시간 화재 위험 정보와 지역별 통계를 기반으로 사용자에게 최적의 화재 예방 솔루션을 제공합니다.

핵심 가치

🚀 주요 기능

1. 화재 위험 관리

2. 보험 서비스

3. AI 예측 시스템

4. 커뮤니티

🛠️ 기술 스택

### Frontend ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=flat-square&logo=html5&logoColor=white) ![CSS3](https://img.shields.io/badge/CSS3-1572B6?style=flat-square&logo=css3&logoColor=white) ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=flat-square&logo=javascript&logoColor=black) ### Backend ![Django](https://img.shields.io/badge/Django-092E20?style=flat-square&logo=django&logoColor=white) ![MySQL](https://img.shields.io/badge/MySQL-4479A1?style=flat-square&logo=mysql&logoColor=white) ![Celery](https://img.shields.io/badge/Celery-37814A?style=flat-square&logo=celery&logoColor=white) ### AI/ML ![Python](https://img.shields.io/badge/Python-3776AB?style=flat-square&logo=python&logoColor=white) ![scikit-learn](https://img.shields.io/badge/scikit--learn-F7931E?style=flat-square&logo=scikit-learn&logoColor=white) ![Pandas](https://img.shields.io/badge/Pandas-150458?style=flat-square&logo=pandas&logoColor=white) ### DevOps ![Docker](https://img.shields.io/badge/Docker-2496ED?style=flat-square&logo=docker&logoColor=white) ![GitHub Actions](https://img.shields.io/badge/GitHub_Actions-2088FF?style=flat-square&logo=github-actions&logoColor=white) ![Nginx](https://img.shields.io/badge/Nginx-009639?style=flat-square&logo=nginx&logoColor=white)

📂 프로젝트 구조

carebool.github.io/
├── 📁 api/                    # Django 백엔드 API
│   ├── config/               # 프로젝트 설정
│   ├── disasters/            # 재난 관리 모듈
│   ├── insurance/            # 보험 서비스 모듈
│   ├── news/                 # 뉴스 크롤링 모듈
│   └── users/                # 사용자 관리 모듈
├── 📁 web/                    # 프론트엔드
│   ├── public/               # HTML 페이지
│   ├── src/                  # CSS, JS, 이미지
│   └── static/               # 정적 리소스
├── 📁 ai-models/              # AI/ML 모델
│   ├── predict_fire_model.pkl
│   └── predictFireModel.py
├── 📁 data-management/        # 데이터 처리
│   └── 화재통계/
├── 📁 deployment/             # 배포 설정
│   ├── docker/               # Docker 구성
│   ├── nginx/                # 웹서버 설정
│   └── github-actions/       # CI/CD 파이프라인
└── 📄 index.html              # 메인 페이지

🏃 시작하기

사전 요구사항

🔧 설치 및 실행

1. 저장소 클론

git clone https://github.com/carebool/carebool.github.io.git
cd carebool.github.io

2. Frontend 실행

# Python 내장 서버
python -m http.server 8000

# 또는 Node.js
npx http-server

3. Backend 실행

# 환경 변수 설정
cp .env.example .env
# .env 파일 편집

# Docker Compose 실행
cd deployment/docker
docker-compose up -d

4. 개발 환경 설정

# API 개발
cd api
pip install -r requirements.txt
python manage.py migrate
python manage.py runserver

# AI 모델 개발
cd ai-models
pip install -r requirements.txt
python predictFireModel.py

🚀 배포

CAREBOOL은 프론트엔드와 백엔드를 분리하여 배포합니다.

GitHub Pages (Frontend)

Backend 배포

📖 상세한 배포 가이드는 DEPLOYMENT.md를 참조하세요.

📡 API 문서

주요 엔드포인트

Method Endpoint Description
GET /api/disasters/ 재난 정보 목록
GET /api/insurance/calculate/ 보험료 계산
GET /api/news/ 최신 뉴스 목록
POST /api/users/register/ 사용자 등록
GET /api/ai/predict/ 화재 위험도 예측

자세한 API 문서는 여기를 참조하세요.

🧪 테스트

# Backend 테스트
cd api
python manage.py test

# 코드 품질 검사
flake8 .
black --check .

# 테스트 커버리지
coverage run --source='.' manage.py test
coverage report

🤝 기여하기

CAREBOOL은 오픈소스 프로젝트입니다. 기여를 환영합니다!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

기여 가이드라인

📝 라이센스

이 프로젝트는 MIT 라이센스 하에 배포됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

👥 팀원

공모자들
팀장 및 프로젝트 관리 : 강성룡
프론트엔드 : 김성재, 김태식, 이나리
백엔드 : 강성룡, 안수현
contact@carebool.com

📞 문의


화재 예방과 안전한 사회를 위해 노력하는 모든 분들께 감사드립니다.

Made with ❤️ by 공모자들
© 2025 CAREBOOL. All rights reserved.