🥾 발자취 (Project Footprint)

2020 공개 SW 개발자 대회 결선 진출작

발자취는 BLE(Bluetooth Low Energy) 핵심 기술인 'Beacon' 모듈을 활용하여, 사용자가 특정 장소를 방문하면, 이를 저장하여 자동으로 하루 일과를 기록해주는 서비스입니다. 자동으로 기록된 일과는 사용자의 마음대로 자신만의 다이어리 처럼 꾸밀 수 있습니다. 또한 임의로 다른 일과를 추가할 수도 있습니다. 이렇게 쌓인 사용자의 기록 하나하나가 서버에 저장되어, 자신만의 추억으로 간직하거나 SNS에 공유할 수 있습니다.

📺 시나리오 소개 동영상

📷 Screenshot

⚙️ Development Environment

🖥 System Architecture

📝 Features

🔥 Getting Started

필요한 코드 사용이 용이하도록 코드에 동작 설명 주석이 첨부 되어있습니다. 기본적인 사용법은 다음과 같습니다.

순서대로 환경을 설정해야 정상적으로 동작합니다.

Django Web Server

1. 'Web' 폴더에 들어있는 프로젝트 폴더를 내려받아 'PyCharm'을 통해 오픈 합니다.

2. Venv 에 진입한 다음, 아래의 명령어를 실행합니다.

   pip install -r requirements.txt

3. settings.py 에서 사용할 데이터베이스 설정을 완료해줍니다. (MySQL으로 기본 세팅 되어있습니다.)

4. 아래 명령어를 실행하여 관리자 계정을 만듭니다. 관리자 페이지 URL은 "localhost:8000/admin" 입니다.

   python manage.py createsuperuser

5. 아래 명령어를 실행하여 데이터베이스 마이그레이션을 한 뒤, 서버 구동을 시작합니다.

   python manage.py makemigrations website
   python manage.py migrate
   python manage.py runserver

6. 웹 사이트가 잘 뜨고, 모바일 앱의 동작이 원활하게 이루어질 시 적용 성공입니다.

7. 모바일 앱 대응을 위하여 호스팅을 해줘야하는데, 실제 서비스를 런칭하거나 배포를 하는 것이 아닌 테스트용 Self-Hosting을 할 때는 Ngrok 같은 서비스를 이용하여 외부에서도 접속가능한 URL을 부여할 수 있습니다.

Server Admin Page

1. 웹 서버가 구동되면,127.0.0.1:8000/admin (관리자 페이지)으로 접속합니다.
2. 생성했던 관리자 계정을 통해 로그인 하며 간편한 데이터베이스 관리가 가능합니다.
3. Beacon Module을 등록하고 싶으면 Place 모델 인스턴스를 생성하면 됩니다.
   • 이 때, Beacon Module의 UUID와 등록하고 싶은 장소의 네이버 플레이스 ID를 기입합니다.
   • Beacon Module은 라즈베리파이, 아두이노가 없어도 Beacon Signal을 Advertising 할 수 있는 앱을 설치하여 그 기능을 대체할 수 있으며 해당 앱에서 Beacon Module의 UUID 값을 찾아 입력하시면 됩니다.
   • 네이버 플레이스 ID는 map.naver.com에서 등록할 장소를 검색하고 브라우저 상 주소 경로의 /place/ 뒤의 ID를 적어주시면 됩니다.

Android App

1. 'App' 폴더에 들어있는 프로젝트 폴더를 내려 받아 'Android Studio'를 통해 오픈 합니다.
2. 'Network' 폴더에 들어있는 Website 클래스의 BaseURL을 구동하는 서버의 URL로 변경합니다.
3. 실제 기기를 통해 앱을 구동합니다. ( 에뮬레이터는 Bluetooth 관련 기능을 사용하지 못합니다. )

✋ Part