init

app/services/notifications.py

@@ -0,0 +1,29 @@
+"""Push notifications via Firebase Cloud Messaging.
+
+TODO: Implement in Phase 2.
+"""
+
+import uuid
+
+
+def send_zone_captured(
+    victim_user_id: uuid.UUID, attacker_name: str, area_m2: float
+) -> None:
+    """Notify a user that their zone was partially captured."""
+    # Phase 2: Use firebase-admin SDK to send FCM push
+    pass
+
+
+def send_leaderboard_change(user_id: uuid.UUID, new_rank: int) -> None:
+    """Notify a user that their leaderboard position changed."""
+    pass
+
+
+def send_streak_at_risk(user_id: uuid.UUID, streak_days: int) -> None:
+    """Notify a user that their streak is about to expire."""
+    pass
+
+
+def send_friend_joined(user_id: uuid.UUID, friend_name: str) -> None:
+    """Notify a user that a friend just joined GeoZoner."""
+    pass