آموزش نصب Planvio روی VPS؛ ساخت مدیر پروژه AI که واقعاً Task و Workflow را اجرا می‌کند

 کرده باشید، احتمالاً با یک مشکل تکراری روبه‌رو شده‌اید: هوش مصنوعی وضعیت پروژه را توضیح می‌دهد، Taskهای عقب‌افتاده را پیدا می‌کند و حتی پیشنهاد می‌دهد چه کاری انجام شود؛ اما در بسیاری از ابزارها، اجرای واقعی کار همچنان بر عهده انسان باقی می‌ماند.

Planvio ایده متفاوتی را دنبال می‌کند. این پروژه متن‌باز و Self-hosted، هوش مصنوعی را به‌عنوان یک لایه اجرایی داخل سیستم مدیریت پروژه قرار می‌دهد؛ یعنی Agent می‌تواند در محدوده مجاز خود Task بسازد، کارها را جابه‌جا کند، مسئولیت‌ها را تغییر دهد، گزارش ایجاد کند و وضعیت پروژه را بررسی کند. نکته مهم‌تر این است که این عملیات از مسیر مجوزها، Policyها و Audit Trail خود برنامه عبور می‌کنند.

Planvio چیست و چرا با یک Chatbot معمولی فرق دارد؟

Planvio یک پلتفرم مدیریت پروژه Self-hosted است که برای کارهایی مثل کمپین‌های بازاریابی، پروژه‌های محصول، عملیات شرکت، پروژه‌های مشتری، منابع انسانی، تحقیق و سایر فعالیت‌های تیمی طراحی شده است. در کنار امکانات کلاسیک مدیریت پروژه، یک لایه AI دارد که می‌تواند روی داده واقعی Workspace کار کند.

تفاوت اصلی در اینجاست: یک Chatbot معمولی ممکن است بگوید «سه Task شما عقب افتاده است». اما یک Agent اجرایی می‌تواند، در صورت داشتن مجوز، همان Taskها را پیدا کند و عملیات مجاز مربوط به آن‌ها را انجام دهد.

طبق مستندات رسمی پروژه، Planvio در حال حاضر مجموعه‌ای از ابزارهای صریح AI را در اختیار Agent قرار می‌دهد و هر ابزار دارای Schema مشخص است. عملیات AI از اعتبارسنجی، بررسی مجوز، محدوده Workspace، اجرای Action و ثبت Audit عبور می‌کند.

مدل‌های AI در Planvio چگونه کار می‌کنند؟

یکی از بخش‌های مهم معماری Planvio، تفکیک سطح اختیار Agent است. این موضوع برای هر کسب‌وکاری که قصد دارد AI را به داده واقعی شرکت متصل کند اهمیت زیادی دارد.

Assistant؛ فقط تحلیل و پاسخ

در این حالت AI می‌تواند داده‌های واقعی پروژه را بررسی کند و پاسخ بدهد، اما تغییری در پروژه ایجاد نمی‌کند. این حالت برای شروع تست سیستم و بررسی کیفیت پاسخ‌ها مناسب است.

Copilot؛ پیشنهاد قبل از اجرا

AI عملیات موردنیاز را پیشنهاد می‌کند، اما انسان قبل از اجرای Action آن را تأیید می‌کند. این مدل برای تیم‌هایی که می‌خواهند ابتدا عملکرد Agent را زیر نظر بگیرند، کاربردی است.

Autonomous؛ اجرای کنترل‌شده

در حالت Autonomous، AI می‌تواند در محدوده‌ای که برای Workspace یا پروژه تعیین شده عملیات را اجرا کند. این حالت به معنی دسترسی نامحدود نیست؛ سیستم همچنان Policy و Permission را اعمال می‌کند و برای عملیات مخرب یا حساس، محدودیت‌هایی وجود دارد.

چه کارهایی را می‌توان با مدیر پروژه AI انجام داد؟

Planvio فقط یک Kanban Board ساده نیست. امکانات پروژه شامل Task، Subtask، Checklist، Dependency، Milestone، Calendar، Timeline، گزارش، بودجه، Time Tracking، Workspace، Role و Permission است.

🔹 ایجاد پروژه و Task با زبان طبیعی

🔹 شکستن یک هدف بزرگ به چند Task و Subtask

🔹 بررسی Taskهای عقب‌افتاده

🔹 تغییر وضعیت Taskها

🔹 تخصیص کار به اعضای تیم

🔹 تحلیل سلامت پروژه

🔹 شناسایی ریسک و کارهای Blocked

🔹 تولید گزارش وضعیت پروژه

🔹 پردازش یادداشت جلسه و تبدیل آن به Task

🔹 اجرای Automationهای زمان‌بندی‌شده یا Event-driven

چرا VPS برای نصب Planvio جذاب است؟

Planvio حتی روی برخی محیط‌های Hosting معمولی نیز قابل اجراست، اما وقتی هدف شما استفاده مداوم از AI، Cron، Queue، ایمیل، گزارش‌ها و چند Workspace باشد، VPS کنترل بیشتری در اختیار شما می‌گذارد.

در VPS می‌توانید منابع CPU و RAM را متناسب با حجم کاربران و عملیات انتخاب کنید، دامنه اختصاصی داشته باشید، HTTPS را مدیریت کنید، تنظیمات PHP-FPM و Nginx را کنترل کنید و در صورت استفاده از مدل‌های محلی، زیرساخت AI را نیز کنار Planvio قرار دهید.

پیش‌نیاز نصب Planvio روی VPS

نسخه فعلی پروژه به PHP 8.3 یا 8.4 نیاز دارد. برای پایگاه داده MySQL 8 یا MariaDB 10.6 به بالا پیشنهاد شده و Nginx، Apache و LiteSpeed نیز در مستندات Deployment پشتیبانی شده‌اند.

نصب Planvio روی VPS؛ روش پیشنهادی

برای محیط Production می‌توانید از Release آماده استفاده کنید. مزیت این روش این است که بسته انتشار، وابستگی‌های Vendor و Assetهای کامپایل‌شده را همراه خود دارد و لازم نیست برای اجرای Production روی VPS، Docker، Redis، Node.js، npm یا Composer را دائماً درگیر کنید.

مرحله اول؛ ساخت کاربر و مسیر برنامه

بهتر است برنامه را خارج از Document Root نگه دارید و فقط پوشه public را در معرض وب قرار دهید.

sudo mkdir -p /var/www/planvio
sudo chown -R $USER:$USER /var/www/planvio
cd /var/www/planvio

مرحله دوم؛ دریافت Release

Release رسمی را از مخزن GitHub پروژه دریافت کنید. نام فایل Release ممکن است با نسخه‌های بعدی تغییر کند؛ بنابراین بهتر است شماره نسخه را از بخش Releases همان مخزن بررسی کنید.

مشاهده Releaseهای رسمی Planvio

مرحله سوم؛ استخراج فایل‌ها

cd /var/www/planvio
unzip planvio-VERSION.zip
chown -R www-data:www-data /var/www/planvio

نام فایل ZIP را با نام Release واقعی جایگزین کنید. اگر سیستم شما از کاربر دیگری برای PHP-FPM استفاده می‌کند، مالکیت فایل‌ها باید مطابق همان کاربر تنظیم شود.

مرحله چهارم؛ ساخت Database

برای Planvio یک Database و User اختصاصی بسازید. استفاده از یک Database مشترک با چند برنامه، مدیریت دسترسی و Backup را پیچیده‌تر می‌کند.

CREATE DATABASE planvio CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'planvio_user'@'localhost' IDENTIFIED BY 'CHANGE_THIS_PASSWORD';
GRANT ALL PRIVILEGES ON planvio.* TO 'planvio_user'@'localhost';
FLUSH PRIVILEGES;

مرحله پنجم؛ تنظیم Document Root

در Nginx، Document Root را روی /var/www/planvio/public قرار دهید. این نکته مهم است زیرا فایل‌های حساس مانند تنظیمات و Credentialهای برنامه نباید مستقیماً از وب قابل دسترسی باشند.

server {
    listen 80;
    listen [::]:80;

```
server_name project.example.com;

root /var/www/planvio/public;
index index.php;

client_max_body_size 24m;

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

location ~ ^/index\.php(/|$) {
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.3-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
    fastcgi_param DOCUMENT_ROOT $realpath_root;
    fastcgi_read_timeout 300;
}

location ~ \.php$ {
    return 404;
}
```

}

مسیر Socket مربوط به PHP-FPM در هر توزیع ممکن است متفاوت باشد. قبل از فعال‌سازی Nginx، مسیر واقعی PHP-FPM سرور خود را بررسی کنید.

مرحله ششم؛ فعال‌سازی HTTPS

بعد از تنظیم DNS دامنه، برای محیط واقعی از HTTPS استفاده کنید. Planvio با داده‌های پروژه، حساب‌های کاربران، فایل‌ها و تنظیمات AI سروکار دارد و اجرای آن روی HTTP معمولی انتخاب مناسبی برای Production نیست.

تنظیم Cron؛ بخش مهم اجرای Workflowهای AI

یکی از اشتباهات رایج در نصب برنامه‌های Laravel این است که برنامه در مرورگر باز می‌شود اما Scheduler و Queue Worker تنظیم نشده‌اند. در Planvio، این موضوع اهمیت بیشتری دارد زیرا برخی Automationها و Jobهای AI باید توسط Queue اجرا شوند.

* * * * * /usr/bin/php8.3 /var/www/planvio/artisan schedule:run >/dev/null 2>&1
*/5 * * * * /usr/bin/php8.3 /var/www/planvio/artisan queue:work database --queue=default,ai --stop-when-empty --max-time=280 --tries=3 >/dev/null 2>&1

Scheduler بهتر است هر دقیقه اجرا شود. Queue Worker نیز طبق مستندات رسمی به‌صورت کوتاه‌مدت اجرا می‌شود، کارهای موجود را پردازش می‌کند و متوقف می‌شود؛ بنابراین برای این معماری الزام به یک Daemon دائمی ندارید.

فعال‌سازی AI در Planvio

Planvio به یک Provider خاص محدود نشده است. طبق مستندات و README پروژه، می‌توان از سرویس‌هایی مانند OpenAI و Anthropic، Endpointهای OpenAI-compatible و Runtimeهای محلی مانند Ollama، LM Studio و vLLM استفاده کرد.

این ویژگی برای VPS اهمیت زیادی دارد. شما می‌توانید یک مدل API-based انتخاب کنید یا در صورت داشتن منابع مناسب، پردازش مدل را روی زیرساخت خودتان قرار دهید.

برای مطالعه جزئیات تنظیم لایه AI، می‌توانید به مستندات رسمی AI در Planvio مراجعه کنید.

ساخت اولین Workflow واقعی با مدیر پروژه AI

حالا فرض کنید یک تیم کوچک دارید و قرار است نسخه جدید سایت شرکت منتشر شود. به‌جای اینکه مدیر پروژه تک‌تک Taskها را دستی بسازد، می‌توانید هدف را به شکل طبیعی به Agent توضیح دهید.

Create a website launch project.

Create tasks for:

* content preparation
* technical SEO
* design review
* staging deployment
* QA
* production deployment

Set dependencies between the tasks
and create a milestone for launch day.

در این سناریو، هدف فقط تولید متن نیست. Agent باید بتواند درخواست را به عملیات داخل سیستم مدیریت پروژه تبدیل کند. اگر Policy و Permission اجازه دهد، Taskها و ارتباطات آن‌ها در خود Planvio ایجاد می‌شوند.

سناریوی دوم؛ مدیریت Taskهای عقب‌افتاده

Find overdue tasks in the website launch project,
group them by assignee,
identify blocked tasks,
and prepare the next actions.

در حالت Assistant، نتیجه بیشتر جنبه تحلیلی دارد. در حالت Copilot، Agent می‌تواند Actionهای پیشنهادی را آماده کند تا مدیر آن‌ها را تأیید کند. در Autonomous، اجرای Actionها فقط در محدوده اختیارات تعریف‌شده انجام می‌شود.

امنیت Agent مهم‌تر از خود AI است

وقتی یک مدل زبانی فقط پاسخ تولید می‌کند، اشتباه آن معمولاً به یک پاسخ اشتباه محدود می‌شود. اما وقتی AI اجازه تغییر Task، تاریخ، مسئول یا وضعیت پروژه را داشته باشد، اشتباه می‌تواند روی داده واقعی اثر بگذارد.

به همین دلیل معماری Planvio از یک اصل مهم استفاده می‌کند: AI نباید بالاتر از سیستم Permission قرار بگیرد.

🔹 AI حساب Administrator مخفی و مستقل ندارد.

🔹 AI نباید Permission کاربر را دور بزند.

🔹 عملیات از مسیر Toolهای تعریف‌شده انجام می‌شود.

🔹 Actionها Audit می‌شوند.

🔹 امکان توقف Autonomous Execution وجود دارد.

🔹 محتوای واردشده توسط کاربران باید به‌عنوان Data غیرقابل‌اعتماد در نظر گرفته شود.

برای جزئیات معماری امنیتی، مستندات AI Security در Planvio را مطالعه کنید.

منابع VPS برای اجرای Planvio چقدر باشد؟

برای یک تیم کوچک که صرفاً خود Planvio، Database، Cron و یک AI API خارجی را اجرا می‌کند، نیاز سخت‌افزاری با سناریوی اجرای مدل محلی تفاوت زیادی دارد.

توجه: این جدول یک نقطه شروع عملی برای انتخاب VPS است، نه حداقل رسمی پروژه. اگر قرار است مدل زبانی را با Ollama یا vLLM روی همان سرور اجرا کنید، اندازه مدل، Quantization، تعداد کاربران هم‌زمان و Context Length می‌توانند نیاز منابع را چند برابر کنند.

Backup و نگهداری؛ بخش فراموش‌شده پروژه‌های AI

وقتی Planvio به مرکز مدیریت پروژه شرکت تبدیل می‌شود، Backup دیگر یک گزینه جانبی نیست. Database، فایل‌های پروژه، تنظیمات و اطلاعات Workspace باید بخشی از برنامه نگهداری باشند.

🔹 از Database به‌صورت منظم Backup بگیرید.

🔹 فایل‌های Attachment را جداگانه در نظر بگیرید.

🔹 Backup را روی همان VPS نگه ندارید.

🔹 قبل از Upgrade نسخه Backup قابل‌بازگشت داشته باشید.

🔹 دسترسی SSH و پنل مدیریت را با احراز هویت مناسب محافظت کنید.

🔹 API Keyهای Providerهای AI را مانند رمز عبور اصلی محافظت کنید.

چه زمانی Planvio انتخاب مناسبی برای یک تیم است؟

اگر نیاز شما فقط یک لیست ساده Todo است، احتمالاً نیازی به یک سیستم Self-hosted با Agent اجرایی ندارید. ارزش Planvio زمانی بیشتر مشخص می‌شود که پروژه‌ها چندمرحله‌ای باشند و بین Taskها، افراد، Milestoneها و گزارش‌ها ارتباط وجود داشته باشد.

🔹 تیم تولید محتوا که Campaignهای متعدد دارد.

🔹 تیم توسعه محصول که Dependencyهای زیادی دارد.

🔹 شرکت خدماتی که چند پروژه مشتری را هم‌زمان مدیریت می‌کند.

🔹 تیم Operations که Workflowهای تکرارشونده دارد.

🔹 تیمی که می‌خواهد داده‌های مدیریت پروژه روی زیرساخت خودش باقی بماند.

🔹 کسب‌وکاری که می‌خواهد AI از مرحله «پیشنهاد» به مرحله «اجرای کنترل‌شده» برسد.

Planvio چه چیزهایی را جایگزین نمی‌کند؟

نباید تصور کرد نصب Planvio به معنی حذف کامل مدیر پروژه یا اعضای تیم است. Agent می‌تواند بسیاری از عملیات تکراری را انجام دهد، اما تصمیم‌های حساس همچنان باید با توجه به Policyهای سازمان و سطح اعتماد موردنظر شما کنترل شوند.

🔹 AI جایگزین مالک پروژه نیست.

🔹 Autonomous به معنی دسترسی نامحدود نیست.

🔹 داده‌های اشتباه می‌توانند خروجی اشتباه ایجاد کنند.

🔹 Workflow ضعیف با AI به‌صورت جادویی به Workflow خوب تبدیل نمی‌شود.

🔹 قبل از اتصال AI به پروژه واقعی، Permission و Approvalها را تست کنید.

مستندات و منابع رسمی Planvio

برای نصب Production، بهتر است همیشه نسخه مستندات متناسب با Release مورد استفاده خود را بررسی کنید:

🔹 مخزن رسمی Planvio در GitHub

🔹 راهنمای نصب رسمی

🔹 راهنمای Deployment و Nginx

🔹 مستندات Autonomous Mode

🔹 مستندات امنیت AI

جمع‌بندی؛ چرا Planvio برای VPS جالب است؟

سؤالات متداول درباره نصب Planvio روی VPS

آیا برای نصب Planvio حتماً Docker لازم است؟

خیر. Release فعلی برای Production به Docker نیاز ندارد و می‌تواند با PHP، MySQL یا MariaDB، Web Server و Cron اجرا شود.

آیا Planvio می‌تواند واقعاً Task ایجاد کند؟

بله، یکی از اهداف اصلی معماری آن همین است. Agent از Toolهای تعریف‌شده برای اجرای عملیات داخل برنامه استفاده می‌کند و عملیات به Permission و Policyهای سیستم وابسته است.

آیا می‌توان Planvio را به Ollama یا vLLM متصل کرد؟

بله. پروژه امکان اتصال به Runtimeهای محلی مانند Ollama و vLLM را فراهم کرده است. برای مدل محلی باید منابع VPS را بر اساس اندازه مدل و حجم درخواست‌ها انتخاب کنید.

آیا حالت Autonomous بدون محدودیت کار می‌کند؟

خیر. Autonomous به معنی دسترسی نامحدود نیست. عملیات همچنان باید از مسیر مجوزها و Policyهای تعریف‌شده عبور کند و برای عملیات حساس محدودیت‌هایی وجود دارد.

چرا Cron در Planvio مهم است؟

Scheduler و Queue Worker برای اجرای Jobهای زمان‌بندی‌شده و پردازش Queue استفاده می‌شوند. بدون تنظیم صحیح آن‌ها ممکن است بعضی Automationها یا Jobهای AI اجرا نشوند.

برای Planvio چه VPSای مناسب است؟

برای شروع یک تیم کوچک، VPS با 2 تا 4 هسته مجازی و حدود 4 تا 8 گیگابایت RAM می‌تواند نقطه شروع مناسبی برای Planvio و AI مبتنی بر API باشد. اجرای مدل محلی نیازمند بررسی جداگانه منابع است.