Guardian Grid SF

Hakkında

Guardian Grid (SF), büyük afetler sırasında toplulukların hızlı ve güvenli bir şekilde tepki vermesine yardımcı olan bir akıllı şehir acil tahliye aracıdır. Sistem, şehir yöneticilerinin veya acil durum yetkililerinin etkilenen doğal afet alanları gibi tehlike bölgelerini işaretlemesine ve etkileşimli bir harita üzerinde doğrudan güvenli bölgeler tanımlamasına olanak tanır. Gelişmiş yol bulma algoritmaları daha sonra mevcut tehlikeleri dikkate alarak sakinler için en güvenli tahliye rotalarını oluşturmak ve iletmek için kullanılır.

Bir acil durum gerçekleştiğinde, yetkililer tehlike ve güvenli alanları güncelleyebilir ve derhal sakinlerin telefonlarına kısa mesaj yoluyla uyarılar gönderebilir. Her kişiye, mevcut konumlarını kullanarak tehlikeyi göz önünde bulunduran bir güvenliğe yönlendiren rota gösteren ve Google Maps ile anında yol tarifi sağlayan bir web portalına bağlantı gönderilir. Durumlar geliştikçe, rotalar gerçek zamanlı olarak yeniden hesaplanır ve herkesi güncel ve güvende tutmak için yeni uyarılar gönderilir. Demoyu buradan izleyin:

Mevcut gösterim kodunda, uyarılar demo ve test amaçlı tek bir telefon numarasına SMS ile gönderilmektedir. Ancak gerçek bir dağıtımda Guardian Grid SF, etkilenen şehir veya bölgedeki herkese tahliye uyarıları yayınlamak için Kablosuz Acil Durum Uyarıları (WEA) sistemi ile entegre olurdu.

Mevcut odak San Francisco Körfez Bölgesi olsa da, vizyonumuz Guardian Grid’i dünya çapındaki diğer büyük şehirlere genişletmektir. Amacımız, her şehrin insanlarını koruyabilmesi, tıkanıklığı en aza indirebilmesi ve acil durumlar gelişirken hızlıca yanıt verebilmesi için koordineli ve veri odaklı tahliyeler sağlayan sağlam bir sistem sunmaktır.

Ekip Aspen

Guardian Grid, National Security Hackathon’da Team Aspen tarafından geliştirildi. Ekibimiz şu kişilerden oluşuyordu:

Ioana Munteanu - Yazılım Mühendisi
Christina Huang - Yazılım Mühendisi
Mehmet Yilmaz - Yazılım Mühendisi
Dylan Eck - Yazılım ve Mekanik Mühendisi

Elliott Wolf, Adam Papa ve Ray Del Vecchio dahil olmak üzere mentorlarımızın ve organizatörlerimizin rehberliği ve desteği için minnettarız.

Hackathon Yolculuğumuz

26-27 Nisan 2025 hackathon haftasonu, beklenmedik ama güçlü bir iş birliğini bir araya getirdi. Yakın arkadaşım Dylan Eck ve ben sırasıyla Colorado ve Missouri’den San Francisco’daki Cerebral Valley’in 2. Ulusal Güvenlik Hackathonu’na katılmak için seyahat ettik. Etkinlik başlangıcında Christina Huang ve Ioana Munteanu ile tanıştık ve Team Aspen doğdu.

Ioana'nın hackathon deneyimimizi vurgulayan LinkedIn gönderisi

Hackathon iki ayrı zorluk sundu. Birincil yol, geleneksel ödül sıralamalarına sahip proje tabanlı bir yarışmaydı; özel bir meydan okuma ise katılımcıları Code Metal’in soğutma sistemlerini etik olarak hacklemeye davet etti. Ekibimizin çeşitli uzmanlıkları, özellikle Dylan’ın yazılım ve mekanik mühendisliği geçmişi göz önüne alındığında, 24 saatlik zaman diliminde her iki meydan okumayı da ele alma yönünde stratejik bir karar verdik.

Bu iddialı yaklaşım iki önemli sonuca yol açtı:

Guardian Grid (SF) - Ana hackathon projemiz acil tahliyeye odaklandı:
- Demo Videosu
- GitHub Deposu
Code Metal Meydan Okuması - Soğutma sistemlerinin en başarılı sızma testini gerçekleştirdik ve bu da bize 5.000$ özel ödül kazandırdı. Bu çözüm gizli tutulsa da, ekibimizin hem yazılım hem de termodinamik sistemlerdeki teknik derinliğini gösterdi.

Guardian Grid ana yarışmada ilk üçe girememiş olsa da, jüri etkisini ve yenilikçi yaklaşımını takdir etti. Projenin kapsamı iddialıydı ve iki meydan okuma arasında odağı bölmemiz, tüm planladığımız özellikleri zaman kısıtlaması içinde uygulayamamıza neden oldu. Yine de jürilerin geri bildirimi, çözümümüzün kentsel acil durum yönetimi alanında önemini doğruladı.

Hackathon dönüştürücü bir deneyim oldu. Teknik başarıların ve ödülün ötesinde, yeni dostluklar kuruldu ve çeşitli yetenek setlerinin baskı altında birleştiğinde ortaya koyduğu güç gösterildi. 2024 sonu ve 2025 başında yaşadığım kişisel zorlukların ardından bu başarı özellikle anlamlı ve canlandırıcı oldu.

Hackathon Detayları

Guardian Grid (SF), Cerebral Valley ve Shield Capital tarafından Stanford DEFCON iş birliğiyle düzenlenen 2. yıllık Ulusal Güvenlik Hackathonu (26-27 Nisan 2025) kapsamında geliştirildi. Etkinlik, ABD askeri paydaşları tarafından seçilen ulusal güvenlik problem beyannameleri için çözümler oluşturmak üzere teknologları ve mühendisleri bir araya getirdi; hükümet, askeri ve startup mentorlerinin rehberliğinde gerçekleştirildi.

Hafta sonu, Stanford Üniversitesi’nde bir savunma teknoloji kariyer fuarı ve ekip oluşturma etkinliği ile başladı, ardından San Francisco’da 24 saatlik hack süreci yapıldı.
Sponsorlar ve destekçiler arasında Shield Capital, In-Q-Tel, NATO Innovation Fund, Vannevar Labs, Scale AI, Groq, Windsurf, Anthropic, Microsoft, Maxar, Dedrone, Distributed Spectrum ve Code Metal yer aldı.
Hackathon kategorileri arasında Akıllı Şehirler, Savaş Oyunları, Denizcilik Desen Analizi, AI Dağıtımları için Siber Güvenlik, Radyo Frekansı Navigasyonu, Genel Ulusal Güvenlik ve Bir Soğutma Sistemini Hackleme yer aldı.

Hackathonun ana bölümünde ödüller birinci için 3.000$ ve Starlink üniteleri, ikinci için 2.000$ ve üçüncü için 1.000$ dahil olmak üzere verildi. Ancak soğutma sistemi meydan okuması için gizli ve özel bir ödül olarak 5.000$ tutarında bir ödül vardı.

Ekibimiz hem Akıllı Şehirler hem de Bir Soğutma Sistemini Hackle meydan okumalarına katıldı. Guardian Grid (SF) bizim Akıllı Şehirler girişimizdi. Soğutma meydan okumasındaki teknik çalışmamız için 5.000$ Özel Ödül ve Şeref Ödülü kazandık ve Akıllı Şehirler çözümümüz jüri ve meslektaşlardan güçlü geri bildirim aldı.

Jüri ve meslektaşlar, Guardian Grid (SF)‘yi acil durum yönetimindeki önemli bir soruna etkili bir yanıt olarak tanıdı; yaratıcılığını, pratik yaklaşımını ve her şeyi LLM teknolojisini her işe yaramış bir çözüm olarak kullanmaktan kaçınmasını övdüler. Akıllı Şehirler projemiz, kaynakları iki meydan okuma arasında bölünmesi nedeniyle zaman kısıtlaması yüzünden ilk üçe girememiş olsa da, jüri potansiyelini ve alaka düzeyini etkileyici buldu. Ekibimiz, Bir Soğutma Sistemini Hackle meydan okumasını kazanmanın yanı sıra bu tanınmayı almaktan onur duydu.

Daha fazla detay ve düşünceyi LinkedIn gönderimizde bulun ve hackathon fotoğraf galerisine buradan göz atın.

GPS Veri Kaynakları

San Francisco Körfez Bölgesi’nde yol bulma ve haritalama için hassas ve kapsamlı yol verilerine ihtiyaç duyduk. Başlangıçta bu verileri almak için hem Google Maps API hem de Mapbox’un API’si ile denemeler yaptık. Ancak lisans kısıtlamaları ve işlevsel sınırlamalar, temel yönlendirme grafiğini hackathon hedeflerimizle uyumlu bir şekilde elde etmemizi veya kullanmamızı engelledi. Bu kısıtlamalar nedeniyle açık ham coğrafi veri kümelerini kullandık. Bu ham coğrafi verileri şu iki açık kaynak kaynaktan aldık:

Lineer özellikler San Francisco Körfez Bölgesi için yol ağını temsil eder. Özellik kümesi, Metropolitan Transportation Commission (MTC/ABAG) tarafından sağlanan tüm ilçe bazlı 2021 TIGER/Line şekil dosyaları kullanılarak oluşturulmuştur. Veri seti, bölgedeki tüm birincil, ikincil, yerel mahalle ve kırsal yolları, şehir sokaklarını, motorlu araç yollarını, rampaları, servis yollarını, ara sokakları, özel yolları, bisiklet yollarını, binicilik/at yollarını, yürüyüş yollarını, yaya patikalarını ve merdivenleri içerir.

Özellik kümesi, her ilçe için benzersiz yol segmentleri içerir ve tek bir yol kesitinin birden fazla tanıma sahip olduğu durumları kapsar (ör. bir eyaletler arası yolun numarasıyla ve yerel adıyla anılması).
Birincil yollar büyük bölünmüş otoyollardır, ikincil yollar ise bölgedeki ana arterlerdir.
Veri seti, yol türünü, yetki alanını ve daha fazlasını tanımlayan öznitelik sütunlarını içerir; esnek yönlendirme ve veri analizini destekler.

Daha fazla lisanslama ve veri ayrıntısı bilgisi için MTC veri kümesi kaynağı sayfasını okuyabilirsiniz.

Nasıl Çalıştırılır

Bu depoyu klonlayın ve içine gidin.
.env.local dosyanızı yapılandırın. Hangi ortam değişkenlerine ihtiyacınız olduğunu öğrenmek için env.local.example dosyasına bakın. Harita kullanıcı arayüzü ve geokodlama için bir MapBox API anahtarı, SMS uyarıları için (sadece demo) bir TextBelt API anahtarı ve demo sırasında mesaj göndermek için bir telefon numarasına ihtiyacınız olacağını unutmayın.
.env.local dosyanızı oluşturduktan sonra, GuardianGrid’in hizmetlerini kurmaya başlayabilirsiniz; bunlar şunları içerir:
- ön uç: Uygulamanın ön uç arayüzü.
- arka uç: Harita yol bulma mantığını içeren uygulamanın arka ucu.
ön uç hizmetini kurmak için, Yarn‘ın yüklü olduğundan emin olun ve şu komutu çalıştırın:
```
yarn install
```

arka uç hizmetini kurmak için, aşağıdakileri yapın:

# go into this directory
cd ./src/backend

# set up a python environment
python3 -m venv env

# activate the python environment
source env/bin/activate

# install dependencies
pip3 install -r requirements.txt

# deactivate python environment
deactivate

# return to the project's root directory
cd -

Her şey kurulduktan sonra, son adım uygulamayı çalıştırmaktır. İki ayrı terminal penceresine veya sekmesine ihtiyacınız olacak; bunlar Terminal #1 ve Terminal #2 olarak adlandırılacaktır.

Terminal #1‘de arka uç hizmetini başlatın:

# go into the backend service directory
cd ./src/backend

# activate the python environment
source env/bin/activate

# run the backend
bash ./run.sh

Terminal #2‘de ön uç hizmetini başlatın:
```
yarn dev
```
Her şey çalışıyor durumda iken, tarayıcınızı açın ve şu adrese gidin: http://localhost:3000/
İşiniz bittiğinde Terminal #1 ve Terminal #2‘yi kapatın.