---
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使用ガイド