Implement geo upload

composer.json

@@ -18,5 +18,9 @@
         "psr-4": {
             "Biigle\\Modules\\Geo\\": "src"
         }
+    },
+    "require": {
+        "lychee-org/php-exif": "^1.0",
+        "proj4php/proj4php": "^2.0"
     }
 }

package.json

@@ -25,6 +25,7 @@
     "vue-template-compiler": "^2.6.11"
   },
   "dependencies": {
-    "@biigle/ol": "^9.2.4"
+    "@biigle/ol": "^9.2.4",
+    "vuedraggable": "^2.24.3"
   }
 }

src/Console/Commands/Config.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Biigle\Modules\Geo\Console\Commands;
+
+use Biigle\Modules\Geo\GeoServiceProvider as ServiceProvider;
+use Illuminate\Console\Command;
+
+class Config extends Command
+{
+    /**
+     * The console command name.
+     *
+     * @var string
+     */
+    protected $name = 'geo:config';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Publish the config file for this module';
+
+    /**
+     * Execute the command.
+     *
+     * @return void
+     */
+    public function handle()
+    {
+        $this->call('vendor:publish', [
+            '--provider' => ServiceProvider::class,
+            '--tag' => ['config'],
+            '--force' => true,
+        ]);
+    }
+}

src/Database/migrations/2024_07_30_155058_add_geo_overlays_table.php

@@ -0,0 +1,56 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+class AddGeoOverlaysTable extends Migration
+{
+    /**
+     * Run the migrations.
+     *
+     * @return void
+     */
+    public function up()
+    {
+        /*
+         | A geo overlay is an image that can be placed on a world map. This can be a
+         | bathymetric map of the area where a specific volume was recorded. Geo overlays
+         | can be uploaded by volume admins and are displayed on the volume geo view.
+         | Each overlay consists of an image and the geospatial information where the
+         | image should be displayed on the world map. While the input format can vary
+         | the geospatial information will always be converted to the latitude and
+         | longitude of the top left and bottom right corners of the image in WGS 84
+         | (EPSG:4326).
+         */
+        Schema::create('geo_overlays', function (Blueprint $table) {
+            $table->increments('id');
+            // A short description of the overlay.
+            $table->string('name', 512);
+            $table->integer('volume_id')->unsigned()->index();
+            $table->foreign('volume_id')
+                  ->references('id')
+                  ->on('volumes')
+                  ->onDelete('cascade');
+            $table->string('type', 10)->nullable();
+            $table->boolean('browsing_layer')->default(0);
+            $table->boolean('context_layer')->default(0);
+            // the position of the overlay (can be set by the user) in case of mutliple uploaded overlays in the same volume 
+            $table->integer('layer_index')->nullable();
+            // follwoing attributes are possible in attrs-column:
+            // if(type == 'geotiff'): 'top_left_lat', 'top_left_lng', 'bottom_right_lat', 'bottom_right_lng', 'width', 'height' 
+            // if(type == 'webmap'): 'url', 'layers'
+            $table->json('attrs')->default('{}');
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     *
+     * @return void
+     */
+    public function down()
+    {
+        Schema::drop('geo_overlays');
+    }
+}

src/GeoOverlay.php

@@ -0,0 +1,119 @@
+<?php
+
+namespace Biigle\Modules\Geo;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Http\UploadedFile;
+use Biigle\Volume;
+use Illuminate\Database\Eloquent\Casts\AsArrayObject;
+use Illuminate\Database\Eloquent\Casts\Attribute;
+use Storage;
+
+class GeoOverlay extends Model
+{
+    /**
+     * Don't maintain timestamps for this model.
+     *
+     * @var bool
+     */
+    public $timestamps = false;
+
+    /**
+     * The attributes hidden in the model's JSON form.
+     *
+     * @var array
+     */
+    protected $hidden = [
+        'volume_id',
+    ];
+
+    protected $fillable = [
+        'browsing_layer',
+        'context_layer',
+        'layer_index',
+        'type',
+        'attrs->url',
+        'attrs->layers',
+        'attrs->top_left_lng',
+        'attrs->top_left_lat',
+        'attrs->bottom_right_lng',
+        'attrs->bottom_right_lat'
+    ];
+
+    /**
+     * The attributes that should be casted to native types.
+     *
+     * @var array
+     */
+    protected $casts = [
+        'attrs' => 'array',
+        'attrs->layers' => 'array'
+    ];
+
+
+    /**
+     * Getter for the attrs json column
+     */
+    protected function attrs(): Attribute {
+
+        return Attribute::make(
+            get: function (mixed $value): array {
+            $value = json_decode($value, true);
+            $float_array = ['top_left_lng', 'top_left_lat', 'bottom_right_lng', 'bottom_right_lat'];
+
+            foreach($value as $entry) {
+                if (in_array($entry, $float_array)) {
+                    $value[$entry] = floatval($value[$entry]);
+                }
+            }
+
+            return $value;
+        });
+    }
+
+    /**
+     * The "booting" method of the model.
+     *
+     * @return void
+     */
+    protected static function boot()
+    {
+        parent::boot();
+
+        // Delete the overlay image file when the model is deleted.
+        static::deleting(function ($overlay) {
+            Storage::disk(config('geo.tiles.overlay_storage_disk'))->deleteDirectory($overlay->id);
+        });
+    }
+
+    /**
+     * The volume, this overlay belongs to.
+     *
+     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
+     */
+    public function volume()
+    {
+        return $this->belongsTo(Volume::class);
+    }
+
+    /**
+     * Get the local path to the overlay image file.
+     *
+     * @return string
+     */
+    public function getPathAttribute()
+    {
+        return "{$this->id}/{$this->id}_original.tif";
+    }
+
+    /**
+     * Store the uploaded image file of the geo overlay.
+     *
+     * @param UploadedFile $file
+     */
+    public function storeFile(UploadedFile $file)
+    {
+        Storage::disk(config('geo.tiles.overlay_storage_disk'))
+            ->putFileAs($this->id, $file, "{$this->id}_original.tif");
+    }
+}

src/GeoServiceProvider.php

@@ -40,10 +40,14 @@ public function boot(Modules $modules, Router $router)
             'viewMixins' => [
                 'imagesIndex',
                 'manualTutorial',
+                'manualVolumes',
                 'volumesSidebar',
                 'volumesScripts',
                 'projectsShowTabs',
-                'volumesStyles'
+                'volumesStyles',
+                'volumesEditRight',
+                'volumesEditScripts',
+                'volumesEditStyles'
             ],
             'apidoc' => [__DIR__.'/Http/Controllers/Api/'],
         ]);
@@ -56,10 +60,18 @@ public function boot(Modules $modules, Router $router)
      */
     public function register()
     {
+        $this->mergeConfigFrom(__DIR__.'/config/geo.php', 'geo');
+
         $this->app->singleton('command.geo.publish', function ($app) {
             return new \Biigle\Modules\Geo\Console\Commands\Publish();
         });
         $this->commands('command.geo.publish');
+
+
+        $this->app->singleton('command.geo.config', function ($app) {
+            return new \Biigle\Modules\Geo\Console\Commands\Config();
+        });
+        $this->commands('command.geo.config');
     }
 
     /**
@@ -71,6 +83,7 @@ public function provides()
     {
         return [
             'command.geo.publish',
+            'command.geo.config',
         ];
     }
 }