How gemini-feli/climate-safe-ai-homes works
ClimateSafe AI Homes is a climate-risk and resilient-housing web platform. The documented user journey is sign-in, location-based risk analysis, personalized advice, and dashboard review; the sampled implementation shows Firebase profiles, weather alerts, and a separate Flask chat/image-analysis service. The README also describes sustainability guidance and interactive home design, but their runtime wiring is not established by the excerpts. Dashed, uncited links mark these unverified connections; unsampled subsystems are represented only where documented.
Main entry points: app.py Chat and image API · index.js Risk dashboard · WeatherController.java Weather API · frontend Web pages
Components 26
Web experience
- Web pages
frontend - Risk dashboard
frontend/js/index.js - Home design
frontend - Sustainability insights
frontend
Identity and alerts
- Firebase Auth
- Auth API
backend/src/main/java/com/climatesafe/backend/controller/AuthController.java - Auth service
backend/src/main/java/com/climatesafe/backend/service/AuthService.java - User profile
backend/src/main/java/com/climatesafe/backend/model/User.java - Firestore
- Push notifications
frontend/js/firebase-notifications.js - Alert API
backend/src/main/java/com/climatesafe/backend/controller/AlertController.java - Notification service
backend/src/main/java/com/climatesafe/backend/service/NotificationService.java
Climate analysis
- Weather API
backend/src/main/java/com/climatesafe/backend/controller/WeatherController.java - Weather service
backend/src/main/java/com/climatesafe/backend/service/WeatherService.java - Weather config
backend/src/main/java/com/climatesafe/backend/config/WeatherConfig.java - OpenWeather
- USGS events
- Risk alerts
backend/src/main/java/com/climatesafe/backend/controller/WeatherController.java
Advice services
- Chat interface
frontend/js/chat.js - Chat and image API
backend/python_service/app.py - Flood impact model
backend/python_service/app.py - Precaution rules
backend/python_service/disaster_precautions.py - Knowledge search
backend/python_service/firestore_search.py - AI text service
- Home recommendations
backend/src/main/java/com/climatesafe/backend/controller/AdviceController.java
Other components
- Homeowner
Connections 27
- Homeowner → Web pages: uses
README.md - Web pages → Auth API: registers profiles
- Web pages → Risk dashboard: opens
README.md - Risk dashboard → Weather API: requests alerts
frontend/js/index.js - Weather API → Weather service: gets weather
backend/src/main/java/com/climatesafe/backend/controller/WeatherController.java - Weather service → Weather config: reads key
backend/src/main/java/com/climatesafe/backend/service/WeatherService.java - Weather service → OpenWeather: fetches conditions
backend/src/main/java/com/climatesafe/backend/service/WeatherService.java - Weather API → USGS events: fetches events
backend/src/main/java/com/climatesafe/backend/controller/WeatherController.java - Weather API → Risk alerts: computes alerts
backend/src/main/java/com/climatesafe/backend/controller/WeatherController.java - Risk alerts → Risk dashboard: returns weather alerts
frontend/js/index.js - Auth API → Firebase Auth: creates accounts
backend/src/main/java/com/climatesafe/backend/controller/AuthController.java - Auth API → Auth service: manages profiles
backend/src/main/java/com/climatesafe/backend/controller/AuthController.java - Auth service → User profile: reads and writes
backend/src/main/java/com/climatesafe/backend/service/AuthService.java - Auth service → Firestore: reads and writes
backend/src/main/java/com/climatesafe/backend/service/AuthService.java - Risk dashboard → Firestore: reads and seeds profile
frontend/js/index.js - Risk dashboard → Push notifications: initializes
frontend/js/index.js - Push notifications → Alert API: registers token
frontend/js/firebase-notifications.js - Alert API → Notification service: sends notifications
backend/src/main/java/com/climatesafe/backend/controller/AlertController.java - Homeowner → Chat interface: asks for advice
README.md - Chat interface → Chat and image API: submits query or image
- Chat and image API → Flood impact model: classifies image
backend/python_service/app.py - Chat and image API → Precaution rules: selects guidance
backend/python_service/app.py - Chat and image API → Knowledge search: searches answers
backend/python_service/app.py - Chat and image API → AI text service: generates response
- Homeowner → Home recommendations: requests guidance
- Home recommendations → Home design: informs modifications
- Home recommendations → Sustainability insights: informs improvements