用語集

本サイトで使う用語の定義。一般用語の意味に加え、サイト独自の計算方法・カラム名も併記する。各項目はアンカーリンクで参照可能（例: /glossary#storage-rate）。

基本エンティティ

ダム（dam）#: 河川を堰き止めて水を貯めるための構造物。本サイトでは国土交通省「ダム便覧」に登録された、堤高 15 m 以上の貯水・治水・利水ダムを対象とする。当サイトには 2,749 基のマスタを収録。
水系（すいけい）#: 一つの河川とそれに接続する支川群、湖沼などを一体としてとらえた集水域。河川法に基づき「一級水系」「二級水系」が指定される。本サイトでは国土数値情報 W07 を一次ソースとし、644 水系を収録。関連: 一級水系 / 二級水系 / その他
一級水系（いっきゅうすいけい）#: 国土交通大臣が指定し、国が直接管理する 109 水系。利根川・淀川など、流域面積や経済影響が特に大きい水系。
二級水系（にきゅうすいけい）#: 都道府県知事が指定・管理する水系。一級水系より小規模だが、地域の重要な水資源。
河川（かせん）#: 水系を構成する個々の川。本流・支川など。水系がツリーの根、河川がそのノードに対応する。
管理者（かんりしゃ）#: ダムを管理する主体。国土交通省、独立行政法人水資源機構、都道府県、電力会社、市町村などが該当する。

容量・貯水関連

総貯水容量（そうちょすいようりょう）#: ダム湛水面の最高水位（サーチャージ水位）まで貯められる容量の合計。死水容量・利水容量・洪水調節容量を含む、ダムの「物理的な最大容積」。単位は m³。
有効貯水容量（ゆうこうちょすいようりょう）#: 総貯水容量から死水容量を除いた、実際に使える容量。利水容量と洪水調節容量を合わせた量にあたる。ダム便覧が公表するのはこの値までで、本サイトが諸元として持つ容量（active_capacity_m3 / API の activeCapacityM3）もこれ。貯水率の分母は原則この値。関連: 英: effective capacity
利水容量（りすいようりょう）#: 有効貯水容量のうち、水道・かんがい・発電などに充てられる部分。洪水期は洪水調節容量を確保するため小さくなる。ダム便覧はこの値を公表していないため、本サイトが諸元として持っているのは有効貯水容量であり、利水容量は一部の出典（川の防災情報・県の防災サイトなど）が公表する貯水率から逆算した場合にだけ分かる。関連: 英: active capacity / conservation storage
洪水調節容量（こうずいちょうせつようりょう）#: 洪水時に下流の被害を抑えるため、空けておくべき容量。有効貯水容量のうち利水容量ではない部分にあたり、洪水期に大きく取られる。
死水容量（しすいようりょう）#: 取水口より下にあり、通常は使えない容量。堆砂や水位低下時の保全に充てられる。
貯水量（ちょすいりょう）#: ある時点でダムに実際に貯まっている水の量（容積）。単位 m³。観測値カラム名は storage_volume_m3。関連: storage_volume_m3 / 貯水容積
貯水率（ちょすいりつ）#: 本サイトでは「現在の貯水量 ÷ その時点で有効な容量」で計算する。分母は原則としてダム便覧の有効貯水容量だが、出典自身が季節を反映した利水容量貯水率を公表しているダムでは、その率が示す分母（洪水期の利水容量）を用いる。容量が登録されていないダムでは — と表示。100 % を超えた場合は表示上 100 % にクリップする。関連: rate = storage_volume_m3 / effective_active_capacity_m3(…)
全国貯水率（ぜんこくちょすいりつ）#: 容量が分かる全国のダム合計について、現在貯水量の合計を各ダムの分母の合計で割った値。「容量の登録があるダム × 直近 7 日以内の観測値」の組のみで集計する。
流入量・放流量（りゅうにゅうりょう・ほうりゅうりょう）#: 流入量 (inflow_m3s) はダムに流入する瞬間流量、放流量 (outflow_m3s) はダムから下流へ放流する瞬間流量。単位は m³/s。
貯水位（ちょすいい）#: ダムに貯まった水の標高。常時満水位 / 制限水位 / 死水位などの基準位と組み合わせて運用される。観測値カラム water_level_m、単位は m。
流域雨量（りゅういきうりょう）#: ダム上流域での降水量。観測値カラム rainfall_mm、単位は mm（観測時刻からの 1 時間積算など、ソースに依存）。

時系列・観測関連

観測値（かんそくち）#: `(dam_id, observed_at, source_id)` で識別される時系列の 1 ポイント。貯水量・貯水位・流入量・放流量・雨量などの値、および品質フラグを併せ持つ。
観測レコード（かんそくレコード）#: observations テーブルの 1 行。観測値そのもの。トップページや /stats のカウンタ「観測レコード」はこの行数を指す。TimescaleDB の approximate_row_count() を使った推定値で、誤差は概ね ±1 %。
観測時刻（かんそくじこく）#: データの観測タイムスタンプ。サイト上の表示は常に JST（Asia/Tokyo）で、末尾に「JST」を付記する。DB には UTC で保存されている。
粒度（りゅうど）#: API・チャートで提供する 3 解像度。hourly（1 時間）、daily（1 日）、monthly（1 ヶ月）。daily / monthly は TimescaleDB の連続集計（continuous aggregate）から返す。
quality_flag#: 観測値の品質を示す数値フラグ。0=正常、>0=何らかの懸念（欠測補完済み、外れ値疑いなど）。フラグ体系はベータ段階で確定予定。
source_id#: 観測値の出所（川の防災情報・各県の防災情報システム・水文水質データベースなど）。同じダムで同じ時刻に複数ソースが存在する場合、source_priorities テーブルで優先順を決める。

サイト独自の概念

名寄せ（なよせ）#: 異なるソース（国土数値情報・ダム便覧・川の防災情報など）に登場する同一ダムを 1 件の dam レコードに紐付ける作業。external_ids JSONB カラムに各ソースの ID を保持する（例: external_ids = {"ndi":"1234","damnet":"567"}）。詳細と具体例は /sources を参照。
rate-able dam#: 有効貯水容量 (active_capacity_m3) が登録されているダム。貯水率の集計対象になる。本サイトでは現在 2,388 基（全 2,749 基中）。
貯水量の変化（ストリップ）#: ホームページとダム詳細ページに表示する 8 つの時間窓（1h / 6h / 12h / 1d / 7d / 30d / 1y / 5y）の貯水量変化率。基準点（anchor）= 直近の観測時刻。各バケット = 「anchor − N」時点の観測との差分。
ライフサイクル段階#: アルファ → ベータ → 正式リリース（GA）。現在のステージは /roadmap 参照。フッターのバージョンバッジに常時表示される。
バージョン番号#: サイトと API の semver。0.x.y はアルファ、0.next.* がベータ予定、≥1.0.0 で GA。フッターおよび OpenAPI info.version に同じ値が出る（ルートの package.json の version が単一ソース。リリースは同じ番号の Git タグ vX.Y.Z と GitHub Release で公開）。

定義の不明点・追加要望は Discord まで。データソースの詳細は /sources、ロードマップは /roadmap。