Guardian Izgarası

Hakkında

Guardian Grid (SF), toplulukların büyük felaketler sırasında hızlı ve güvenli bir şekilde yanıt vermesine yardımcı olan akıllı şehir acil durum tahliye aracıdır. Sistem, şehir yöneticilerinin veya acil durum yetkililerinin doğal afetlerden etkilenen bölgeler 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ı, mevcut tehlikeleri dikkate alarak sakinler için en güvenli tahliye rotalarını oluşturur ve iletir.

Bir acil durum meydana geldiğinde, yetkililer tehlike ve güvenli alanları güncelleyebilir ve hemen metin mesajı yoluyla sakinlerin telefonlarına uyarılar gönderebilir. Her kişi, mevcut konumunu kullanarak güvenliğe giden tehlike farkındalıklı bir rotayı gösteren ve Google Maps ile anlık yönlendirmeler sağlayan bir web portalına bir bağlantı alır. Durumlar geliştikçe, rotalar gerçek zamanlı olarak yeniden hesaplanır ve herkesin güncel ve güvende kalması için yeni uyarılar gönderilir. Demo’yu burada inceleyin:

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

Şu anda odak San Francisco Körfez Bölgesi’nde 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ı koruyabilen, sıkışıklığı en aza indirebilen ve acil durumlar ortaya çıktıkça hızlı yanıt verebilen, koordine ve veri odaklı tahliyeler için sağlam bir sistem sunmaktır.

Aspen Takımı

Guardian Grid, Ulusal Güvenlik Hackathonu’nda Aspen Takımı tarafından geliştirildi. Ekibimiz şunlardan 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ühendis

Mentörlerimiz ve organizatörlerimiz Elliott Wolf, Adam Papa ve Ray Del Vecchio’dan aldığımız rehberlik ve destek için minnettarız.

Hackathon Yolculuğumuz

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

Hackathon iki ayrı zorluk sundu. Birincil iz, geleneksel yerleştirme ödülleriyle proje tabanlı bir yarışmaydı, özel bir zorluk ise katılımcıları Code Metal‘in soğutma sistemlerini etik bir şekilde hacklemeye davet etti. Ekibimizin çeşitli uzmanlıkları, özellikle Dylan’ın hem yazılım hem de mekanik mühendislik geçmişi göz önüne alındığında, 24 saatlik zaman diliminde her iki zorluğu da ele alma stratejik kararını aldık.

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

1. Guardian Grid (SF) - Acil durum tahliyesine odaklanan ana hackathon projemiz:

   • Demo Videosu
   • GitHub Deposu

2. Code Metal Challenge - Soğutma sistemlerine yönelik en başarılı penetrasyon testini gerçekleştirerek 5.000 $‘lık özel ödülümüzü kazandık. Bu çözüm gizli kalmakla birlikte, 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 potansiyel etkisini ve yenilikçi yaklaşımını takdir etti. Projenin kapsamı iddialıydı ve iki zorluk arasında odaklanmayı bölmek, zaman kısıtlaması nedeniyle hayal ettiğimiz tüm özellikleri hayata geçiremeyecek olmamıza yol açtı. Yine de, jüri geri bildirimi, çözümümüzün kentsel acil durum yönetimine katkısının önemini doğruladı.

Hackathon dönüştürücü bir deneyim oldu. Teknik başarıların ve ödül parasının ötesinde, yeni dostluklar kuruldu ve baskı altında farklı beceri setlerinin bir araya gelmesinin gücü gösterildi. 2024 sonu ve 2025 başındaki kişisel zorlukların ardından bu başarı özellikle anlamlı ve canlandırıcıydı.

Hackathon Detayları

Guardian Grid (SF), Cerebral Valley ve Shield Capital’in Stanford DEFCON iş birliğiyle ev sahipliği yaptığı 2. yıllık Ulusal Güvenlik Hackathonu’nda (26-27 Nisan 2025) geliştirildi. Etkinlik, ABD askeri paydaşları tarafından belirlenen ulusal güvenlik problem açıklamaları için çözümler üretmek üzere teknologları ve mühendisleri bir araya getirdi; hükümet, askeri ve startup mentörlerinden rehberlik alındı.

• Hafta sonu, Stanford Üniversitesi’nde bir savunma teknolojisi kariyer fuarı ve takım oluşturma etkinliği, ardından San Francisco’da 24 saatlik hackleme süreci içeriyordu.
• 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 Hackle bulunuyordu.

Hackathonun ana bölümü, birinci sıra için 3.000 $ ve Starlink birimleri, ikinci sıra için 2.000 $ ve üçüncü sıra için 1.000 $ içeren ödüller sundu. Ancak, soğutma sistemi için gizli bir özel ödül de 5.000 $ değerindeydi.

Ekibimiz Akıllı Şehirler ve Bir Soğutma Sistemini Hackle zorluklarına katıldı. Guardian Grid (SF), Akıllı Şehirler girişimizdi. Soğutma zorluğundaki teknik çalışmamız için 5.000 $‘lık Özel Ödül ve Onurlu Bir Övgü kazandık; Akıllı Şehirler çözümümüz ise jüri ve akranlardan güçlü geri bildirimler aldı.

Jüri ve akranlar, 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 LLM teknolojisini tek bir çözüm olarak kullanmaktan kaçınmasını övdüler. İki zorluğa kaynakları bölmek zorunda kalmamız nedeniyle Akıllı Şehirler projemiz birinci üçe girememiş olsa da, jüri potansiyelini ve alaka düzeyini takdir etti. Ekibimiz, Bir Soğutma Sistemini Hackle yarışmasını kazanmanın yanı sıra bu tanıma layık görülmekten onur duydu.

Daha fazla detay ve düşünceyi LinkedIn Gönderimiz üzerinden bulabilir ve hackathon fotoğraf galerisini buradan inceleyebilirsiniz.

GPS Veri Kaynakları

San Francisco Körfez Bölgesi’nde yol bulma ve haritalama için kesin ve kapsamlı yol verilerine ihtiyacımız vardı. Başlangıçta bu verileri elde etmek için Google Maps API ve Mapbox API’yi denedik. Ancak lisans kısıtlamaları ve işlevsel sınırlamalar, hackathon hedeflerimizle uyumlu bir yönlendirme grafiği elde etmemizi veya kullanmamızı engelledi. Bu kısıtlamalar nedeniyle açık ham coğrafi veri setlerini kullandık. Bu ham coğrafi verileri aşağıdaki iki açık kaynak üzerinden edindik:

• San Francisco Körfez Bölgesi Karayolları (MTC Açık Veri Portalı)
• San Francisco Körfez Bölgesi Karayollarını Keşfedin

Linear features represent roadways for the San Francisco Bay Region. The feature set was assembled using all county-based 2021 TIGER/Line shapefiles by the Metropolitan Transportation Commission (MTC/ABAG). The dataset includes all primary, secondary, local neighborhood, and rural roads, city streets, vehicular trails, ramps, service drives, alleys, private roads, bike paths, bridle/horse paths, walkways, pedestrian trails, and stairways for the entire region.

• The feature set contains unique road segments for each county and includes cases where a single stretch of road has multiple designations (e.g., an interstate being called by its number and local name).
• Primary roads are major divided highways, while secondary roads are main arteries in the region.
• The dataset includes attribute columns for identifying road type, jurisdiction, and more, supporting flexible routing and data analysis.

You can read more about the licensing and data details at the MTC dataset source.

How To Run

1. Clone this repository and navigate into it.

2. Set up your .env.local file. Refer to the env.local.example file to learn what environment variables you need. Note that you will need a MapBox API key for the map UI and geocoding, a TextBelt API key for SMS alerts (demo only), as well as a phone number for texting during the demo.

3. After you create your .env.local file, you can start setting up all of GuardianGrid’s services, which include:

   • frontend: The app’s frontend interface.
   • backend: The app’s backend, including map pathfinding logic.

4. To set up the frontend service, ensure you have Yarn installed and run:

   yarn install
   

5. To set up the backend service, do the following:

   # 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 -
   

6. With everything set up, the final step is to run the app. You’ll need two separate terminal windows or tabs, referred to as Terminal #1 and Terminal #2.

7. In Terminal #1, start the backend service:

   # go into the backend service directory
   cd ./src/backend
   
   # activate the python environment
   source env/bin/activate
   
   # run the backend
   bash ./run.sh
   

8. In Terminal #2, start the frontend service:

   yarn dev
   

9. With everything running, open your browser and go to: http://localhost:3000/

10. When finished, close Terminal #1 and Terminal #2.