first commit

apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/03-channel-management.md

@@ -0,0 +1,235 @@
+---
+title: チャネル
+description: ABC User Feedbackでフィードバック収集チャネルを作成、設定、管理し、カスタムフィールドと画像設定を扱う方法を説明します。
+sidebar_position: 3
+---
+
+# チャネル
+
+**チャネル（Channel）**は、フィードバック収集パスまたは目的に応じて区別される単位です。各チャネルは独立したフィールド構造、画像設定、AI機能を持ち、さまざまなフィードバック収集シナリオに合わせて設定できます。
+
+---
+
+## チャネルの概要
+
+### チャネルの役割
+
+チャネルは次の役割を果たします：
+
+- **フィードバック収集パスの区別**: Web、アプリ、カスタマーサービス、アンケートなど
+- **データ構造の定義**: チャネル別の固有フィールド設定
+- **収集ポリシーの管理**: 画像許可、検索期間、セキュリティ設定など
+- **分析単位の提供**: チャネル別の独立した統計と分析
+
+---
+
+## チャネルの作成
+
+### アクセス方法
+
+新しいチャネルを作成する方法：
+
+1. **プロジェクト作成直後**: プロジェクト完了画面で**Create Channel**ボタンをクリック
+2. **追加チャネル作成**: **Settings > Channel List**で**Create Channel**ボタンをクリック
+
+### Step 1: チャネル基本情報
+
+![channel-create-1](/img/channel/1.png)
+
+| 項目                               | 説明                                                        | 例                                                          |
+| ---------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
+| **Name**                           | チャネル名（必須）                                          | `Webフィードバック`、`アプリレビュー`、`カスタマーサービス` |
+| **Description**                    | チャネルの簡単な説明（オプション）                          | `ウェブサイトユーザーの意見収集`                            |
+| **Maximum Feedback Search Period** | フィードバック検索可能な最大期間（30/90/180/365日、すべて） | `90日`                                                      |
+
+#### 最大フィードバック検索期間設定時の注意事項
+
+- **影響範囲**: フィードバックダウンロード機能に直接影響します
+- **ダウンロード動作**: 設定された検索期間内のすべてのフィードバックがダウンロード対象になります
+- **パフォーマンステスト**: 1日のフィードバック数が多い場合、さまざまな期間でテストして最適値を探すことをお勧めします
+- **段階的調整**: 最初は短い期間から始め、必要に応じて段階的に延長するのが安全です
+
+**完了後**: 情報を入力した後、**Next**ボタンをクリックします。
+
+### Step 2: フィールド設定
+
+![channel-create-2](/img/channel/2.png)
+
+チャネルで収集するデータ構造を定義します。これはAPIリクエスト構造とフィードバックテーブル構成に直接影響します。
+
+#### デフォルトシステムフィールド
+
+すべてのチャネルに自動的に含まれるフィールド：
+
+| Key         | Format      | プロパティ | 説明                       |
+| ----------- | ----------- | ---------- | -------------------------- |
+| `id`        | number      | Read Only  | フィードバック固有ID       |
+| `createdAt` | date        | Read Only  | フィードバック作成時刻     |
+| `updatedAt` | date        | Read Only  | フィードバック更新時刻     |
+| `issues`    | multiSelect | Editable   | リンクされたイシューリスト |
+
+> これらのフィールドは削除したり、主要なプロパティを変更したりできません。
+
+#### カスタムフィールドの追加
+
+実際のビジネス要件に合わせたフィールドを追加します。
+
+1. **Add Field**ボタンをクリックします
+2. フィールド情報を入力します
+
+| 項目             | 説明                                            | 例                                             |
+| ---------------- | ----------------------------------------------- | ---------------------------------------------- |
+| **Key**          | 一意の識別子（大文字/小文字、数字、`_`）        | `message`、`rating`                            |
+| **Display Name** | UIに表示される名前                              | `フィードバック内容`、`ユーザーメールアドレス` |
+| **Format**       | データ形式（下の表を参照）                      | `text`、`keyword`、`number`                    |
+| **Property**     | `Editable`（入力可能）/ `Read Only`（閲覧のみ） | `Editable`                                     |
+| **Status**       | `Active` / `Inactive`                           | `Active`                                       |
+| **Description**  | チームメンバーが理解しやすい説明（オプション）  | `ユーザーが入力したフィードバック内容`         |
+
+### フィールド形式の種類
+
+| Format        | 説明                 | 使用例                           | API例                            |
+| ------------- | -------------------- | -------------------------------- | -------------------------------- |
+| `text`        | 自由テキスト入力     | フィードバック内容、詳細説明     | `"アプリが頻繁にフリーズします"` |
+| `keyword`     | 短いキーワード/タグ  | バージョン情報、ページ名         | `"v1.2.3"`                       |
+| `number`      | 数字                 | 評価、年齢、使用時間             | `5`                              |
+| `date`        | 日付                 | 発生日、有効期限                 | `"2024-03-01T00:00:00Z"`         |
+| `select`      | 単一選択             | カテゴリ、優先度                 | `"機能リクエスト"`               |
+| `multiSelect` | 複数選択             | タグ、関連機能                   | `["バグ", "UI"]`                 |
+| `images`      | 画像URL配列          | スクリーンショット、添付ファイル | `["https://..."]`                |
+| `aiField`     | AI分析結果フィールド | 感情分析、要約、キーワード抽出   | `"ポジティブ"`                   |
+
+> **images形式について**: 詳細な画像設定方法については、[画像設定](/ja/user-guide/settings/image-setting)ドキュメントを参照してください。
+>
+> **aiField形式について**: AIフィールド設定とテンプレート構成方法については、[AI設定](/ja/user-guide/settings/ai-setting)ドキュメントを参照してください。
+
+### フィールド構成例
+
+#### Webフィードバックチャネル
+
+| Key           | Display Name       | Format  | 用途                         |
+| ------------- | ------------------ | ------- | ---------------------------- |
+| `message`     | フィードバック内容 | text    | ユーザーの意見               |
+| `userEmail`   | メールアドレス     | keyword | 連絡先（オプション）         |
+| `pageUrl`     | ページURL          | keyword | フィードバック発生位置       |
+| `category`    | カテゴリ           | select  | バグ/機能リクエスト/改善事項 |
+| `priority`    | 優先度             | select  | 高/中/低                     |
+| `screenshots` | スクリーンショット | images  | 問題状況のキャプチャ         |
+
+#### モバイルアプリレビューチャネル
+
+| Key          | Display Name     | Format  | 用途             |
+| ------------ | ---------------- | ------- | ---------------- |
+| `message`    | レビュー内容     | text    | ユーザーレビュー |
+| `rating`     | 評価             | number  | 1-5点評価        |
+| `appVersion` | アプリバージョン | keyword | バグ追跡用       |
+| `deviceType` | デバイスタイプ   | select  | iOS/Android      |
+| `crashLogs`  | クラッシュログ   | text    | 技術的エラー情報 |
+
+### フィールドプレビュー
+
+フィールド設定を完了した後、**Preview**ボタンで実際のフィードバック入力画面をプレビューできます。
+
+このプレビューは、APIリクエストに必要なフィールド構造と同じです。
+
+**完了後**: **Next**ボタンで次のステップに進みます。
+
+### Step 3: チャネル作成完了
+
+![create-channel-3](/img/channel/3.png)
+
+すべてのステップを完了すると、**要約画面**が表示されます：
+
+- チャネル情報：名前、説明、タイムゾーン
+- フィールド情報
+
+---
+
+## フィールド管理
+
+### フィールドの編集
+
+既存のフィールドを編集するには、フィールドリストで編集したいフィールドの行をクリックして情報を変更します。
+
+> **注意**: `Key`と`Format`は作成後に変更できません。データの一貫性のために制限されています。
+
+### フィールドの削除
+
+フィードバックデータの整合性と一貫性を保証するため、**フィールド削除機能は提供されていません**。
+
+#### 削除の代わりに推奨される方法
+
+1. **Inactive状態に変更**: フィールドを無効化して新しいフィードバック収集から除外
+2. **データの保持**: 既に収集されたフィードバックデータはそのまま維持
+3. **フィルタリングの活用**: フィールドリストでActiveフィールドのみを表示して管理効率を確保
+
+#### 完全削除が必要な場合
+
+フィールドを完全に削除する必要がある状況では：
+
+- チャネル全体を削除して新しく作成する方法を検討
+- データをエクスポート後、新しい構造に移行
+- 開発チームと相談してデータベースレベルで処理
+
+### フィールドステータス管理
+
+#### Active / Inactiveの切り替え
+
+- **Active**: フィードバック収集時に使用されるフィールド
+- **Inactive**: 一時的に無効化されたフィールド（データは保持）
+
+#### フィルタリングオプション
+
+上部のコントロールで次の条件でフィールドをフィルタリングできます：
+
+- **Status**: `Active` / `Inactive`
+- **Property**: `Editable` / `Read Only`
+
+---
+
+## チャネル情報管理
+
+![channel-setting](/img/channel/channel-setting.png)
+
+### チャネル基本情報の編集
+
+作成されたチャネルの基本情報を変更できます。
+
+#### アクセス方法
+
+1. **Settings > Channel List > [チャネル選択]**
+2. **Channel Information**タブをクリック
+
+#### 編集可能な項目
+
+| 項目                               | 編集可能 | 注意事項                                 |
+| ---------------------------------- | -------- | ---------------------------------------- |
+| **Channel ID**                     | ❌ 不可  | システム内部識別子                       |
+| **Channel Name**                   | ✅ 可能  | チームメンバーに表示される名前           |
+| **Description**                    | ✅ 可能  | チャネルの目的                           |
+| **Maximum Feedback Search Period** | ✅ 可能  | パフォーマンスに影響する可能性があります |
+
+### チャネルの削除
+
+使用しなくなったチャネルを削除できます。
+
+#### 削除手順
+
+1. Channel Information画面下部の**Delete Channel**ボタンをクリック
+2. 確認ポップアップでチャネル名を正確に入力
+3. **Delete**ボタンで最終確定
+
+#### 削除時の注意事項
+
+- そのチャネルの**すべてのフィードバックデータが永続的に削除**されます
+- **元に戻せないため**、事前のバックアップまたはエクスポートを推奨します
+- 関連するAPIキー設定も確認が必要です
+
+---
+
+## 関連ドキュメント
+
+- [プロジェクト管理](./02-project-management.md) - プロジェクト設定と権限管理
+- [フィードバック管理](./04-feedback-management.md) - 収集されたフィードバックの分析と活用
+- [API統合](/ja/developer-guide/api-integration) - 外部システムとの統合方法
+- [AI統合](/ja/user-guide/settings/ai-setting) - AI機能設定