專案憲法：Laravel 學習筆記與書籤管理系統
第一部分：專案願景與範圍
1. 專案願景 (Vision)
此專案的首要目標是作為一個載體，引導開發者（您）由淺入深地、系統化地掌握 Laravel 框架。

2. 指導原則 (Guiding Principles)
學習優先 (Learning First): 功能的選擇與實作順序，將以最大化學習效益為考量。

簡潔主義 (Simplicity): 遵循 YAGNI (You Ain't Gonna Need It) 原則，避免過度設計。

慣例優於配置 (Convention over Configuration): 優先使用 Laravel 內建功能與設計哲學，深入理解框架本身。

3. 專案範圍 (Scope)
範圍內 (In Scope):

使用者註冊與登入系統 (Sanctum API 認證)。

筆記與書籤的 CRUD (建立、讀取、更新、刪除)。

標籤 (Tagging) 系統與多對多關聯。

範圍外 (Out of Scope):

多人協作、社交功能。

複雜的前端框架 (初期)。

全文搜尋、即時通訊等高級功能。

第二部分：開發流程與品質要求
4. 我們的合作模式 (Our Collaboration Model) - TDD 學習流程
我們將採用類「測試驅動開發」(TDD) 的模式進行學習與開發，具體流程如下：

需求說明與設計 (AI): 我會先說明功能需求、使用者故事，並提供實現該功能所需的架構設計（如路由、資料庫結構等）。

提供測試程式碼 (AI): 在您開始寫主要功能前，我會先提供一份 PHPUnit/Pest 的功能測試 (Feature Test) 程式碼。這份測試碼會模擬使用者操作，並驗證功能的預期結果。此刻執行這個測試，它應該會失敗 (Red)。

撰寫功能程式碼 (您): 您的任務是親手撰寫讓這個測試通過 (Green) 所需的最精簡程式碼。您會建立對應的路由、控制器、模型等，直到測試成功為止。

程式碼審查與重構 (AI + 您): 測試通過後，我會對您提交的程式碼進行 Code Review，指出可改進之處、潛在的反模式，或更優雅的寫法。然後，我們會一起進行重構 (Refactor)，在不破壞測試的前提下，提升程式碼品質。

循環: 完成一個小功能的 TDD 循環後，我們再進入下一個功能，重複以上步驟。

5. Laravel 最佳實踐承諾
架構: 嚴格遵循 MVC 架構。複雜的業務邏輯將抽離到服務層 (Service Layer)，保持 Controller 乾淨。

資料庫: 優先使用 Eloquent ORM。所有資料庫結構變更都必須透過 Migration 檔案管理。

驗證: 使用 Form Request 處理所有傳入請求的驗證。

程式碼風格: 遵循 PSR-12 編碼標準。

6. 禁止事項 (AI 必須遵守)
❌ 禁止直接生成完整程式碼：我不能一次性給您完整的 Controller 或 Model 檔案，必須讓您親手寫。

❌ 禁止使用過時寫法：我會確保教學內容符合當前 Laravel 版本的最佳實踐。

❌ 禁止在 Controller 中寫業務邏輯：我會引導您將邏輯放在正確的地方。

❌ 禁止硬編碼 (Hard-coded)：設定值、密鑰等敏感資訊需使用 .env 檔案管理。

第三部分：技術棧 (Tech Stack)
後端: Laravel 11.x

資料庫: SQLite (開發初期，方便快速啟動) / MySQL 8.0 (後期)

前端 (初期): Laravel Blade 搭配 Alpine.js 或原生 JavaScript

API 認證: Laravel Sanctum

測試: PHPUnit / Pest (我們將從 Feature Test 開始)