escolalms/tasks

Escola Headless LMS Tasks

0.1.1 2024-02-16 11:53 UTC

Requires

• php: >=7.4
• escolalms/auth: ^0
• escolalms/core: ^1
• escolalms/settings: ^0
• laravel/framework: >=8.0

Requires (Dev)

• darkaonline/l5-swagger: 8.1.0
• escolalms/courses: ^0.4
• orchestra/testbench: >=5.0
• phpunit/phpunit: ^9.0

MIT

• Tomasz Smolarek

README

What does it do

This package is used to manage user tasks. Users can create their own tasks or assign tasks to other system users.

Tasks can be marked as ready/not ready only by users who created the task. If the task is assigned to another user, a request is sent to checking the correctness of the task. The user sending the request then receives a notification of the task verification status.

Notes can be added to an assignment. Notes can be added by the task author or assigned user. Each note contains information about who created the note.

The packet also has a scheduled task that reminds you of overdue tasks. By default, the reminder period is set to 30 days. No notifications will be sent for tasks older than 30 days.

Installing

• composer require escolalms/tasks
• php artisan migrate
• php artisan db:seed --class="EscolaLms\Tasks\Database\Seeders\TaskPermissionSeeder"

Configuration

In the configuration, you can specify the period until when notifications about overdue tasks should be sent. Parametr możesz określić z poziomu pliku config.php lub ustawień administracyjnych systemu. You can specify the parameter from the config.php file or system administration settings.

Example config.php

[
    'notifications' => [
        'overdue_period' => 14,
    ],
]

Endpoints

All the endpoints are defined in swagger

Test details

Events

• TaskAssignedEvent - The task has been assigned to the user.
• TaskCompleteRequestEvent - A request has been sent to check the correctness of the task.
• TaskCompleteUserConfirmationEvent - The task has been marked as correct.
• TaskIncompleteEvent - The task has not been completed.
• TaskOverdueEvent - Task overdue, time to complete task has run out.
• TaskDeletedEvent - The task has been removed.
• TaskUpdatedEvent - The task has been updated.
• TaskNoteCreatedEvent - A note for the task has been created.

These events are listened to by the escolalms/templates-email package, which sends emails. Additionally, notifications are stored in database.

Permissions

Permissions are defined in seeder