Develop

.gitignore

@@ -10,3 +10,5 @@ Homestead.yaml
 npm-debug.log
 yarn-error.log
 .env
+*.md
+!README.md

.php_cs

@@ -3,6 +3,7 @@ $finder = PhpCsFixer\Finder::create()
     ->notPath('bootstrap/cache')
     ->notPath('storage')
     ->notPath('vendor')
+    ->notPath('node_modules')
     ->in(__DIR__)
     ->name('*.php')
     ->notName('*.blade.php')
@@ -13,12 +14,22 @@ $finder = PhpCsFixer\Finder::create()
 return PhpCsFixer\Config::create()
     ->setRules(array(
         '@Symfony'                          => true,
-        'binary_operator_spaces'            => ['default' => 'align'],
+        'class_definition'                  => [
+            'multiLineExtendsEachSingleLine' => true,
+        ],
+        'ordered_class_elements'            => [
+            'use_trait', 'constant_public', 'constant_protected', 'constant_private', 
+            'property_public', 'property_protected', 'property_private', 'construct', 
+            'destruct', 'magic', 'phpunit', 'method_public', 'method_protected', 
+            'method_private'
+        ],
+        'binary_operator_spaces'            => ['default' => 'align_single_space_minimal'],
         'array_syntax'                      => ['syntax' => 'short'],
         'concat_space'                      => ['spacing' => 'one'],
+        'blank_line_after_namespace'        => true,
         'linebreak_after_opening_tag'       => true,
         'not_operator_with_successor_space' => true,
         'ordered_imports'                   => true,
         'phpdoc_order'                      => true,
     ))
-    ->setFinder($finder);
+    ->setFinder($finder);

README.md

@@ -53,12 +53,35 @@ Create [Google Service Account Credentials](https://console.developers.google.co
 
 ## Usage
 
+### User Accounts
+
+By default, there's no users created. But you can run `php artisan db:seed DevelopmentSeeder` to run create 3 main users - Developer, Administrator and User.
+
+Login details for default users:
+
+1. E-mail : **developer@app.com** Password: `developer`
+2. E-mail : **administrator@app.com** Password: `administrator`
+3. 1. E-mail : **user@app.com** Password: `user`
+
+By default, all newly registered user will be assign role as `user`.
+
+### Access Control
+
+Access control for the application can be configure from `config/acl.php`. It consist of `roles`, `permissions` and `actions`. Default seeder for ACL is in `database/seeds/RolesAndPermissionsSeeder.php`. You may overwrite this as you please.
+
+Seeded roles and permissions based on `database/seeds/RolesAndPermissionsSeeder.php` will have all guards specify in `config/auth.php`.
+
 ### Commands
 
 There's some commands area ready built-in. Others, may refer to respective packages.
 
 - `reload:db` - Run `migrate:fresh --seed` with `profile:seed`. You may extend the usage.
 - `reload:cache` - Recache everything
+- `reload:all` - Run above two commands. Passing `-d` will seed `DevelopementSeeder` - useful for development setup.
+
+### API
+
+This boilerplate make use of Laravel Passport. Managing passport only allowed in for role developer. You can overwrite this behaviour in `routes/web.php`.
 
 ### Helpers
 
@@ -192,6 +215,10 @@ Simply record audit trail on given `$model`, with proper `$message`. You can opt
    ]
 ```
 
+**user()**
+
+The `user()` helper simply return the current logged in user object. The helper will take care your guard.
+
 ## Test
 
 To run the test, type `vendor/bin/phpunit` in your terminal.

app/Console/Commands/ReloadAllCommand.php

@@ -11,7 +11,8 @@ class ReloadAllCommand extends Command
      *
      * @var string
      */
-    protected $signature = 'reload:all';
+    protected $signature = 'reload:all
+                                {--d|dev : Seed development data}';
 
     /**
      * The console command description.
@@ -37,5 +38,15 @@ public function handle()
     {
         $this->call('reload:cache');
         $this->call('reload:db');
+        $this->call('storage:link');
+        $this->call('passport:install', [
+            '--force' => true,
+        ]);
+
+        if ($this->option('dev')) {
+            $this->call('db:seed', [
+                '--class' => 'DevelopmentSeeder',
+            ]);
+        }
     }
 }

app/Http/Kernel.php

@@ -58,5 +58,7 @@ class Kernel extends HttpKernel
         'can'        => \Illuminate\Auth\Middleware\Authorize::class,
         'guest'      => \App\Http\Middleware\RedirectIfAuthenticated::class,
         'throttle'   => \Illuminate\Routing\Middleware\ThrottleRequests::class,
+        'role'       => \Spatie\Permission\Middlewares\RoleMiddleware::class,
+        'permission' => \Spatie\Permission\Middlewares\PermissionMiddleware::class,
     ];
 }

app/Models/User.php

@@ -10,12 +10,13 @@
 use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
+use Laravel\Passport\HasApiTokens;
 use Spatie\MediaLibrary\HasMedia\Interfaces\HasMediaConversions;
 use Spatie\Permission\Traits\HasRoles;
 
 class User extends Authenticatable implements HasMediaConversions
 {
-    use HasProfile, HasMediaExtended, HasThumbnail, HasRoles, HasSlugExtended, LogsActivityExtended, Notifiable, SoftDeletes;
+    use HasApiTokens, HasProfile, HasMediaExtended, HasThumbnail, HasRoles, HasSlugExtended, LogsActivityExtended, Notifiable, SoftDeletes;
 
     /**
      * Guarded Field.

app/Observers/Kernel.php

@@ -21,7 +21,7 @@ class Kernel
     protected $observeBy = [
         \App\Observers\ReferenceObserver::class => [
         ],
-        \App\Observers\HashidsObserver::class   => [
+        \App\Observers\HashidsObserver::class => [
             \App\Models\User::class,
             \Spatie\MediaLibrary\Media::class,
         ],

app/Providers/AppServiceProvider.php

@@ -15,6 +15,13 @@ public function boot()
         $this->bootProviders();
     }
 
+    /**
+     * Register any application services.
+     */
+    public function register()
+    {
+    }
+
     /**
      * Boot Providers Based On Environments.
      */
@@ -26,11 +33,4 @@ private function bootProviders()
             $this->app->register($provider);
         });
     }
-
-    /**
-     * Register any application services.
-     */
-    public function register()
-    {
-    }
 }

app/Providers/AuthServiceProvider.php

@@ -3,6 +3,7 @@
 namespace App\Providers;
 
 use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider;
+use Laravel\Passport\Passport;
 
 class AuthServiceProvider extends ServiceProvider
 {
@@ -21,5 +22,7 @@ class AuthServiceProvider extends ServiceProvider
     public function boot()
     {
         $this->registerPolicies();
+
+        Passport::routes();
     }
 }

app/Providers/EventServiceProvider.php

@@ -13,16 +13,16 @@ class EventServiceProvider extends ServiceProvider
      * @var array
      */
     protected $listen = [
-        'Illuminate\Auth\Events\Registered'    => [
+        'Illuminate\Auth\Events\Registered' => [
             'App\Listeners\AssignDefaultRole',
         ],
-        'Illuminate\Auth\Events\Login'         => [
+        'Illuminate\Auth\Events\Login' => [
             'App\Listeners\LogSuccessfulLogin',
         ],
-        'Illuminate\Auth\Events\Failed'        => [
+        'Illuminate\Auth\Events\Failed' => [
             'App\Listeners\LogFailedLogin',
         ],
-        'Illuminate\Auth\Events\Logout'        => [
+        'Illuminate\Auth\Events\Logout' => [
             'App\Listeners\LogSuccessfulLogout',
         ],
         'Illuminate\Auth\Events\PasswordReset' => [

app/Providers/RouteServiceProvider.php

@@ -55,7 +55,20 @@ protected function mapApiRoutes()
     {
         Route::prefix('api')
              ->middleware('api')
-             ->namespace($this->namespace)
+             ->namespace($this->namespace . '\Api')
              ->group(base_path('routes/api.php'));
     }
+
+    /**
+     * Define the "datatable" routes for the application.
+     *
+     * These routes are typically stateless.
+     */
+    protected function mapDatatableRoutes()
+    {
+        Route::prefix('datatable')
+             ->middleware('api')
+             ->namespace($this->namespace . '\Api\Datatable')
+             ->group(base_path('routes/datatable.php'));
+    }
 }

app/Support/helpers.php

@@ -109,3 +109,19 @@ function audit($model, $message, $causedBy = null)
         }
     }
 }
+
+/*
+ * user() helper
+ */
+if (! function_exists('user')) {
+    function user()
+    {
+        foreach (config('auth.guards') as $key => $value) {
+            if (Auth::guard($key)->check()) {
+                return Auth::guard($key)->user();
+            }
+        }
+
+        return null;
+    }
+}

composer.json

@@ -10,9 +10,11 @@
         "cleaniquecoders/blueprint-macro": "^1.0",
         "cleaniquecoders/profile": "^1.0",
         "davejamesmiller/laravel-breadcrumbs": "^5.0",
+        "doctrine/dbal": "^2.7",
         "fideloper/proxy": "~4.0",
         "hashids/hashids": "^2.0",
         "laravel/framework": "5.6.*",
+        "laravel/passport": "^6.0",
         "laravel/tinker": "~1.0",
         "predis/predis": "^1.1",
         "softon/sweetalert": "^1.0",
@@ -27,9 +29,11 @@
         "spatie/laravel-permission": "^2.7",
         "spatie/laravel-referer": "^1.3",
         "spatie/laravel-responsecache": "^4.1",
-        "spatie/laravel-sluggable": "^2.1"
+        "spatie/laravel-sluggable": "^2.1",
+        "yajra/laravel-datatables": "^1.0"
     },
     "require-dev": {
+        "barryvdh/laravel-debugbar": "^3.1",
         "codedungeon/phpunit-result-printer": "^0.6.0",
         "filp/whoops": "~2.0",
         "fzaninotto/faker": "~1.4",