added spare parts images

app/Helpers/roles.php

@@ -42,6 +42,13 @@ if(!function_exists('year')) {
     }
 }
 
+if(!function_exists('glob_safe')) {
+    function glob_safe(string $str): string
+    {
+        return str_replace(['[', ']', '*', '?'], ['[[]', '[]]', '[*]', '[?]'], $str);
+    }
+}
+
 if(!function_exists('fileName')) {
     function fileName($file): string
     {

app/Http/Controllers/SparePartController.php

@@ -10,6 +10,7 @@ use App\Models\SparePart;
 use App\Models\SparePartsView;
 use Illuminate\Http\RedirectResponse;
 use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Cache;
 use Illuminate\Support\Facades\File;
 use Illuminate\Support\Facades\Log;
 use Illuminate\Support\Facades\Storage;
@@ -273,6 +274,8 @@ class SparePartController extends Controller
             // Сохраняем изображение
             $image->move($directory, $filename);
 
+            Cache::forget('spare_part_image:' . $sparePart->article);
+
             return redirect()->route('spare_parts.show', $sparePart)
                 ->with(['success' => 'Изображение успешно загружено!']);
         }

app/Models/SparePart.php

@@ -10,6 +10,7 @@ use Illuminate\Database\Eloquent\Relations\BelongsTo;
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\SoftDeletes;
+use Illuminate\Support\Facades\Cache;
 
 /**
  * Каталог запчастей — СПРАВОЧНИК.
@@ -123,10 +124,22 @@ class SparePart extends Model
     // Атрибут для картинки
     public function image(): Attribute
     {
-        $path = '';
-        if (file_exists(public_path() . '/images/spare_parts/' . $this->article . '.jpg')) {
-            $path = url('/images/spare_parts/' . $this->article . '.jpg');
-        }
+        $article = $this->article;
+        $cacheKey = 'spare_part_image:' . $article;
+
+        $path = Cache::remember($cacheKey, 3600, function () use ($article) {
+            $dir = public_path('images/spare_parts');
+            $pattern = $dir . '/' . glob_safe($article) . '*.*';
+            $files = glob($pattern, GLOB_NOSORT);
+
+            if (empty($files)) {
+                return '';
+            }
+
+            $filename = basename($files[0]);
+            return url('/images/spare_parts/' . rawurlencode($filename));
+        });
+
         return Attribute::make(get: fn() => $path);
     }
 

docs/spare-parts.md

@@ -11,6 +11,7 @@
 5. [Движения запасов](#5-движения-запасов)
 6. [Контроль наличия](#6-контроль-наличия)
 7. [Связь с рекламациями](#7-связь-с-рекламациями)
+8. [Загрузка файлов по FTP](#загрузка-файлов-по-ftp)
 
 ---
 
@@ -358,6 +359,70 @@
 
 ---
 
+## Загрузка файлов по FTP
+
+По FTP доступна папка `public/images/`. В ней находятся три каталога:
+
+### Структура папок
+
+```
+public/images/
+├── main/              ← картинки каталога МАФ
+├── spare_parts/       ← картинки запчастей
+└── tech-docs/         ← техническая документация (схемы сборки, габариты и т.д.)
+```
+
+### 1. Картинки каталога МАФ (`main/`)
+
+Формат имени файла: `{артикул}.0000.0000.jpg`
+
+Примеры: `0001.0000.0000.jpg`, `1112.0000.0000.jpg`
+
+Поддерживаются форматы: jpg, jpeg, png.
+
+### 2. Картинки запчастей (`spare_parts/`)
+
+Файлы кладутся в корень папки (без подпапок).
+
+Имя файла должно **начинаться с артикула** запчасти. Допускается суффикс после артикула (например, вариант размера).
+
+Примеры:
+- `0000.0000.0041.jpg` — артикул `0000.0000.0041`
+- `0000.0000.0483_50.jpg` — артикул `0000.0000.0483`, вариант 50
+- `BR08.050.jpg` — артикул `BR08.050`
+
+Поддерживаются форматы: jpg, jpeg, png.
+
+> Картинки кешируются на 1 час. После загрузки новых файлов они появятся в системе в течение часа.
+
+### 3. Техническая документация (`tech-docs/`)
+
+Файлы раскладываются **по подпапкам с артикулом** изделия.
+
+Структура:
+```
+tech-docs/
+├── 1112/
+│   ├── 1112.0000.0000 – Габаритные размеры.pdf
+│   ├── 1112.0000.0000 – Инструкция по сборке (Бетон. СУПП).pdf
+│   ├── 1112.0000.0000 – Схема скважин (Бетон. СУПП).pdf
+│   └── 1112.0000.0000 – Схемы установки опор (Бетон. СУПП).pdf
+├── 4005/
+│   └── ...
+```
+
+Типичные документы в папке артикула:
+- Габаритные размеры
+- Инструкция по сборке
+- Схема скважин
+- Схемы установки опор
+
+Формат: PDF.
+
+Эти документы используются при формировании монтажного пакета для площадки и при скачивании архива техдокументации по заказу.
+
+---
+
 ## Часто задаваемые вопросы
 
 ### Почему не могу удалить запчасть?

public/images/readme.md

@@ -0,0 +1,63 @@
+## Загрузка файлов по FTP
+
+По FTP доступна папка `public/images/`. В ней находятся три каталога:
+
+### Структура папок
+
+```
+public/images/
+├── main/              ← картинки каталога МАФ
+├── spare_parts/       ← картинки запчастей
+└── tech-docs/         ← техническая документация (схемы сборки, габариты и т.д.)
+```
+
+### 1. Картинки каталога МАФ (`main/`)
+
+Формат имени файла: `{артикул}.0000.0000.jpg`
+
+Примеры: `0001.0000.0000.jpg`, `1112.0000.0000.jpg`
+
+Поддерживаются форматы: jpg, jpeg, png.
+
+### 2. Картинки запчастей (`spare_parts/`)
+
+Файлы кладутся в корень папки (без подпапок).
+
+Имя файла должно **начинаться с артикула** запчасти. Допускается суффикс после артикула (например, вариант размера).
+
+Примеры:
+- `0000.0000.0041.jpg` — артикул `0000.0000.0041`
+- `0000.0000.0483_50.jpg` — артикул `0000.0000.0483`, вариант 50
+- `BR08.050.jpg` — артикул `BR08.050`
+
+Поддерживаются форматы: jpg, jpeg, png.
+
+> Картинки кешируются на 1 час. После загрузки новых файлов они появятся в системе в течение часа.
+
+### 3. Техническая документация (`tech-docs/`)
+
+Файлы раскладываются **по подпапкам с артикулом** изделия.
+
+Структура:
+```
+tech-docs/
+├── 1112/
+│   ├── 1112.0000.0000 – Габаритные размеры.pdf
+│   ├── 1112.0000.0000 – Инструкция по сборке (Бетон. СУПП).pdf
+│   ├── 1112.0000.0000 – Схема скважин (Бетон. СУПП).pdf
+│   └── 1112.0000.0000 – Схемы установки опор (Бетон. СУПП).pdf
+├── 4005/
+│   └── ...
+```
+
+Типичные документы в папке артикула:
+- Габаритные размеры
+- Инструкция по сборке
+- Схема скважин
+- Схемы установки опор
+
+Формат: PDF.
+
+Эти документы используются при формировании монтажного пакета для площадки и при скачивании архива техдокументации по заказу.
+
+---