From ce58fcc9996f31b0631e12594b8cbe554f1032e9 Mon Sep 17 00:00:00 2001
From: "jetbrains-junie[bot]"
 <201638009+jetbrains-junie[bot]@users.noreply.github.com>
Date: Sun, 31 Aug 2025 16:17:02 +0000
Subject: [PATCH 1/2] feat: implement AI weather summary service with AJAX  An
 AI summary service was implemented to generate weather summaries and activity
 suggestions using LangChain4j with Google Gemini. The report page now fetches
 the summary asynchronously via AJAX. Configuration for the Google Gemini API
 key was added for live summarization.

---
 build.gradle                                  |  2 +
 .../weatherapp/ai/AiSummaryService.java       | 85 +++++++++++++++++++
 .../weatherapp/web/AiSummaryController.java   | 40 +++++++++
 src/main/resources/application.properties     |  5 ++
 src/main/resources/templates/report.html      | 55 +++++++++++-
 5 files changed, 185 insertions(+), 2 deletions(-)
 create mode 100644 src/main/java/com/example/weatherapp/ai/AiSummaryService.java
 create mode 100644 src/main/java/com/example/weatherapp/web/AiSummaryController.java

diff --git a/build.gradle b/build.gradle
index a2bfc98..d29afa8 100644
--- a/build.gradle
+++ b/build.gradle
@@ -20,6 +20,8 @@ dependencies {
 
     // LangChain4j core - used for PromptTemplate (no external API key required)
     implementation 'dev.langchain4j:langchain4j:0.35.0'
+    // LangChain4j Google Gemini (direct Gemini API via Google AI Studio)
+    implementation 'dev.langchain4j:langchain4j-google-ai-gemini:0.35.0'
 
     testImplementation 'org.springframework.boot:spring-boot-starter-test'
 }
diff --git a/src/main/java/com/example/weatherapp/ai/AiSummaryService.java b/src/main/java/com/example/weatherapp/ai/AiSummaryService.java
new file mode 100644
index 0000000..02c1d46
--- /dev/null
+++ b/src/main/java/com/example/weatherapp/ai/AiSummaryService.java
@@ -0,0 +1,85 @@
+package com.example.weatherapp.ai;
+
+import com.example.weatherapp.weather.WeatherService.WeatherReport;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import dev.langchain4j.model.chat.ChatLanguageModel;
+import dev.langchain4j.model.googleai.GoogleAiGeminiChatModel;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+
+import java.util.Objects;
+
+@Service
+public class AiSummaryService {
+
+    private final String apiKey;
+    private final String modelName;
+    private final ObjectMapper mapper = new ObjectMapper();
+
+    private volatile ChatLanguageModel cachedModel;
+
+    public AiSummaryService(
+            @Value("${ai.gemini.api-key:}") String apiKey,
+            @Value("${ai.gemini.model:gemini-1.5-flash}") String modelName
+    ) {
+        this.apiKey = apiKey == null ? "" : apiKey.trim();
+        this.modelName = (modelName == null || modelName.isBlank()) ? "gemini-1.5-flash" : modelName;
+    }
+
+    public boolean isConfigured() {
+        return apiKey != null && !apiKey.isBlank();
+    }
+
+    public String summarize(WeatherReport report, String timezone, String city) {
+        if (!isConfigured()) {
+            return "AI summary unavailable: missing Google Gemini API key.";
+        }
+        ChatLanguageModel model = getModel();
+        String reportJson;
+        try {
+            reportJson = mapper.writeValueAsString(report);
+        } catch (JsonProcessingException e) {
+            reportJson = safeReport(report);
+        }
+
+        String location = city != null && !city.isBlank() ? city : "the provided coordinates";
+        String tz = timezone != null ? timezone : "auto";
+
+        String prompt = "You are an assistant that summarizes short-term weather forecasts for lay people.\n" +
+                "Given the JSON weather report from Open-Meteo (hourly arrays for next ~72 hours) and context, provide:\n" +
+                "1) A concise overview of the upcoming weather for the next 1-3 days in " + location + " (timezone: " + tz + ").\n" +
+                "2) Practical tips.\n" +
+                "3) 3-5 activity suggestions suited to the conditions (indoor/outdoor).\n" +
+                "Be specific about temperature ranges, precipitation likelihood, wind, and humidity.\n" +
+                "Keep it under 180 words, use short paragraphs and bullet points.\n\n" +
+                "Weather JSON:\n" + reportJson + "\n\n" +
+                "Respond in plain text (no JSON).";
+
+        try {
+            return model.generate(prompt);
+        } catch (RuntimeException ex) {
+            return "AI summary unavailable at the moment. Reason: " + ex.getMessage();
+        }
+    }
+
+    private String safeReport(WeatherReport r) {
+        try { return mapper.writeValueAsString(r); } catch (Exception e) { return "{}"; }
+    }
+
+    private ChatLanguageModel getModel() {
+        ChatLanguageModel m = cachedModel;
+        if (m == null) {
+            synchronized (this) {
+                m = cachedModel;
+                if (m == null) {
+                    cachedModel = m = GoogleAiGeminiChatModel.builder()
+                            .apiKey(apiKey)
+                            .modelName(modelName)
+                            .build();
+                }
+            }
+        }
+        return m;
+    }
+}
diff --git a/src/main/java/com/example/weatherapp/web/AiSummaryController.java b/src/main/java/com/example/weatherapp/web/AiSummaryController.java
new file mode 100644
index 0000000..c4e3832
--- /dev/null
+++ b/src/main/java/com/example/weatherapp/web/AiSummaryController.java
@@ -0,0 +1,40 @@
+package com.example.weatherapp.web;
+
+import com.example.weatherapp.ai.AiSummaryService;
+import com.example.weatherapp.weather.WeatherService.WeatherReport;
+import org.springframework.http.HttpStatus;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.Map;
+
+@RestController
+@RequestMapping("/api/ai-summary")
+public class AiSummaryController {
+
+    private final AiSummaryService aiSummaryService;
+
+    public AiSummaryController(AiSummaryService aiSummaryService) {
+        this.aiSummaryService = aiSummaryService;
+    }
+
+    @PostMapping(consumes = MediaType.APPLICATION_JSON_VALUE, produces = MediaType.APPLICATION_JSON_VALUE)
+    public ResponseEntity<?> summarize(@RequestBody WeatherReport report,
+                                       @RequestParam(value = "timezone", required = false) String timezone,
+                                       @RequestParam(value = "city", required = false) String city) {
+        try {
+            String text = aiSummaryService.summarize(report, timezone, city);
+            return ResponseEntity.ok(Map.of(
+                    "summary", text,
+                    "model", "gemini",
+                    "configured", aiSummaryService.isConfigured()
+            ));
+        } catch (Exception e) {
+            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(Map.of(
+                    "summary", "AI summary failed.",
+                    "error", e.getMessage()
+            ));
+        }
+    }
+}
diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties
index 0c074a1..5585809 100644
--- a/src/main/resources/application.properties
+++ b/src/main/resources/application.properties
@@ -1,3 +1,8 @@
 spring.application.name=weather-app-java
 server.port=8080
 spring.thymeleaf.cache=false
+
+# Google Gemini API configuration (Google AI Studio / Generative Language API)
+# Provide via environment variable for security in production
+ai.gemini.api-key=${GOOGLE_GEMINI_API_KEY:}
+ai.gemini.model=${GOOGLE_GEMINI_MODEL:gemini-1.5-flash}
diff --git a/src/main/resources/templates/report.html b/src/main/resources/templates/report.html
index c218800..a9f42db 100644
--- a/src/main/resources/templates/report.html
+++ b/src/main/resources/templates/report.html
@@ -92,10 +92,10 @@
     <a href="/" class="back">← Back</a>
     <h1>
       Weather report
-      <span th:if="${city}">for <span th:text="${city}"></span></span>
+      <span th:if="${city}">for <span id="cityName" th:text="${city}"></span></span>
       (<span th:text="${lat}">lat</span>, <span th:text="${lon}">lon</span>)
     </h1>
-    <p class="muted">Timezone: <span th:text="${timezone}">auto</span></p>
+    <p class="muted">Timezone: <span id="tz" th:text="${timezone}">auto</span></p>
 
     <div th:if="${error}" class="error" th:text="${error}">An error occurred</div>
 
@@ -106,6 +106,11 @@ <h1>
       <div id="humidityChart" class="chart"></div>
     </div>
 
+    <div id="aiSummary" class="card" style="margin-top: 1rem;">
+      <h2 style="margin-top:0; font-size: 1.2rem;">AI summary & activity suggestions</h2>
+      <div id="aiSummaryContent" class="muted">Generating AI summary…</div>
+    </div>
+
     <script id="report-json" type="application/json" th:utext="${reportJson}">{}</script>
 
     <script>
@@ -117,6 +122,8 @@ <h1>
       let chartDataCache = {};
 
       function drawCharts() {
+        // Kick off AI summary fetch in parallel and not blocking charts
+        fetchAiSummary();
         const jsonEl = document.getElementById('report-json');
         if (!jsonEl) return;
         let report;
@@ -214,6 +221,50 @@ <h1>
         chart.draw(data, options);
       }
 
+      async function fetchAiSummary() {
+        const jsonEl = document.getElementById('report-json');
+        const target = document.getElementById('aiSummaryContent');
+        if (!jsonEl || !target) return;
+        let report;
+        try {
+          report = JSON.parse(jsonEl.textContent || '{}');
+        } catch (e) {
+          target.textContent = 'AI summary unavailable (invalid report data).';
+          return;
+        }
+        try {
+          const params = new URLSearchParams();
+          const tz = document.getElementById('tz')?.textContent || undefined;
+          const city = document.getElementById('cityName')?.textContent || undefined;
+          if (tz) params.set('timezone', tz);
+          if (city) params.set('city', city);
+
+          const resp = await fetch('/api/ai-summary' + (params.toString() ? ('?' + params.toString()) : ''), {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(report)
+          });
+          const data = await resp.json();
+          if (!resp.ok) {
+            target.textContent = data?.summary || 'AI summary failed.';
+            target.classList.remove('muted');
+            return;
+          }
+          const summary = data?.summary || 'No AI summary available.';
+          target.textContent = '';
+          // Render as simple paragraphs, split on double newlines
+          summary.split(/\n\n+/).forEach(p => {
+            const para = document.createElement('p');
+            para.textContent = p;
+            target.appendChild(para);
+          });
+          target.classList.remove('muted');
+        } catch (err) {
+          target.textContent = 'AI summary unavailable.';
+          target.classList.remove('muted');
+        }
+      }
+
       // Redraw charts on window resize
       window.addEventListener('resize', () => {
         if (Object.keys(chartDataCache).length > 0) {

From e74bafd5a5e1ffe6331ebd9634c9109464ab1444 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ivan=20=C5=A0ari=C4=87?= <invoices@path-variable.com>
Date: Sun, 31 Aug 2025 16:52:54 +0000
Subject: [PATCH 2/2] Pending changes exported from your codespace

---
 .../weatherapp/weather/WeatherService.java    | 144 +++++++++++++-----
 src/main/resources/application.properties     |   2 +-
 src/main/resources/templates/report.html      |  20 +--
 3 files changed, 116 insertions(+), 50 deletions(-)

diff --git a/src/main/java/com/example/weatherapp/weather/WeatherService.java b/src/main/java/com/example/weatherapp/weather/WeatherService.java
index 7d0ce47..0f2a3c5 100644
--- a/src/main/java/com/example/weatherapp/weather/WeatherService.java
+++ b/src/main/java/com/example/weatherapp/weather/WeatherService.java
@@ -32,15 +32,15 @@ public WeatherReport fetchHourlyReport(double lat, double lon) {
                         "temperature_2m",
                         "precipitation",
                         "wind_speed_10m",
-                        "relative_humidity_2m"
-                ))
+                        "relative_humidity_2m"))
                 .queryParam("forecast_days", 3)
                 .queryParam("timezone", "auto")
                 .toUriString();
 
         ResponseEntity<Map> resp = restTemplate.getForEntity(url, Map.class);
         Map body = resp.getBody();
-        if (body == null) throw new IllegalStateException("Empty response from weather API");
+        if (body == null)
+            throw new IllegalStateException("Empty response from weather API");
 
         // Map response into our DTO
         WeatherReport report = new WeatherReport();
@@ -52,11 +52,13 @@ public WeatherReport fetchHourlyReport(double lat, double lon) {
         if (!(hourlyObj instanceof Map<?, ?> hourly)) {
             throw new IllegalStateException("Unexpected response: missing hourly");
         }
-        report.setTimes(asStringList(hourly.get("time")));
-        report.setTemperature2m(asDoubleList(hourly.get("temperature_2m")));
-        report.setPrecipitation(asDoubleList(hourly.get("precipitation")));
-        report.setWindSpeed10m(asDoubleList(hourly.get("wind_speed_10m")));
-        report.setRelativeHumidity2m(asDoubleList(hourly.get("relative_humidity_2m")));
+        WeatherReport.Hourly hourlyData = new WeatherReport.Hourly();
+        hourlyData.setTime(asStringList(hourly.get("time")));
+        hourlyData.setTemperature2m(asDoubleList(hourly.get("temperature_2m")));
+        hourlyData.setPrecipitation(asDoubleList(hourly.get("precipitation")));
+        hourlyData.setWindSpeed10m(asDoubleList(hourly.get("wind_speed_10m")));
+        hourlyData.setRelativeHumidity2m(asDoubleList(hourly.get("relative_humidity_2m")));
+        report.setHourly(hourlyData);
 
         return report;
     }
@@ -72,14 +74,21 @@ private static List<String> asStringList(Object o) {
 
     @SuppressWarnings("unchecked")
     private static List<Double> asDoubleList(Object o) {
-        if (o == null) return null;
+        if (o == null)
+            return null;
         return ((List<?>) o).stream().map(WeatherService::asDouble).toList();
     }
 
     private static Double asDouble(Object o) {
-        if (o == null) return null;
-        if (o instanceof Number n) return n.doubleValue();
-        try { return Double.parseDouble(String.valueOf(o)); } catch (Exception e) { return null; }
+        if (o == null)
+            return null;
+        if (o instanceof Number n)
+            return n.doubleValue();
+        try {
+            return Double.parseDouble(String.valueOf(o));
+        } catch (Exception e) {
+            return null;
+        }
     }
 
     @JsonIgnoreProperties(ignoreUnknown = true)
@@ -87,30 +96,91 @@ public static class WeatherReport {
         private Double latitude;
         private Double longitude;
         private String timezone;
-        private List<String> times;
-        @JsonProperty("temperature_2m")
-        private List<Double> temperature2m;
-        private List<Double> precipitation;
-        @JsonProperty("wind_speed_10m")
-        private List<Double> windSpeed10m;
-        @JsonProperty("relative_humidity_2m")
-        private List<Double> relativeHumidity2m;
-
-        public Double getLatitude() { return latitude; }
-        public void setLatitude(Double latitude) { this.latitude = latitude; }
-        public Double getLongitude() { return longitude; }
-        public void setLongitude(Double longitude) { this.longitude = longitude; }
-        public String getTimezone() { return timezone; }
-        public void setTimezone(String timezone) { this.timezone = timezone; }
-        public List<String> getTimes() { return times; }
-        public void setTimes(List<String> times) { this.times = times; }
-        public List<Double> getTemperature2m() { return temperature2m; }
-        public void setTemperature2m(List<Double> temperature2m) { this.temperature2m = temperature2m; }
-        public List<Double> getPrecipitation() { return precipitation; }
-        public void setPrecipitation(List<Double> precipitation) { this.precipitation = precipitation; }
-        public List<Double> getWindSpeed10m() { return windSpeed10m; }
-        public void setWindSpeed10m(List<Double> windSpeed10m) { this.windSpeed10m = windSpeed10m; }
-        public List<Double> getRelativeHumidity2m() { return relativeHumidity2m; }
-        public void setRelativeHumidity2m(List<Double> relativeHumidity2m) { this.relativeHumidity2m = relativeHumidity2m; }
+        private Hourly hourly;
+
+        public Double getLatitude() {
+            return latitude;
+        }
+
+        public void setLatitude(Double latitude) {
+            this.latitude = latitude;
+        }
+
+        public Double getLongitude() {
+            return longitude;
+        }
+
+        public void setLongitude(Double longitude) {
+            this.longitude = longitude;
+        }
+
+        public String getTimezone() {
+            return timezone;
+        }
+
+        public void setTimezone(String timezone) {
+            this.timezone = timezone;
+        }
+
+        public Hourly getHourly() {
+            return hourly;
+        }
+
+        public void setHourly(Hourly hourly) {
+            this.hourly = hourly;
+        }
+
+        // Nested class to match the "hourly" object structure
+        @JsonIgnoreProperties(ignoreUnknown = true)
+        public static class Hourly {
+            private List<String> time;
+            @JsonProperty("temperature_2m")
+            private List<Double> temperature2m;
+            private List<Double> precipitation;
+            @JsonProperty("wind_speed_10m")
+            private List<Double> windSpeed10m;
+            @JsonProperty("relative_humidity_2m")
+            private List<Double> relativeHumidity2m;
+
+            public List<String> getTime() {
+                return time;
+            }
+
+            public void setTime(List<String> time) {
+                this.time = time;
+            }
+
+            public List<Double> getTemperature2m() {
+                return temperature2m;
+            }
+
+            public void setTemperature2m(List<Double> temperature2m) {
+                this.temperature2m = temperature2m;
+            }
+
+            public List<Double> getPrecipitation() {
+                return precipitation;
+            }
+
+            public void setPrecipitation(List<Double> precipitation) {
+                this.precipitation = precipitation;
+            }
+
+            public List<Double> getWindSpeed10m() {
+                return windSpeed10m;
+            }
+
+            public void setWindSpeed10m(List<Double> windSpeed10m) {
+                this.windSpeed10m = windSpeed10m;
+            }
+
+            public List<Double> getRelativeHumidity2m() {
+                return relativeHumidity2m;
+            }
+
+            public void setRelativeHumidity2m(List<Double> relativeHumidity2m) {
+                this.relativeHumidity2m = relativeHumidity2m;
+            }
+        }
     }
 }
diff --git a/src/main/resources/application.properties b/src/main/resources/application.properties
index 5585809..a8cca54 100644
--- a/src/main/resources/application.properties
+++ b/src/main/resources/application.properties
@@ -4,5 +4,5 @@ spring.thymeleaf.cache=false
 
 # Google Gemini API configuration (Google AI Studio / Generative Language API)
 # Provide via environment variable for security in production
-ai.gemini.api-key=${GOOGLE_GEMINI_API_KEY:}
+ai.gemini.api-key=${AI_API_KEY:}
 ai.gemini.model=${GOOGLE_GEMINI_MODEL:gemini-1.5-flash}
diff --git a/src/main/resources/templates/report.html b/src/main/resources/templates/report.html
index 666d6a0..a6bbe6e 100644
--- a/src/main/resources/templates/report.html
+++ b/src/main/resources/templates/report.html
@@ -85,6 +85,7 @@
     }
   </style>
   <script src="https://www.gstatic.com/charts/loader.js"></script>
+  <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
 </head>
 
 <body>
@@ -102,6 +103,11 @@ <h1>
 
     <div id="loading" class="muted">Loading weather data…</div>
 
+    <div id="aiSummary" class="card" style="margin-top: 1rem;">
+      <h2 style="margin-top:0; font-size: 1.2rem;">AI summary & activity suggestions</h2>
+      <div id="aiSummaryContent" class="muted">Generating AI summary…</div>
+    </div>
+
     <div id="charts" class="charts" style="display:none">
       <div id="tempChart" class="chart"></div>
       <div id="precipChart" class="chart"></div>
@@ -109,11 +115,6 @@ <h1>
       <div id="humidityChart" class="chart"></div>
     </div>
 
-    <div id="aiSummary" class="card" style="margin-top: 1rem;">
-      <h2 style="margin-top:0; font-size: 1.2rem;">AI summary & activity suggestions</h2>
-      <div id="aiSummaryContent" class="muted">Generating AI summary…</div>
-    </div>
-
     <script id="report-json" type="application/json" th:utext="${reportJson}">{}</script>
 
     <script>
@@ -286,13 +287,8 @@ <h2 style="margin-top:0; font-size: 1.2rem;">AI summary & activity suggestions</
             return;
           }
           const summary = data?.summary || 'No AI summary available.';
-          target.textContent = '';
-          // Render as simple paragraphs, split on double newlines
-          summary.split(/\n\n+/).forEach(p => {
-            const para = document.createElement('p');
-            para.textContent = p;
-            target.appendChild(para);
-          });
+          // Render markdown using marked.js
+          target.innerHTML = marked.parse(summary);
           target.classList.remove('muted');
         } catch (err) {
           target.textContent = 'AI summary unavailable.';