اعلام تغییرات محصول

معرفی

برای تغییرهایی که کاربر در محصول می‌بیند یک خبر کوتاه بنویسید. هر نسخه با نسخه و تاریخش شناخته می‌شود و همهٔ تغییرهای آن از ابتدا دیده می‌شوند. هیچ دکمهٔ «جزئیات بیشتر»، آکاردئون یا پاراگراف توضیح در آخرین تغییرات وجود ندارد.

نمونه بصری

هر نسخه و هر تیتر همیشه دیده می‌شود

1. نسخه‌ها از جدید به قدیم‌اند و هر کدام تاریخ دارند.
2. هر تغییر یک changes.text کوتاه است: نتیجه‌ای که کاربر اکنون می‌بیند یا کاری که می‌تواند انجام دهد.
3. priority عددی بزرگ‌تر مقدم است؛ تساوی، ترتیب ورودی را نگه می‌دارد. بدون اولویت صریح، تغییر مهم، قابلیت جدید، بهبود و رفع اشکال به‌ترتیب نمایش داده می‌شوند.
4. تصویر اختیاری با alt، کامل و بدون برش کنار همان تیتر می‌آید؛ لینک اقدام به همان تغییر تعلق دارد.
5. details و body قدیمی در داده می‌مانند و نمایش ندارند. summary فقط وقتی تغییرها خالی باشند یک بولت جایگزین است.

پنل هر نسخه را در یک کارت نشان می‌دهد. مودال همهٔ تیترهای یک انتشار مهم را دارد. صفحهٔ کامل تاریخچهٔ همهٔ نسخه‌های منتشرشده است. یک تغییر به عنوان کل نسخه تبدیل نمی‌شود و هیچ نوعی پشت شمارنده پنهان نمی‌ماند.

بودجهٔ اعلان

همهٔ کانال‌ها در پنل و صفحهٔ تاریخچه می‌آیند. کانال اندازهٔ خبر را تعیین می‌کند، نه باز یا بسته بودن تیترها. در هدر از WhatsNewBell variant="version" استفاده کنید؛ اعلان‌های عملیاتی کاربر از مرکز اعلان‌ها می‌آیند.

پیاده‌سازی

فید را در مخزن محصول با defineReleaseFeed اعتبارسنجی کنید. هوک useWhatsNew را یک‌بار در پوسته فراخوانی کنید و پنل و مودال را به همان وضعیت وصل کنید؛ شناسهٔ خبر پس از انتشار تغییر نکند.

import { defineReleaseFeed } from '@partodata/ui/release-notes'

export const whatsNewFeed = defineReleaseFeed({
  product: 'monitoring',
  notes: [
    {
      id: 'report-scheduling',
      date: '2026-07-14',
      version: '4.1.0',
      channel: 'announce',
      changes: [
        {
          type: 'feature',
          text: 'گزارش‌ها را زمان‌بندی کنید',
          priority: 20,
          cta: { label: 'زمان‌بندی گزارش', href: '/reports/schedule' },
        },
        { type: 'fix', text: 'تاریخ شمسی در عنوان ایمیل درست نمایش داده می‌شود', priority: 10 },
      ],
    },
  ],
})

تیترها رسمی، مشخص و رو به کاربر باشند. ارقام در داده لاتین‌اند و فونت فارسی شکل دیداری آن‌ها را می‌سازد. برای یک تغییر تصویر بگذارید که نتیجه را روشن‌تر کند؛ تصویر بی‌توضیح یا متن جایگزین «عکس» کافی نیست.

رفتار دسترسی‌پذیر و دیده‌شدن

نسخه و تاریخ تنها سرتیتر انتشارند و تغییرها اعضای فهرست‌اند. همهٔ تیترها در ترتیب خواندن DOM حاضرند. پنل و مودال با Escape بسته می‌شوند؛ triggerRef فوکوس را به کنترل بازکننده برمی‌گرداند. بدنهٔ پیمایش‌پذیر توقف Tab دارد. اولین بازدید ساکت است؛ پنل هنگام بازشدن خبرها را دیده‌شده می‌کند و مودال هنگام نمایش ثبت می‌شود.

راهنماهای مرتبط

• WhatsNew: کامپوننت‌ها، فید و Props
• ReleaseTimeline: صفحهٔ کامل همهٔ نسخه‌ها
• useWhatsNew: وضعیت، ذخیره‌سازی و کانال‌ها
• NotificationCenter: نتیجهٔ عملیات کاربر