用語集

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

基本エンティティ

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

容量・貯水関連

総貯水容量（そうちょすいようりょう）#: ダム湛水面の最高水位（サーチャージ水位）まで貯められる容量の合計。死水容量・利水容量・洪水調節容量を含む、ダムの「物理的な最大容積」。単位は m³。
利水容量（りすいようりょう）#: 通常運用で利用可能な貯水容量。総貯水容量から死水容量および洪水調節容量を除いた残り。水道・かんがい・発電などの用途に充てられる。本サイトの「貯水率」の分母に用いる。関連: 英: active capacity
洪水調節容量（こうずいちょうせつようりょう）#: 洪水時に下流の被害を抑えるため、空けておくべき容量。利水容量とは独立にダムが確保する。
死水容量（しすいようりょう）#: 取水口より下にあり、通常は使えない容量。堆砂や水位低下時の保全に充てられる。
貯水量（ちょすいりょう）#: ある時点でダムに実際に貯まっている水の量（容積）。単位 m³。観測値カラム名は storage_volume_m3。関連: storage_volume_m3 / 貯水容積
貯水率（ちょすいりつ）#: 本サイトでは「現在の貯水量 ÷ 利水容量」で計算する。利水容量を持つダムだけが対象。100 % を超えた場合は表示上 100 % にクリップする（実運用上は洪水期の制限水位等に依存し、表示の単純化のため）。利水容量が登録されていないダムでは — と表示。関連: rate = storage_volume_m3 / 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#: 観測値の出所（ダム便覧・川の防災情報・水文水質データベース・synthetic など）。同じダムで同じ時刻に複数ソースが存在する場合、source_priorities テーブルで優先順を決める。
synthetic（合成データ）#: 実観測ソースが整うまでの暫定として生成された人工的な観測値。source_id が "synthetic" のレコードはこれ。アルファ段階のみ。ベータでは段階的に実観測値に置換える。

サイト独自の概念

名寄せ（なよせ）#: 異なるソース（国土数値情報・ダム便覧・川の防災情報など）に登場する同一ダムを 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 に同じ値が出る（lib/version.ts が単一ソース）。

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