[WKP-81] Persist user preferences across devices

app/Http/Controllers/Api/UserIgnoredWordsController.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\StoreUserIgnoredWordRequest;
+use App\Http\Resources\UserIgnoredWordResource;
+use App\Models\UserIgnoredWord;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Resources\Json\AnonymousResourceCollection;
+use Illuminate\Support\Facades\Auth;
+
+class UserIgnoredWordsController extends Controller
+{
+    /**
+     * List ignored words.
+     *
+     * Returns all spell-check ignored words for the user, sorted alphabetically.
+     */
+    public function index(): AnonymousResourceCollection
+    {
+        $words = Auth::user()->ignoredWords()->orderBy('word')->get();
+
+        return UserIgnoredWordResource::collection($words);
+    }
+
+    /**
+     * Add a word to the ignored list.
+     *
+     * Words are automatically lowercased. Returns 201 for new entries, 200 for duplicates.
+     */
+    public function store(StoreUserIgnoredWordRequest $request): JsonResponse
+    {
+        $word     = $request->validated('word');
+        $language = $request->validated('language');
+
+        $entry = Auth::user()->ignoredWords()->firstOrCreate(['word' => $word, 'language' => $language]);
+
+        return response()->json(
+            ['data' => new UserIgnoredWordResource($entry)],
+            $entry->wasRecentlyCreated ? 201 : 200
+        );
+    }
+
+    /**
+     * Remove an ignored word.
+     *
+     * Removes a word from the user's ignored list.
+     */
+    public function destroy(UserIgnoredWord $word): JsonResponse
+    {
+        if ($word->user_id !== Auth::id()) {
+            return response()->json(['error' => 'Not found'], 404);
+        }
+
+        $word->delete();
+
+        return response()->json(null, 204);
+    }
+}

app/Http/Controllers/Api/UserPreferencesController.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\UpdateUserPreferencesRequest;
+use App\Http\Resources\UserPreferenceResource;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\Auth;
+
+class UserPreferencesController extends Controller
+{
+    /**
+     * Show user preferences.
+     *
+     * Returns the authenticated user's personalisation preferences (theme, palette, layout).
+     * Returns `{data: null}` when the user has no preference row yet.
+     */
+    public function show(): JsonResponse
+    {
+        $preference = Auth::user()->preference;
+
+        return response()->json([
+            'data' => $preference ? new UserPreferenceResource($preference) : null,
+        ]);
+    }
+
+    /**
+     * Update user preferences.
+     *
+     * Partial update — only fields present in the request are written.
+     * Creates the preference row on first call.
+     */
+    public function update(UpdateUserPreferencesRequest $request): JsonResponse
+    {
+        $preference = Auth::user()->preference()->updateOrCreate(
+            ['user_id' => Auth::id()],
+            $request->validated()
+        );
+
+        return response()->json(['data' => new UserPreferenceResource($preference)]);
+    }
+}

app/Http/Controllers/Api/UserViewStatesController.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\UpdateUserViewStatesRequest;
+use App\Http\Resources\UserViewStateResource;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\Auth;
+
+class UserViewStatesController extends Controller
+{
+    /**
+     * Show user view states.
+     *
+     * Returns per-page sort selections (documents, book view, translation,
+     * extraction, page linking). Returns `{data: null}` when no row exists.
+     */
+    public function show(): JsonResponse
+    {
+        $state = Auth::user()->viewState;
+
+        return response()->json([
+            'data' => $state ? new UserViewStateResource($state) : null,
+        ]);
+    }
+
+    /**
+     * Update user view states.
+     *
+     * Partial update — only sort columns present in the request are written.
+     * Creates the row on first call.
+     */
+    public function update(UpdateUserViewStatesRequest $request): JsonResponse
+    {
+        $state = Auth::user()->viewState()->updateOrCreate(
+            ['user_id' => Auth::id()],
+            $request->validated()
+        );
+
+        return response()->json(['data' => new UserViewStateResource($state)]);
+    }
+}

app/Http/Requests/StoreUserIgnoredWordRequest.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class StoreUserIgnoredWordRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'word'     => ['required', 'string', 'max:100'],
+            'language' => ['required', 'string', 'in:en,fr,de,es,it,la,ro'],
+        ];
+    }
+
+    protected function prepareForValidation(): void
+    {
+        if ($this->has('word')) {
+            $this->merge(['word' => mb_strtolower(trim($this->word))]);
+        }
+    }
+}

app/Http/Requests/UpdateUserPreferencesRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateUserPreferencesRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        return [
+            'theme_mode' => ['sometimes', 'string', 'in:auto,light,dark'],
+            'palette'    => ['sometimes', 'string', 'in:reading-room,cobalt,monastic,grove,ferrous,plum'],
+            'layout'     => ['sometimes', 'string', 'in:reading-room,workbench,compendium,glass,scriptorium,console'],
+        ];
+    }
+}

app/Http/Requests/UpdateUserViewStatesRequest.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UpdateUserViewStatesRequest extends FormRequest
+{
+    private const COLUMNS = [
+        'sort_documents',
+        'sort_book_view',
+        'sort_translation',
+        'sort_extraction',
+        'sort_page_linking',
+    ];
+
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    public function rules(): array
+    {
+        $rules = [];
+        foreach (self::COLUMNS as $col) {
+            $rules[$col]          = ['sometimes', 'array:sort,dir'];
+            $rules["{$col}.sort"] = ['required_with:'.$col, 'string', 'max:50'];
+            $rules["{$col}.dir"]  = ['required_with:'.$col, 'in:asc,desc'];
+        }
+
+        return $rules;
+    }
+}

app/Http/Resources/UserIgnoredWordResource.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class UserIgnoredWordResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'id'         => $this->id,
+            'word'       => $this->word,
+            'language'   => $this->language,
+            'created_at' => $this->created_at->toISOString(),
+        ];
+    }
+}

app/Http/Resources/UserPreferenceResource.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class UserPreferenceResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'theme_mode' => $this->theme_mode,
+            'palette'    => $this->palette,
+            'layout'     => $this->layout,
+        ];
+    }
+}

app/Http/Resources/UserViewStateResource.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class UserViewStateResource extends JsonResource
+{
+    public function toArray(Request $request): array
+    {
+        return [
+            'sort_documents'    => $this->sort_documents,
+            'sort_book_view'    => $this->sort_book_view,
+            'sort_translation'  => $this->sort_translation,
+            'sort_extraction'   => $this->sort_extraction,
+            'sort_page_linking' => $this->sort_page_linking,
+        ];
+    }
+}

app/Models/User.php

@@ -4,6 +4,7 @@
 
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
 use Illuminate\Support\Facades\Hash;
@@ -29,6 +30,21 @@ public function dictionaryWords(): HasMany
         return $this->hasMany(UserDictionaryWord::class);
     }
 
+    public function ignoredWords(): HasMany
+    {
+        return $this->hasMany(UserIgnoredWord::class);
+    }
+
+    public function preference(): HasOne
+    {
+        return $this->hasOne(UserPreference::class);
+    }
+
+    public function viewState(): HasOne
+    {
+        return $this->hasOne(UserViewState::class);
+    }
+
     public function isVerified(): bool
     {
         return !is_null($this->email_verified_at);

app/Models/UserIgnoredWord.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class UserIgnoredWord extends Model
+{
+    use HasFactory;
+
+    protected $fillable = ['user_id', 'word', 'language'];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/UserPreference.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class UserPreference extends Model
+{
+    use HasFactory;
+
+    protected $fillable = ['user_id', 'theme_mode', 'palette', 'layout'];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}

app/Models/UserViewState.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class UserViewState extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'user_id',
+        'sort_documents',
+        'sort_book_view',
+        'sort_translation',
+        'sort_extraction',
+        'sort_page_linking',
+    ];
+
+    protected $casts = [
+        'sort_documents'    => 'array',
+        'sort_book_view'    => 'array',
+        'sort_translation'  => 'array',
+        'sort_extraction'   => 'array',
+        'sort_page_linking' => 'array',
+    ];
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}