From e91b4251fd52a7aeda842ecae3e0651e1fa16ae1 Mon Sep 17 00:00:00 2001 From: Mark Gregory Date: Mon, 15 Jun 2026 08:42:38 +0100 Subject: [PATCH] and audit trail --- Modules/AuditTrail/Config/.gitkeep | 0 Modules/AuditTrail/Config/config.php | 8 + Modules/AuditTrail/Console/.gitkeep | 0 .../AuditTrail/Database/Migrations/.gitkeep | 0 Modules/AuditTrail/Database/Seeders/.gitkeep | 0 .../Seeders/AuditTrailDatabaseSeeder.php | 21 +++ .../AuditTrail/Database/factories/.gitkeep | 0 Modules/AuditTrail/Helpers/.gitkeep | 0 Modules/AuditTrail/Helpers/Helper.php | 12 ++ Modules/AuditTrail/Http/Controllers/.gitkeep | 0 .../Http/Controllers/AuditTrailController.php | 79 +++++++++ Modules/AuditTrail/Http/Middleware/.gitkeep | 0 Modules/AuditTrail/Http/Requests/.gitkeep | 0 Modules/AuditTrail/Models/.gitkeep | 0 Modules/AuditTrail/Providers/.gitkeep | 0 .../Providers/AuditTrailServiceProvider.php | 155 ++++++++++++++++++ .../Providers/RouteServiceProvider.php | 69 ++++++++ Modules/AuditTrail/Resources/assets/.gitkeep | 0 Modules/AuditTrail/Resources/assets/js/app.js | 0 .../AuditTrail/Resources/assets/sass/app.scss | 0 Modules/AuditTrail/Resources/lang/.gitkeep | 0 Modules/AuditTrail/Resources/views/.gitkeep | 0 .../Resources/views/index.blade.php | 9 + .../Resources/views/layouts/master.blade.php | 19 +++ Modules/AuditTrail/Routes/.gitkeep | 0 Modules/AuditTrail/Routes/api.php | 18 ++ Modules/AuditTrail/Routes/web.php | 16 ++ Modules/AuditTrail/Support/.gitkeep | 0 Modules/AuditTrail/Support/ModuleInfo.php | 26 +++ Modules/AuditTrail/Tests/Browser/.gitkeep | 0 Modules/AuditTrail/Tests/Feature/.gitkeep | 0 Modules/AuditTrail/Tests/Unit/.gitkeep | 0 Modules/AuditTrail/Traits/.gitkeep | 0 Modules/AuditTrail/View/.gitkeep | 0 Modules/AuditTrail/composer.json | 29 ++++ Modules/AuditTrail/module.json | 14 ++ Modules/AuditTrail/package.json | 17 ++ Modules/AuditTrail/webpack.mix.js | 11 ++ composer.json | 1 + ...06_15_074154_create_activity_log_table.php | 27 +++ ...add_event_column_to_activity_log_table.php | 22 +++ ...atch_uuid_column_to_activity_log_table.php | 22 +++ modules_statuses.json | 3 +- 43 files changed, 577 insertions(+), 1 deletion(-) create mode 100644 Modules/AuditTrail/Config/.gitkeep create mode 100644 Modules/AuditTrail/Config/config.php create mode 100644 Modules/AuditTrail/Console/.gitkeep create mode 100644 Modules/AuditTrail/Database/Migrations/.gitkeep create mode 100644 Modules/AuditTrail/Database/Seeders/.gitkeep create mode 100644 Modules/AuditTrail/Database/Seeders/AuditTrailDatabaseSeeder.php create mode 100644 Modules/AuditTrail/Database/factories/.gitkeep create mode 100644 Modules/AuditTrail/Helpers/.gitkeep create mode 100644 Modules/AuditTrail/Helpers/Helper.php create mode 100644 Modules/AuditTrail/Http/Controllers/.gitkeep create mode 100644 Modules/AuditTrail/Http/Controllers/AuditTrailController.php create mode 100644 Modules/AuditTrail/Http/Middleware/.gitkeep create mode 100644 Modules/AuditTrail/Http/Requests/.gitkeep create mode 100644 Modules/AuditTrail/Models/.gitkeep create mode 100644 Modules/AuditTrail/Providers/.gitkeep create mode 100644 Modules/AuditTrail/Providers/AuditTrailServiceProvider.php create mode 100644 Modules/AuditTrail/Providers/RouteServiceProvider.php create mode 100644 Modules/AuditTrail/Resources/assets/.gitkeep create mode 100644 Modules/AuditTrail/Resources/assets/js/app.js create mode 100644 Modules/AuditTrail/Resources/assets/sass/app.scss create mode 100644 Modules/AuditTrail/Resources/lang/.gitkeep create mode 100644 Modules/AuditTrail/Resources/views/.gitkeep create mode 100644 Modules/AuditTrail/Resources/views/index.blade.php create mode 100644 Modules/AuditTrail/Resources/views/layouts/master.blade.php create mode 100644 Modules/AuditTrail/Routes/.gitkeep create mode 100644 Modules/AuditTrail/Routes/api.php create mode 100644 Modules/AuditTrail/Routes/web.php create mode 100644 Modules/AuditTrail/Support/.gitkeep create mode 100644 Modules/AuditTrail/Support/ModuleInfo.php create mode 100644 Modules/AuditTrail/Tests/Browser/.gitkeep create mode 100644 Modules/AuditTrail/Tests/Feature/.gitkeep create mode 100644 Modules/AuditTrail/Tests/Unit/.gitkeep create mode 100644 Modules/AuditTrail/Traits/.gitkeep create mode 100644 Modules/AuditTrail/View/.gitkeep create mode 100644 Modules/AuditTrail/composer.json create mode 100644 Modules/AuditTrail/module.json create mode 100644 Modules/AuditTrail/package.json create mode 100644 Modules/AuditTrail/webpack.mix.js create mode 100644 database/migrations/2026_06_15_074154_create_activity_log_table.php create mode 100644 database/migrations/2026_06_15_074155_add_event_column_to_activity_log_table.php create mode 100644 database/migrations/2026_06_15_074156_add_batch_uuid_column_to_activity_log_table.php diff --git a/Modules/AuditTrail/Config/.gitkeep b/Modules/AuditTrail/Config/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Config/config.php b/Modules/AuditTrail/Config/config.php new file mode 100644 index 00000000..d0401f3d --- /dev/null +++ b/Modules/AuditTrail/Config/config.php @@ -0,0 +1,8 @@ + 'AuditTrail', + 'features' => + [ + ], +]; diff --git a/Modules/AuditTrail/Console/.gitkeep b/Modules/AuditTrail/Console/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Database/Migrations/.gitkeep b/Modules/AuditTrail/Database/Migrations/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Database/Seeders/.gitkeep b/Modules/AuditTrail/Database/Seeders/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Database/Seeders/AuditTrailDatabaseSeeder.php b/Modules/AuditTrail/Database/Seeders/AuditTrailDatabaseSeeder.php new file mode 100644 index 00000000..ede190ef --- /dev/null +++ b/Modules/AuditTrail/Database/Seeders/AuditTrailDatabaseSeeder.php @@ -0,0 +1,21 @@ +call("OthersTableSeeder"); + } +} diff --git a/Modules/AuditTrail/Database/factories/.gitkeep b/Modules/AuditTrail/Database/factories/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Helpers/.gitkeep b/Modules/AuditTrail/Helpers/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Helpers/Helper.php b/Modules/AuditTrail/Helpers/Helper.php new file mode 100644 index 00000000..cf1c5008 --- /dev/null +++ b/Modules/AuditTrail/Helpers/Helper.php @@ -0,0 +1,12 @@ +registerTranslations(); + $this->registerConfig(); + $this->registerViews(); + $this->registerHelpers(); + $this->registerCommands(); + $this->loadMigrationsFrom(module_path(ModuleInfo::name(), 'Database/Migrations')); + } + + /** + * Register the service provider. + * + * @return void + */ + public function register(): void + { + $this->app->register(RouteServiceProvider::class); + } + + /** + * Register the helpers. + * + * @return void + */ + protected function registerHelpers(): void + { + foreach (glob(__DIR__.'/../Helpers/*.php') as $filename) { + require_once $filename; + } + } + + /** + * Dynamically Register Commands. + * + * @return void + */ + public function registerCommands(): void + { + if (!$this->app->runningInConsole()) { + return; + } + $commandPath = __DIR__ . '/../Console'; + $commands = collect(File::allFiles($commandPath)) + ->map(function ($file) { + $class = 'Modules\\' . $this->moduleName . '\\Console\\' . $file->getFilenameWithoutExtension(); + return $class; + }) + ->filter(function ($class) { + return class_exists($class); + }) + ->values() + ->all(); + $this->commands($commands); + } + + /** + * Register config. + * + * @return void + */ + protected function registerConfig(): void + { + $this->publishes([ + module_path(ModuleInfo::name(), 'Config/config.php') => config_path( ModuleInfo::nameLower(). '.php'), + ], 'config'); + $this->mergeConfigFrom( + module_path(ModuleInfo::name(), 'Config/config.php'), ModuleInfo::nameLower() + ); + } + + /** + * Register views. + * + * @return void + */ + public function registerViews(): void + { + $viewPath = resource_path('views/modules/' . ModuleInfo::nameLower()); + $sourcePath = module_path(ModuleInfo::name(), 'Resources/views'); + $this->publishes([ + $sourcePath => $viewPath + ], ['views', ModuleInfo::nameLower() . '-module-views']); + $this->loadViewsFrom(array_merge($this->getPublishableViewPaths(), [$sourcePath]), ModuleInfo::nameLower()); + } + + /** + * Register translations. + * + * @return void + */ + public function registerTranslations(): void + { + $langPath = resource_path('lang/modules/' . ModuleInfo::nameLower()); + + if (is_dir($langPath)) { + $this->loadTranslationsFrom($langPath, ModuleInfo::nameLower()); + } else { + $this->loadTranslationsFrom(module_path(ModuleInfo::name(), 'Resources/lang'), ModuleInfo::nameLower()); + } + } + + /** + * Regsiter View Paths + * @return array + */ + private function getPublishableViewPaths(): array + { + $paths = []; + foreach (Config::get('view.paths') as $path) { + if (is_dir($path . '/modules/' . ModuleInfo::nameLower())) { + $paths[] = $path . '/modules/' . ModuleInfo::nameLower(); + } + } + return $paths; + } +} diff --git a/Modules/AuditTrail/Providers/RouteServiceProvider.php b/Modules/AuditTrail/Providers/RouteServiceProvider.php new file mode 100644 index 00000000..9c3c3243 --- /dev/null +++ b/Modules/AuditTrail/Providers/RouteServiceProvider.php @@ -0,0 +1,69 @@ +mapApiRoutes(); + + $this->mapWebRoutes(); + } + + /** + * Define the "web" routes for the application. + * + * These routes all receive session state, CSRF protection, etc. + * + * @return void + */ + protected function mapWebRoutes() + { + Route::middleware('web') + ->namespace($this->moduleNamespace) + ->group(module_path('AuditTrail', '/Routes/web.php')); + } + + /** + * Define the "api" routes for the application. + * + * These routes are typically stateless. + * + * @return void + */ + protected function mapApiRoutes() + { + Route::prefix('api') + ->middleware('api') + ->namespace($this->moduleNamespace) + ->group(module_path('AuditTrail', '/Routes/api.php')); + } +} diff --git a/Modules/AuditTrail/Resources/assets/.gitkeep b/Modules/AuditTrail/Resources/assets/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Resources/assets/js/app.js b/Modules/AuditTrail/Resources/assets/js/app.js new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Resources/assets/sass/app.scss b/Modules/AuditTrail/Resources/assets/sass/app.scss new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Resources/lang/.gitkeep b/Modules/AuditTrail/Resources/lang/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Resources/views/.gitkeep b/Modules/AuditTrail/Resources/views/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Resources/views/index.blade.php b/Modules/AuditTrail/Resources/views/index.blade.php new file mode 100644 index 00000000..bac0ec79 --- /dev/null +++ b/Modules/AuditTrail/Resources/views/index.blade.php @@ -0,0 +1,9 @@ +@extends('audittrail::layouts.master') + +@section('content') +

Hello World

+ +

+ This view is loaded from module: {!! config('audittrail.name') !!} +

+@endsection diff --git a/Modules/AuditTrail/Resources/views/layouts/master.blade.php b/Modules/AuditTrail/Resources/views/layouts/master.blade.php new file mode 100644 index 00000000..e04a95a3 --- /dev/null +++ b/Modules/AuditTrail/Resources/views/layouts/master.blade.php @@ -0,0 +1,19 @@ + + + + + + + Module AuditTrail + + {{-- Laravel Mix - CSS File --}} + {{-- --}} + + + + @yield('content') + + {{-- Laravel Mix - JS File --}} + {{-- --}} + + diff --git a/Modules/AuditTrail/Routes/.gitkeep b/Modules/AuditTrail/Routes/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Routes/api.php b/Modules/AuditTrail/Routes/api.php new file mode 100644 index 00000000..823149fc --- /dev/null +++ b/Modules/AuditTrail/Routes/api.php @@ -0,0 +1,18 @@ +get('/audittrail', function (Request $request) { + return $request->user(); +}); \ No newline at end of file diff --git a/Modules/AuditTrail/Routes/web.php b/Modules/AuditTrail/Routes/web.php new file mode 100644 index 00000000..b90a4e7e --- /dev/null +++ b/Modules/AuditTrail/Routes/web.php @@ -0,0 +1,16 @@ +group(function() { + Route::get('/', 'AuditTrailController@index'); +}); diff --git a/Modules/AuditTrail/Support/.gitkeep b/Modules/AuditTrail/Support/.gitkeep new file mode 100644 index 00000000..e69de29b diff --git a/Modules/AuditTrail/Support/ModuleInfo.php b/Modules/AuditTrail/Support/ModuleInfo.php new file mode 100644 index 00000000..a3535197 --- /dev/null +++ b/Modules/AuditTrail/Support/ModuleInfo.php @@ -0,0 +1,26 @@ +create(config('activitylog.table_name'), function (Blueprint $table) { + $table->bigIncrements('id'); + $table->string('log_name')->nullable(); + $table->text('description'); + $table->nullableMorphs('subject', 'subject'); + $table->nullableMorphs('causer', 'causer'); + $table->json('properties')->nullable(); + $table->timestamps(); + $table->index('log_name'); + }); + } + + public function down() + { + Schema::connection(config('activitylog.database_connection'))->dropIfExists(config('activitylog.table_name')); + } +} diff --git a/database/migrations/2026_06_15_074155_add_event_column_to_activity_log_table.php b/database/migrations/2026_06_15_074155_add_event_column_to_activity_log_table.php new file mode 100644 index 00000000..7b797fd5 --- /dev/null +++ b/database/migrations/2026_06_15_074155_add_event_column_to_activity_log_table.php @@ -0,0 +1,22 @@ +table(config('activitylog.table_name'), function (Blueprint $table) { + $table->string('event')->nullable()->after('subject_type'); + }); + } + + public function down() + { + Schema::connection(config('activitylog.database_connection'))->table(config('activitylog.table_name'), function (Blueprint $table) { + $table->dropColumn('event'); + }); + } +} diff --git a/database/migrations/2026_06_15_074156_add_batch_uuid_column_to_activity_log_table.php b/database/migrations/2026_06_15_074156_add_batch_uuid_column_to_activity_log_table.php new file mode 100644 index 00000000..8f7db665 --- /dev/null +++ b/database/migrations/2026_06_15_074156_add_batch_uuid_column_to_activity_log_table.php @@ -0,0 +1,22 @@ +table(config('activitylog.table_name'), function (Blueprint $table) { + $table->uuid('batch_uuid')->nullable()->after('properties'); + }); + } + + public function down() + { + Schema::connection(config('activitylog.database_connection'))->table(config('activitylog.table_name'), function (Blueprint $table) { + $table->dropColumn('batch_uuid'); + }); + } +} diff --git a/modules_statuses.json b/modules_statuses.json index 8e350fa7..b54ad281 100644 --- a/modules_statuses.json +++ b/modules_statuses.json @@ -18,5 +18,6 @@ "Pricing": true, "Helpdesk": true, "Documentation": true, - "Countries": true + "Countries": true, + "AuditTrail": true } \ No newline at end of file