chore: [env] .env.example 업데이트 및 .gitignore 정리

- .env.example을 SAM 프로젝트 실제 키 구조로 업데이트
- .gitignore에 !.env.example 예외 추가
- GCS_* 중복 키 제거, Gemini/Claude/Vertex 키 섹션 추가

app/Models/Permissions/Role.php

@@ -8,14 +8,13 @@
 use App\Models\Tenants\Tenant;
 use App\Traits\Auditable;
 use App\Traits\BelongsToTenant;
-use Illuminate\Database\Eloquent\Relations\BelongsToMany;
+use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\SoftDeletes;
-use Spatie\Permission\Models\Role as SpatieRole;
 
 /**
  * @mixin IdeHelperRole
  */
-class Role extends SpatieRole
+class Role extends Model
 {
     use Auditable, BelongsToTenant, SoftDeletes;
 
@@ -35,6 +34,14 @@ class Role extends SpatieRole
         'tenant_id' => 'integer',
     ];
 
+    /**
+     * 관계: 메뉴 권한 (다대다)
+     */
+    public function menuPermissions()
+    {
+        return $this->hasMany(RoleMenuPermission::class, 'role_id');
+    }
+
     /**
      * 관계: 테넌트
      */
@@ -54,7 +61,7 @@ public function userRoles()
     /**
      * 관계: 사용자 (user_roles 테이블 통해)
      */
-    public function users(): BelongsToMany
+    public function users()
     {
         return $this->belongsToMany(
             User::class,
@@ -64,6 +71,19 @@ public function users(): BelongsToMany
         );
     }
 
+    /**
+     * 관계: 권한 (role_has_permissions 테이블 통해)
+     */
+    public function permissions()
+    {
+        return $this->belongsToMany(
+            Permission::class,
+            'role_has_permissions',
+            'role_id',
+            'permission_id'
+        );
+    }
+
     /**
      * 스코프: 공개된 역할만
      */