Refactor: Create shared AttachmentService and AttachmentModel

- Created common AttachmentService for all modules (app/Services/)
- Created common AttachmentModel (app/Models/)
- Created common migration (app/Database/Migrations/)
- Updated Tasks module to use shared AttachmentService
- Added Twig functions: format_filesize(), get_file_icon()
- Removed duplicate TaskAttachmentModel and task_attachments migration
- AttachmentService can be used by any module: task, deal, contact, etc.

app/Database/Migrations/2026-02-08-120000_CreateAttachmentsTable.php

@@ -4,7 +4,7 @@ namespace App\Database\Migrations;
 
 use CodeIgniter\Database\Migration;
 
-class CreateTaskAttachmentsTable extends Migration
+class CreateAttachmentsTable extends Migration
 {
     public function up()
     {
@@ -15,10 +15,15 @@ class CreateTaskAttachmentsTable extends Migration
                 'unsigned'       => true,
                 'auto_increment' => true,
             ],
-            'task_id' => [
+            'entity_type' => [
+                'type'       => 'VARCHAR',
+                'constraint' => 50,
+                'null'       => false,
+                'comment'    => 'Тип сущности: task, deal, contact, etc.',
+            ],
+            'entity_id' => [
                 'type'       => 'INT',
                 'constraint' => 11,
-                'unsigned'   => true,
                 'null'       => false,
             ],
             'file_name' => [
@@ -57,14 +62,14 @@ class CreateTaskAttachmentsTable extends Migration
         ]);
         
         $this->forge->addKey('id', true);
-        $this->forge->addKey('task_id');
+        $this->forge->addKey(['entity_type', 'entity_id']);
-        $this->forge->addForeignKey('task_id', 'tasks', 'id', '', 'CASCADE');
+        $this->forge->addKey('uploaded_by');
         
-        $this->forge->createTable('task_attachments');
+        $this->forge->createTable('attachments');
     }
 
     public function down()
     {
-        $this->forge->dropTable('task_attachments');
+        $this->forge->dropTable('attachments');
     }
 }

app/Libraries/Twig/TwigGlobalsExtension.php

@@ -52,6 +52,10 @@ class TwigGlobalsExtension extends AbstractExtension
             new TwigFunction('is_module_active', [$this, 'isModuleActive'], ['is_safe' => ['html']]),
             new TwigFunction('is_module_available', [$this, 'isModuleAvailable'], ['is_safe' => ['html']]),
             new TwigFunction('csrf_meta', [$this, 'csrf_meta'], ['is_safe' => ['html']]),
+
+            // Attachment functions
+            new TwigFunction('format_filesize', [$this, 'formatFilesize'], ['is_safe' => ['html']]),
+            new TwigFunction('get_file_icon', [$this, 'getFileIcon'], ['is_safe' => ['html']]),
         ];
     }
 
@@ -59,6 +63,42 @@ class TwigGlobalsExtension extends AbstractExtension
     {
         return csrf_meta();
     }
+
+    public function formatFilesize(int $bytes): string
+    {
+        if ($bytes >= 1073741824) {
+            return number_format($bytes / 1073741824, 2) . ' GB';
+        } elseif ($bytes >= 1048576) {
+            return number_format($bytes / 1048576, 2) . ' MB';
+        } elseif ($bytes >= 1024) {
+            return number_format($bytes / 1024, 2) . ' KB';
+        }
+
+        return $bytes . ' B';
+    }
+
+    public function getFileIcon(string $fileType): string
+    {
+        $icons = [
+            'image' => 'fa-file-image',
+            'pdf' => 'fa-file-pdf',
+            'word' => 'fa-file-word',
+            'excel' => 'fa-file-excel',
+            'powerpoint' => 'fa-file-powerpoint',
+            'zip' => 'fa-file-zipper',
+            'text' => 'fa-file-lines',
+            'video' => 'fa-file-video',
+            'audio' => 'fa-file-audio',
+        ];
+
+        foreach ($icons as $key => $icon) {
+            if (stripos($fileType, $key) !== false) {
+                return $icon;
+            }
+        }
+
+        return 'fa-file';
+    }
     // ========================================
     // Access Functions для Twig
     // ========================================

app/Models/AttachmentModel.php

@@ -1,22 +1,19 @@
 <?php
 
-namespace App\Modules\Tasks\Models;
+namespace App\Models;
 
 use CodeIgniter\Model;
-use App\Models\Traits\TenantScopedModel;
 
-class TaskAttachmentModel extends Model
+class AttachmentModel extends Model
 {
-    use TenantScopedModel;
+    protected $table            = 'attachments';
-
-    protected $table            = 'task_attachments';
     protected $primaryKey       = 'id';
     protected $useAutoIncrement = true;
     protected $returnType       = 'array';
     protected $useSoftDeletes   = false;
-    protected $tenantField      = 'task.organization_id';
     protected $allowedFields    = [
-        'task_id',
+        'entity_type',
+        'entity_id',
         'file_name',
         'file_path',
         'file_size',
@@ -28,11 +25,12 @@ class TaskAttachmentModel extends Model
     protected $updatedField  = 'updated_at';
 
     /**
-     * Получить вложения задачи
+     * Получить вложения по типу и ID сущности
      */
-    public function getByTask(int $taskId): array
+    public function getByEntity(string $entityType, int $entityId): array
     {
-        return $this->where('task_id', $taskId)
+        return $this->where('entity_type', $entityType)
+            ->where('entity_id', $entityId)
             ->orderBy('created_at', 'DESC')
             ->findAll();
     }
@@ -45,10 +43,19 @@ class TaskAttachmentModel extends Model
         return $this->find($attachmentId);
     }
 
+    /**
+     * Проверить принадлежность вложения сущности
+     */
+    public function belongsToEntity(string $entityType, int $entityId, int $attachmentId): bool
+    {
+        $attachment = $this->find($attachmentId);
+        return $attachment && $attachment['entity_type'] === $entityType && $attachment['entity_id'] == $entityId;
+    }
+
     /**
      * Удалить вложение
      */
-    public function deleteAttachment(int $attachmentId, int $userId): bool
+    public function deleteAttachment(int $attachmentId): bool
     {
         $attachment = $this->find($attachmentId);
         if (!$attachment) {
@@ -64,6 +71,32 @@ class TaskAttachmentModel extends Model
         return $this->delete($attachmentId);
     }
 
+    /**
+     * Удалить все вложения сущности
+     */
+    public function deleteByEntity(string $entityType, int $entityId): bool
+    {
+        $attachments = $this->where('entity_type', $entityType)
+            ->where('entity_id', $entityId)
+            ->findAll();
+
+        foreach ($attachments as $attachment) {
+            $this->deleteAttachment($attachment['id']);
+        }
+
+        return true;
+    }
+
+    /**
+     * Получить количество вложений сущности
+     */
+    public function countByEntity(string $entityType, int $entityId): int
+    {
+        return $this->where('entity_type', $entityType)
+            ->where('entity_id', $entityId)
+            ->countAllResults();
+    }
+
     /**
      * Получить размер файла в человекочитаемом формате
      */

app/Modules/Tasks/Controllers/TasksController.php

@@ -706,10 +706,10 @@ class TasksController extends BaseController
             throw \CodeIgniter\Exceptions\PageNotFoundException::forPageNotFound('Задача не найдена');
         }
 
-        $attachmentModel = new \App\Modules\Tasks\Models\TaskAttachmentModel();
+        $attachmentModel = new \App\Models\AttachmentModel();
-        $attachment = $attachmentModel->find($attachmentId);
+        $attachment = $attachmentModel->getById($attachmentId);
 
-        if (!$attachment || $attachment['task_id'] != $taskId) {
+        if (!$attachment || $attachment['entity_type'] !== 'task' || $attachment['entity_id'] != $taskId) {
             throw \CodeIgniter\Exceptions\PageNotFoundException::forPageNotFound('Вложение не найдено');
         }
 

app/Modules/Tasks/Services/TaskService.php

@@ -6,7 +6,7 @@ use App\Modules\Tasks\Models\TaskModel;
 use App\Modules\Tasks\Models\TaskAssigneeModel;
 use App\Modules\Tasks\Models\TaskColumnModel;
 use App\Modules\Tasks\Models\TaskSubtaskModel;
-use App\Modules\Tasks\Models\TaskAttachmentModel;
+use App\Services\AttachmentService;
 use CodeIgniter\Events\Events;
 
 class TaskService
@@ -15,7 +15,7 @@ class TaskService
     protected TaskAssigneeModel $assigneeModel;
     protected TaskColumnModel $columnModel;
     protected TaskSubtaskModel $subtaskModel;
-    protected TaskAttachmentModel $attachmentModel;
+    protected AttachmentService $attachmentService;
 
     public function __construct()
     {
@@ -23,7 +23,7 @@ class TaskService
         $this->assigneeModel = new TaskAssigneeModel();
         $this->columnModel = new TaskColumnModel();
         $this->subtaskModel = new TaskSubtaskModel();
-        $this->attachmentModel = new TaskAttachmentModel();
+        $this->attachmentService = new AttachmentService();
     }
 
     /**
@@ -183,8 +183,8 @@ class TaskService
         $task['subtasks'] = $this->subtaskModel->getByTask($taskId);
         $task['subtasks_count'] = count($task['subtasks']);
         $task['subtasks_completed'] = count(array_filter($task['subtasks'], fn($s) => $s['is_completed']));
-        $task['attachments'] = $this->attachmentModel->getByTask($taskId);
+        $task['attachments'] = $this->attachmentService->getByEntity('task', $taskId);
-        $task['attachments_count'] = count($task['attachments']);
+        $task['attachments_count'] = $this->attachmentService->count('task', $taskId);
 
         return $task;
     }
@@ -355,45 +355,14 @@ class TaskService
         return $result;
     }
 
-    // ========== Вложения (Attachments) ==========
+    // ========== Вложения (Attachments) - используем общий AttachmentService ==========
 
     /**
      * Загрузить вложение
      */
     public function uploadAttachment(int $taskId, array $file, int $userId): ?int
     {
-        $uploadPath = WRITEPATH . 'uploads/tasks/' . $taskId . '/';
+        return $this->attachmentService->upload('task', $taskId, $file, $userId);
-        
-        // Создаём директорию если не существует
-        if (!is_dir($uploadPath)) {
-            mkdir($uploadPath, 0755, true);
-        }
-
-        // Генерируем уникальное имя файла
-        $originalName = $file['name'];
-        $extension = pathinfo($originalName, PATHINFO_EXTENSION);
-        $newFileName = uniqid() . '_' . time() . '.' . $extension;
-        $filePath = $uploadPath . $newFileName;
-
-        // Перемещаем загруженный файл
-        if (!move_uploaded_file($file['tmp_name'], $filePath)) {
-            return null;
-        }
-
-        $attachmentId = $this->attachmentModel->insert([
-            'task_id' => $taskId,
-            'file_name' => $originalName,
-            'file_path' => $filePath,
-            'file_size' => $file['size'],
-            'file_type' => $file['type'] ?? '',
-            'uploaded_by' => $userId,
-        ]);
-
-        if ($attachmentId) {
-            Events::trigger('task.attachment_uploaded', $taskId, $attachmentId, $userId);
-        }
-
-        return $attachmentId;
     }
 
     /**
@@ -401,17 +370,6 @@ class TaskService
      */
     public function deleteAttachment(int $taskId, int $attachmentId, int $userId): bool
     {
-        $attachment = $this->attachmentModel->find($attachmentId);
+        return $this->attachmentService->delete('task', $taskId, $attachmentId, $userId);
-        if (!$attachment || $attachment['task_id'] != $taskId) {
-            return false;
-        }
-
-        $result = $this->attachmentModel->deleteAttachment($attachmentId, $userId);
-
-        if ($result) {
-            Events::trigger('task.attachment_deleted', $taskId, $attachmentId, $userId);
-        }
-
-        return $result;
     }
 }

app/Modules/Tasks/Views/tasks/show.twig

@@ -155,13 +155,13 @@
                     <ul class="list-group list-group-flush mb-3" id="attachments-list">
                         {% for attachment in task.attachments %}
                             <li class="list-group-item d-flex align-items-center gap-2" data-attachment-id="{{ attachment.id }}">
-                                <i class="fa-solid fa-file text-muted"></i>
+                                <i class="fa-solid {{ get_file_icon(attachment.file_type) }} text-muted"></i>
                                 <a href="{{ base_url('/tasks/' ~ task.id ~ '/attachments/' ~ attachment.id ~ '/download') }}" 
                                    target="_blank" class="flex-grow-1 text-decoration-none">
                                     {{ attachment.file_name }}
                                 </a>
                                 <small class="text-muted">
-                                    {{ attachment.file_size|filesize }}
+                                    {{ format_filesize(attachment.file_size) }}
                                 </small>
                                 <button type="button" class="btn btn-outline-danger btn-sm"
                                         onclick="deleteAttachment({{ task.id }}, {{ attachment.id }})"

app/Services/AttachmentService.php

@@ -0,0 +1,116 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\AttachmentModel;
+use CodeIgniter\Events\Events;
+
+class AttachmentService
+{
+    protected AttachmentModel $attachmentModel;
+
+    public function __construct()
+    {
+        $this->attachmentModel = new AttachmentModel();
+    }
+
+    /**
+     * Загрузить вложение
+     */
+    public function upload(string $entityType, int $entityId, array $file, int $userId): ?int
+    {
+        $uploadPath = WRITEPATH . 'uploads/' . $entityType . '/' . $entityId . '/';
+        
+        // Создаём директорию если не существует
+        if (!is_dir($uploadPath)) {
+            mkdir($uploadPath, 0755, true);
+        }
+
+        // Генерируем уникальное имя файла
+        $originalName = $file['name'];
+        $extension = pathinfo($originalName, PATHINFO_EXTENSION);
+        $newFileName = uniqid() . '_' . time() . '.' . $extension;
+        $filePath = $uploadPath . $newFileName;
+
+        // Перемещаем загруженный файл
+        if (!move_uploaded_file($file['tmp_name'], $filePath)) {
+            return null;
+        }
+
+        $attachmentId = $this->attachmentModel->insert([
+            'entity_type' => $entityType,
+            'entity_id' => $entityId,
+            'file_name' => $originalName,
+            'file_path' => $filePath,
+            'file_size' => $file['size'],
+            'file_type' => $file['type'] ?? '',
+            'uploaded_by' => $userId,
+        ]);
+
+        if ($attachmentId) {
+            Events::trigger('attachment.uploaded', [
+                'entity_type' => $entityType,
+                'entity_id' => $entityId,
+                'attachment_id' => $attachmentId,
+                'user_id' => $userId,
+            ]);
+        }
+
+        return $attachmentId;
+    }
+
+    /**
+     * Удалить вложение
+     */
+    public function delete(string $entityType, int $entityId, int $attachmentId, int $userId): bool
+    {
+        if (!$this->attachmentModel->belongsToEntity($entityType, $entityId, $attachmentId)) {
+            return false;
+        }
+
+        $result = $this->attachmentModel->deleteAttachment($attachmentId);
+
+        if ($result) {
+            Events::trigger('attachment.deleted', [
+                'entity_type' => $entityType,
+                'entity_id' => $entityId,
+                'attachment_id' => $attachmentId,
+                'user_id' => $userId,
+            ]);
+        }
+
+        return $result;
+    }
+
+    /**
+     * Получить вложения сущности
+     */
+    public function getByEntity(string $entityType, int $entityId): array
+    {
+        return $this->attachmentModel->getByEntity($entityType, $entityId);
+    }
+
+    /**
+     * Получить количество вложений
+     */
+    public function count(string $entityType, int $entityId): int
+    {
+        return $this->attachmentModel->countByEntity($entityType, $entityId);
+    }
+
+    /**
+     * Получить иконку файла
+     */
+    public function getFileIcon(string $fileType): string
+    {
+        return $this->attachmentModel->getFileIcon($fileType);
+    }
+
+    /**
+     * Форматировать размер файла
+     */
+    public function formatSize(int $bytes): string
+    {
+        return $this->attachmentModel->formatSize($bytes);
+    }
+}