star-cloud/開發.md

# Star Cloud 開發文件 (開發.md)

## 環境設定 (Environment Setup)

### 時區與語系 (Timezone & Locale)

本專案已統一使用台北時間與繁體中文，若重新建立環境或更新 `.env`，請確保以下設定：

```env
APP_LOCALE=zh_TW
APP_TIMEZONE=Asia/Taipei
```

### 資料庫 (Database)

- 資料庫儲存的時間戳記將對應 `Asia/Taipei`。
- 若有舊資料同步問題，請參考修正腳本，確保所有 `created_at`, `updated_at` 與業務時間一致。

## 開發慣例 (Development Conventions)

1. **監聽器 (Listeners)**：
   - 避免在多個 ServiceProvider 中重複註冊同一個監聽器。
   - 登入日誌實作了 **10 秒防重覆 (Debouncing)** 機制。
2. **裝置偵測**：
   - 使用 `jenssegers/agent` 套件進行裝置與瀏覽器偵測。
   - 登入紀錄應包含 `device_type`, `browser`, `platform` 等詳細資訊。