Web インストーラーウォークスルー

FeedbackPulse SaaS には美しいブラウザベースのインストーラーが含まれています。初回のファイルアップロードと composer install 後は、コマンドラインは不要です。

インストーラーへのアクセス

以下に移動します：

https://yourdomain.com/install

インストーラーが表示されない場合： 以下を確認してください：

Web サーバーが public/ ディレクトリを指していること

Apache の mod_rewrite が有効（または Nginx に適切な try_files が設定されていること）

storage/installed.lock ファイルが存在しないこと（初回インストール後にインストーラーをブロックします）

ステップ 1：ようこそ & ライセンス

最初の画面でようこそメッセージが表示され、Envato/CodeCanyon の購入コードを求められます。

購入コードの確認場所：

CodeCanyon にログインします
Downloads → FeedbackPulse SaaS を見つけます
Download → License certificate and purchase code をクリックします
購入コードは次のような形式です：a1b2c3d4-e5f6-7890-abcd-ef1234567890

機能：

Envato API でライセンスを検証します
正規のコピーであることを確認します
インストーラーの残りのステップのロックを解除します

ステップ 2：要件チェック

インストーラーがサーバーを自動スキャンして以下を確認します：

PHP バージョン

PHP 8.4 以上が必要です
現在の PHP バージョンが表示されます

ベンダー依存関係

vendor/autoload.php が存在するかどうかを確認します（Composer の依存関係がインストールまたはアップロードされている必要があります）

PHP エクステンション

以下が確認されます：

pdo_mysql — データベース接続
mbstring — 文字列処理
openssl — 暗号化
tokenizer — コード解析
xml — XML 処理
ctype — 文字検証
json — JSON 処理
bcmath — 数値演算
fileinfo — ファイルタイプ検出
curl — API 呼び出し

ディレクトリパーミッション

storage/ — 書き込み可能である必要があります
bootstrap/cache/ — 書き込み可能である必要があります

結果の表示

緑のチェックマーク = 要件を満たしています
赤の X マーク = 要件を満たしていません（先に進む前に修正が必要）

失敗したチェックの修正：

# 不足している PHP エクステンションのインストール（Ubuntu）
sudo apt install php8.4-mysql php8.4-mbstring php8.4-xml php8.4-bcmath php8.4-curl php8.4-gd php8.4-zip

# パーミッションの修正
sudo chmod -R 775 storage bootstrap/cache
sudo chown -R www-data:www-data storage bootstrap/cache

# PHP を再起動
sudo systemctl restart php8.4-fpm

ステップ 3：データベースの設定

MySQL/MariaDB の接続詳細を入力します：

フィールド	例	備考
データベースホスト	`127.0.0.1`	信頼性のために `localhost` ではなく `127.0.0.1` を使用
データベースポート	`3306`	MySQL のデフォルトポート
データベース名	`feedbackpulse`	事前に作成が必要！
データベースユーザー名	`feedbackpulse_user`	データベースへの完全な権限が必要
データベースパスワード	`your_secure_password`	ユーザーのパスワード

このステップの前に

事前にデータベースを作成する必要があります：

-- MySQL にログイン
mysql -u root -p

-- データベースを作成
CREATE DATABASE feedbackpulse CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 専用ユーザーを作成（推奨）
CREATE USER 'feedbackpulse_user'@'localhost' IDENTIFIED BY 'your_secure_password';
GRANT ALL PRIVILEGES ON feedbackpulse.* TO 'feedbackpulse_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;

「Setup Database」をクリックしたときの動作

インストーラーが接続をテストします
データベース認証情報を .env ファイルに保存します
すべてのデータベースマイグレーションを実行します（約 30 のテーブルを作成）
デフォルトデータをシードします：
- 3 つのデフォルトサブスクリプションプラン（Starter、Growth、Pro）
- デフォルトのプラットフォーム設定
成功メッセージを表示します

注意： セッションとキャッシュドライバーは、安定性のためにインストール中は file のままです。完了ステップで自動的に database に切り替えられます。

このステップはサーバーによって 10〜30 秒かかる場合があります。

ステップ 4：管理者アカウント

スーパー管理者アカウントを作成します：

フィールド	例	備考
氏名	山田太郎	表示名
メールアドレス	[email protected]	ログインと通知に使用
パスワード	（強力なパスワード）	最低 8 文字。強力なパスワードを使用してください！
パスワードの確認	（一致する必要があります）	上記と一致する必要があります

動作

role = superadmin でユーザーアカウントを作成します
自動的に作成される唯一のスーパー管理者アカウントです
/login でログインして /admin/dashboard にアクセスするために使用します

セキュリティのヒント： 一意の強力なパスワードを使用してください。後で設定で 2FA を有効化できます。

ステップ 5：メールの設定

トランザクションメール送信のための SMTP を設定します：

フィールド	例	備考
SMTP ホスト	`smtp.gmail.com`	メールプロバイダーの SMTP サーバー
SMTP ポート	`587`	TLS は 587、SSL は 465
SMTP ユーザー名	`[email protected]`	通常はメールアドレス
SMTP パスワード	`your_app_password`	アプリ専用パスワードを推奨
暗号化	`tls`	TLS（推奨）または SSL
送信元アドレス	`[email protected]`	送信メールの「差出人」アドレス
送信元名	`FeedbackPulse`	送信メールの「差出人」名

主要な SMTP プロバイダー

プロバイダー	ホスト	ポート	暗号化	備考
Gmail	`smtp.gmail.com`	587	TLS	アプリパスワードが必要（通常のパスワード不可）
Mailgun	`smtp.mailgun.org`	587	TLS	トランザクションメールに最適
Amazon SES	`email-smtp.{region}.amazonaws.com`	587	TLS	大規模利用にコスト効率的
SendGrid	`smtp.sendgrid.net`	587	TLS	ユーザー名に `apikey` を使用
Postmark	`smtp.postmarkapp.com`	587	TLS	最高の配信率
Mailtrap	`sandbox.smtp.mailtrap.io`	587	TLS	テスト専用！

今すぐメールを設定できない場合： このステップをスキップして、後で Admin → Settings → Email で設定できます。メールなしでもプラットフォームは動作しますが、招待、ダイジェスト、パスワードリセットなどの機能が使えなくなります。

ステップ 6：インストール完了！

以下の内容が表示されるサクセスページが表示されます：

データベースの設定とマイグレーション完了
管理者アカウントの作成完了
メールの設定完了
installed.lock ファイルの作成完了
セッションとキャッシュドライバーを database に切り替え完了
Web ベースの cron 用に CRON_TOKEN が自動生成完了
共有ホスティング通知（シンリンクを作成できなかった場合）

Cron ジョブの設定手順（完了ページに表示）

完了ページには、コピー&ペースト可能なコマンド付きの 2 つの cron セットアップオプションが表示されます：

CLI コマンド — VPS/専用サーバー用：

* * * * * cd /path/to/project && php artisan schedule:run >> /dev/null 2>&1

URL/wget — 共有ホスティング用（自動生成された CRON_TOKEN を使用）：
```
wget -q -O /dev/null "https://yourdomain.com/cron/run?token=YOUR_CRON_TOKEN"
```

保存してください！ ページを移動する前に完了ページから cron コマンドをコピーしてください。CRON_TOKEN は .env ファイルでも確認できます。

`installed.lock` ファイルについて

インストーラーは誰もインストーラーを再実行できないように storage/installed.lock を作成します。これはセキュリティ対策です。

インストーラーを再実行するには（例：新規インストール）、このファイルを削除します：
rm storage/installed.lock
その後 /install に再度アクセスします。

インストール後チェックリスト

インストーラーが完了したら：

完了ページに表示された手順を使用して cron ジョブを設定します（Cron ジョブとキューワーカーを参照）
スーパー管理者認証情報で https://yourdomain.com/login にログインします
Admin → Plans にアクセス — サブスクリプションプランを確認・カスタマイズ
Admin → Settings → Payments にアクセス — Stripe/PayPal を接続
Admin → Settings → Email にアクセス — テストメールを送信
Admin → Landing Page にアクセス — 公開ホームページをカスタマイズ
SSL を設定します（SSL 証明書を参照）
必要に応じてワイルドカード DNS を設定します（ワイルドカード DNS セットアップを参照）

次のステップ

Apache 設定または Nginx 設定
環境変数 — .env の微調整
Cron ジョブとキューワーカー — 自動タスクの設定

インストーラーへのアクセス​

ステップ 1：ようこそ & ライセンス​

ステップ 2：要件チェック​

PHP バージョン​

ベンダー依存関係​

PHP エクステンション​

ディレクトリパーミッション​

結果の表示​

ステップ 3：データベースの設定​

このステップの前に​

「Setup Database」をクリックしたときの動作​

ステップ 4：管理者アカウント​

動作​

ステップ 5：メールの設定​

主要な SMTP プロバイダー​

ステップ 6：インストール完了！​

Cron ジョブの設定手順（完了ページに表示）​

installed.lock ファイルについて​

インストール後チェックリスト​

次のステップ​