🚨 ResQ 🚨

Instant support for your travel emergencies!

🌐 This is the English version of the README. | 한국어 버전

🎯 Goal

Unexpected emergencies can happen anywhere and at any time.


ResQ aims to be a reliable companion that protects your life and safety in such moments.

---

💡 Key Features

🆘 Quickly request help in emergency situations

* 👆One tap to connect to an emergency hotline and start recording the situation
* Provides guidelines on how to handle common emergency situations

---

📌 Basic Features

• Log in with Google account

• Emergency response guidelines for each situation -- 🌐ko(Korean), 🌐en(English)

• Add favorite emergency responses

• Search for emergency responses that are not displayed on the main screen

---

📌 Medical Information Management

• Fill out medical information such as allergies, medications, etc. for emergencies

• Set destination country -- 🌐 KR, US, GB, JP, CN, DE, FR, MX

• Add family and friends who are traveling with you to the group

• Translate medical information of the group members into the language of the destination country

• Convert height and weight units based on the destination country's measurement system

---

📌 Situation Recording

• Automatically save audio files recorded during emergencies

• Save situation recordings as text using the Speech-to-Text API

---

🧩 Project Architecture

⚙️ Tech Stacks

stack	description
Go	main server programming language
Gin	web framework for Go-based server
MongoDB	core database for storing and managing application data
GCP (Google Cloud Platform)	cloud platform for operating the entire system infrastructure and services
Gemini	provides medical context-based translations of medical information
Google Cloud Speech-to-Text API	converts recorded emergency situation audio files to text
Elasticsearch + Monstache	synchronizes MongoDB data to enable fast search
Kibana	visualizes Elasticsearch data, provides data analysis and dashboards
Docker + GitHub Actions	builds and deploys the server automatically via a CI/CD environment
GAR (Google Artifact Registry)	stores Docker images for server deployment
GCS (Google Cloud Storage)	temporarily stores automatically recorded audio files during emergencies
Google Cloud Load Balancer	distributes traffic to ensure service load balancing and high availability
Google Cloud DNS	configures domain names to connect users to the service
Google Cloud CDN	caches static content to reduce latency and improve response times

📂 Project Structure

.
├── 🔒 auth/
├── ⭐ favorite/
├── 👥 group/
├── 🌍 language/
├── 💊 medical_info/
├── 🎤 recording/
├── 🚑 situation/
├── 👤 user/
├── 🔧 util/
├── db
│   ├── gcs.go
│   └── mongo.go
├── docs
│   ├── docs.go
│   ├── swagger.json
│   └── swagger.yaml
├── 🐋 Dockerfile
├── go.mod
├── go.sum
├── ▶️ main.go
└── README.md

▶️ How to Run

git clone https://github.com/GDG-on-Campus-KHU/SDGP_team5_BE.git

cd SDGP_team5_BE

go mod tidy

air

👥 Team Members

Name	English Name	Role	GitHub
권동현	DongHyeon Gwon	Mobile	GwonDongHyeon21
김민	Min Kim	Backend	kmin1231
김태훈	Taehoon Kim	Mobile	taeh-kim
박상영	SangYeong Park	Backend	Imsyp