karnoweb / task-manager

13.0.1 2026-11-02 08:46 UTC

Requires

• php: ^8.3
• illuminate/database: ^13.0
• illuminate/events: ^13.0
• illuminate/support: ^13.0

Requires (Dev)

• laravel/pint: ^1.32
• orchestra/testbench: ^11.0
• phpstan/phpstan: ^2.3
• phpunit/phpunit: ^12.0
• rector/rector: ^2.0

Suggests

• ext-curl: Required by the default pinned HTTPS webhook transport.
• ext-intl: Required for Persian/Jalali recurrence; enables Unicode normalization.

MIT

Published on Packagist.org on 2026-11-02 08:46 UTC

README

پکیج مستقل Laravel برای کار شخصی، پروژه و موتور گردش‌کار. Todo به Project، Pipeline، Kanban، Calendar یا CRM نیاز ندارد.

نصب

وابستگی پکیج: PHP ^8.3 و Illuminate ^13.0؛ الزامات Laravel 13 میزبان نیز برقرار باشند. در رجیستری تنظیم‌شده سازمان:

composer require karnoweb/task-manager
php artisan migrate

برای مخزن محلی و تنظیمات، راهنمای نصب را ببینید. انتشار config برای شروع لازم نیست.

نخستین Todo

پس از ثبت UserResolver (حل‌کننده هویت) در میزبان طبق راهنمای اتصال:

<?php
use Illuminate\Support\Str;
use Karnoweb\TaskManager\Facades\TaskManager;

$operation = (string) Str::uuid(); // برای تلاش مجدد همین فرمان، همین مقدار را نگه دارید.

return TaskManager::tasks()->inContext()->create('تماس با مشتری', $operation);

خروجی TaskResult (شیء داده نتیجه) شامل publicKey، state و version است. هویت فقط از حل‌کننده ثبت‌شده میزبان خوانده می‌شود؛ نبود حل‌کننده یا کاربر خطا دارد. با شعبه غیرفعال، Scope (قلمرو جداسازی) پیش‌فرض default است؛ با شعبه فعال branch:<شناسه> اعمال می‌شود؛ برای داده‌های موجود نگاشت قبلی را در تنظیم Resolverها حفظ کنید. شروع سریع و مثال کامل.

راهنما

• مسیر مطالعه پایه، پیشرفته و داخلی
• ساخت مستقیم Task پروژه
• گردش‌کار مستقل و محافظ سفارشی
• آزمون، محدودیت محیط و رفع خطا
• ۱۵ سناریوی اجرایی جامع فارسی

آزمون در ریشه مخزن پکیج: php vendor/phpunit/phpunit/phpunit --do-not-cache-result. پایگاه آزمایش باید اختصاصی باشد؛ آزمون‌ها ساختار آن را بازسازی می‌کنند.

پیشوند جداول نصب تازه با task-manager.table_prefix تنظیم می‌شود؛ پیش‌فرض tm_ است. راهنمای پایگاه داده.