應用 APP 功能實作

scripts/README.md

@@ -0,0 +1,80 @@
+# 測試數據插入說明
+
+## 問題修復
+
+✅ **已修復重複約束錯誤**：原來的腳本會因為同一個用戶對同一個應用重複評分而出現 `Duplicate entry` 錯誤。現在已修復為使用不同的用戶 ID。
+
+✅ **已修復 null 值錯誤**：修復了 `user_id` 不能為 null 的問題，提供了簡化版本的腳本。
+
+## 腳本版本
+
+### 版本 1：完整版本 (`insert-test-data.sql`)
+- 使用不同的用戶 ID 避免重複約束
+- 需要資料庫中有至少 10 個活躍用戶
+
+### 版本 2：簡化版本 (`insert-test-data-simple.sql`)
+- 使用單一用戶 ID，避免 null 值問題
+- 只需要資料庫中有至少 1 個活躍用戶
+- 只有 1 條評分記錄
+
+### 版本 3：多用戶版本 (`insert-test-data-multi-user.sql`) ⭐ 推薦
+- 使用 5 個不同用戶，避免重複約束
+- 需要資料庫中有至少 5 個活躍用戶
+- 包含 25 條瀏覽、8 條按讚、5 條評分記錄
+- 平衡了數據豐富度和穩定性
+
+## 方法一：使用 MySQL 命令行
+
+1. 打開命令提示符或 PowerShell
+2. 連接到 MySQL：
+   ```bash
+   mysql -u root -p
+   ```
+3. 選擇資料庫：
+   ```sql
+   USE ai_showcase_platform;
+   ```
+4. 執行 SQL 腳本（推薦使用多用戶版本）：
+   ```sql
+   source E:/ai-showcase-platform/scripts/insert-test-data-multi-user.sql
+   ```
+
+## 方法二：使用 MySQL Workbench 或其他 GUI 工具
+
+1. 打開 MySQL Workbench
+2. 連接到您的 MySQL 服務器
+3. 選擇 `ai_showcase_platform` 資料庫
+4. 打開 `scripts/insert-test-data-multi-user.sql` 文件（推薦）
+5. 執行整個腳本
+
+## 方法三：使用 phpMyAdmin
+
+1. 打開 phpMyAdmin
+2. 選擇 `ai_showcase_platform` 資料庫
+3. 點擊 "SQL" 標籤
+4. 複製 `scripts/insert-test-data-multi-user.sql` 的內容（推薦）
+5. 貼上並執行
+
+## 預期結果
+
+執行成功後，您應該看到：
+- 25 條瀏覽記錄（使用 5 個不同用戶）
+- 8 條按讚記錄（使用 5 個不同用戶）
+- 5 條評分記錄（使用 5 個不同用戶）
+- 應用統計數據更新為：25 瀏覽、8 讚、4.2 平均評分
+
+## 驗證
+
+執行完成後，您可以：
+1. 重新載入應用管理頁面
+2. 點擊任何應用的「查看詳情」
+3. 切換到「統計數據」標籤頁查看真實數據
+4. 切換到「評價管理」標籤頁查看評價列表
+
+## 注意事項
+
+- 腳本會先清空現有的測試數據，避免重複
+- **簡化版本**：使用單一用戶 ID，只有 1 條評分記錄
+- **多用戶版本**：使用 5 個不同用戶，平衡數據豐富度和穩定性 ⭐ 推薦
+- **完整版本**：使用不同用戶 ID，需要至少 10 個活躍用戶
+- 如果您的資料庫中用戶數量少於 5 個，建議使用簡化版本