454 lines
13 KiB
Markdown
454 lines
13 KiB
Markdown
# План доработки модуля Tasks
|
||
|
||
> На основе ТЗ п.3.6 и анализа текущего состояния кода
|
||
|
||
---
|
||
|
||
## Этап 1: Базовые улучшения (Critical)
|
||
|
||
### 1.1 RBAC — добавить проверку прав
|
||
|
||
**Файлы:** `TasksController.php`
|
||
|
||
```php
|
||
// Добавить в начало методов:
|
||
public function store()
|
||
{
|
||
if (!$this->access->canCreate('tasks')) {
|
||
return $this->forbiddenResponse('Нет прав для создания задач');
|
||
}
|
||
}
|
||
|
||
public function edit(int $id)
|
||
{
|
||
if (!$this->access->canEdit('tasks')) {
|
||
return $this->forbiddenResponse('Нет прав для редактирования');
|
||
}
|
||
}
|
||
```
|
||
|
||
**Аналогично:** `update()`, `destroy()`, `moveColumn()`, `complete()`, `reopen()`
|
||
|
||
### 1.2 Валидация входных данных
|
||
|
||
**Файлы:** `TasksController.php`
|
||
|
||
```php
|
||
public function store()
|
||
{
|
||
$validation = \Config\Services::validation();
|
||
$validation->setRules([
|
||
'title' => 'required|min_length[3]|max_length[255]',
|
||
'board_id' => 'required|integer',
|
||
'column_id' => 'required|integer',
|
||
'priority' => 'in_list[low,medium,high,urgent]',
|
||
'due_date' => 'valid_date',
|
||
]);
|
||
|
||
if (!$validation->withRequest($this->request)->run()) {
|
||
return redirect()->back()->withErrors($validation->getErrors())->withInput();
|
||
}
|
||
}
|
||
```
|
||
|
||
### 1.3 Исправить Events нейминг
|
||
|
||
**Файл:** `TaskService.php`
|
||
|
||
```php
|
||
// Было:
|
||
Events::trigger('tasks.created', $taskId, $data, $userId);
|
||
|
||
// Стало (согласно ТЗ и документации):
|
||
Events::trigger('task.created', $taskId, $data, $userId);
|
||
```
|
||
|
||
**Аналогично:** `task.updated`, `task.column_changed`, `task.completed`, `task.reopened`
|
||
|
||
---
|
||
|
||
## Этап 2: Подзадачи (Subtasks)
|
||
|
||
### 2.1 Миграция
|
||
|
||
```php
|
||
// database/migrations/2026-02-08-CreateTaskSubtasksTable.php
|
||
public function up()
|
||
{
|
||
$this->forge->addField([
|
||
'id' => ['type' => 'INT', 'auto_increment' => true],
|
||
'task_id' => ['type' => 'INT'],
|
||
'title' => ['type' => 'VARCHAR', 'constraint' => 255],
|
||
'is_completed' => ['type' => 'BOOLEAN', 'default' => false],
|
||
'order_index' => ['type' => 'INT', 'default' => 0],
|
||
'created_at' => ['type' => 'DATETIME'],
|
||
'updated_at' => ['type' => 'DATETIME'],
|
||
]);
|
||
$this->forge->addKey('id', true);
|
||
$this->forge->addForeignKey('task_id', 'tasks', 'id', 'CASCADE', 'CASCADE');
|
||
$this->forge->createTable('task_subtasks');
|
||
}
|
||
```
|
||
|
||
### 2.2 Модель
|
||
|
||
```php
|
||
// app/Modules/Tasks/Models/TaskSubtaskModel.php
|
||
class TaskSubtaskModel extends Model
|
||
{
|
||
use TenantScopedModel;
|
||
protected $table = 'task_subtasks';
|
||
protected $tenantField = 'task.organization_id'; // через task relationship
|
||
|
||
protected $allowedFields = ['task_id', 'title', 'is_completed', 'order_index'];
|
||
}
|
||
```
|
||
|
||
### 2.3 API
|
||
|
||
```php
|
||
// TasksController.php
|
||
public function addSubtask(int $taskId)
|
||
{
|
||
$data = [
|
||
'task_id' => $taskId,
|
||
'title' => $this->request->getPost('title'),
|
||
'order_index' => $this->subtaskModel->getNextOrder($taskId),
|
||
];
|
||
$this->subtaskModel->insert($data);
|
||
return redirect()->to("/tasks/{$taskId}");
|
||
}
|
||
|
||
public function toggleSubtask(int $taskId, int $subtaskId)
|
||
{
|
||
$subtask = $this->subtaskModel->find($subtaskId);
|
||
$this->subtaskModel->update($subtaskId, [
|
||
'is_completed' => !$subtask['is_completed']
|
||
]);
|
||
}
|
||
```
|
||
|
||
### 2.4 View
|
||
|
||
```twig
|
||
{# tasks/show.twig #}
|
||
<div class="subtasks">
|
||
{% for subtask in task.subtasks %}
|
||
<div class="subtask {{ subtask.is_completed ? 'completed' }}">
|
||
<input type="checkbox" {{ subtask.is_completed ? 'checked' }}
|
||
onchange="toggleSubtask({{ subtask.id }})">
|
||
{{ subtask.title }}
|
||
</div>
|
||
{% endfor %}
|
||
<input type="text" placeholder="Добавить подзадачу...">
|
||
</div>
|
||
```
|
||
|
||
---
|
||
|
||
## Этап 3: Чек-листы (Checklists)
|
||
|
||
> Аналогично подзадачам, но чек-листы — это произвольные списки внутри задачи
|
||
|
||
### 3.1 Структура
|
||
|
||
```
|
||
task_checklists
|
||
├── id
|
||
├── task_id
|
||
├── title (например "Подготовка к встрече")
|
||
└── items (JSON array или связанная таблица)
|
||
|
||
task_checklist_items
|
||
├── id
|
||
├── checklist_id
|
||
├── text
|
||
├── is_completed
|
||
└── order_index
|
||
```
|
||
|
||
---
|
||
|
||
## Этап 4: Вложения (Attachments)
|
||
|
||
### 4.1 Миграция
|
||
|
||
```php
|
||
// database/migrations/2026-02-08-CreateTaskAttachmentsTable.php
|
||
public function up()
|
||
{
|
||
$this->forge->addField([
|
||
'id' => ['type' => 'INT', 'auto_increment' => true],
|
||
'task_id' => ['type' => 'INT'],
|
||
'file_name' => ['type' => 'VARCHAR', 'constraint' => 255],
|
||
'file_path' => ['type' => 'VARCHAR', 'constraint' => 500],
|
||
'file_size' => ['type' => 'INT'],
|
||
'file_type' => ['type' => 'VARCHAR', 'constraint' => 100],
|
||
'uploaded_by' => ['type' => 'INT'],
|
||
'created_at' => ['type' => 'DATETIME'],
|
||
]);
|
||
$this->forge->addKey('id', true);
|
||
$this->forge->addForeignKey('task_id', 'tasks', 'id', 'CASCADE', 'CASCADE');
|
||
$this->forge->createTable('task_attachments');
|
||
}
|
||
```
|
||
|
||
### 4.2 Загрузка файлов
|
||
|
||
```php
|
||
// TasksController.php
|
||
public function uploadAttachment(int $taskId)
|
||
{
|
||
$file = $this->request->getFile('file');
|
||
if ($file->isValid()) {
|
||
$uploadedPath = $this->uploadService->upload($file, "tasks/{$taskId}");
|
||
$this->attachmentModel->insert([
|
||
'task_id' => $taskId,
|
||
'file_name' => $file->getName(),
|
||
'file_path' => $uploadedPath,
|
||
'file_size' => $file->getSize(),
|
||
'file_type' => $file->getMimeType(),
|
||
'uploaded_by' => $this->getCurrentUserId(),
|
||
]);
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Этап 5: Комментарии
|
||
|
||
### 5.1 Миграция
|
||
|
||
```php
|
||
// database/migrations/2026-02-08-CreateTaskCommentsTable.php
|
||
public function up()
|
||
{
|
||
$this->forge->addField([
|
||
'id' => ['type' => 'INT', 'auto_increment' => true],
|
||
'task_id' => ['type' => 'INT'],
|
||
'user_id' => ['type' => 'INT'],
|
||
'content' => ['type' => 'TEXT'],
|
||
'mentioned_users' => ['type' => 'JSON'], // массив user_id для @mentions
|
||
'created_at' => ['type' => 'DATETIME'],
|
||
'updated_at' => ['type' => 'DATETIME'],
|
||
]);
|
||
$this->forge->addKey('id', true);
|
||
$this->forge->addForeignKey('task_id', 'tasks', 'id', 'CASCADE', 'CASCADE');
|
||
$this->forge->createTable('task_comments');
|
||
}
|
||
```
|
||
|
||
### 5.2 Обработка @mentions
|
||
|
||
```php
|
||
// TaskCommentService.php
|
||
public function parseMentions(string $content): array
|
||
{
|
||
preg_match_all('/@(\d+)/', $content, $matches);
|
||
return $matches[1] ?? [];
|
||
}
|
||
|
||
public function createComment(int $taskId, int $userId, string $content): int
|
||
{
|
||
$mentionedUsers = $this->parseMentions($content);
|
||
|
||
$commentId = $this->commentModel->insert([
|
||
'task_id' => $taskId,
|
||
'user_id' => $userId,
|
||
'content' => $content,
|
||
'mentioned_users' => json_encode($mentionedUsers),
|
||
]);
|
||
|
||
// Уведомить упомянутых пользователей
|
||
foreach ($mentionedUsers as $mentionedUserId) {
|
||
$this->notificationService->create([
|
||
'user_id' => $mentionedUserId,
|
||
'type' => 'mention',
|
||
'message' => "Вас упомянули в задаче",
|
||
'link' => "/tasks/{$taskId}",
|
||
]);
|
||
}
|
||
|
||
return $commentId;
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Этап 6: Зависимости задач
|
||
|
||
### 6.1 Миграция
|
||
|
||
```php
|
||
// database/migrations/2026-02-08-CreateTaskDependenciesTable.php
|
||
public function up()
|
||
{
|
||
$this->forge->addField([
|
||
'id' => ['type' => 'INT', 'auto_increment' => true],
|
||
'blocking_task_id' => ['type' => 'INT'], // задача, которая блокирует
|
||
'blocked_task_id' => ['type' => 'INT'], // задача, которая заблокирована
|
||
'dependency_type' => ['type' => 'ENUM', 'options' => ['blocks', 'depends_on']],
|
||
'created_at' => ['type' => 'DATETIME'],
|
||
]);
|
||
$this->forge->addKey('id', true);
|
||
$this->forge->addForeignKey('blocking_task_id', 'tasks', 'id', 'CASCADE', 'CASCADE');
|
||
$this->forge->addForeignKey('blocked_task_id', 'tasks', 'id', 'CASCADE', 'CASCADE');
|
||
$this->forge->createTable('task_dependencies');
|
||
}
|
||
```
|
||
|
||
### 6.2 Проверка при изменении статуса
|
||
|
||
```php
|
||
// TaskService.php
|
||
public function completeTask(int $taskId, int $userId): bool
|
||
{
|
||
// Проверить зависимости
|
||
$blockingTasks = $this->getBlockingTasks($taskId);
|
||
if (!empty($blockingTasks)) {
|
||
foreach ($blockingTasks as $blocking) {
|
||
if (!$blocking['is_completed']) {
|
||
throw new \Exception("Задача заблокирована: {$blocking['title']}");
|
||
}
|
||
}
|
||
}
|
||
|
||
return parent::completeTask($taskId, $userId);
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Этап 7: Интеграция с CRM
|
||
|
||
### 7.1 События CRM → Tasks
|
||
|
||
```php
|
||
// app/Config/Events.php
|
||
|
||
// При создании сделки
|
||
Events::on('deal.created', function ($deal, $userId) {
|
||
service('eventManager')
|
||
->forModule('crm')
|
||
->moduleOn('deal.created', function ($deal, $userId) {
|
||
if (service('moduleSubscription')->isModuleActive('tasks')) {
|
||
$taskService = service('taskService');
|
||
$taskService->createTask([
|
||
'title' => "Первичный контакт: {$deal['title']}",
|
||
'description' => 'Сделка создана, необходимо связаться с клиентом',
|
||
'priority' => 'high',
|
||
'due_date' => date('Y-m-d', strtotime('+1 day')),
|
||
], $userId);
|
||
}
|
||
});
|
||
});
|
||
|
||
// При переводе на этап "Коммерческое предложение"
|
||
Events::on('deal.stage_changed', function ($deal, $oldStage, $newStage, $userId) {
|
||
if ($newStage === 'proposal') {
|
||
// Создать задачу на подготовку КП
|
||
}
|
||
});
|
||
|
||
// При завершении сделки
|
||
Events::on('deal.won', function ($deal, $userId) {
|
||
// Создать задачу "Благодарность клиенту"
|
||
});
|
||
```
|
||
|
||
### 7.2 Задачи в карточке клиента
|
||
|
||
```php
|
||
// CRM/Controllers/ClientsController.php
|
||
public function view(int $id)
|
||
{
|
||
$client = $this->clientModel->find($id);
|
||
$tasks = $this->taskService->getByClientId($id); // метод для получения задач клиента
|
||
|
||
return $this->renderTwig('@CRM/Clients/view', [
|
||
'client' => $client,
|
||
'tasks' => $tasks,
|
||
]);
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## Этап 8: Интеграция с Booking
|
||
|
||
### 8.1 События Booking → Tasks
|
||
|
||
```php
|
||
// При создании записи
|
||
Events::on('booking.created', function ($booking, $userId) {
|
||
// Создать задачу на подготовку к встрече
|
||
});
|
||
```
|
||
|
||
---
|
||
|
||
## Приоритеты реализации
|
||
|
||
| Приоритет | Задача | Оценка |
|
||
|-----------|--------|--------|
|
||
| P0 | RBAC (права доступа) | 2ч |
|
||
| P0 | Валидация | 2ч |
|
||
| P1 | Подзадачи (subtasks) | 8ч |
|
||
| P1 | Чек-листы | 6ч |
|
||
| P1 | Вложения | 8ч |
|
||
| P2 | Комментарии + @mentions | 12ч |
|
||
| P2 | Зависимости задач | 6ч |
|
||
| P2 | Интеграция CRM → Tasks | 8ч |
|
||
| P3 | Интеграция Booking → Tasks | 4ч |
|
||
|
||
**Общая оценка:** ~56 часов
|
||
|
||
---
|
||
|
||
## Зависимости между этапами
|
||
|
||
```
|
||
Этап 1 (RBAC + валидация) → нужен перед всеми
|
||
|
||
Этап 2 (subtasks) → зависит от 1
|
||
Этап 3 (checklists) → зависит от 1
|
||
Этап 4 (attachments) → зависит от 1
|
||
|
||
Этап 5 (comments) → зависит от 2
|
||
Этап 6 (dependencies) → зависит от 1
|
||
|
||
Этап 7 (CRM integration) → зависит от 5
|
||
Этап 8 (Booking integration) → зависит от 1
|
||
```
|
||
|
||
---
|
||
|
||
## Модели для создания/обновления
|
||
|
||
```
|
||
app/Modules/Tasks/Models/
|
||
├── TaskModel.php (существует)
|
||
├── TaskColumnModel.php (существует)
|
||
├── TaskBoardModel.php (существует)
|
||
├── TaskAssigneeModel.php (существует)
|
||
├── TaskSubtaskModel.php ✨ НОВАЯ
|
||
├── TaskChecklistModel.php ✨ НОВАЯ
|
||
├── TaskChecklistItemModel.php ✨ НОВАЯ
|
||
├── TaskAttachmentModel.php ✨ НОВАЯ
|
||
└── TaskCommentModel.php ✨ НОВАЯ
|
||
```
|
||
|
||
---
|
||
|
||
## Контроллеры
|
||
|
||
```
|
||
app/Modules/Tasks/Controllers/
|
||
├── TasksController.php (существует)
|
||
├── TaskApiController.php (существует)
|
||
├── TaskSubtasksController.php ✨ НОВЫЙ
|
||
├── TaskAttachmentsController.php ✨ НОВЫЙ
|
||
└── TaskCommentsController.php ✨ НОВЫЙ
|
||
```
|