タウキート ガイド

このガイドはタスクごとに構成されています。各セクションは 1 つのタスクに関するすべて（コマンド＋ダッシュボード設定）をまとめています。初めての方は上から、目的のセクションへはセクション一覧から直接どうぞ。

最初のセットアップ手順

1. ボットをサーバーに追加し、必要な権限（ロールとチャンネルの管理）を付与します。
2. /setup configure を実行し、ログチャンネル、レポートチャンネル、管理ロール、メンバーロールを設定します。
3. /attendance で適切なチャンネルに出席パネルを作成します。
4. （任意）必要に応じて、設定からアラート・休憩・ポイントを有効化します。

出席パネル（メンバー向け）

管理者がメンバーの見えるチャンネルに一度だけ作成します。メンバーはコマンドを入力せず、直接ボタンを押せます：

• 📝 出勤：新しいセッションを開始します。同時に2つのセッションを開くことはできません。
• 👋 退勤：現在のセッションを終了し、その長さを計上します（システムが有効ならポイントも付与）。
• ⏱️ 自分の時間を表示：本日の勤務時間の概要と、アクティブな場合は現在のセッションの長さを表示します。
• 💤 休憩（AFK）：休憩機能を有効にした場合のみ表示され、時間の計上を一時停止します。

在席状況のリアルタイム監視（管理者向け）

/activesessions コマンドは、出勤してまだ退勤していない全員の最新リストを、各人の在席時間と更新ボタンとともに表示します：

手動での対応（管理者向け）

メンバーが記録を忘れたり、セッションを修正する必要があることがあります。これらのコマンドで完全に制御できます：

休憩（AFK）とアラート

時間の計上をより公平にするため、設定から有効化できる2つの任意機能です：

• 休憩（AFK）：メンバーが休憩ボタンを押すと時間の計上が一時停止し、もう一度押すと再開します。休憩が上限（既定で 15 分）を超えると、自動的に退勤が記録されます。
• アラート：セッションが指定の長さ（既定で 12 時間）を超えた人に、ログチャンネルのメッセージとメンバーへの個別リマインダーで通知します — 退勤を忘れた場合に備えて。

ダッシュボードから

上記のすべては、コマンドなしでウェブのダッシュボードからも利用できます。設定ページで、ライブのアクティブセッション一覧を表示するチャンネルとそのメッセージ形式（テキストまたは Embed）を指定でき、ボットは今誰がいるかを自動更新するメッセージを投稿します：

ポイントの計算方法

基本はシンプルで、出席1時間あたりの基本レート（既定で1時間1ポイント）です。その上に、2つの任意のレイヤーがあります：

• ティア（Tiers）：合計時間に応じて異なるレート — より多く出席した人に報いるため。
• ピーク時間の倍率（ボーナス）：指定の時間帯にポイントを倍にして、その時間帯の出席を促します。

メンバー向けコマンド

ポイントの管理（管理者向け）

ダッシュボードから

すべてのポイント設定は設定ページから視覚的に管理できます：システムの有効化、基本レートの設定、ティアの追加、ピーク倍率の期間の指定 — コマンド構文を覚える必要はありません。

オンデマンドレポート

各レポートはレポートチャンネルに送信され、export オプションでグラフ付きの整形された Excel ファイルとしてエクスポートできます：

自動レポート

毎日手動でレポートを抽出する代わりに、ロールをチャンネルに紐づければ、その日次レポートが（サーバーのタイムゾーンで）深夜に自動送信されます：

分析と比較（ダッシュボード）

分析ページはデータをビジュアルに変換します：合計時間と平均、ピーク時間帯、そして時間の経過に伴う出席傾向。比較ページでは複数のメンバーを並べて表示できます：

時間の調整とリセット

セッションを開かずにメンバーの時間を修正する、または記録をリセットするには：

同じ2つの操作は、ダッシュボードの時間の調整ページから視覚的に行えます：

管理ロール

どのロールが管理者コマンドを使用できるか（設定の基本ロールに加えて）を定義します。Administrator 権限を持つ人やサーバーのオーナーは常に完全なアクセス権を持ちます。

ボットのカスタマイズ

できること

レポートを抽出して手動で読む代わりに、アシスタントに直接質問すると、サーバーの出席データを読み取って答えます：サマリー、比較、ピーク時間帯、予測、欠席・遅刻者など。すべての回答は実際のデータに基づきます。

使い方