From c156809231a2a1cb984067d3967380a4c41d2055 Mon Sep 17 00:00:00 2001
From: "2569718930@qq.com" <2569718930@qq.com>
Date: Thu, 12 Mar 2026 09:41:48 +0800
Subject: [PATCH] feat: Add a shell script to validate frontend caching
 behavior for PolyWeather API endpoints.

---
 scripts/validate_frontend_cache.sh | 186 +++++++++++++++++++++++++++++
 1 file changed, 186 insertions(+)
 create mode 100644 scripts/validate_frontend_cache.sh

diff --git a/scripts/validate_frontend_cache.sh b/scripts/validate_frontend_cache.sh
new file mode 100644
index 00000000..f22eb013
--- /dev/null
+++ b/scripts/validate_frontend_cache.sh
@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+
+set -u
+
+BASE_URL="${1:-http://38.54.27.70:8000}"
+CURL_BIN="${CURL_BIN:-curl}"
+
+PASS_COUNT=0
+FAIL_COUNT=0
+
+print_line() {
+  printf '%s\n' "$1"
+}
+
+pass() {
+  PASS_COUNT=$((PASS_COUNT + 1))
+  print_line "PASS: $1"
+}
+
+fail() {
+  FAIL_COUNT=$((FAIL_COUNT + 1))
+  print_line "FAIL: $1"
+}
+
+header_dump() {
+  local url="$1"
+  "$CURL_BIN" -sS -D - -o /dev/null "$url"
+}
+
+status_code() {
+  local headers="$1"
+  printf '%s\n' "$headers" | awk 'NR==1 { print $2 }'
+}
+
+header_value() {
+  local headers="$1"
+  local key="$2"
+  printf '%s\n' "$headers" \
+    | tr -d '\r' \
+    | awk -F': ' -v k="$key" 'tolower($1)==tolower(k) { print $2; exit }'
+}
+
+contains_ci() {
+  local haystack="$1"
+  local needle="$2"
+  printf '%s' "$haystack" | grep -qi -- "$needle"
+}
+
+check_reachable() {
+  local url="${BASE_URL%/}/api/cities"
+  local headers
+  if ! headers="$(header_dump "$url")"; then
+    fail "cannot connect to $url"
+    return 1
+  fi
+  local code
+  code="$(status_code "$headers")"
+  if [ "$code" = "200" ] || [ "$code" = "304" ]; then
+    pass "service reachable at $BASE_URL"
+    return 0
+  fi
+  fail "service reachable but unexpected status for /api/cities: $code"
+  return 1
+}
+
+check_cached_endpoint() {
+  local endpoint="$1"
+  local label="$2"
+  local url="${BASE_URL%/}${endpoint}"
+  local headers
+  if ! headers="$(header_dump "$url")"; then
+    fail "$label request failed: $url"
+    return
+  fi
+
+  local code cache_control etag
+  code="$(status_code "$headers")"
+  cache_control="$(header_value "$headers" "Cache-Control")"
+  etag="$(header_value "$headers" "ETag")"
+
+  if [ "$code" != "200" ]; then
+    fail "$label status expected 200, got $code"
+  else
+    pass "$label status 200"
+  fi
+
+  if [ -n "$cache_control" ] && ! contains_ci "$cache_control" "no-store"; then
+    pass "$label Cache-Control is cacheable: $cache_control"
+  else
+    fail "$label Cache-Control invalid: ${cache_control:-<empty>}"
+  fi
+
+  if [ -n "$etag" ]; then
+    pass "$label has ETag: $etag"
+  else
+    fail "$label missing ETag"
+  fi
+}
+
+check_force_refresh_nostore() {
+  local endpoint="$1"
+  local label="$2"
+  local url="${BASE_URL%/}${endpoint}"
+  local headers
+  if ! headers="$(header_dump "$url")"; then
+    fail "$label request failed: $url"
+    return
+  fi
+
+  local code cache_control
+  code="$(status_code "$headers")"
+  cache_control="$(header_value "$headers" "Cache-Control")"
+
+  if [ "$code" != "200" ]; then
+    fail "$label status expected 200, got $code"
+  else
+    pass "$label status 200"
+  fi
+
+  if contains_ci "$cache_control" "no-store"; then
+    pass "$label Cache-Control is no-store"
+  else
+    fail "$label Cache-Control expected no-store, got: ${cache_control:-<empty>}"
+  fi
+}
+
+check_if_none_match_304() {
+  local endpoint="$1"
+  local label="$2"
+  local url="${BASE_URL%/}${endpoint}"
+
+  local headers1
+  if ! headers1="$(header_dump "$url")"; then
+    fail "$label first request failed: $url"
+    return
+  fi
+
+  local etag
+  etag="$(header_value "$headers1" "ETag")"
+  if [ -z "$etag" ]; then
+    fail "$label cannot run 304 check: missing ETag"
+    return
+  fi
+
+  local headers2 code2
+  if ! headers2="$("$CURL_BIN" -sS -D - -o /dev/null -H "If-None-Match: $etag" "$url")"; then
+    fail "$label second request failed: $url"
+    return
+  fi
+  code2="$(status_code "$headers2")"
+  if [ "$code2" = "304" ]; then
+    pass "$label If-None-Match returns 304"
+  else
+    fail "$label expected 304, got $code2"
+  fi
+}
+
+main() {
+  print_line "=== PolyWeather Frontend Cache Validation ==="
+  print_line "Base URL: $BASE_URL"
+  print_line ""
+
+  if ! check_reachable; then
+    print_line ""
+    print_line "Result: FAIL ($FAIL_COUNT failed, $PASS_COUNT passed)"
+    exit 1
+  fi
+
+  check_cached_endpoint "/api/cities" "cities"
+  check_if_none_match_304 "/api/cities" "cities"
+
+  check_cached_endpoint "/api/city/ankara/summary" "city summary"
+  check_force_refresh_nostore "/api/city/ankara/summary?force_refresh=true" "city summary force_refresh"
+
+  check_cached_endpoint "/api/history/ankara" "history"
+  check_if_none_match_304 "/api/history/ankara" "history"
+
+  print_line ""
+  if [ "$FAIL_COUNT" -gt 0 ]; then
+    print_line "Result: FAIL ($FAIL_COUNT failed, $PASS_COUNT passed)"
+    exit 1
+  fi
+  print_line "Result: PASS ($PASS_COUNT passed)"
+}
+
+main "$@"