chiga-log

茅ヶ崎ヘッドランド（Tバー）、サザンビーチ茅ヶ崎など、茅ヶ崎海岸周辺のコンディション（潮汐・波・水温・天気）を確認できるWebツールです。 スマートフォン（iPhone/Android）およびPCのブラウザから直接利用できます。

特徴

• ホーム画面アプリ化: iOS/Androidのブラウザから「ホーム画面に追加」するとスタンドアロンアプリとして起動。バックグラウンド復帰時に自動でデータを最新化します。
• レスポンシブ対応: スマートフォンでの閲覧に最適化された、屋外でも見やすいレイアウトを採用しています。
• 視覚的な潮汐グラフ: Chart.jsを用いた滑らかな曲線により、満潮・干潮のタイミングを直感的に把握できます。
• 自動データ更新: GitHub Actionsを利用して定期的にデータを取得・生成することで、APIの制限を回避しつつ、最新の天気予報（forecast.json）や潮汐情報（tide_widget.json）を安定して配信しています。
• データ鮮度の明示: 各データの生成時刻（updated_at）を基準に鮮度を判定し、更新が停止している（Actions停止・API障害等）場合や古いデータのときは、影響を受けるカードにだけ注記を表示します。誤って古い情報を最新と誤読させません（詳細は下記「データ鮮度の表示と堅牢化」）。

使い方（WEBでの確認方法：推奨）

以下のURLにアクセスするだけで、いつでも最新の情報を確認できます。

https://surf90.github.io/chiga-log/

参照している位置情報について

以下の地点固有の値（座標・各種コード・地名）は _data/site.json 1ファイルに集約しています。別の海岸へフォークする際の変更手順は FORK.md を参照してください。

潮汐情報

• 月齢・潮回り: NASA SVS（Scientific Visualization Studio）の月齢から、当日JST正午の月齢と朔の日を1日とする陰暦日を算出。潮回りは陰暦日から判定。
• 満干潮・潮位: 気象庁の湘南港（江の島）潮位表（tide_data.json）を優先的に使用。
• バックアップ: エラー発生時のみ、Stormglass APIによる推計データ（約25km四方グリッド）を使用。

波情報

• 波高（海域最大）・周期: 気象庁 沿岸波浪ガイダンスの関東地方南部（相模湾から外房まで）の海域内で最も高い地点の有義波高と卓越周期を使用（個々の波の「最大波高」ではない）。

グラフの見かた（潮汐・波高/周期）

• 表示範囲: 2日分を横スクロールで表示します。潮汐グラフと波グラフのスクロール位置は連動します。
• 初期位置: 開いた時点で「今」の少し手前までスクロールした状態になり、現在時刻を示すオレンジの縦帯と、これから先の変化がすぐ見えます。
• Y軸の固定: 横スクロールしても左右の目盛り（潮位 m・波高 m・周期 秒）は端に貼り付いたままなので、どの時間帯を見ていても数値を読み取れます。
• 右端のフェード: グラフ右端がわずかに薄くなっているのは、横に続きがある（2日目のデータがある）ことを示すためです。

海面状況

• 波の高さ・海水温: 茅ヶ崎ヘッドランド（北緯: 35.3175 / 東経: 139.4151）を基準点としたOpen-Meteo海洋モデル（25km〜50km四方のグリッドデータ）を使用。
  • 範囲: 指定座標周辺の「沖合」の推計値です。 地形や風の影響を強く受ける波打ち際（サーフゾーン）の実際のコンディションとは異なる場合があります。

注意報・警報

• 注意報・警報: 気象庁が発表する「茅ヶ崎市（コード: 1420700）」の個別データを参照。
  • 取得元は気象庁レガシーフィード（data.jma.go.jp の VPWS50/JPTF、神奈川県）。bosai の警報JSON（warning/140000.json）は神奈川で更新が停止する事象が確認されたため使用しません。
  • レガシーフィードはCORS非対応のため、閲覧者のブラウザから Cloudflare Worker（chiga-log-warning-api）を経由して気象庁へアクセスします。Workerは閲覧時に茅ヶ崎分を抽出し、応答を60秒キャッシュします。
  • ページ表示時と表示中5分ごとに注意報・警報を再取得するため、GitHub Actionsのschedule遅延に依存せず最新発表へアクセスできます。
  • Worker障害時は fetch-openmeteo.yml が生成する data/warning_chigasaki.json へフォールバックします。scripts/fetch_warning.py が取得失敗した場合も既存ファイルを温存し、誤って「なし」表示にしません。
  • フォールバックしたデータが3時間より古い（または取得時刻が不明な）場合は、「現在、注意報・警報はありません」とは表示せず、「最新情報を確認できていません（最終取得 ○時間前）」と表示します。
  • 2026-05-28 運用開始の新たな防災気象情報に対応。名称はレベル付き（例:「レベル４土砂災害危険警報」）で、バッジは気象庁の警戒レベル配色に合わせ「特別警報（レベル5・黒）／危険警報（レベル4・紫）／警報（レベル3・赤）／注意報（橙）」の4段階で表示します。画面下端のバーは警報以上で表示します。

津波注意報・警報

• 津波情報: 気象庁の津波予報区「相模湾・三浦半島（コード: 330）」に津波注意報・津波警報・大津波警報が発表されている時だけ、ページ最上部に専用カードを表示します（津波予報のみ・解除時は非表示）。
  • 取得元は気象庁 bosai 津波フィード（一覧 bosai/tsunami/data/list.json → 詳細JSON）。CORS対応のためクライアントから直接取得します（警報と異なりBFF不要・GitHub Actions追加なし）。
  • 表示内容: 種別バッジ（大津波警報=紫 / 津波警報=赤 / 津波注意報=橙）・予報区名・予想の高さ・第一波到達時刻。取得失敗時はダミーを出さずカード非表示（三原則1）。

熱中症警戒アラート

• 熱中症情報: 環境省の公式CSVから神奈川県（都道府県コード 14）の正式発表を取得し、発表中だけ「注意報・警報」の直下、「天気予報」の直上に専用カードを表示します。
  • 熱中症警戒アラート（フラグ 1）は黄〜黄橙の枠と薄い黄色背景、熱中症特別警戒アラート（フラグ 3）は濃いオレンジ枠で一段強く表示します。特別警戒の事前判定（フラグ 2）は表示しません。
  • 前日17時・当日5時の通常警戒と、前日14時の特別警戒を対象日ごとに判定します。専用Actionsは各発表の25分・15分・5分前に取得を試み、起動遅延に備えます。先行取得できても公式発表時刻までは表示せず、既存の30分ワークフローも安全網として残します。
  • 運用期間（例年4月第4水曜〜10月第4水曜）外は公式CSVが公開されないため、4/15〜10/31 以外は取得自体を省略します（cron は不変）。

天気予報

• 天気予報: 気象庁が発表する「神奈川県東部（コード: 140010）」の予報区データを使用。
  • 天気・風・降水確率は配列の先頭ではなく、現在時刻に当たる要素（今日の日付・現在の6時間区間）を表示します。Actions の発火遅延で日付を跨いでも昨日の予報を今日の値として出しません。
  • 最高/最低気温は、今日の値が既に無い時間帯（17時発表以降など）に明日の値を出す場合「明日」を明記します。
  • scripts/fetch_forecast.py は取得失敗・気象庁の仕様変更（想定外の構造）を検知した場合、null で既存ファイルを上書きせず前回の有効データを温存します（誤読防止・三原則1）。

風予報（時間別）

• 風速・風向・最大瞬間風速（翌日まで1時間ごと、昼間帯）: 茅ヶ崎ヘッドランド（北緯: 35.3175 / 東経: 139.4151）を基準点としたOpen-Meteo気象モデルを使用。参照時刻の1時間前から24時間先までの4〜23時を表示（夜は翌朝の風まで見えるよう、日付が変わる位置に「明日」の区切りを入れる）。
  • scripts/fetch_openmeteo.py はソース（天気・海況・アメダス・風予報）ごとに独立して保存します。一部の取得に失敗しても取得できた分は反映し、欠けた部分は前回値を時刻ごと引き継ぎます（ジョブは失敗として通知）。
• 表示方法: これから先の3件は常に表示し、それ以降を「この先の風を表示」で開閉します。残りが無い時間帯（夜間など）はボタン自体を表示しません。

現在の天気

• 気温・湿度・風速・風向・降水量（現在値）: 気象庁アメダス辻堂観測所（コード: 46141）のデータを使用。

データ鮮度の表示と堅牢化

外部ソースの障害やGitHub Actionsの停止（例: リポジトリオーナーのアカウント一時停止）でデータ更新が止まった際、古い情報を最新と誤読させないための仕組みです。

• 更新日時の是正: 画面下部の「更新日時」は、閲覧者が取得した時刻ではなくデータの実際の生成時刻（weather_marine.json の updated_at）と経過時間を表示します。
• セクション別の鮮度注記: 潮汐・波・天気・風・警報・現在の気温･風の各データが、種別ごとの閾値（更新頻度に応じて個別設定）を超えて古い場合に「データが古い可能性」を各カードに注記します。生成時刻フィールドの表記差（updated_at / fetchedAt / observed_at）は内部で吸収するため、データ種別によらず同一ロジックで鮮度を判定します。GitHub Actionsのスケジュール遅延は種別ごとに独立して起きるため、あえてページ全体の警告バナーは持たず、影響を受けるカードだけに注記することで「他の情報まで古い」という誤認を避けています。
• 取得失敗の明示: 津波・現況の取得失敗を「情報なし（平常）」と区別して明示します。
• バックエンド温存: データ取得スクリプトは取得失敗・仕様変更時に既存の有効データを温存し、null・空データでの上書きを防ぎます（fetch_forecast.py / fetch_warning.py / fetch_openmeteo.py ほか）。

注: オーナーのアカウント停止時はGitHub Actions自体が停止するため、リポジトリ内の監視では検知できません。上記の閲覧者側の鮮度表示が実質的な安全網です。

オフライン対応とキャッシュ戦略（PWA）

sw.js（Service Worker）がリクエストの種類ごとに戦略を変えます。「古いデータを最新に見せない」ことと「修正が確実に届くこと」を、表示速度より優先しています。

対象	戦略	意図
data/*.json（潮汐・波・天気）	ネットワーク優先・保存しない	鮮度最優先（三原則1）。オフライン時のみ退避キャッシュを試み、Cache Storage の肥大化も避ける
ナビゲーション（ページ遷移）	ネットワーク優先	オフライン時だけ App Shell（index.html）を返す
地点設定（site-config.js）	ネットワーク優先	CSP connect-src は警報BFFのURLから生成されナビゲーションで即時に切り替わる。設定だけ旧版を返すと取得がCSPにブロックされるため、同じ鮮度で取る
静的アセット（CSS/JS/画像）	Stale-While-Revalidate	キャッシュがあれば即返して描画をブロックせず（三原則2）、裏で再取得して次回アクセスから新版に入れ替わる

This is the beginning of the README. Read the rest at the original. Read the full README ↗