> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# データと分析

> Teams のデータ指標：ダッシュボード、権限、コミット AI 比率の集計と帰属。

<Info>
  対象プラン：Teams, Enterprise
</Info>

Qoder Teams の**データ指標**について、ダッシュボードの内容、指標の定義、誰がどこまで見られるか、および「コミットにおける AI 生成比率」がプロダクト内で**どのように集計・帰属されるか**を説明します。

## ダッシュボードの指標

### コミットコードにおける AI 比率

<img src="https://mintcdn.com/qoder/V0zN5TAiiuDl2IXR/images/teams-analytics-ai-share.png?fit=max&auto=format&n=V0zN5TAiiuDl2IXR&q=85&s=efd79adabe9b9757f40c78bedcdcfbe0" alt="コミットコードにおける AI 比率" width="1024" height="522" data-path="images/teams-analytics-ai-share.png" />

**定義:** コミットに含まれる変更のうち、AI によって生成された行の割合。**AI** には **Agent**、**Edit**、**NEXT** が含まれます。

**フィルター:**

* **リポジトリ**で絞り込み（Git 情報から取得）。
* **メインブランチのみ**の表示オプション。

**数値の読み方:** Qoder 以外に**サードパーティ製ツール**でもコードを作成している場合、1 コミットあたりの総行数にその出力が含まれることがあります。それはダッシュボード上の「AI 生成」の**分子**には含まれず、**分母**側には含まれることがあるため、**画面上の比率が想定より低く見える**ことがあります。表示はプロダクト内のダッシュボードを正としてください。

### Agent による保持行数

<img src="https://mintcdn.com/qoder/V0zN5TAiiuDl2IXR/images/teams-analytics-agent-lines.png?fit=max&auto=format&n=V0zN5TAiiuDl2IXR&q=85&s=313dc2a1e06e518fb68958ec1217a2df" alt="Agent による保持行数" width="1024" height="526" data-path="images/teams-analytics-agent-lines.png" />

**定義:** **Agent** と **Edit** によって生成され、リポジトリに残っている行数（Agent による追加・削除行を含む）。

**ファイル拡張子**別に内訳を表示できます。拡張子のグループは次のとおりです。

* **フロントエンド:** `.js`、`.jsx`、`.ts`、`.tsx`、`.vue`、`.svelte`、`.html`、`.css`、`.scss`、`.less`、`.sass`
* **バックエンド:** `.py`、`.java`、`.go`、`.rs`、`.rb`、`.php`、`.cs`、`.kt`、`.scala`、`.swift`、`.m`
* **システム／低レベル:** `.c`、`.cpp`、`.h`、`.hpp`、`.asm`
* **スクリプト／設定:** `.sh`、`.bash`、`.zsh`、`.ps1`、`.bat`、`.yaml`、`.yml`、`.toml`、`.json`、`.xml`、`.ini`、`.env`
* **データ／クエリ:** `.sql`、`.graphql`、`.prisma`
* **モバイル:** `.dart`、`.swift`、`.kt`
* **ドキュメント／マークアップ:** `.md`、`.mdx`、`.rst`、`.tex`
* **その他:** `.r`、`.lua`、`.perl`、`.ex`、`.exs`、`.clj`、`.hs`、`.erl`、`.zig`、`.nim`、`.proto`、`.tf`、`.dockerfile`

### NEXT の採用回数と推薦回数

<img src="https://mintcdn.com/qoder/V0zN5TAiiuDl2IXR/images/teams-analytics-next.png?fit=max&auto=format&n=V0zN5TAiiuDl2IXR&q=85&s=c5e468b1b96eb8e4243fa739a230b236" alt="NEXT の採用と推薦" width="1024" height="525" data-path="images/teams-analytics-next.png" />

* **NEXT 採用回数:** NEXT 補完の累計採用回数。
* **NEXT 推薦回数:** NEXT 補完の累計推薦（表示）回数。

## 権限

データ指標は、機能が有効な組織のメンバーが利用できます。**ロールで閲覧範囲**が決まります。

| ロール              | 閲覧範囲          |
| ---------------- | ------------- |
| **管理者（Admin）**   | 組織全体のデータ。     |
| **メンバー（Member）** | **自分**のデータのみ。 |

**メンバー**はデータ指標を利用し、自身に紐づくレポートを閲覧できます。**管理者**は、プロダクト UI で提供されている範囲で、組織全体の集計やメンバー別ビューを追加で閲覧できます。実際の範囲は組織設定と製品バージョンによります。

## AI 生成比率：ルールと帰属

下表は、現行ポリシーのもとで、どの種類のコミットが本指標に含まれるか／除外されるかを示します。「適用」は、そのルールがフィルタや集計に**関与するか**を意味します。

| ルール                 | 説明                                                                                            | 適用 |
| ------------------- | --------------------------------------------------------------------------------------------- | -- |
| **超大規模コミットの除外**     | 依存の一括投入、移行、vendor 取り込みなど、手書き以外の大規模変更でよく見られるケース。**異常に大きい**単一コミットは検知され、本指標の集計から**除外**されることがあります | あり |
| **ローカルマージのみ**       | プル／マージ／同期などに伴い、**実質的なコード変更を含まない**コミットは、本指標の集計から一般的に除外されます                                     | あり |
| **Revert コミット**     | 過去コミットの取り消し。**現在のポリシーでは除外しません**                                                               | なし |
| **Squash / Amend**  | **一部のワークフローやツールチェーン**では、同一の変更セットが**複数回計上**されることがあります                                          | あり |
| **フォーマットのみの一括コミット** | **一般的なコード整形ツール**による書式のみの変更。**現在のポリシーでは除外せず**、加工後のコード状態との整合を取ります                               | なし |

**補足:** Squash／Amend による二重計上の有無はワークフローとツールに依存します。**表示値はプロダクト内のダッシュボードを最終の基準**としてください。

**帰属と境界（コミットのされ方に応じたプロダクトの挙動）:**

* **同期に近いマージ:** リモートからローカルへマージし、**実質的なコード編集を伴わない**同期に当たる変更は、本指標の AI 帰属の基礎に**含まれません**（上表の「ローカルマージのみ」と整合）。
* **パス変更とコピー:** 生成後に**パスだけ変更**したり、生成内容を**別パスにコピー**してコミットした場合、新パス側はルール上しばしば Qoder AI に**帰属できず**、本指標の AI 生成集計に**含まれません**。
* **複数ディレクトリ／ワークツリー:** チェックアウトパスが変わりやすい環境でも、プロダクトのルールに従い生成元と**紐づけられる変更は、一般的に集計に含まれます**。
* **Amend と再コミット:** **amend** などで再提出したあとも、なお **Qoder AI が生成した行**であれば **AI 生成として引き続きカウント**されます。
* **極大の依存・生成物:** 誤って巨大な `.module` 系ファイルをコミットした場合は、**異常に大きい**コミットの扱いに該当し、本指標の基礎から**まとめて除外**されることがあります。**ダッシュボードの表示**を参照してください。
