From e5516193b02968ea998918ea4ea93a8f93cbba15 Mon Sep 17 00:00:00 2001 From: sky121113 Date: Fri, 13 Mar 2026 10:41:06 +0800 Subject: [PATCH] =?UTF-8?q?[CLEANUP]=20=E7=A7=BB=E9=99=A4=E6=A0=B9?= =?UTF-8?q?=E7=9B=AE=E9=8C=84=E4=B8=8B=E9=8C=AF=E8=AA=A4=E4=BD=8D=E7=BD=AE?= =?UTF-8?q?=E7=9A=84=E8=A6=8F=E7=AF=84=E6=96=87=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- GEMINI.md | 20 -------------------- 開發.md | 26 -------------------------- 2 files changed, 46 deletions(-) delete mode 100644 GEMINI.md delete mode 100644 開發.md diff --git a/GEMINI.md b/GEMINI.md deleted file mode 100644 index 1ce7cdc..0000000 --- a/GEMINI.md +++ /dev/null @@ -1,20 +0,0 @@ -# Star Cloud 開發規範 (GEMINI.md) - -## 1. 時間與時區規範 - -- **預設時區**:必須設定為 `Asia/Taipei` (UTC+8)。 -- **實作方式**: - - `.env`:必須包含 `APP_TIMEZONE=Asia/Taipei`。 - - `config/app.php`:必須使用 `env('APP_TIMEZONE', 'Asia/Taipei')` 並將其作為預設值。 -- **目的**:確保所有資料庫紀錄、日誌及使用者介面顯示的時間與台灣當地時間一致。 - -## 2. 語系規範 - -- **預設語系**:繁體中文 (`zh_TW`)。 -- **實作方式**: - - `.env`:`APP_LOCALE=zh_TW`。 - - `config/app.php`:`env('APP_LOCALE', 'zh_TW')`。 - -## 3. 專案建立規範 - -- 未來任何新專案的初始化,都必須**優先完成**上述時區與語系的設定,嚴禁使用預設的 UTC 或英文設定。 diff --git a/開發.md b/開發.md deleted file mode 100644 index 644cc96..0000000 --- a/開發.md +++ /dev/null @@ -1,26 +0,0 @@ -# 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` 等詳細資訊。