日々の体調やつらい症状の変化をスコア化して可視化するための手引きです。
📊 記録の基本ステップ
-
1
日付の選択:
「← 昨日」や「翌日 →」ボタン、またはカレンダー入力を利用して記録したい日付を選びます。 -
2
症状の入力:
各症状に対して時間帯（朝・昼・夜・全体）ごとに当てはまる強さを選びます。「なし」または「0（ほぼ症状なし）〜 5（非常に強い）」の評価基準に従ってタップまたはクリックで選択します。
※ 一度選択したスコアを「未記入」に戻したい場合は、選択中のボタンをもう一度タップ（クリック）すると解除されます。 -
3
備考の記入:
薬の服用状況、体調に影響を与えそうなライフイベント（天候、食事、睡眠不足など）があれば、備考欄に自由にテキストを残します。 -
4
自動保存（オートセーブ）:
スコアボタンを選択した時や、備考欄の入力が完了したタイミングで自動的にデータが保存されます。画面の右下に「保存しました」とステータスが表示されるため、保存ボタンを毎回押す必要はありません。
💡 スコア評価の目安（ガイドライン）
めまいやその他の不快な症状をスコアリングする際の一般的な基準です。ご自身の判断で一貫した基準に沿って記録することが大切です。
💡 睡眠やメンタルなど、スコアの「向き（良し悪し）」について
「睡眠」や「メンタル」のように、状態が良い方向（ポジティブ）として記録したい項目は、ご自身の直感に合わせて「数値が大きいほど状態が良い（快適・元気）」として記録していただいて全く問題ありません！
毎日ストレスなく直感的に入力できるよう、以下のような解釈で一貫して記録することをお勧めします：
「睡眠」や「メンタル」のように、状態が良い方向（ポジティブ）として記録したい項目は、ご自身の直感に合わせて「数値が大きいほど状態が良い（快適・元気）」として記録していただいて全く問題ありません！
毎日ストレスなく直感的に入力できるよう、以下のような解釈で一貫して記録することをお勧めします：
- 睡眠スコア: 数値が大きいほど「ぐっすり眠れた（睡眠の質が良い・快適）」として記録。
（例：5 ＝ 非常に良く眠れてスッキリ、0 ＝ 全く眠れず非常に辛かった） - メンタルスコア: 数値が大きいほど「気分が良い・穏やか・元気」として記録。
（例：5 ＝ 気分が非常に良く元気、0 ＝ 落ち込みやイライラが極めて強く辛かった）
❓ 一度記録したスコアを「未記入」に戻したい時は？
- 個別に未記入にする: 選択されている（色がついている）スコアボタンをもう一度タップ（クリック）すると、選択が解除されて「未記入」の状態に戻ります。
- この日の記録をすべてクリアする: 画面最下部にある「この日をクリア」ボタンを押すと、その日のすべての症状スコアと備考メモが一括でクリアされ、未記入状態に戻ります。
| スコア | 通常スコア（めまい・不調項目など） ※数値が大きいほど【つらい】 |
逆スコア（睡眠・メンタル項目など） ※数値が大きいほど【快適】 |
|---|---|---|
| なし |
症状が完全に消失している、またはその症状が起きる理由がない状態。 ※ まだ一度も入力を行っていない「未記入」の状態とは明確に区別されます。 |
|
| 0 | ほぼなし / 快適: 症状を全く、あるいはほぼ自覚しない快適な状態。 【ボタン色：緑】 |
非常に悪い / 不調: 全く眠れなかったり、気分が極めて優れない非常につらい状態。 【ボタン色：紫】 |
| 1 | ごく軽度: ほんの少し違和感があるが、生活や仕事には全く影響しない状態。 【ボタン色：薄緑】 |
悪い: 睡眠が非常に浅かったり、強いイライラや落ち込みがある状態。 【ボタン色：赤】 |
| 2 | 軽度: 自覚症状があり少し気になるが、問題なく普段通り過ごせる状態。 【ボタン色：黄】 |
やや悪い: 途中で目が覚めてしまったり、気分にすっきりしない曇りがある状態。 【ボタン色：オレンジ】 |
| 3 | 中等度: はっきりと不快感があり、ペースを落としたり休憩を取る必要がある状態。 【ボタン色：オレンジ】 |
普通: 可もなく不可もなく、平穏または普段通りの状態。 【ボタン色：黄】 |
| 4 | 重度: 症状が強く、日常生活に明確な支障があり、横になって安静にする状態。 【ボタン色：赤】 |
良い: 十分によく眠れたり、気分が安定して前向きな状態。 【ボタン色：薄緑】 |
| 5 | 非常に重度: 極めて強い症状があり、一人での歩行が困難であったり、身動きが取れず非常につらい状態。 【ボタン色：紫】 |
非常に良い / 快適: ぐっすり熟睡できてすっきり快適、または非常に健康的で活発な状態。 【ボタン色：緑】 |
⚙️ 症状項目のカスタマイズ
画面右上（スマートフォンの場合はハンバーガーメニュー等）の「設定」リンクから、ご自身の健康状態に合わせて記録項目を柔軟にカスタマイズできます。
-
A
新しい症状の追加:
「項目を追加」セクションで、記録したい項目（例：頭痛、肩こり、吐き気など）を登録できます。時間帯別に細かく記録するか、1日の「全体」のみにするかを選択可能です。 -
B
表示順の変更:
各項目の左端にある「☰（ドラッグハンドル）」をドラッグ＆ドロップすることで、直感的に記録画面の並び順を変更できます。 -
C
有効・無効（非表示）の切り替え:
一時的に使わなくなった項目は、「有効」チェックボックスをオフにすることで、**過去の記録データを残したまま**、記録画面から安全に非表示にできます。
⚠️ 免責事項・ご利用上の注意
■ 本アプリは医療機器ではありません
SymptoPort（からだの天気図）は、日々の体調や症状の変化をご自身で記録・可視化し、健康状態のセルフケアをサポートすることを目的とした個人的な記録用ツールです。医学的な診断、治療、予防、指示を目的としたものではありません。体調不良が続く場合や、症状が悪化・変化する場合は、自己判断せず必ず医師や専門の医療機関を受診してください。
■ 暑さ指数（WBGT）について
本アプリで自動算出および表示される暑さ指数（WBGT）は、Open-Meteo APIから取得した地域の気象データ（気温・湿度・風速・全天日射量）を基に、環境省の算出式（推定式）に則って計算した簡易的な疑似値（参考値）です。
局所的な測定環境や実測条件により、環境省が発表する公式の値や実際の現地の値とは異なる場合があります。熱中症予防の絶対的な判断基準として過信せず、個人の体調変化や周囲の環境に留意し、適切な予防行動（水分補給、エアコンの使用、休養等）をとるための目安としてご利用ください。
📝 更新履歴
- 2026-05-31 (v0.6.4): 服薬設定で「寝る前の薬（`before_sleep`）」を有効にしている際に、保存時にサーバー側で時間帯の不一致（400 Bad Request）が発生して「保存に失敗しました」と赤警告が表示され、記録が一切保存できなくなっていた深刻なバリデーション判定バグを修正しました。
- 2026-05-31 (v0.6.3): 記録保存API（/api/save）を全面的にリファクタリングし、すべての入力検証と数値変換をデータベース書き込み開始前に完了させるように順序を改善。さらに症状スコア、備考メモ、気象データの保存を一括した単一のトランザクションとして統合しました。これにより、気象データ入力値エラー等が発生した際に、症状スコアだけが中途半端に部分保存されて画面上には「保存失敗」と出てしまうデータ不整合（齟齬）を完全に解消し、アトミックな保存を保証しました。
- 2026-05-30 (v0.6.2): 新規登録した症状の保存処理がオートセーブ時に他の無効化された症状の影響で「保存に失敗しました」になり、以降すべての保存がブロックされる致命的な不具合を修正（登録済みの全症状を正しく許容するようにバリデーションを改善）。また、設定画面で重複したID（英字名）で症状を追加しようとした際に、何が起きたか明確に伝わる美しい警告アラートを表示するようにUIを向上。
- 2026-05-29 (v0.6.0): 居住地設定（全国47都道府県庁所在地＋釧路の計48地域）によるWBGT算出の地域最適化に対応。また、服薬チェック機能（時間帯別に💊マーク付きで服用状況をワンタップ記録・印刷）を追加。さらに、入力画面の時間帯ブロックを縦1列（1カラム）に変更し、スマホ等の狭い画面でもスコアボタンが絶対に折り返さず綺麗に一行表示されるようにUI/レイアウトを改善。その他、暑さ指数が0未満の際の「取得不可（-）」自動判定、グラフ印刷での気温（Ta）推移の2軸プロット追加、データのバックアップ・リストア機能（JSONファイルによる全データ保存・復元）、「医療機器ではない旨」「簡易計算による疑似WBGT値である旨」の免責事項の明記、印刷用レポートの簡潔な「一覧表示」と従来の「詳細表示」の動的切り替えUI（A4・PDF印刷連動）を実装、および**服薬チェックデータのオートセーブ保存失敗バグの修正**。
- 2026-05-29 (v0.5.0): [ベータ機能] 東京の暑さ指数(WBGT)自動計算・記録機能、および症状×WBGTの時系列2軸グラフ印刷レポート機能を追加
- 2026-05-29: アプリ名を SymptoPort（からだの天気図）に変更
- 2026-05-29: PWA対応（ホーム画面インストール・オフラインキャッシュ）
- 2026-05-29: 印刷レポートページ（/print）を追加。日付範囲指定で症状一覧をA4印刷可能
- 2026-05-29: SNS共有プレビュー（OGP / Twitter Card）対応
- 2026-05-29: ランディングページ（/lp）を新設。未ログイン時はLPへ誘導
- 2026-05-27: 自動保存（オートセーブ）と連打・重複保存防止機能を追加
- 2026-05-26: 逆スコア設定（睡眠・メンタル向け）と配色自動反転機能、使い方ガイドを追加
- 2026-05-25: セキュリティ強化（ログイン画面のTurnstile追加、セッション管理のリファクタリングなど）
- 2026-05-25: 新規登録機能の追加とボット対策（Cloudflare Turnstile）の実装