ایجاد و مدیریت تیکت‌ها

این راهنما نشان می‌دهد چگونه تیکت بسازید و مدیریت کنید.

ساخت یک تیکت

از رابط کاربری

در نوار کناری فضای کاری روی تیکت‌ها کلیک کنید.
روی تیکت جدید بزنید.
این موارد را پر کنید:
- عنوان — خلاصه‌ای کوتاه. تنها فیلد الزامی است.
- شرح — markdown، همراه با یک نوار ابزار قالب‌بندی.
- وضعیت — برای انجام (پیش‌فرض) یا بک‌لاگ. وضعیت‌های شروع‌شده و پایانی از راه چرخهٔ عمر به دست می‌آیند، نه هنگام ساخت.
- اولویت — هیچ، فوری، بالا، متوسط یا پایین.
- تخصیص‌یافته — خودتان یا هر عاملی در فضای کاری.
- پروژه — گروه‌بندی اختیاری.
روی ایجاد بزنید، یا نخست ایجاد بیشتر را روشن کنید تا پنجره برای ورود سریع باز بماند.

هیچ انتخابگر ارائه‌دهنده‌ای در پنجره نیست. تیکت در برابر ارائه‌دهندهٔ فعال تیکتِ فضای کاری ساخته می‌شود.

از سوی یک عامل

از یک عامل در یک فضا بخواهید:

برای رفع مشکل مهلت ورود در اتصال‌های کند یک تیکت بساز.

این درخواست ابزار MCP با نام create_ticket را فراخوانی می‌کند. اولویت در آن ابزار یک عدد صحیح است، نه یک نام:

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

مقدار	اولویت
`0`	هیچ
`1`	فوری
`2`	بالا
`3`	متوسط
`4`	پایین

تنها workspace_id و title الزامی‌اند؛ description، priority، assignee (شناسهٔ یک عامل) و team_id اختیاری‌اند. این ابزار در دستهٔ «نوشتن در یک ردیاب خارجی» جای می‌گیرد و پیش از اجرا تأیید شما را می‌خواهد.

تغییر وضعیت تیکت

تیکت‌ها این چرخهٔ عمر را دنبال می‌کنند:

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done، failed و cancelled پایانی‌اند. cancelled از هر وضعیت ناپایانی قابل دسترسی است. done و failed از inProgress یا inReview قابل دسترسی‌اند؛ open نیز می‌تواند مستقیم به blocked برود. انتخابگر وضعیت در رابط کاربری همهٔ وضعیت‌ها جز failed را فهرست می‌کند — عامل‌ها آن را با fail_ticket علامت می‌زنند.

برای تغییر آن، از هر یک از این‌ها استفاده کنید:

ردیف وضعیت در ستون ویژگی‌های تیکت،
زیرمنوی وضعیت در منوی راست‌کلیک یک تیکت در فهرست،
چیپ وضعیت روی نوار شناور پس از انتخاب چندگانهٔ تیکت‌ها.

تغییرهای وضعیت رویدادهای دامنه منتشر می‌کنند (TicketStatusChanged، TicketCompleted و دیگران) که می‌توانند پایپ‌لاین‌ها را فعال کنند. راه‌اندازی تریگرهای پایپ‌لاین را ببینید.

تخصیص یک تیکت

تیکت را باز کنید.
در ستون ویژگی‌ها، تخصیص‌یافته را تنظیم کنید — خودتان، عضو دیگری از فضای کاری، یا یک عامل.

افزودن برچسب

برچسب‌ها به‌صورت دسته‌ای از فهرست تیکت‌ها اعمال می‌شوند، نه از یک تیکت تکی — ستون ویژگی‌ها هیچ کنترل برچسبی ندارد.

نشانگر را روی یک ردیف در فهرست تیکت‌ها ببرید و چک‌باکس آن را تیک بزنید. هر تعداد که لازم دارید تیک بزنید؛ به‌محض انتخاب شدن هر چیزی، یک نوار شناور پدیدار می‌شود.
در آن نوار، چیپ برچسب‌ها را باز کنید.
یک برچسب انتخاب کنید. به هر تیکت انتخاب‌شده‌ای که آن را ندارد افزوده می‌شود؛ برچسب‌های موجود هرگز پاک نمی‌شوند. پاک کردن برچسب‌ها همهٔ آن‌ها را برمی‌دارد. انتخابگر برچسب‌هایی را فهرست می‌کند که از قبل روی تیکتی در فضای کاری هستند. عامل‌ها می‌توانند نامی تازه را از راه update_ticket یا tickets.patch بیفزایند.

پیوند دادن تیکت‌ها

روابط روی کارت روابط در ستون ویژگی‌های تیکت قرار دارند، یا پشت ربط دادن به در منوی راست‌کلیک فهرست.

تیکت را باز کنید و کارت روابط را بیابید.
کنترل افزودن آن را بزنید و رابطه را انتخاب کنید:

رابطه	معنا
زیرمسئلهٔ…	والد این تیکت آن یکی است
والدِ…	تیکت دیگر فرزند این یکی است
مسدودشده توسط…	این تیکت توسط آن یکی مسدود شده است
مسدودکنندهٔ…	این تیکت آن یکی را مسدود می‌کند
مرتبط با…	متقارن، بدون جهت ضمنی
تکراری از…	این تیکت تکرار آن یکی است

تیکت مقصد را انتخاب کنید.

تکراری‌شده توسط در کارت ظاهر می‌شود ولی در انتخابگر نیست — وارون تکراری از است و از تیکت دیگر تنظیم می‌شود. هر رابطهٔ فهرست‌شده با کلیک، تیکت پیوندشده را باز می‌کند و با بردن نشانگر روی آن برداشته می‌شود.

رابطه‌های والد و زیرمسئله روی خود تیکت ذخیره می‌شوند، نه به‌صورت ردیف‌های پیوند؛ بنابراین حذف یک والد به فرزندانش آبشار می‌شود (پایین را ببینید)، در حالی که پیوندهای مسدودکننده و مرتبط این‌گونه نیستند.

افزودن همکاران

همکاران یک فهرست روی تیکت‌اند — چه کسی درگیر است و با چه نقشی.

تیکت را باز کنید.
کنترل شخص‌+ روی کارت افزودن همکار را بزنید.
یک عامل انتخاب کنید.

این سه نقش عبارت‌اند از assignee، collaborator (پیش‌فرض) و reviewer. انتخابگر رابط کاربری فقط عامل‌های فضای کاری را فهرست می‌کند و همیشه نقش پیش‌فرض را می‌نویسد؛ انسان‌ها می‌توانند به‌صورت ردیف ظاهر شوند، اما در آن منو عرضه نمی‌شوند. ابزار MCP با نام add_ticket_collaborator یک role می‌پذیرد.

افزودن همکار یک ردیف می‌نویسد و هیچ رویداد دامنه‌ای منتشر نمی‌کند؛ هیچ دسترسی‌ای به فضا نمی‌دهد. برای آوردن یک عامل به یک گفتگو، به‌جای آن آن را از سرصفحهٔ فضا به‌عنوان مشارکت‌کننده بیفزایید — فضاها را ببینید.

حذف یک تیکت

از حذف تیکت در پایین ستون ویژگی‌ها، منوی راست‌کلیک، یا کنش حذف نوار شناور پس از انتخاب چندگانه استفاده کنید.