✨ new imports methods

Author: GautierDele

content/2.essentials/1.perimeters.md

@@ -45,9 +45,12 @@ This allows it to surpass other perimeters while still working in coordination w
 
 ```php
 use Illuminate\Database\Eloquent\Builder;
+use App\Models\Task;
 
 class TaskControl extends Control
 {
+    protected string $model = Task::class;
+
     protected function perimeters(): array
     {
         return [

content/2.essentials/2.controls.md

@@ -16,7 +16,14 @@ use Lomkit\Access\Controls\Control;
 
 class PostControl extends Control
 {
-        /**
+    /**
+     * The model the control refers to.
+     *
+     * @var class-string<Model>
+     */
+    protected string $model;
+
+     /**
      * Retrieve the list of perimeter definitions for the current control.
      *
      * @return array<\Lomkit\Access\Perimeters\Perimeter> An array of Perimeter objects.
@@ -30,6 +37,17 @@ class PostControl extends Control
 }
 ```
 
+Don't forget to define the linked model:
+
+```php
+  /**
+   * The model the control refers to.
+   *
+   * @var class-string<Model>
+   */
+  protected string $model = \App\Models\Task::class;
+```
+
 Next you'll need to define your perimeters in the way you want them to be registered:
 
 ```php
@@ -82,33 +100,34 @@ class Post extends Model
 }
 ```
 
-### (Optional) Specify which Control to use
+### Parent query isolation
 
-You can optionally specify which Control class this model should use:
+By default the access parent's query is isolated from your base query, this is to prevent conflict if you manipulate the query after.
 
-```php
-use Lomkit\Access\Controls\HasControl;
-use App\Access\Controls\PostControl;
+If you want to disable this, simply set `queries.isolate_parent_query` in your config file
 
-class Post extends Model
-{
-    use HasControl;
-    
-    protected static string $control = PostControl::class;
-}
+```php[access-control.php]
+<?php
+
+return [
+    'queries' => [
+        'isolate_parent_query'           => false, // Set this to false
+    ],
+];
 ```
 
-## Policies
+### Perimeter query isolation
 
-In order to be applied to the policy, you need to extend the `ControlledPolicy` class:
+By default the access perimeter's query are isolated from your the other perimeters query, this is to prevent conflict if you manipulate overlayed perimeter.
 
-```php
-use Lomkit\Access\Policies\ControlledPolicy;
+If you want to disable this, simply set `queries.isolate_perimeter_queries` in your config file
 
-class PostPolicy extends ControlledPolicy
-{
-    protected string $model = Post::class;
-}
-```
+```php[access-control.php]
+<?php
 
-And you are ready to go, have a look at the [usage section](/essentials/usage) to apply the security wherever you want !
+return [
+    'queries' => [
+        'isolate_perimeter_queries'           => false, // Set this to false
+    ],
+];
+```

content/2.essentials/3.policies.md

@@ -0,0 +1,20 @@
+---
+title: Policies
+description: Automatically apply Laravel Access Control on your policies !
+---
+
+## Policies
+
+In order to be applied to the policy, you need to extend the `ControlledPolicy` class and specify the linked control:
+
+```php
+use Lomkit\Access\Policies\ControlledPolicy;
+use App\Access\Control\PostControl;
+
+class PostPolicy extends ControlledPolicy
+{
+    protected string $control = PostControl::class;
+}
+```
+
+And you are ready to go, have a look at the [usage section](/essentials/usage#policies) to apply the security wherever you want !

content/2.essentials/3.usage.md renamed to content/2.essentials/4.usage.md

@@ -13,6 +13,12 @@ Post::controlled()
     ->get();
 ```
 
+::info
+When using the query, Access Control will always use the `view` method in the `should` function. This is because it considers you are trying to view models 
+since you make a SQL query.  
+If you are on an index of a controller, the control might trigger twice, once for `viewAny` (Policy) and once for `view` (Query)
+::
+
 ## Policies
 
 Policies are secured by default for the common method: `viewAny`, `view`, `update`, `create`, `delete`, `restore`, `forceDelete`.