b24014/Q-A_test
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

first commit
CI / typecheck (push) Successful in 1m8s
Details
CI / format (push) Failing after 1m6s
Details
CI / lint (push) Failing after 49s
Details
CI / test (push) Failing after 1m8s
Details

Browse Source
This commit is contained in:
SDI
2026-07-15 18:05:12 +09:00
commit 12e4f17b62
4633 changed files with 817125 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/01-getting-started.md
+263
View File
@@ -0,0 +1,263 @@
---
title: はじめに
description: ABC User Feedbackインストール後、初期設定から最初のフィードバック収集まで、システムを開始する方法を説明します。
sidebar_position: 1
---
# はじめに
ABC User Feedbackを初めてインストールした後、システムを使用するには初期設定が必要です。このドキュメントでは、テナント作成から最初のフィードバック収集までの全プロセスを段階的に説明します。
---
## 初期設定の概要
ABC User Feedbackを開始するには、次の順序で設定を進めます：
1. **テナントと管理者アカウントの作成**
2. **初回ログインとプロフィール設定**
3. **プロジェクトの作成**
4. **チャネルの作成とフィールド設定**
5. **APIキーの発行**
6. **最初のフィードバック収集のテスト**
---
## システムへのアクセス
ABC User Feedbackのインストールが必要な場合は、まず[Docker Hubイメージを使用したインストール](/ja/developer-guide/installation/docker-hub-images)を進めてください。
インストールを完了したら、Webブラウザを通じてABC User Feedbackにアクセスします：
```
http://localhost:3000
```
> ポートやドメインを変更した場合は、設定に応じたアドレスを入力してください。
---
## テナントと管理者アカウントの作成
![member-register.png](/img/tenant.png)
初めてアクセスすると、**テナント作成と管理者アカウント登録**画面が表示されます。
### Step 1: テナント情報の入力
テナント名を設定します。
テナント名を入力した後、**Next**ボタンをクリックします。
> このテナント名はログインUIに表示されます。
### Step 2: 管理者アカウントの作成
システムの最初の管理者アカウントを作成します。
1. 管理者アカウントのメールアドレスを入力し、**Request Code**ボタンをクリックします。
2. メールボックスで認証コードを確認して入力します
3. **Verify**ボタンをクリックします
4. 認証が完了したら、パスワードを設定します。
:::info パスワード要件
- **8文字以上**
- **英字を含む**（A–Z、a–z）
- **特殊文字を含む**（例：`@`、`#`、`!`）
- **連続文字禁止**（例：`aa`、`11`）
> **例**: ✅ `MyCompany2024!`, ❌ `12345678`、`password`
:::
テナントと管理者アカウントの作成が完了すると、確認画面が表示されます。
**次のステップ**: **確認**ボタンをクリックしてログイン画面に移動します。
---
## ログイン
作成した管理者アカウントで初回ログインを行います。
1. **Email**: 先ほど登録した管理者メールアドレスを入力します
2. **Password**: 設定したパスワードを入力します
3. **Sign In**ボタンをクリックします
---
## 最初のプロジェクトの作成
ログインすると、プロジェクト作成ウィザードが自動的に開始されます。
### システム構造の理解
ABC User Feedbackは、次の階層構造を持っています：
```
テナント（組織）
└── プロジェクト（製品/サービス単位）
└── チャネル（フィードバック収集パス）
```
### Step 1: プロジェクト基本情報
| 項目 | 説明 | 例 |
| --------------- | -------------------------------------- | ------------------------------- |
| **Name** | プロジェクト名 | `モバイルアプリ`、`Webサービス` |
| **Description** | プロジェクトの説明（オプション） | `顧客フィードバック収集と分析` |
| **Time Zone** | 時間基準（ダッシュボードと統計に影響） | `Asia/Tokyo` |
**完了後**: 情報を入力した後、**Next**ボタンをクリックします。
### Step 2: チームメンバーの招待（オプション）
このステップでは、プロジェクトにチームメンバーを招待できます。今スキップしても、後でいつでも追加できます。
### Step 3: APIキーの生成（オプション）
外部システムとの統合用のAPIキーを事前に生成できます。
### プロジェクト作成完了
すべての情報を入力すると、プロジェクト作成が完了します。
**次のステップを選択**：
- **Create Channel**: すぐにチャネルを作成してフィードバック収集を開始
- **Skip for Now**: 後でチャネルを作成
---
## 最初のチャネルの作成
プロジェクト作成後、実際にフィードバックを収集するには**チャネル**を作成する必要があります。
### チャネルの概念の理解
チャネルは**フィードバック収集パス**を意味します：
- ウェブサイトのお問い合わせフォーム
- モバイルアプリ内のフィードバック
- カスタマーサービスVoC
- アンケート回答
### Step 1: チャネル基本情報
| 項目 | 説明 | 例 |
| ---------------------------------- | ----------------------------------------------------- | ------------------------------------- |
| **Name** | チャネル名 | `Webフィードバック`、`アプリレビュー` |
| **Description** | チャネルの説明（オプション） | `ウェブサイトユーザーの意見` |
| **Maximum Feedback Search Period** | フィードバック検索可能期間（30/90/180/365日、すべて） | `90日` |
**完了後**: 情報を入力した後、**Next**ボタンをクリックします。
### Step 2: フィールド設定
チャネルで収集するデータ構造を定義します。
#### デフォルトフィールド
システムで自動的に作成されるフィールド：
| フィールド名 | 形式 | プロパティ | 説明 |
| ------------ | ----------- | ---------- | -------------------------- |
| `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`、`date`、`select`、`multiSelect`、`images`、`aiField` |
| **Property** | `Editable`（UIで変更可能）/ `Read Only`（変更不可） | `Editable` |
| **Status** | `Active` / `Inactive` | `Active` |
#### 推奨デフォルトフィールド構成
最初のチャネルには、次のフィールドを追加することをお勧めします：
| Key | Display Name | Format | 説明 |
| ----------- | ---------------------- | ------- | ---------------------- |
| `message` | フィードバック内容 | text | ユーザーフィードバック |
| `userEmail` | ユーザーメールアドレス | keyword | 連絡先（オプション） |
| `rating` | 満足度 | number | 1-5点評価 |
### フィールドプレビュー
フィールド設定を完了した後、**Preview**ボタンでフィードバック入力画面をプレビューできます。
**完了後**: **Complete**ボタンでチャネル作成を完了します。
### チャネル作成完了
**次のステップ**: **Start**ボタンをクリックしてフィードバック収集を開始します。
---
## 最初のフィードバック収集のテスト
チャネル作成が完了すると、実際にフィードバックを収集できます。
### APIによるフィードバック登録
作成したAPIキーを使用して最初のフィードバックを登録してみましょう。
#### APIリクエスト例
```bash
curl -X POST http://localhost:4000/api/projects/1/channels/1/feedbacks \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-d '{
"message": "アプリの実行速度が遅いです",
"userEmail": "user@example.com",
"rating": 3
}'
```
> `YOUR_API_KEY`は、先ほど作成した実際のAPIキーに置き換えてください。
#### 成功レスポンスの確認
APIリクエストが成功すると、次のようなレスポンスが返されます：
```json
{
"id": 1
}
```
### フィードバックの確認
登録したフィードバックをWebインターフェースで確認してみましょう。
1. 上部メニューで**Feedback**タブをクリック
2. フィードバックリストで登録されたフィードバックを確認
3. フィードバックをクリックして詳細情報を確認
### 最初のイシューの作成
フィードバックに基づいてイシューを作成してみましょう。
1. フィードバック詳細画面で、**Issue**セクションの**`+`ボタン**をクリック
2. イシュー名を入力し、**Enter**キーまたは**Create**ボタンをクリック
3. 作成されたイシューを確認
## 次のステップガイド
基本的な設定と最初のフィードバック収集が完了しました！
## 関連ドキュメント
- [API統合](/ja/developer-guide/api-integration) - 詳細なAPI使用ガイド
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/02-project-management.md
+347
View File
@@ -0,0 +1,347 @@
---
title: プロジェクト
description: ABC User Feedbackでプロジェクトを作成、設定、管理し、チームメンバーの役割と権限を設定する方法を説明します。
sidebar_position: 2
---
# プロジェクト
ABC User Feedbackでは、**プロジェクト**はフィードバックを収集・分析する最も基本的な単位です。プロジェクトの作成からチーム管理、権限設定の機能を説明します。
---
## プロジェクトの概要
プロジェクトは次の階層構造を持ちます：
```
テナント
└── プロジェクト（複数可能）
├── チャネル（複数可能）
├── メンバーと役割
├── イシュートラッカー統合
├── ウェブフック統合
├── AI機能
└── APIキー
```
各プロジェクトは複数のチャネルを含む管理単位で、チームメンバーと役割、イシュートラッカー統合、外部システム統合などを独立して設定・運用できます。
---
## プロジェクトの作成
### アクセス権限
プロジェクトの作成は**Superユーザー**のみ可能です。一般ユーザーは既存のプロジェクトにメンバーとして招待されて参加できます。
> Superユーザー権限が必要な場合は、システム管理者にお問い合わせください。
### アクセス方法
新しいプロジェクトを作成する方法は2つあります：
1. **初回ログイン時**: プロジェクト作成ウィザードが自動的に開始されます
2. **追加プロジェクト**: 左サイドバー上部の**Create Project**ボタンをクリックします
### Step 1: プロジェクト基本情報
![create-project-1](/img/project/1.png)
プロジェクト作成時に次の情報を入力します：
| 項目 | 説明 | 例 |
| --------------- | ---------------------------------------------------- | -------------------------------------------------------- |
| **Name** | プロジェクト名（必須） | `モバイルアプリ`、`カスタマーサービス`、`ベータサービス` |
| **Description** | 簡単な説明（オプション） | `iOS/Androidアプリユーザーフィードバック収集` |
| **Time Zone** | フィードバックとレポートの時間基準として使用（必須） | `Asia/Seoul` |
> タイムゾーンは**ダッシュボード統計**に影響します。
**完了後**: すべての情報を入力した後、**Next**ボタンをクリックします。
### Step 2: チームメンバーの追加（オプション）
![create-project-2](/img/project/2.png)
このステップは**スキップ可能**です。後でプロジェクト設定からいつでも追加できます。
#### メンバーの追加
1. 右上の**Register Member**ボタンをクリックします
2. 次の項目を入力します：
- **Email**: システムに登録されたユーザーを選択
- **Role**: Admin、Editor、Viewerから選択
> カスタム役割を使用したい場合は、**Role Management**ボタンをクリックして追加設定が可能です。
**完了後**: メンバーリストを確認して**Next**をクリックします。
### Step 3: APIキーの生成（オプション）
![create-project-3](/img/project/3.png)
APIキーは外部システムからフィードバックを収集する際に使用されます。設定メニューから後で生成できるため、今はスキップしてもかまいません。
#### キー生成方法
1. 右上の**Create API Key**ボタンをクリックします
2. キーが自動生成されてリストに表示されます
3. 生成されたキーをコピーして安全な場所に保存します
### プロジェクト作成完了
![create-project-4](/img/project/4.png)
すべてのステップを完了すると、**要約画面**が表示されます：
- プロジェクト情報: 名前、説明、タイムゾーン
- メンバーリスト
- 生成されたAPIキー
- 役割設定状態
#### 次のステップ
- すぐにチャネルを作成してフィードバック収集を開始するには、**Create Channel**ボタンをクリックします
- または**Later**ボタンで後で作成できます
---
## プロジェクト設定の管理
![project-setting.png](/img/project/project-setting.png)
### アクセス方法
プロジェクト設定を変更するには：
1. 上部メニューで**Settings**をクリック
2. 左メニューから**Project Setting**を選択
### 基本情報の編集
次の項目をいつでも変更できます：
| 項目 | 説明 | 注意事項 |
| --------------- | ---------------------------------- | ---------------------------------- |
| **Name** | プロジェクト名 | チームメンバーに表示される名前 |
| **Description** | 説明（オプション） | プロジェクトの目的 |
| **Time Zone** | 統計と時間関連データの基準時刻設定 | 変更時、既存データには影響しません |
**保存方法**: 変更後、右上の**Save**ボタンをクリックします。
### タイムゾーン変更時の注意事項
- 既存のフィードバック/イシューの時間情報には影響しません
- 変更後、ダッシュボード統計でデータの不一致が発生する可能性があります。
### プロジェクトの削除
#### 削除手順
プロジェクトを完全に削除するには：
1. Project Setting画面下部の**Delete Project**ボタンをクリックします
2. 確認ポップアップでプロジェクト名を正確に入力します
3. **Delete**ボタンで最終確定します
#### 削除時の注意事項
- そのプロジェクト内の**すべてのフィードバック、イシュー、設定が永続的に削除**されます
- **元に戻せないため**、事前のバックアップまたはエクスポートを推奨します
- 削除時、接続されたチャネルとAPIキーも一緒に削除されます
---
## メンバー管理
![member-setting.png](/img/project/member-setting.png)
### メンバーリストの確認
現在プロジェクトに参加しているメンバーを確認するには：
1. 上部メニューで**Settings**をクリック
2. 左メニューから**Member Management**を選択
メンバーリストには次の情報が表示されます：
| 項目 | 説明 |
| ---------- | ------------------------------ |
| Email | アカウントメールアドレス |
| Name | ユーザー名（プロフィール基準） |
| Department | 所属部門 |
| Role | プロジェクト内の役割 |
| Joined | プロジェクト参加日 |
### 新しいメンバーの招待
![member-register.png](/img/project/member-register.png)
#### 招待手順
1. **Register Member**ボタンをクリックします
2. 招待情報を入力します：
| 項目 | 説明 |
| --------- | ------------------------------------------- |
| **Email** | 招待するユーザーのメールアドレス |
| **Role** | 割り当てる役割（Admin、Editor、Viewerなど） |
3. **Invite**ボタンをクリックして招待を完了します
### メンバー情報の編集
既存のメンバー情報を変更するには：
1. メンバーリストで編集したいメンバーの行をクリックします
2. ポップアップでRoleを変更できます：
3. **Save**ボタンで変更を保存します
### メンバーの削除
メンバーをプロジェクトから削除するには：
1. メンバー編集ポップアップ下部の**削除**ボタンをクリックします
2. 確認メッセージで**確認**をクリックします
> メンバーを削除しても、そのユーザーが作成したフィードバック/イシュー記録はそのまま維持され、プロジェクトアクセス権限のみが削除されます。
---
## 役割と権限管理
![role-setting.png](/img/project/role-setting.png)
### デフォルト役割
システムでは次のデフォルト役割を提供します：
| 役割 | 権限要約 |
| ---------- | --------------------------------------------------------- |
| **Admin** | すべての機能にアクセス可能。プロジェクト削除を含む |
| **Editor** | フィードバック/イシューの作成、編集、削除可能。設定は不可 |
| **Viewer** | 閲覧のみ可能。編集、削除、設定アクセス不可 |
### カスタム役割の作成
![role-create.png](/img/project/role-create.png)
より細分化された権限が必要な場合は、カスタム役割を作成できます：
1. Member Management画面で**Role Management**リンクをクリックします
2. **Create Role**ボタンをクリックします
3. 役割名と権限を入力します：
### 権限設定
各役割について、次の機能別権限を設定できます：
#### フィードバック権限
| 権限項目 | 説明 |
| ----------------------------------- | ------------------------------------- |
| **Download Feedback** | フィードバックデータのダウンロード |
| **Edit Feedback** | フィードバックの編集 |
| **Delete Feedback** | フィードバックの削除 |
| **Attach/Detach Issue in Feedback** | フィードバックとイシューのリンク/解除 |
#### イシュー権限
| 権限項目 | 説明 |
| ---------------- | -------------- |
| **Create Issue** | イシューの作成 |
| **Edit Issue** | イシューの編集 |
| **Delete Issue** | イシューの削除 |
#### プロジェクト管理
| 権限項目 | 説明 |
| --------------------- | ---------------------- |
| **Edit Project Info** | プロジェクト情報の編集 |
| **Delete Project** | プロジェクトの削除 |
#### メンバー管理
| 権限項目 | 説明 |
| ------------------------- | -------------------------- |
| **Read Project Member** | プロジェクトメンバーの閲覧 |
| **Create Project Member** | プロジェクトメンバーの招待 |
| **Edit Project Member** | プロジェクトメンバーの編集 |
| **Delete Project Member** | プロジェクトメンバーの削除 |
#### 役割管理
| 権限項目 | 説明 |
| ----------------------- | ---------------------- |
| **Read Project Role** | プロジェクト役割の閲覧 |
| **Create Project Role** | プロジェクト役割の作成 |
| **Edit Project Role** | プロジェクト役割の編集 |
| **Delete Project Role** | プロジェクト役割の削除 |
#### APIキー管理
| 権限項目 | 説明 |
| ------------------ | ------------- |
| **Read API Key** | APIキーの閲覧 |
| **Create API Key** | APIキーの作成 |
| **Edit API Key** | APIキーの編集 |
| **Delete API Key** | APIキーの削除 |
#### イシュートラッカー
| 権限項目 | 説明 |
| ---------------------- | ------------------------ |
| **Read Issue Tracker** | イシュートラッカーの閲覧 |
| **Edit Issue Tracker** | イシュートラッカーの設定 |
#### ウェブフック管理
| 権限項目 | 説明 |
| ------------------ | ------------------ |
| **Read Webhook** | ウェブフックの閲覧 |
| **Create Webhook** | ウェブフックの作成 |
| **Edit Webhook** | ウェブフックの編集 |
| **Delete Webhook** | ウェブフックの削除 |
#### AIとチャネル設定
| 権限項目 | 説明 |
| ---------------------- | ------------ |
| **Read Generative AI** | AI設定の閲覧 |
| **Edit Generative AI** | AI設定の編集 |
#### チャネル関連設定
| 権限項目 | 説明 |
| ---------------------- | -------------------- |
| **Edit Channel Info** | チャネル情報の編集 |
| **Delete Channel** | チャネルの削除 |
| **Read Field** | フィールドの閲覧 |
| **Edit Field** | フィールドの編集 |
| **Read Image Setting** | 画像設定の閲覧 |
| **Edit Image Setting** | 画像設定の編集 |
| **Create Channel** | 新しいチャネルの作成 |
### 権限設定のヒント
#### セキュリティのベストプラクティス
- **最小権限の原則**: 業務に必要な最小限の権限のみを付与
- **定期的なレビュー**: チーム変更や退職者発生時に権限を確認
- **Admin役割の制限**: 管理者は可能な限り少ない数で維持
### 役割の編集と削除
- **編集**: 役割リストで希望する項目をクリックして名前と権限を変更できます
- **削除**: 使用されていない役割は**Delete**ボタンで削除可能です
> **注意**: Admin役割は常に1つ以上存在する必要があり、削除できません。
---
## 関連ドキュメント
- [チャネル管理](./03-channel-management.md) - チャネルの作成とフィールド設定
- [フィードバック管理](./04-feedback-management.md) - フィードバックの収集と分析
- [API統合](/ja/developer-guide/api-integration) - APIキーの使用方法
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/03-channel-management.md
+235
View File
@@ -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機能設定
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/04-feedback-management.md
+336
View File
@@ -0,0 +1,336 @@
---
title: フィードバック
description: ABC User Feedbackでフィードバックを作成、閲覧、分析、管理する方法を説明します。
sidebar_position: 4
---
# フィードバック
フィードバックはABC User Feedbackのコアデータです。このドキュメントでは、フィードバックの作成から分析、管理まで、フィードバックに関連するすべての機能を説明します。
![feedback](/img/feedback/0.png)
---
## フィードバックの作成
フィードバックは主に外部システム（ウェブサイト、モバイルアプリ、API統合）によって作成されますが、管理者が直接作成することもできます。
### APIによるフィードバック作成
最も一般的なフィードバック作成方法です。
#### 基本APIリクエスト構造
```bash
curl -X POST http://your-domain.com/api/v1/projects/{projectId}/channels/{channelId}/feedbacks \
-H "Content-Type: application/json" \
-H "X-API-KEY: YOUR_API_KEY" \
-d '{
"message": "ユーザーフィードバック内容",
"userEmail": "user@example.com",
"category": "バグレポート"
}'
```
#### チャネルフィールドに応じたリクエスト例
各チャネルのフィールド設定に応じてリクエスト構造が異なります：
**Webフィードバックチャネル例**：
```json
{
"message": "ログインボタンが動作しません",
"userEmail": "user@company.com",
"pageUrl": "https://example.com/login",
"category": "バグ",
"priority": "高",
"browserInfo": "Chrome 119.0.0"
}
```
**モバイルアプリチャネル例**：
```json
{
"message": "アプリが頻繁にフリーズします",
"rating": 2,
"appVersion": "v2.1.3",
"deviceType": "iOS",
"crashLogs": "Exception in thread main..."
}
```
#### 画像を含むフィードバック
画像URL方式を使用する場合：
```json
{
"message": "画面が壊れて表示されます",
"userEmail": "user@example.com",
"images": [
"https://cdn.example.com/screenshot1.png",
"https://cdn.example.com/screenshot2.png"
]
}
```
### フィードバック作成の確認
作成されたフィードバックはすぐにフィードバックリストに表示されます。
---
## フィードバックリストへのアクセス
作成されたフィードバックを確認・管理するためにフィードバックリストにアクセスします。
### アクセス方法
1. 左サイドバーから目的の**プロジェクト**を選択します
2. 下部のチャネルリストから目的の**チャネル**をクリックします
3. 上部メニューで**Feedback**タブを選択します
### フィードバックテーブル構成
フィードバックリストはテーブル形式で表示され、次の基本構造を持ちます：
| 列タイプ | 説明 | 例 |
| ---------------- | ---------------------------------- | ---------------------------- |
| **デフォルト列** | すべてのチャネルに共通表示 | ID、Created、Updated、Issue |
| **カスタム列** | チャネルフィールド設定に応じて表示 | Message、UserEmail、Category |
---
## フィードバックフィルタリング/ソート/ビューオプション
大量のフィードバックデータから目的の情報を素早く見つけるためのさまざまなツールを提供します。
![feedback-option](/img/feedback/1.png)
### 日付フィルタリング
上部の**Date**ボタンで閲覧期間を設定できます。
#### 提供される期間オプション
| オプション | 説明 | 使用例 |
| ------------ | ---------------------------- | ------------------------ |
| **今日** | 当日登録されたフィードバック | リアルタイムモニタリング |
| **昨日** | 前日のフィードバック | 日次レビュー |
| **過去7日** | 最近1週間のデータ | 週次分析 |
| **過去30日** | 最近1ヶ月のデータ | 月次トレンド把握 |
| **カスタム** | 開始日-終了日を直接設定 | 特定期間分析 |
### 高度なフィルタ
**Filter**ボタンをクリックすると、さまざまな条件でフィードバックをフィルタリングできます。
![feedback-filter](/img/feedback/2.png)
#### フィルタ構造
```
Where: 最初の条件
And: すべての条件を満たすフィードバック
Or: いずれかを満たすフィードバック
```
> **注意**: `And`と`Or`は同時に混在して使用できません。
#### フィールドタイプ別フィルタオプション
| フィールドタイプ | 使用可能な演算子 | 例 |
| ---------------- | ------------------------------------ | ---------------------------- |
| **text** | Contains（部分一致） | message contains "バグ" |
| **keyword** | Is（完全一致） | category is "機能リクエスト" |
| **number** | Is（完全一致） | rating == 3 |
| **select** | Is（完全一致） | |
| **multiSelect** | Is（完全一致）、Contains（部分一致） | |
| **aiField** | Contains（部分一致） | |
| **date** | Is（完全一致）、Between（期間一致） | created between 日付範囲 |
#### フィルタ使用例
**マルチセレクトカテゴリの高度な検索**：
```
Where: category contains "バグ"
And: priority is "高"
```
**複数のイシューがリンクされたフィードバックを検索**：
```
Where: issues contains "ログインイシュー"
Or: issues contains "UI改善"
```
**特定カテゴリの4評価フィードバックを検索**：
```
Where: category is "機能リクエスト"
And: rating is 4
```
### ソート機能
テーブルヘッダーをクリックして、その列基準でソートできます。Created列とUpdated列でこの機能が提供されます。
### ビューオプション
フィードバックリストの表示方法をユーザーのニーズに合わせて調整できます。
#### Expand機能
**Expand**ボタンをクリックすると、テーブルで各フィードバックの詳細内容をプレビューできます。
**活用方法**：
- 詳細パネルを開かずに主要な内容を確認
- 複数のフィードバックを素早く閲覧
- 長いテキストフィールドの全体内容を確認
#### 列の表示/非表示
テーブル上部の**View**ボタンで表示する列を選択できます。
**機能**：
- **必須列**: ID、Createdは常に表示（非表示不可）
- **オプション列**: カスタムフィールドを個別に表示/非表示設定
- **画面最適化**: 必要な情報のみを表示して画面スペースを効率的に活用
**使用のヒント**：
```
モニタリング用: ID、Created、Messageのみ表示
分析用: すべてのカスタムフィールドを表示
レビュー用: Message、Category、Priorityを表示
```
## フィードバックの確認/編集/削除
個別のフィードバックの詳細情報を確認し、必要に応じて編集または削除できます。
### フィードバック詳細表示
#### アクセス方法
フィードバックテーブルで**行をクリック**すると、右側に詳細表示パネルが開きます。
![feedback-detail](/img/feedback/3.png)
### 詳細パネル構成
詳細パネルは次のように構成されます：
#### 1. 基本情報エリア
- **フィードバックID**: 一意の識別番号
- **作成時刻**: 初回登録日時
- **更新時刻**: 最後の変更日時
- **イシュー**: タグ付けされたイシュー
#### 2. カスタムフィールドエリア
チャネルで設定したすべてのカスタムフィールドが表示されます。
### フィードバックの編集
#### 編集可能なフィールド
詳細パネルで**Edit**ボタンをクリックして編集モードに切り替えることができます。
#### 編集可能な項目
| 項目 | 編集可能 | 注意事項 |
| ------------------------ | -------- | ---------------------------------------------------------------------- |
| **デフォルトフィールド** | ❌ 不可 | ID、作成日など |
| **カスタムフィールド** | ✅ 可能 | フィールド設定のPropertyによって異なる、StatusがInactiveの場合は不可能 |
#### 編集完了
1. 必要な情報を編集します
2. **Save**ボタンをクリックします
3. 変更内容がすぐに反映され、"Updated"時刻が更新されます
### イシューリンク管理
#### 新しいイシューの作成
1. イシュー列の**+ボタン**をクリックします
2. イシュー名を入力し、**Create**オプションをクリックします
#### 既存イシューのリンク
1. イシューセクションの**+ボタン**をクリックします
2. リンクするイシューの名前を入力します
3. ドロップダウンからリンクするイシューを選択します
#### イシューリンクの解除
1. イシューセクションの**+ボタン**をクリックします
2. 解除するイシューを選択します
### フィードバックの削除
#### 単一フィードバックの削除
1. 詳細パネル下部の**Delete Feedback**ボタンをクリックします
2. 確認ダイアログで削除を承認します
#### 複数フィードバックの削除
1. フィードバックリストで**チェックボックス**を使用して複数のフィードバックを選択します
2. 上部に表示される**Delete Selected**ボタンをクリックします
3. 一括削除を確認します
#### 削除時の注意事項
- **復元不可能**: 削除されたフィードバックは元に戻せません
- **イシューリンク解除**: リンクされたイシューはそのまま維持されますが、リンクが解除されます
- **統計への影響**: ダッシュボード統計から該当データが除外されます
---
## フィードバックのダウンロード
収集されたフィードバックデータを分析またはバックアップするために、さまざまな形式でエクスポートできます。
### ダウンロード機能へのアクセス
#### すべてのフィードバックのダウンロード
1. フィードバックリスト上部の**Export**ボタンをクリックします
#### フィルタされたフィードバックのダウンロード
1. 希望する条件でフィルタリングを適用します
2. **Export**ボタンをクリックして、現在のフィルタ条件に一致するデータのみをダウンロードします
#### 選択されたフィードバックのダウンロード
1. チェックボックスで特定のフィードバックを選択します
2. **Export Selected**ボタンをクリックします
### ダウンロード形式の選択
Exportボタンをクリックすると、ダウンロード形式を選択できます。
#### サポートされる形式
| 形式 | 拡張子 | 利点 | 推奨使用例 |
| --------- | ------- | ------------------------ | ------------------------ |
| **CSV** | `.csv` | 軽量で互換性が高い | Excel、Google Sheets分析 |
| **Excel** | `.xlsx` | 書式保持、複数シート対応 | 詳細分析、レポート作成 |
---
## 関連ドキュメント
- [チャネル管理](./03-channel-management.md) - フィードバック収集のためのチャネルとフィールド設定
- [イシュー管理](./05-issue-management.md) - フィードバックからイシューを作成・管理
- [API統合](/ja/developer-guide/api-integration) - 外部システムからフィードバックを送信する方法
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/05-issue-management.md
+314
View File
@@ -0,0 +1,314 @@
---
title: イシュー
description: ABC User Feedbackでイシューを作成、管理し、カンバン/リストビューで効率的に追跡する方法を説明します。
sidebar_position: 5
---
# イシュー
**イシュー（Issue）**は、フィードバックで発見された問題点や改善点を体系的に管理するためのコア機能です。イシューの作成からカテゴリ管理、さまざまなビューモードの活用まで、イシュー管理のすべての機能を説明します。
![issue](/img/issue/1.png)
---
## イシューの概要
### イシューの役割
イシューは次の目的で使用されます：
- **問題の追跡**: バグ、エラー、パフォーマンス問題などを体系的に管理
- **機能リクエスト管理**: ユーザーリクエストを構造化して開発計画に反映
- **改善点の導出**: フィードバック分析による改善ポイントの特定
### イシューステータス
各イシューは次のステータスを持ちます：
| ステータス | 説明 | 使用タイミング |
| --------------- | ---------- | ---------------------- |
| **New** | 新規登録 | イシュー初回作成 |
| **On Review** | レビュー中 | 担当者がレビュー開始 |
| **In Progress** | 処理中 | 実際の作業進行中 |
| **Resolved** | 解決完了 | 問題解決および完了 |
| **On Hold** | 一時保留 | 追加情報待ちまたは延期 |
---
## イシューの作成/編集/削除
### イシュー作成方法
イシューは2つの方法で作成できます。
#### 1. フィードバックからイシュー作成（推奨）
最も一般的な方法で、特定のフィードバックに基づいてイシューを作成します。
1. **Feedback**タブでフィードバックをクリックして詳細表示を開きます
2. 右側の詳細パネルの**Issue**セクションで**`+`ボタン**をクリックします
3. イシュー名を入力し、**Enter**キーを押すか**Create**オプションをクリックします
#### 2. イシューリストから直接作成
1. 上部メニューで**Issue**タブをクリックします
2. 左上の**+ Create Issue**ボタンをクリックします
3. イシュー作成ダイアログで情報を入力します：
| 項目 | 説明 | 必須 | 例 |
| --------------- | --------------------------------- | ---------- | ------------------------ |
| **Title** | イシュータイトル | 必須 | `ログインボタンの誤動作` |
| **Description** | 詳細説明 | オプション | `特定のブラウザで発生` |
| **Category** | イシュー分類 | オプション | `バグ` |
| **Status** | 初期ステータス（デフォルト: New） | オプション | `New` |
### イシューの編集
作成されたイシューの情報を変更できます。
#### 編集方法
1. イシューリストで編集したいイシューをクリックします
2. 右側に開く**Issue Details**パネルで**Edit**ボタンをクリックします
3. 編集モードで次の項目を変更できます：
#### 編集可能な項目
| 項目 | 編集可能 | 説明 |
| --------------- | -------- | -------------------------------------- |
| **Title** | ✅ 可能 | イシュータイトル |
| **Description** | ✅ 可能 | 詳細説明 |
| **Category** | ✅ 可能 | イシュー分類（ドロップダウンから選択） |
| **Status** | ✅ 可能 | 現在の進行状況 |
| **Ticket** | ✅ 可能 | 外部イシュートラッカーチケット番号 |
| **ID** | ❌ 不可 | システム自動生成 |
| **Created** | ❌ 不可 | 作成日時 |
#### 保存とキャンセル
- **Save**ボタン: 変更を保存して編集モードを終了します
- **Cancel**ボタン: 変更をキャンセルして元の状態に戻します
### 外部イシュートラッカー統合
外部イシュートラッカー（Jiraなど）との統合が設定されている場合、イシューに外部チケットをリンクできます。
#### チケットリンク方法
1. イシュー詳細パネルの**Ticket**フィールドに外部チケット番号を入力します
2. 入力された番号は自動的に外部システムリンクに変換されます
> **参考**: 外部イシュートラッカー統合は**Settings > Issue Tracker Management**で事前設定が必要です。
### イシューの削除
不要になったイシューを削除できます。
#### 削除方法
1. イシュー詳細パネルで**Delete**ボタンをクリックします
2. 確認ダイアログで削除を承認します
#### 削除時の注意事項
- **復元不可能**: 削除されたイシューは元に戻せません
- **フィードバックリンク解除**: リンクされたフィードバックのイシューリンクが削除されます
- **統計への影響**: ダッシュボードイシュー統計から該当データが除外されます
---
## カンバンビュー
カンバンビューは、イシューをステータス別の列に分けて視覚的に管理できるビュー方式です。
![issue-kanban](/img/issue/2.png)
### カンバンビューへのアクセス
1. 上部メニューで**Issue**タブをクリックします
2. 右上で**Kanban**ビューを選択します
### カンバンボード構成
各ステータス別に列が構成され、イシューがカード形式で表示されます。
#### カンバン列構成
| 列 | 表示情報 | カード数表示 |
| --------------- | ---------------------- | ------------ |
| **New** | 新規登録されたイシュー | 上部に数字 |
| **On Review** | レビュー中のイシュー | 上部に数字 |
| **In Progress** | 進行中のイシュー | 上部に数字 |
| **Resolved** | 解決完了したイシュー | 上部に数字 |
| **On Hold** | 保留されたイシュー | 上部に数字 |
#### イシューカード情報
各イシューカードには次の情報が表示されます：
- **イシュータイトル**: クリックで詳細表示に移動
- **フィードバック数**: リンクされたフィードバック数（📝アイコンとともに）
- **カテゴリ**: 設定されている場合は下部に表示
- **外部チケット**: リンクされている場合はチケット番号を表示
### ドラッグアンドドロップによるステータス変更
カンバンビューのコア機能で、イシューカードをドラッグして別の列に移動させてステータスを変更できます。
#### 使用方法
1. イシューカードをマウスでクリックしてドラッグします
2. 希望するステータス列の上に移動させます
3. マウスを離すとステータスが自動的に変更されます
### カンバンビューフィルタリング
上部のフィルタ機能を使用して、特定条件のイシューのみを表示できます。
#### 使用可能なフィルタ
1. **Date**フィルタ: 特定期間に作成されたイシューのみを表示
2. **Filter**ボタン: 高度なフィルタ条件設定
#### フィルタ条件例
| フィルタタイプ | 条件例 | 使用例 |
| -------------- | ------------------------- | -------------------------------- |
| **Category** | Category = "バグ" | バグイシューのみ確認 |
| **Title** | Title contains "ログイン" | ログイン関連イシュー検索 |
| **Created** | Created >= 2024-03-01 | 特定日付以降に作成されたイシュー |
| **Status** | Status != "Resolved" | 未解決イシューのみ表示 |
### カンバンビューソート
各列内でイシューカードのソート順序を変更できます。
#### ソートオプション
- **Created Date ↓**: 最新作成順
- **Created Date ↑**: 古い順
- **Feedback Count ↓**: リンクされたフィードバック数が多い順
---
## リストビュー
リストビューは、イシューをカテゴリ別にグループ化してテーブル形式で表示するビュー方式です。
### リストビューへのアクセス
1. 上部メニューで**Issue**タブをクリックします
2. 右上で**List**ビューを選択します
### リストビュー構成
カテゴリ別にグループ化されたイシューが階層的に表示されます。
#### カテゴリグループ
各カテゴリは折りたたみ/展開可能なグループとして表示されます：
- **グループヘッダー**: カテゴリ名と含まれるイシュー数
- **折りたたみ/展開矢印**: グループ内容の表示/非表示を切り替え
- **"No Category"**: カテゴリが指定されていないイシュー
### リストビューフィルタリング
カンバンビューと同じフィルタ機能を提供します。
#### フィルタ適用方法
1. 上部の**Date**または**Filter**ボタンをクリックします
2. 希望する条件を設定します
3. フィルタリングされた結果がカテゴリ別にグループ化されて表示されます
#### 空のカテゴリ処理
フィルタリング結果にイシューがないカテゴリは自動的に非表示になります。
### リストビューソート
各列ヘッダーをクリックしてソートできます。
#### ソート動作
- **最初のクリック**: 昇順ソート ↑
- **2回目のクリック**: 降順ソート ↓
#### 各ソート内容
| ソート基準 | 使用例 |
| -------------------- | -------------------------------- |
| **Created ↓** | 最新イシューから確認 |
| **Feedback Count ↓** | 影響度が大きいイシュー優先処理 |
| **Status** | ステータス別にグループ化して確認 |
---
## イシューカテゴリ
イシューカテゴリは、イシューを分類して体系的に管理できるようにする機能です。
### カテゴリの目的
- **イシュー分類**: バグ、機能リクエスト、改善事項などに区分
- **分析の容易性**: カテゴリ別のイシュー発生パターン分析
### デフォルトカテゴリ例
一般的に使用されるカテゴリ分類：
| カテゴリ | 説明 | 優先度 | 担当チーム例 |
| ------------------ | ---------------------------- | ------ | -------------- |
| **バグ** | 機能誤動作、エラー | 高 | 開発チーム |
| **機能リクエスト** | 新機能追加リクエスト | 中 | 企画チーム |
| **改善事項** | 既存機能向上 | 中 | UXチーム |
| **パフォーマンス** | 速度、安定性問題 | 高 | インフラチーム |
| **UI/UX** | ユーザーインターフェース問題 | 低 | デザインチーム |
| **ドキュメント** | ヘルプ、ガイド関連 | 低 | 技術文書チーム |
### カテゴリ管理
#### カテゴリの追加
イシュー詳細パネルで新しいカテゴリを追加できます：
1. イシュー詳細パネルの**Category**フィールドで**Add**ボタンをクリックします
2. 新しいカテゴリ名を入力します
3. **Enter**キーを押すか確認ボタンをクリックします
#### カテゴリの割り当て
既存のイシューにカテゴリを割り当てたり変更したりできます：
1. イシュー詳細パネルで**Edit**ボタンをクリックします
2. **Category**ドロップダウンから希望するカテゴリを選択します
3. **Save**ボタンで変更を保存します
### カテゴリ別イシュー管理
#### リストビューでカテゴリ別確認
リストビューでは、カテゴリ別にグループ化されたイシューを一目で確認できます：
- **カテゴリ別イシュー数**: 各グループヘッダーに含まれるイシュー数を表示
- **グループ折りたたみ/展開**: 必要なカテゴリのみを選択的に確認
- **"No Category"グループ**: 未分類イシューの別管理
#### カテゴリ別フィルタリング
特定カテゴリのイシューのみを確認したい場合：
1. **Filter**ボタンをクリックします
2. **Category**条件を追加します
3. 希望するカテゴリを選択します
---
## 関連ドキュメント
- [フィードバック管理](./04-feedback-management.md) - フィードバックからイシューを作成・リンクする方法
- [イシュートラッカー統合](/ja/user-guide/settings/issue-tracker-management) - 外部ツールとの統合設定
- [プロジェクト管理](./02-project-management.md) - チーム構成と権限管理
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/01-tenant-settings.md
+236
View File
@@ -0,0 +1,236 @@
---
title: テナント設定
description: ABC User Feedbackのテナント情報、ログイン方式、ユーザー管理など、組織全体に影響を与える設定を管理する方法を案内します。
sidebar_position: 1
---
# テナント設定
テナント設定はABC User Feedbackの最上位管理機能で、組織全体に影響を与える重要な設定を扱います。このドキュメントでは、テナント情報管理、ログイン方式設定、全ユーザー管理方法を説明します。
> **注意**: これらの設定は**Super Admin権限**を持つユーザーのみがアクセスできます。
---
## テナント設定
テナントは組織の最上位単位で、すべてのプロジェクトとユーザーが含まれる範囲です。
### アクセス方法
1. 右上メニューで**Home**アイコンをクリックします
2. 左メニューから**Tenant Information**を選択します
### 編集可能な項目
| 項目 | 説明 | 編集可能 | 例 |
| --------------- | ------------------------------------- | -------- | ----------------------- |
| **ID** | テナント固有識別子（システム自動生成） | ❌ 不可 | `1` |
| **Name** | テナント名（組織名、会社名など） | ✅ 可能 | `ABC Company` |
| **Description** | テナント説明（オプション） | ✅ 可能 | `顧客フィードバック管理システム` |
### 情報編集方法
1. **Name**または**Description**フィールドを編集します
2. 右上の**Save**ボタンをクリックします
3. 保存完了時に成功メッセージが表示されます
> テナント名はログインUIに表示される場合があります。
---
## ログイン設定
ユーザーがシステムにアクセスする際に使用する認証方式を設定します。
### アクセス方法
1. 右上メニューで**Home**アイコンをクリックします
2. 左メニューから**Login Management**を選択します
### サポートされるログイン方式
#### 1. メールログイン
デフォルトで提供されるメール+パスワードの組み合わせ方式です。
**特徴**：
- 追加設定なしでデフォルト有効化
- ユーザー招待 → メール認証 → パスワード設定の順序
- パスワードリセット機能提供
**パスワードポリシー**：
- 最低8文字以上
- 英字、数字、特殊文字を含むことを推奨
- 連続文字禁止（例：`aa`、`11`）
#### 2. Googleログイン
Google OAuth 2.0によるソーシャルログイン方式です。
**設定方法**：
1. **Googleログイン有効化**: トグルをONに切り替えます
2. **Google Cloud Console設定が必要です**：
> **参考**: Google OAuth統合の詳細な実装方法については、[OAuth統合ガイド](/ja/developer-guide/oauth-integration)を参照してください。
#### 3. カスタムOAuthログイン
独自のOAuthサーバーや他のOAuthプロバイダーを使用する方式です。
**設定項目**：
| 項目 | 説明 | 例 |
| ----------------- | ----------------------------- | ---------------------------------------- |
| **Provider Name** | ログインボタンに表示される名前 | `Microsoftでログイン` |
| **Client ID** | OAuthクライアントID | `abc123xyz` |
| **Client Secret** | OAuthクライアントシークレット | `supersecret` |
| **Auth URL** | 認証リクエストURL | `https://auth.example.com/oauth2/auth` |
| **Token URL** | トークンリクエストURL | `https://auth.example.com/oauth2/token` |
| **User Info URL** | ユーザー情報リクエストURL | `https://auth.example.com/oauth2/userinfo` |
| **Scope** | リクエストする権限範囲 | `openid email profile` |
| **Email Key** | ユーザー情報のメールフィールド名 | `email` |
**設定順序**：
1. 各フィールドにOAuthサーバー情報を入力します
2. **Save**ボタンをクリックして保存します
3. ログイン画面で設定されたProvider Nameでボタンが表示されます
### ログイン方式の組み合わせ
複数のログイン方式を同時に有効化できます：
- **メールのみ**: デフォルトログインフォームのみ表示
- **メール+Google**: ログインフォーム+「Googleでログイン」ボタン
- **メール+カスタム**: ログインフォーム+カスタムOAuthボタン
### ログイン設定のテスト
設定変更後、必ずテストを実施してください：
1. ブラウザのシークレットモードでログインページにアクセス
2. 設定したログイン方式が正常に表示されるか確認
3. 各方式で実際のログインテストを実行
---
## ユーザー管理
テナント全体のユーザーを中央で統合管理する機能です。
### アクセス方法
1. 右上メニューで**Home**アイコンをクリックします
2. 左メニューから**User Management**を選択します
### ユーザーリストの確認
#### 表示される情報
| 列 | 説明 | 表示例 |
| ---------- | ------------------------- | ---------------------- |
| Email | ログインアカウントメールアドレス | `user@company.com` |
| Name | ユーザー名（プロフィール基準） | `山田太郎` |
| Department | 所属部門 | `開発チーム` |
| Type | ユーザータイプ | `SUPER` / `GENERAL` |
| Project | アクセス可能なプロジェクトリスト | `プロジェクトA、プロジェクトB` |
| Created | アカウント作成日時 | `2024-03-15 14:30` |
#### ユーザータイプの説明
| タイプ | 説明 | 権限範囲 |
| --------- | -------------------------------------------------------- | --------------- |
| `SUPER` | すべてのプロジェクトと設定にアクセス可能。全体システム管理者の役割 | テナント全体 |
| `GENERAL` | 指定されたプロジェクトにのみアクセス可能 | 特定のプロジェクトのみ |
### ユーザー検索とフィルタリング
大量のユーザーがいる場合、希望するユーザーを素早く見つけることができます。
#### フィルタ機能
上部の**Filter**ボタンをクリックして条件を設定します。
**フィルタ条件**：
- **Email**: メールアドレスで検索
- **Name**: ユーザー名で検索
- **Department**: 部門名で検索
**演算子オプション**：
- **CONTAINS**: 含む場合
- **IS**: 完全一致する場合
### ユーザーの招待
新しいユーザーをシステムに招待します。
#### 招待方法
1. 右上の**Invite User**ボタンをクリックします
2. 招待情報を入力します
| 項目 | 説明 | オプション |
| ----------- | --------------------------- | ----------------------------- |
| **Email** | 招待するユーザーのメールアドレス | 必須入力 |
| **Type** | ユーザータイプ | `GENERAL` / `SUPER` |
| **Project** | アクセスを許可するプロジェクト | プロジェクトリストから選択 |
| **Role** | そのプロジェクトでの役割 | `Admin` / `Editor` / `Viewer` |
3. **Invite**ボタンをクリックして招待を完了します
#### 招待後のプロセス
1. 招待されたユーザーにメールが送信されます
2. ユーザーがメールのリンクをクリックして登録手続きを進めます
3. 登録完了後、指定されたプロジェクトに自動的に追加されます
### ユーザー情報の編集
既存のユーザーの情報と権限を変更できます。
#### 編集方法
1. ユーザーリストで編集したいユーザーをクリックします
2. **Edit User**ポップアップが開きます
#### 編集可能な項目
| 項目 | 編集可能 | 説明 |
| --------- | -------- | ------------------------------ |
| **Email** | ❌ 不可 | アカウント識別子として変更不可 |
| **Type** | ✅ 可能 | `GENERAL` ↔ `SUPER`変更可能 |
#### 保存と適用
1. 必要な情報を編集します
2. **Save**ボタンをクリックします
3. 変更は即座に適用され、該当ユーザーの次回ログインから反映されます
### ユーザーの削除
システムを使用しなくなったユーザーを削除できます。
#### 削除方法
1. ユーザー編集ポップアップ下部の**Delete**ボタンをクリックします
2. 確認ダイアログで削除を承認します
#### 削除時の注意事項
- **復元不可能**: 削除されたユーザーアカウントは元に戻せません
- **アクセス権限の即座削除**: 削除時、すべてのシステムアクセスが即座にブロックされます
---
## 関連ドキュメント
- [プロジェクト管理](../02-project-management.md) - プロジェクト別メンバーと権限管理
- [OAuth統合ガイド](../../02-developer-guide/03-oauth-integration.md) - OAuth設定の技術的実装方法
- [API統合](/ja/developer-guide/api-integration) - APIによるユーザー管理方法
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/02-api-key-management.md
+134
View File
@@ -0,0 +1,134 @@
---
title: APIキー設定
description: ABC User Feedbackで外部システム統合のためのAPIキーを作成、管理し、セキュリティを維持する方法を説明します。
sidebar_position: 2
---
# APIキー設定
APIキーは、外部システムがABC User Feedbackと安全に統合できるようにする認証手段です。このドキュメントでは、APIキーの作成から管理、セキュリティ維持まで、画面中心で説明します。
![api-key-setting.png](/img/api-key/api-key-setting.png)
---
## APIキーの概要
### APIキーの役割
APIキーは次の目的で使用されます：
- **外部システム認証**: ウェブサイト、モバイルアプリからフィードバック送信
- **自動化統合**: バッチジョブ、スクリプトによるデータ収集
- **サードパーティツール接続**: 分析ツール、モニタリングシステム統合
- **セキュリティ制御**: プロジェクト別の独立したアクセス権限管理
### セキュリティ特徴
- **プロジェクト別独立性**: 各プロジェクトごとに別々のキー発行
- **ステータス管理**: Active/Inactiveステータスで即座に制御可能
---
## APIキーの作成
### アクセス方法
1. 上部メニューで**Settings**をクリック
2. 左メニューから**APIキー管理**を選択
### キー作成プロセス
#### 1. 作成ボタンをクリック
APIキー管理画面で右上の**Create API Key**ボタンをクリックします。
#### 2. 自動生成と表示
ボタンをクリックするとすぐに新しいAPIキーが自動生成され、ポップアップで表示されます。
**ポップアップ構成要素**：
- **APIキー値**: 完全なキー文字列を表示
- **Copyボタン**: クリップボードに即座にコピー
---
## APIキーリスト管理
### キーリスト画面構成
作成されたAPIキーはテーブル形式で管理されます。
#### テーブル列情報
| 列 | 説明 | 表示形式 |
| ----------- | ---------------------- | -------------------------- |
| **APIキー** | 生成されたキー値 | `AbcdEfgh...` |
| **Status** | 現在の有効化ステータス | Active / Inactive |
| **Created** | キー作成日時 | `2024-03-15 14:30` |
| **Actions** | 管理アクションボタン | ステータス変更、削除ボタン |
#### キー識別方法
完全なキー値を再度確認できないため、次の方法でキーを区別します：
- **作成時刻**: いつ作成されたキーか確認
- **使用目的メモ**: 別途キーの用途を記録しておく
---
## APIキーステータス管理
![api-key-detail.png](/img/api-key/api-key-detail.png)
### Active / Inactiveの切り替え
各APIキーは即座に有効化/無効化できます。
#### ステータス別の意味
| ステータス | 説明 | API呼び出し結果 |
| ------------ | --------------------------- | ---------------- |
| **Active** | 実際のAPI呼び出しに使用可能 | 正常処理 |
| **Inactive** | 呼び出しブロック状態 | 401 Unauthorized |
#### ステータス変更方法
1. APIキーリストで**Status**列のトグルスイッチをクリックします
2. ステータスが即座に変更され、画面に反映されます
3. そのキーを使用する外部システムで即座に影響を受けます
---
## APIキーの削除
### 削除タイミング
次の場合、APIキーを削除する必要があります：
- **キー公開**: 誤ってキーが公開された場合
- **プロジェクト終了**: 該当プロジェクトの使用終了
- **セキュリティポリシー**: 定期的なキー交換ポリシーに従って
- **未使用キー**: 使用しなくなったキーの整理
### 削除方法
#### 1. 削除ボタンをクリック
キーリストで削除したいキーの**Actions**列の削除ボタンをクリックします。
#### 2. 削除確認
確認ダイアログで削除を最終承認します。
#### 3. 削除完了
**Delete**ボタンをクリックすると、キーが即座に削除され、リストから削除されます。
---
## 関連ドキュメント
- [API統合ガイド](/ja/developer-guide/api-integration) - APIキーを使用した実際の統合実装方法
- [プロジェクト管理](/ja/user-guide/project-management) - プロジェクト別APIキー管理
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/03-issue-tracker-management.md
+167
View File
@@ -0,0 +1,167 @@
---
title: イシュートラッカー設定
description: ABC User Feedbackで外部イシュートラッカー（Jiraなど）と統合してイシューを追跡し、リンクする方法を案内します。
sidebar_position: 3
---
# イシュートラッカー設定
イシュートラッカー設定により、ABC User Feedbackのイシューを外部イシュー管理システム（Jiraなど）と統合できます。内部イシューに外部チケットリンクを接続して、開発ワークフローと自然に統合できます。
---
## イシュートラッカーの概要
### 統合の目的
イシュートラッカー統合は次の目的で使用されます：
- **ワークフロー統合**: 顧客フィードバックと開発作業の接続
- **イシュー追跡**: 内部イシューと外部チケットの1対1マッピング
- **進行状況共有**: 開発チームとカスタマーサポートチーム間の情報同期
- **効率性向上**: 重複作業の防止とコンテキストの維持
### 統合方式
- **手動リンク接続**: ABCイシューに外部チケット番号を手動で入力
- **URL自動生成**: 設定されたBase URLとProject Keyで自動リンク生成
- **クリック移動**: 生成されたリンクをクリックして外部システムにすぐに移動
> **参考**: リアルタイム双方向同期はサポートしていません。ステータス変更などの同期が必要な場合は、[Webhook](./04-webhook-management.md)を活用してください。
---
## 設定画面へのアクセス
### アクセス方法
1. 上部メニューで**Settings**をクリック
2. 左メニューから**イシュートラッカー管理**を選択
### 設定画面構成
イシュートラッカー管理画面は次のように構成されます：
- **Issue Tracking System**: 統合するシステムを選択するドロップダウン
- **Connection Settings**: 接続情報入力エリア
- **Link Preview**: 生成されるリンクのプレビュー
- **Test Connection**: 接続テストボタン
---
## Jira統合設定
### システム選択
#### 1. Issue Tracking System設定
ドロップダウンから**Jira**を選択します。
### 接続情報入力
#### 2. Base URL設定
Jiraシステムの基本アドレスを入力します。
| 入力例 | 説明 |
| ----------------------------------- | ----------------------- |
| `https://yourcompany.atlassian.net` | Jira Cloudインスタンス |
| `https://jira.company.com` | セルフホスティングJira Server |
| `https://jira.internal:8080` | 内部ネットワークJira |
**注意事項**：
- `https://`または`http://`プロトコルを含める必要があります
- 最後のスラッシュ（`/`）を削除
- ポート番号がある場合は含める
#### 3. Project Key設定
Jiraプロジェクトの固有キーを入力します。
| 入力例 | 説明 |
| --------- | -------------------- |
| `PROJ` | 一般的なプロジェクトキー |
| `DEV` | 開発チームプロジェクト |
| `CS` | カスタマーサポートチームプロジェクト |
| `BUG` | バグ管理専用 |
**Project Key確認方法**：
1. Jiraで該当プロジェクトにアクセス
2. イシュー番号の`-`の前の部分がProject Key
3. 例：`PROJ-123`で`PROJ`がProject Key
### リンクプレビュー
設定した情報に基づいて生成されるリンクをプレビューできます。
#### プレビュー構成
```
Base URL + /browse/ + Project Key + - + Issue Number
```
**例**：
- Base URL: `https://yourcompany.atlassian.net`
- Project Key: `PROJ`
- Issue Number: `123`（ユーザーが入力）
- **生成されたリンク**: `https://yourcompany.atlassian.net/browse/PROJ-123`
#### リンク形式検証
プレビューで次を確認してください：
- URL形式が正しいか
- 実際のJiraイシューにアクセス可能か
- チームメンバーがアクセス権限を持っているか
---
## イシューでのチケット接続
### チケット番号入力
イシュートラッカー設定が完了すると、個別のイシューで外部チケットを接続できます。
#### 接続方法
1. **Issue**タブで希望するイシューをクリックします
2. 右側の**Issue Details**パネルが開きます
3. **Ticket**フィールドに外部チケット番号を入力します
#### 入力形式
| 入力方式 | 説明 | 生成されるリンク |
| --------- | ----------- | ------------------------------------------ |
| `123` | 数字のみ入力 | `https://jira.company.com/browse/PROJ-123` |
システムが自動的にProject Keyを追加するため、数字のみ入力すれば十分です。
### リンク自動生成
チケット番号入力後、**Save**ボタンをクリックするとリンクが自動生成されます。
#### リンク機能
- **クリック移動**: リンクをクリックすると新しいタブで外部Jiraイシューに移動
- **外部リンク表示**: リンクの横に外部リンクアイコンを表示
- **編集可能**: Editモードでチケット番号を変更可能
### 接続解除
外部チケット接続を削除するには：
1. イシュー詳細パネルで**Edit**ボタンをクリック
2. **Ticket**フィールドの内容を削除
3. **Save**ボタンで変更を保存
---
## 関連ドキュメント
- [イシュー管理](/ja/user-guide/issue-management) - イシュー作成とチケット接続の使用方法
- [Webhook管理](/ja/user-guide/settings/webhook-management) - イシューステータス変更時の外部システム通知
- [API統合ガイド](/ja/developer-guide/api-integration) - APIによるイシュー管理
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/04-webhook-management.md
+170
View File
@@ -0,0 +1,170 @@
---
sidebar_position: 4
title: 'ウェブフック設定'
description: '外部システムと自動統合するためにウェブフックを設定し、イベント発生時に通知を送信する方法を説明します。'
---
# ウェブフック設定
ウェブフックは、ABC User Feedbackで**特定のイベント発生時に外部システムに自動通知**を送信する機能です。フィードバック作成、イシューステータス変更などのイベントをリアルタイムで外部サービス（Slack、Discord、独自サーバーなど）に配信できます。詳細な統合ガイドについては、[ウェブフック統合](/ja/developer-guide/webhook-integration)ドキュメントを参照してください。
![webhook-setting](/img/webhook/webhook-setting.png)
---
## アクセス方法
1. 上部メニューで**Settings**をクリック
2. 左メニューから**Webhook Integration**を選択
---
## Webhook Integration画面の概要
![webhook-list.png](/img/webhook/webhook-list.png)
ウェブフック統合画面は次のように構成されます：
### ウェブフックリストテーブル構成
| 列 | 説明 |
| ----------------- | --------------------------------------- |
| **On/Off** | ウェブフック有効化/無効化トグルスイッチ |
| **Name** | ウェブフック名 |
| **URL** | 通知を受信する外部エンドポイント |
| **Event Trigger** | 購読中のイベントトリガー |
| **Created** | ウェブフック作成日時 |
---
## 新しいウェブフックの作成
### 1. ウェブフック登録開始
右上の**Register Webhook**ボタンをクリックすると、ウェブフック登録モーダルが開きます。
### 2. 基本情報入力
#### 必須入力項目
| 項目 | 説明 |
| -------- | ------------------------------------------- |
| **Name** | ウェブフック識別のための名前 |
| **URL** | HTTP POSTリクエストを受信するエンドポイント |
### 3. トークン設定（オプション）
**Token**フィールドで認証用のトークンを設定できます：
- **Generate**ボタンをクリックして自動生成
- または直接トークン値を入力
### 4. Event Trigger選択
購読するイベントをチャネル別に選択できます：
#### サポートされるイベントタイプ
各チャネル（VOC、Review、Survey、VOC Test）について、次のイベントを選択できます：
| イベントタイプ | 説明 |
| ----------------------- | ------------------------------------------ |
| **Feedback Creation** | 新しいフィードバックが登録されたとき |
| **Issue Registration** | 新しいイシューが作成されたとき |
| **Issue Status Change** | イシューステータスが変更されたとき |
| **Issue Creation** | イシューがフィードバックにリンクされたとき |
### 5. ウェブフック保存
すべての情報を入力した後：
1. **OK**ボタンをクリックしてウェブフックを作成
2. **Cancel**ボタンでキャンセル可能
---
## ウェブフックステータス管理
### 有効化/無効化の切り替え
ウェブフックリストで各ウェブフックの**On/Off**列にあるトグルスイッチをクリックしてステータスを変更できます：
- **On（有効化）**: イベント発生時にリアルタイム送信
- **Off（無効化）**: ウェブフックは維持されますが送信は停止
### 一時無効化シナリオ
- 外部サーバーがメンテナンス中の場合
- ウェブフックURL変更作業中の場合
- スパム通知を防ぐ必要がある場合
---
## ウェブフック編集と削除
### ウェブフック編集
ウェブフックリストで編集したいウェブフックをクリックすると編集モーダルが開きます：
#### 編集可能な項目
- ウェブフック名
- Target URL変更
- トークン値修正
- イベントタイプ追加/削除
### ウェブフック削除
ウェブフックを完全に削除するには：
1. 編集モーダルで削除オプションを選択
2. またはリストから直接削除ボタンをクリック（UIに削除ボタンがある場合）
---
## ウェブフックテストと検証
### 手動検証方法
1. **フィードバック作成テスト**：
- テストフィードバックを登録して`Feedback Creation`イベントを確認
2. **イシュー管理テスト**：
- イシューを作成またはステータスを変更して関連イベントを確認
3. **外部サービス確認**：
- Slack、Discordなどでメッセージ受信を確認
---
## 一般的な統合例
### Slackウェブフック設定
```
Name: Slack通知
URL: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXX
Events: Feedback Creation, Issue Registration（すべてのチャネル）
```
### Discordウェブフック設定
```
Name: Discord開発チーム通知
URL: https://discord.com/api/webhooks/123456789/abcdefghijk
Events: Issue Status Change（VOCチャネルのみ）
```
### カスタムサーバー統合
```
Name: 内部分析システム
URL: https://api.yourcompany.com/webhooks/feedback
Token: your-generated-token
Events: すべてのイベント（すべてのチャネル）
```
---
## 関連ドキュメント
- [Webhook開発者ガイド](/ja/developer-guide/webhook-integration) - ウェブフック受信サーバーの実装方法
- [APIキー管理](./02-api-key-management.md) - APIキーベース認証設定
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/05-ai-setting.md
+272
View File
@@ -0,0 +1,272 @@
---
sidebar_position: 5
title: 'AI設定'
description: '生成AI機能を使用するための基本設定と統合方法を説明します。'
---
# AI設定
ABC User Feedbackで**生成AI機能**を使用するには、まずAIプロバイダーとの統合を設定する必要があります。
AI設定を完了すると、**AIフィールドテンプレート**、**AIイシュー推奨**、**AI使用量モニタリング**などのすべての機能を活用できます。
---
## アクセス方法
1. 上部メニューで**Settings**をクリック
2. 左メニューから**Generative AI Integration**を選択
3. 上部タブで**AI Setting**をクリック
---
## AIプロバイダー選択と設定
![ai-setting.png](/img/ai/ai-setting.png)
### 1. プロバイダー選択
現在サポートされているAIプロバイダーOpenAI、Google Geminiのいずれかを選択します：
### 2. APIキー入力
選択したAIプロバイダーから発行されたAPIキーを入力します。
### 3. Base URL設定（オプション）
ほとんどの場合、**空欄にしておくとデフォルト値**が自動的に使用されます。
特別なエンドポイントやプロキシサーバーを使用する場合のみ入力してください。
### 4. System Prompt設定（オプション）
AIがすべてのリクエストを処理する際に参照する**基本指示**を設定できます。
組織のトーンアンドマナーや特別な要件がある場合に活用してください。
### 5. 設定保存
すべての情報を入力した後、右上の**Save**ボタンをクリックします。
---
## AI使用量モニタリング
![ai-usage.png](/img/ai/ai-usage.png)
**AI Usage**タブでAI機能の使用量とコストをモニタリングできます。
### 使用量ダッシュボード
確認できる情報：
- **日次/月次API呼び出し数**
- **トークン使用量**（入力/出力別）
- **機能別使用分布**（AIフィールド vs イシュー推奨）
---
## AIフィールドテンプレート管理
![ai-field-template.png](/img/ai/ai-field-template.png)
AI設定を完了した後、**AI Field Template**タブでフィードバック自動分析テンプレートを管理できます。
### デフォルトテンプレート
システムで提供されるデフォルトテンプレート：
| テンプレート | 説明 | 活用例 |
| ---------------------- | ---------------------------------------------- | ------------------------------ |
| **Feedback Summary** | フィードバックを1文で要約 | 長いフィードバックの核心を把握 |
| **Sentiment Analysis** | 感情分析（ポジティブ/ネガティブ/ニュートラル） | 顧客満足度トレンド分析 |
| **Translation** | フィードバックを英語に翻訳 | 多言語フィードバック統合分析 |
| **Keyword Extraction** | 核心キーワード2-3個抽出 | イシューカテゴリ自動タグ付け |
### カスタムテンプレート作成
![ai-field-template-create.png](/img/ai/ai-field-template-create.png)
1. **Create New**カードをクリック
2. テンプレート情報を入力
| 項目 | 説明 |
| --------------- | --------------------- |
| **Title** | テンプレート名 |
| **Prompt** | AIに与える指示文 |
| **Model** | 使用するAIモデル選択 |
| **Temperature** | 創造性調整（0.0~1.0） |
3. Playgroundでテスト
- "Add Data"ボタンでテストフィードバック入力
- "AI test execution"クリックで結果確認
### テンプレート編集と削除
- テンプレートカードクリック → 編集
- **Delete Template**ボタンで削除
- 削除時、そのテンプレートを使用するAIフィールドに影響を与える可能性があります
---
## AIフィールドをチャネルに適用
AIフィールドテンプレートを作成した後、実際のチャネルのフィールドとして適用する必要があります。フィードバックでAI分析結果を確認できます。
### 1. Field ManagementでAIフィールド追加
**Settings > Channel List > [チャネル選択] > Field Management**でAIフィールドを追加します。
#### AIフィールド設定項目
| 項目 | 説明 | 必須 |
| ----------------------- | ------------------------------------ | ---------- |
| **Key** | フィールド固有識別子 | 必須 |
| **Display Name** | UIに表示される名前 | 必須 |
| **Format** | `aiField`選択 | 必須 |
| **Template** | 作成したAIフィールドテンプレート選択 | 必須 |
| **Target Field** | 分析対象となるテキストフィールド | 必須 |
| **Property** | EditableまたはRead Only | 必須 |
| **AI Field Automation** | 自動実行有無 | オプション |
#### 設定例
```
Key: sentiment_analysis
Display Name: 感情分析
Format: aiField
Template: Feedback Sentiment Analysis
Target Field: message
Property: Read Only
AI Field Automation: ON（自動実行）
```
### 2. Template接続とTarget Field設定
**Template**ドロップダウンから以前に作成したAIフィールドテンプレートを選択します。
**Target Field**はAI分析の対象となるフィールドを指定します
### 3. AI Field Automation設定
**AI Field Automation**トグルを通じて実行方式を選択します：
- **ON（自動実行）**: 新しいフィードバック登録時に自動的にAI分析実行
- **OFF（手動実行）**: ユーザーが手動で実行ボタンをクリックする必要があります
## フィードバックでAI分析結果確認
AIフィールド設定が完了すると、フィードバックリストと詳細画面でAI分析結果を確認できます。
### フィードバックリストで確認
フィードバックテーブルにAIフィールドが新しい列として追加されます：
- **Summary**: AIが生成した要約
- **Classification**: AI分類結果
- **Korean**: 翻訳結果など
### フィードバック詳細画面で確認
フィードバック詳細表示パネルでより詳細なAI分析結果を確認できます：
1. フィードバック行をクリック → 右側詳細パネルが開きます
2. AIフィールド別の分析結果を確認
3. 各AIフィールドごとに分析結果とともに表示
## AI分析手動実行
フィードバック詳細画面で手動でAI分析を実行できます。
### Run AIボタン使用
1. フィードバック詳細画面で**Run AI**ボタンをクリック
2. AI分析が実行され、結果がそのフィールドに自動入力されます
3. 分析完了後、結果をすぐに確認可能
### 手動実行活用シナリオ
- **コスト節約**: 必要なフィードバックのみを選択してAI分析
- **パフォーマンス確認**: 新しいテンプレートの結果を事前にテスト
- **再分析**: テンプレート修正後、既存フィードバックを再分析
---
## AIイシュー推奨設定
**AI Issue Recommendation**タブでフィードバックベースの自動イシュー推奨機能を設定できます。
![ai-issue-recommendation.png](/img/ai/ai-issue-recommendation.png)
### 推奨設定作成
![ai-issue-recommendation-create.png](/img/ai/ai-issue-recommendation-create.png)
1. **Create New**ボタンをクリック
2. 設定項目を入力
| 項目 | 説明 | 必須 |
| ---------------- | --------------------------------- | ---------- |
| **Channel** | 適用するチャネル選択 | 必須 |
| **Target Field** | 分析対象フィールド（例：message） | 必須 |
| **Prompt** | 推奨基準プロンプト | オプション |
| **Enable** | 機能有効化トグル | 必須 |
3. 高度な設定
| 設定 | 説明 |
| ------------------------- | -------------------------------------------------- |
| **Model** | 使用モデル |
| **Temperature** | 創造性調整 |
| **Data Reference Amount** | 参照するイシュー量（イシューと関連フィードバック） |
### 推奨機能テスト
入力された設定についてPlaygroundでテスト：
1. 例示フィードバック入力
2. "AI test execution"クリック
3. 推奨イシューリスト確認
### 実際のフィードバックで推奨活用
フィードバック詳細表示で：
- AI推奨イシューリスト確認
- チェックボックスで適切なイシュー選択
- **Retry**ボタンで別の推奨リクエスト
### フィードバックリストでイシュー推奨使用
AIイシュー推奨を設定したチャネルでは、フィードバックリスト画面でも直接イシュー推奨機能を使用できます。
#### 使用方法
1. フィードバックリストでイシューを接続したいフィードバックの**Issue列**にある**+ボタン**をクリック
2. ドロップダウンメニューが表示されたら**"Run AI"**を選択
3. AIが関連イシューを分析して推奨リストを表示
#### 推奨結果確認と適用
AI分析完了後、推奨イシューリストから：
- **推奨されたイシュー**確認
- 推奨された適切なイシュー選択
- 新しいイシュー作成オプションも提供
- 選択完了後、該当イシューがフィードバックに自動接続
#### 一括処理活用
複数のフィードバックを選択した状態でもAIイシュー推奨を使用でき、効率的なフィードバック分類が可能です：
1. フィードバックリストで複数行選択（チェックボックス活用）
2. 上部一括作業メニューでAIイシュー推奨実行
3. 各フィードバックごとに推奨イシュー確認と適用
---
## 関連ドキュメント
- [フィールド設定](/ja/user-guide/feedback-management) - AIフィールドをチャネルに適用する方法
- [イシュー作成とステータス管理](/ja/user-guide/issue-management) - AI推奨イシューの活用方法
- [フィードバック確認とフィルタリング](/ja/user-guide/feedback-management) - AI分析結果確認方法
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/06-image-setting.md
+102
View File
@@ -0,0 +1,102 @@
---
sidebar_position: 6
title: '画像設定'
description: 'フィードバックに添付された画像の保存方式とセキュリティポリシーを設定する方法を案内します。'
---
# 画像設定
ABC User Feedbackでは、ユーザーがフィードバックを提出する際に**画像と一緒にアップロード**できるようにサポートしています。画像の保存方式とセキュリティポリシーを適切に設定することで、安全で効率的なフィードバック収集環境を構築できます。
![image-setting.png](/img/image/image-setting.png)
---
## アクセス方法
1. 上部メニューで**Settings**をクリック
2. 左メニューから**Channel List > [チャネル選択]**
3. 下部タブから**Image Management**を選択
---
## Image Storage Integration設定
**Multipart Upload API**方式で画像をサーバーに直接アップロードするか、**Presigned URL Download**機能を活用するには、S3またはS3互換ストレージ統合が必要です。
### 必須設定項目
| 項目 | 説明 | 例 |
| --------------------- | ---------------------------- | ----------------------------------------- |
| **Access Key ID** | S3アクセスのためのキーID | `AKIAIOSFODNN7EXAMPLE` |
| **Secret Access Key** | キーに対するシークレット | `wJalrXUtnFEMI/K7MDENG/...` |
| **End Point** | S3 APIエンドポイントURL | `https://s3.ap-northeast-1.amazonaws.com` |
| **Region** | バケットが位置する地域 | `ap-northeast-1` |
| **Bucket Name** | 画像が保存される対象バケット | `consumer-ufb-images` |
### Presigned URL Download設定
**Presigned URL Download**オプションを通じて画像ダウンロードセキュリティを強化できます。
#### 設定オプション
- **Enable**: 認証されたワンタイムURLを通じて画像にアクセス（セキュリティ強化）
- **Disable**: 画像URLが直接公開され、公開アクセス可能
### 接続テスト
すべての設定を入力した後、**Test Connection**ボタンをクリックしてストレージ接続を確認します。
接続結果：
- ✅ **成功**: "Connection test succeeded"メッセージ
- ❌ **失敗**: 入力値、バケット権限、ネットワーク設定を再確認する必要があります
---
## Image URL Domain Whitelist設定
**Image URL方式**を使用するか、セキュリティを強化したい場合、信頼できるドメインのみを許可するようにホワイトリストを設定できます。
### 現在の状態確認
デフォルト設定は**"All image URLs are allowed"**状態で、すべてのドメインの画像URLを許可します。
### ホワイトリスト追加
セキュリティ強化のために特定のドメインのみを許可するには：
1. **Whitelist**エリアに信頼できるドメインを追加
2. 例示ドメイン：
- `cdn.yourcompany.com`
- `images.trusted-partner.io`
- `storage.googleapis.com`
---
## サポートされるストレージサービス
### AWS S3
- 最も一般的に使用されるクラウドストレージ
- 安定性が高く、拡張性に優れています
---
## 設定保存
すべての設定を完了した後、右上の**Save**ボタンをクリックして変更を保存します。
保存後：
- 新しい画像アップロードが設定した方式で動作
- 既存の画像は既存設定のまま維持
- Test Connectionで設定の正常動作を再確認することを推奨
---
## 関連ドキュメント
- [フィールド設定](/ja/user-guide/feedback-management) - 画像フィールドをフィードバックフォームに追加する方法
- [フィードバック確認とフィルタリング](/ja/user-guide/feedback-management) - アップロードされた画像をフィードバックで確認する方法
- [APIキー管理](./02-api-key-management.md) - APIキーセキュリティ管理方法
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/_category_.json
+5
View File
@@ -0,0 +1,5 @@
{
"position": 7,
"label": "設定",
"description": "設定に関するガイドです。"
}
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/07-settings/index.md
+7
View File
@@ -0,0 +1,7 @@
---
title: 設定
---
import DocCardList from '@theme/DocCardList';
<DocCardList />
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/_category_.json
+5
View File
@@ -0,0 +1,5 @@
{
"position": 2,
"label": "ユーザーガイド"
}
apps/docs/i18n/ja/docusaurus-plugin-content-docs/current/01-user-guide/index.md
+7
View File
@@ -0,0 +1,7 @@
---
title: ユーザーガイド
---
import DocCardList from '@theme/DocCardList';
<DocCardList />