From e2f00c6e21e7ae2c1393bc4654db68aa48520bc1 Mon Sep 17 00:00:00 2001
From: "kihong.kim" <kihong.kim@yanolja.com>
Date: Sat, 31 Jan 2026 21:19:13 +0900
Subject: [PATCH] feat: Enhance TV support and Daily Weather Forecast (w/ Air
 Quality)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- **Frontend (Flutter)**
    - Optimize for Google TV: Force Landscape mode, disable touchscreen requirement, and set TV Dashboard as default home.
    - Weather Widget:
        - Add Daily Max/Min temperature ('최고/최저').
        - Add Air Quality Index (AQI) with visual indicator ('미세먼지').
        - Increase font sizes and adjust layout to match Digital Clock style.
        - Implement 1-hour auto-refresh timer.
    - Model: Update WeatherInfo to support tempMin, tempMax, and aqi.

- **Backend (Node.js)**
    - Weather API (/api/weather):
        - Implement daily forecast aggregation logic (Seoul Time KST) to calculate accurate daily High/Low.
        - Integrate OpenWeatherMap Air Pollution API to fetch AQI.
---
 backend/routes/weather.js                     |  51 +++++-
 .../android/app/src/main/AndroidManifest.xml  |   4 +
 flutter_app/lib/main.dart                     |  18 +-
 flutter_app/lib/models/weather_info.dart      |   9 +
 flutter_app/lib/services/mock_data.dart       |   3 +
 flutter_app/lib/widgets/weather_widget.dart   | 165 ++++++++++++++++--
 6 files changed, 217 insertions(+), 33 deletions(-)

diff --git a/backend/routes/weather.js b/backend/routes/weather.js
index 7178b4a..1e08c19 100644
--- a/backend/routes/weather.js
+++ b/backend/routes/weather.js
@@ -25,9 +25,56 @@ router.get("/", async (req, res) => {
       params.q = q || city;
     }
 
-    const response = await axios.get(`${baseUrl}/weather`, { params });
-    res.json(response.data);
+    // 1. Fetch Current Weather (to get lat/lon and timezone)
+    const currentResponse = await axios.get(`${baseUrl}/weather`, { params });
+    const currentData = currentResponse.data;
+    const { coord } = currentData;
+
+    // 2. Fetch Forecast (for daily min/max) & Air Quality
+    const [forecastResponse, airResponse] = await Promise.all([
+      axios.get(`${baseUrl}/forecast`, {
+        params: { ...params, lat: coord.lat, lon: coord.lon },
+      }),
+      axios.get(`${baseUrl}/air_pollution`, {
+        params: { lat: coord.lat, lon: coord.lon, appid: apiKey },
+      }),
+    ]);
+
+    // 3. Process Forecast for Today's Min/Max (Seoul Time: UTC+9)
+    // OpenWeatherMap returns timestamps in UTC.
+    // Seoul is UTC+9.
+    const SeoulOffset = 9 * 60 * 60 * 1000;
+    const nowKST = new Date(Date.now() + SeoulOffset);
+    const todayStr = nowKST.toISOString().split("T")[0]; // YYYY-MM-DD in KST
+
+    const todayItems = forecastResponse.data.list.filter((item) => {
+      const itemDateKST = new Date(item.dt * 1000 + SeoulOffset);
+      const itemDateStr = itemDateKST.toISOString().split("T")[0];
+      return itemDateStr === todayStr;
+    });
+
+    if (todayItems.length > 0) {
+      // Find min and max from the 3-hour segments
+      const minTemp = Math.min(...todayItems.map((item) => item.main.temp_min));
+      const maxTemp = Math.max(...todayItems.map((item) => item.main.temp_max));
+
+      // Update the response structure
+      currentData.main.temp_min = minTemp;
+      currentData.main.temp_max = maxTemp;
+    }
+
+    // 4. Attach Air Quality (AQI)
+    // OpenWeatherMap AQI: 1 (Good) ... 5 (Very Poor)
+    if (airResponse.data.list && airResponse.data.list.length > 0) {
+      currentData.aqi = airResponse.data.list[0].main.aqi;
+    }
+
+    res.json(currentData);
   } catch (error) {
+    console.error("Weather API Error:", error.message);
+    if (error.response) {
+      console.error("Data:", error.response.data);
+    }
     res.status(500).json({ message: "Failed to fetch weather" });
   }
 });
diff --git a/flutter_app/android/app/src/main/AndroidManifest.xml b/flutter_app/android/app/src/main/AndroidManifest.xml
index a4f82cd..5db760f 100644
--- a/flutter_app/android/app/src/main/AndroidManifest.xml
+++ b/flutter_app/android/app/src/main/AndroidManifest.xml
@@ -3,6 +3,9 @@
     <uses-feature
         android:name="android.software.leanback"
         android:required="false" />
+    <uses-feature
+        android:name="android.hardware.touchscreen"
+        android:required="false" />
     <application
         android:label="google_tv_dashboard"
         android:name="${applicationName}"
@@ -16,6 +19,7 @@
             android:theme="@style/LaunchTheme"
             android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
             android:hardwareAccelerated="true"
+            android:screenOrientation="landscape"
             android:windowSoftInputMode="adjustResize">
             <!-- Specifies an Android theme to apply to this Activity as soon as
                  the Android process has started. This theme is visible to the user
diff --git a/flutter_app/lib/main.dart b/flutter_app/lib/main.dart
index 04bb4cc..d4020d0 100644
--- a/flutter_app/lib/main.dart
+++ b/flutter_app/lib/main.dart
@@ -22,6 +22,10 @@ Future<void> main() async {
   WidgetsFlutterBinding.ensureInitialized();
   // Hide status bar for TV immersive experience
   SystemChrome.setEnabledSystemUIMode(SystemUiMode.immersiveSticky);
+  await SystemChrome.setPreferredOrientations([
+    DeviceOrientation.landscapeLeft,
+    DeviceOrientation.landscapeRight,
+  ]);
   GoogleFonts.config.allowRuntimeFetching = false;
 
   await initializeDateFormatting();
@@ -136,19 +140,7 @@ class AdaptiveHome extends StatelessWidget {
 
   @override
   Widget build(BuildContext context) {
-    const forceTv = String.fromEnvironment('FORCE_TV', defaultValue: 'false');
-    if (forceTv.toLowerCase() == 'true') {
-      return const TvDashboardScreen();
-    }
-
-    final size = MediaQuery.of(context).size;
-    final shortestSide = size.shortestSide;
-    final isMobile = shortestSide < 600;
-
-    if (isMobile) {
-      return const MobileHomeScreen();
-    }
-
+    // Forcing TV Dashboard for Google TV deployment
     return const TvDashboardScreen();
   }
 }
diff --git a/flutter_app/lib/models/weather_info.dart b/flutter_app/lib/models/weather_info.dart
index fc3943e..0186e83 100644
--- a/flutter_app/lib/models/weather_info.dart
+++ b/flutter_app/lib/models/weather_info.dart
@@ -1,12 +1,18 @@
 class WeatherInfo {
   final String description;
   final double temperature;
+  final double tempMin;
+  final double tempMax;
+  final int aqi;
   final String icon;
   final String city;
 
   const WeatherInfo({
     required this.description,
     required this.temperature,
+    required this.tempMin,
+    required this.tempMax,
+    required this.aqi,
     required this.icon,
     required this.city,
   });
@@ -18,6 +24,9 @@ class WeatherInfo {
     return WeatherInfo(
       description: weather["description"] as String? ?? "",
       temperature: (json["main"]?["temp"] as num?)?.toDouble() ?? 0,
+      tempMin: (json["main"]?["temp_min"] as num?)?.toDouble() ?? 0,
+      tempMax: (json["main"]?["temp_max"] as num?)?.toDouble() ?? 0,
+      aqi: json["aqi"] as int? ?? 0,
       icon: weather["icon"] as String? ?? "",
       city: json["name"] as String? ?? "",
     );
diff --git a/flutter_app/lib/services/mock_data.dart b/flutter_app/lib/services/mock_data.dart
index 946ca1b..8731f2d 100644
--- a/flutter_app/lib/services/mock_data.dart
+++ b/flutter_app/lib/services/mock_data.dart
@@ -135,6 +135,9 @@ class MockDataStore {
   static WeatherInfo weather = const WeatherInfo(
     description: "clear sky",
     temperature: 12,
+    tempMin: 8,
+    tempMax: 15,
+    aqi: 2,
     icon: "01d",
     city: "Seoul",
   );
diff --git a/flutter_app/lib/widgets/weather_widget.dart b/flutter_app/lib/widgets/weather_widget.dart
index 0b01866..ffe7afb 100644
--- a/flutter_app/lib/widgets/weather_widget.dart
+++ b/flutter_app/lib/widgets/weather_widget.dart
@@ -5,9 +5,92 @@ import '../config/api_config.dart';
 import '../models/weather_info.dart';
 import '../services/weather_service.dart';
 
-class WeatherWidget extends StatelessWidget {
+class WeatherWidget extends StatefulWidget {
   const WeatherWidget({super.key});
 
+  @override
+  State<WeatherWidget> createState() => _WeatherWidgetState();
+}
+
+class _WeatherWidgetState extends State<WeatherWidget> {
+  Timer? _refreshTimer;
+
+  @override
+  void initState() {
+    super.initState();
+    // Refresh weather every 1 hour
+    _refreshTimer = Timer.periodic(const Duration(hours: 1), (timer) {
+      if (mounted) {
+        setState(() {}); // Rebuild to trigger FutureBuilder
+      }
+    });
+  }
+
+  @override
+  void dispose() {
+    _refreshTimer?.cancel();
+    super.dispose();
+  }
+
+  Widget _buildAqiIcon(int aqi) {
+    Color color;
+    IconData icon;
+    String label;
+
+    switch (aqi) {
+      case 1: // Good
+        color = Colors.blue;
+        icon = Icons.sentiment_very_satisfied;
+        label = "좋음";
+        break;
+      case 2: // Fair
+        color = Colors.green;
+        icon = Icons.sentiment_satisfied;
+        label = "보통";
+        break;
+      case 3: // Moderate
+        color = Colors.yellow[700]!;
+        icon = Icons.sentiment_neutral;
+        label = "주의";
+        break;
+      case 4: // Poor
+        color = Colors.orange;
+        icon = Icons.sentiment_dissatisfied;
+        label = "나쁨";
+        break;
+      case 5: // Very Poor
+        color = Colors.red;
+        icon = Icons.sentiment_very_dissatisfied;
+        label = "매우 나쁨";
+        break;
+      default:
+        return const SizedBox.shrink();
+    }
+
+    return Column(
+      children: [
+        Container(
+          padding: const EdgeInsets.all(4),
+          decoration: BoxDecoration(
+            color: color.withOpacity(0.2),
+            shape: BoxShape.circle,
+            border: Border.all(color: color, width: 2),
+          ),
+          child: Icon(icon, color: color, size: 20),
+        ),
+        const SizedBox(height: 2),
+        Text(
+          label,
+          style: TextStyle(
+            color: color,
+            fontSize: 10,
+            fontWeight: FontWeight.bold,
+          ),
+        ),
+      ],
+    );
+  }
+
   @override
   Widget build(BuildContext context) {
     return FutureBuilder<WeatherInfo>(
@@ -27,6 +110,7 @@ class WeatherWidget extends StatelessWidget {
         }
 
         if (snapshot.hasError) {
+          debugPrint('Weather Error: ${snapshot.error}');
           return const Text(
             'Weather Unavailable',
             style: TextStyle(color: Colors.white54),
@@ -42,42 +126,87 @@ class WeatherWidget extends StatelessWidget {
         final iconUrl = (ApiConfig.useMockData || kIsWeb)
             ? null
             : (weather.icon.isNotEmpty
-                ? "http://openweathermap.org/img/wn/${weather.icon}@2x.png"
+                ? "https://openweathermap.org/img/wn/${weather.icon}@2x.png"
                 : null);
 
         return Row(
           mainAxisSize: MainAxisSize.min,
+          crossAxisAlignment: CrossAxisAlignment.center,
           children: [
+            // Weather Icon
             if (iconUrl != null)
               Image.network(
                 iconUrl,
-                width: 50,
-                height: 50,
+                width: 72,
+                height: 72,
                 errorBuilder: (_, __, ___) =>
                     const Icon(Icons.wb_sunny, color: Colors.amber),
               )
             else
-              const Icon(Icons.wb_sunny, color: Colors.amber, size: 40),
-            const SizedBox(width: 12),
+              const Icon(Icons.wb_sunny, color: Colors.amber, size: 60),
+            const SizedBox(width: 16),
+            
+            // Temperature & City info
             Column(
               crossAxisAlignment: CrossAxisAlignment.start,
               mainAxisAlignment: MainAxisAlignment.center,
               children: [
-                Text(
-                  '${weather.temperature.round()}°C',
-                  style: Theme.of(context).textTheme.headlineSmall?.copyWith(
-                        color: Colors.white,
-                        fontWeight: FontWeight.bold,
-                      ),
-                ),
-                Text(
-                  '${weather.city} · ${weather.description}',
-                  style: Theme.of(
-                    context,
-                  ).textTheme.bodyMedium?.copyWith(color: Colors.white70),
+                Row(
+                  crossAxisAlignment: CrossAxisAlignment.baseline,
+                  textBaseline: TextBaseline.alphabetic,
+                  children: [
+                    Text(
+                      '${weather.temperature.round()}°',
+                      style: Theme.of(context).textTheme.displaySmall?.copyWith(
+                            fontSize: 42, // Slightly larger to stand out
+                            color: Colors.yellowAccent,
+                            fontWeight: FontWeight.bold,
+                            height: 1.0,
+                          ),
+                    ),
+                    const SizedBox(width: 12),
+                    Column(
+                      crossAxisAlignment: CrossAxisAlignment.start,
+                      children: [
+                         Text(
+                          '${weather.city} · ${weather.description}',
+                          style: Theme.of(context).textTheme.titleLarge?.copyWith(
+                            color: Colors.white70,
+                            fontWeight: FontWeight.w500,
+                            fontSize: 20
+                          ),
+                        ),
+                        const SizedBox(height: 4),
+                        Text(
+                          '최고:${weather.tempMax.round()}° 최저:${weather.tempMin.round()}°',
+                          style: Theme.of(context).textTheme.titleLarge?.copyWith(
+                                color: Colors.white,
+                                fontSize: 22,
+                                fontWeight: FontWeight.bold
+                              ),
+                        ),
+                      ],
+                    ),
+                  ],
                 ),
               ],
             ),
+            
+            // AQI Indicator (Right side)
+            if (weather.aqi > 0) ...[
+              const SizedBox(width: 24),
+              Container(
+                height: 50,
+                width: 2,
+                color: Colors.white24,
+              ),
+              const SizedBox(width: 24),
+              // Scaled up AQI
+              Transform.scale(
+                scale: 1.2,
+                child: _buildAqiIcon(weather.aqi),
+              ),
+            ],
           ],
         );
       },