star-cloud/開發.md

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

環境設定 (Environment Setup)

時區與語系 (Timezone & Locale)

本專案已統一使用台北時間與繁體中文，若重新建立環境或更新 .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 等詳細資訊。