[DOC] 新增 GEMINI.md 與 開發.md 規範手冊,統一時區與開發慣例
All checks were successful
star-cloud-deploy-demo / deploy-demo (push) Successful in 49s

This commit is contained in:
2026-03-13 10:38:05 +08:00
parent 3fbb7bc286
commit 7f9f76111c
3 changed files with 51 additions and 4 deletions

26
開發.md Normal file
View File

@@ -0,0 +1,26 @@
# 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` 等詳細資訊。