Add authentication system with user management, migrations, and CLI commands

composer.json

@@ -14,7 +14,8 @@
         "ext-json": "*",
         "neuron-php/mvc": "0.8.*",
         "neuron-php/cli": "0.8.*",
-        "ljonesfl/blahg": "0.5.*"
+        "neuron-php/jobs": "0.2.*",
+        "phpmailer/phpmailer": "^6.9"
     },
     "require-dev": {
         "phpunit/phpunit": "9.*",
@@ -25,12 +26,20 @@
             "Neuron\\": "src/"
         },
         "files": [
-            "src/Bootstrap.php"
+            "src/Bootstrap.php",
+            "src/Cms/Auth/helpers.php",
+            "src/Cms/Email/helpers.php",
+            "src/Cms/View/helpers.php"
         ]
     },
     "autoload-dev": {
         "psr-4": {
             "Tests\\": "tests/"
         }
+    },
+    "extra": {
+        "neuron": {
+            "cli-provider": "Neuron\\Cms\\Cli\\Provider"
+        }
     }
 }

config/auth.yaml

@@ -0,0 +1,40 @@
+# Authentication Configuration
+# Configuration for the Neuron CMS authentication system
+
+auth:
+  # Default authentication driver
+  default: session
+
+  # Session configuration
+  session:
+    lifetime: 120  # Session lifetime in minutes (2 hours)
+    expire_on_close: false
+    cookie_name: neuron_session
+    cookie_httponly: true
+    cookie_secure: true  # Set to true for HTTPS only
+    cookie_samesite: Lax  # Lax, Strict, or None
+
+  # Remember me configuration
+  remember:
+    enabled: true
+    lifetime: 43200  # 30 days in minutes
+
+  # Password configuration
+  passwords:
+    min_length: 8
+    require_uppercase: true
+    require_lowercase: true
+    require_numbers: true
+    require_special_chars: false
+    hash_algorithm: argon2id  # argon2id or bcrypt
+
+  # Login throttling (brute force protection)
+  throttle:
+    enabled: true
+    max_attempts: 5  # Max failed attempts before lockout
+    lockout_duration: 15  # Lockout duration in minutes
+
+  # User storage
+  storage:
+    type: file  # file or database (future)
+    path: storage/users  # Path for file-based storage

debug-maintenance.php

@@ -0,0 +1,28 @@
+<?php
+
+require_once __DIR__ . '/vendor/autoload.php';
+
+use Neuron\Cms\Maintenance\MaintenanceManager;
+
+$basePath = getcwd();
+$manager = new MaintenanceManager($basePath);
+
+echo "Maintenance Status Check\n";
+echo "========================\n\n";
+
+echo "Base Path: $basePath\n";
+echo "Maintenance File: " . $basePath . "/.maintenance.json\n";
+echo "File Exists: " . (file_exists($basePath . '/.maintenance.json') ? 'Yes' : 'No') . "\n\n";
+
+if (file_exists($basePath . '/.maintenance.json')) {
+    echo "File Contents:\n";
+    echo file_get_contents($basePath . '/.maintenance.json') . "\n\n";
+}
+
+echo "Is Enabled: " . ($manager->isEnabled() ? 'Yes' : 'No') . "\n";
+echo "Message: " . $manager->getMessage() . "\n";
+echo "Retry After: " . $manager->getRetryAfter() . "\n\n";
+
+$status = $manager->getStatus();
+echo "Full Status:\n";
+print_r($status);

examples/config/routes.yaml

@@ -1,32 +1,174 @@
+# CMS Routes Configuration
+# Admin routes with authentication
+
 routes:
-  login:
+  # Authentication routes
+  - method: GET
+    route: /login
+    controller: Neuron\Cms\Controllers\Auth\LoginController@showLoginForm
+
+  - method: POST
     route: /login
-    method: POST
-    controller: App\Controllers\AuthController@login
-    request: login
-
-  test:
-    route: /test
-    method: POST
-    controller: Mvc\TestController@test
-    request: test
-
-  put:
-    route: /test_put
-    method: PUT
-    controller: Mvc\TestController@test
-
-  delete:
-    route: /test_delete
-    method: DELETE
-    controller: Mvc\TestController@test
-
-  no_request:
-    route: /no_request
-    method: GET
-    controller: Mvc\TestController@no_request
-
-  bad_request:
-    route: /bad_request
-    method: GET
-    controller: Mvc\TestController@bad_request
+    controller: Neuron\Cms\Controllers\Auth\LoginController@login
+
+  - method: POST
+    route: /logout
+    controller: Neuron\Cms\Controllers\Auth\LoginController@logout
+    filter: auth
+
+  # Admin Dashboard
+  - method: GET
+    route: /admin
+    controller: Neuron\Cms\Controllers\Admin\DashboardController@index
+    filter: auth
+
+  - method: GET
+    route: /admin/dashboard
+    controller: Neuron\Cms\Controllers\Admin\DashboardController@index
+    filter: auth
+
+  # User Management
+  - method: GET
+    route: /admin/users
+    controller: Neuron\Cms\Controllers\Admin\UserController@index
+    filter: auth
+
+  - method: GET
+    route: /admin/users/create
+    controller: Neuron\Cms\Controllers\Admin\UserController@create
+    filter: auth
+
+  - method: POST
+    route: /admin/users
+    controller: Neuron\Cms\Controllers\Admin\UserController@store
+    filter: auth
+
+  - method: GET
+    route: /admin/users/:id/edit
+    controller: Neuron\Cms\Controllers\Admin\UserController@edit
+    filter: auth
+
+  - method: PUT
+    route: /admin/users/:id
+    controller: Neuron\Cms\Controllers\Admin\UserController@update
+    filter: auth
+
+  - method: DELETE
+    route: /admin/users/:id
+    controller: Neuron\Cms\Controllers\Admin\UserController@destroy
+    filter: auth
+
+  # Profile Management
+  - method: GET
+    route: /admin/profile
+    controller: Neuron\Cms\Controllers\Admin\ProfileController@edit
+    filter: auth
+
+  - method: PUT
+    route: /admin/profile
+    controller: Neuron\Cms\Controllers\Admin\ProfileController@update
+    filter: auth
+
+  # Settings
+  - method: GET
+    route: /admin/settings
+    controller: Neuron\Cms\Controllers\Admin\SettingsController@index
+    filter: auth
+
+  - method: PUT
+    route: /admin/settings
+    controller: Neuron\Cms\Controllers\Admin\SettingsController@update
+    filter: auth
+
+  # Blog Post Management
+  - method: GET
+    route: /admin/posts
+    controller: Neuron\Cms\Controllers\Admin\PostController@index
+    filter: auth
+
+  - method: GET
+    route: /admin/posts/create
+    controller: Neuron\Cms\Controllers\Admin\PostController@create
+    filter: auth
+
+  - method: POST
+    route: /admin/posts
+    controller: Neuron\Cms\Controllers\Admin\PostController@store
+    filter: auth
+
+  - method: GET
+    route: /admin/posts/:id/edit
+    controller: Neuron\Cms\Controllers\Admin\PostController@edit
+    filter: auth
+
+  - method: PUT
+    route: /admin/posts/:id
+    controller: Neuron\Cms\Controllers\Admin\PostController@update
+    filter: auth
+
+  - method: DELETE
+    route: /admin/posts/:id
+    controller: Neuron\Cms\Controllers\Admin\PostController@destroy
+    filter: auth
+
+  # Blog Category Management
+  - method: GET
+    route: /admin/categories
+    controller: Neuron\Cms\Controllers\Admin\CategoryController@index
+    filter: auth
+
+  - method: GET
+    route: /admin/categories/create
+    controller: Neuron\Cms\Controllers\Admin\CategoryController@create
+    filter: auth
+
+  - method: POST
+    route: /admin/categories
+    controller: Neuron\Cms\Controllers\Admin\CategoryController@store
+    filter: auth
+
+  - method: GET
+    route: /admin/categories/:id/edit
+    controller: Neuron\Cms\Controllers\Admin\CategoryController@edit
+    filter: auth
+
+  - method: PUT
+    route: /admin/categories/:id
+    controller: Neuron\Cms\Controllers\Admin\CategoryController@update
+    filter: auth
+
+  - method: DELETE
+    route: /admin/categories/:id
+    controller: Neuron\Cms\Controllers\Admin\CategoryController@destroy
+    filter: auth
+
+  # Blog Tag Management
+  - method: GET
+    route: /admin/tags
+    controller: Neuron\Cms\Controllers\Admin\TagController@index
+    filter: auth
+
+  - method: GET
+    route: /admin/tags/create
+    controller: Neuron\Cms\Controllers\Admin\TagController@create
+    filter: auth
+
+  - method: POST
+    route: /admin/tags
+    controller: Neuron\Cms\Controllers\Admin\TagController@store
+    filter: auth
+
+  - method: GET
+    route: /admin/tags/:id/edit
+    controller: Neuron\Cms\Controllers\Admin\TagController@edit
+    filter: auth
+
+  - method: PUT
+    route: /admin/tags/:id
+    controller: Neuron\Cms\Controllers\Admin\TagController@update
+    filter: auth
+
+  - method: DELETE
+    route: /admin/tags/:id
+    controller: Neuron\Cms\Controllers\Admin\TagController@destroy
+    filter: auth