feat: add subscription announce settings

x0sina · x0sina · commit 3fb5e428bbd5 · 2025-11-04T12:18:49.000+03:30
diff --git a/dashboard/public/statics/locales/en.json b/dashboard/public/statics/locales/en.json
@@ -200,6 +200,12 @@
         "profileTitle": "Profile Title",
         "profileTitlePlaceholder": "My VPN Service",
         "profileTitleDescription": "Display name for the subscription profile",
+        "announce": "Announcement",
+        "announcePlaceholder": "Service maintenance starts at 02:00",
+        "announceDescription": "Short message shown to users in supported subscription clients",
+        "announceUrl": "Announcement URL",
+        "announceUrlPlaceholder": "https://status.example.com",
+        "announceUrlDescription": "Optional link with more information about the announcement",
         "hostStatusFilter": "Host Status Filter",
         "hostStatusFilterDescription": "Filter hosts based on their status"
       },
diff --git a/dashboard/public/statics/locales/fa.json b/dashboard/public/statics/locales/fa.json
@@ -107,6 +107,12 @@
         "profileTitle": "عنوان پروفایل",
         "profileTitlePlaceholder": "سرویس VPN من",
         "profileTitleDescription": "نام نمایشی برای پروفایل اشتراک",
+        "announce": "متن اطلاعیه",
+        "announcePlaceholder": "سرویس امشب ساعت ۰۲:۰۰ در دسترس نیست",
+        "announceDescription": "پیام کوتاهی که در کلاینت‌های سازگار نمایش داده می‌شود",
+        "announceUrl": "آدرس اطلاعیه",
+        "announceUrlPlaceholder": "https://status.example.com",
+        "announceUrlDescription": "لینک اختیاری برای جزئیات بیشتر اطلاعیه",
         "hostStatusFilter": "فیلتر وضعیت هاست",
         "hostStatusFilterDescription": "فیلتر کردن هاست‌ها بر اساس وضعیت آن‌ها"
       },
diff --git a/dashboard/public/statics/locales/ru.json b/dashboard/public/statics/locales/ru.json
@@ -213,6 +213,12 @@
         "profileTitle": "Название профиля",
         "profileTitlePlaceholder": "Мой VPN сервис",
         "profileTitleDescription": "Отображаемое имя для профиля подписки",
+        "announce": "Объявление",
+        "announcePlaceholder": "Технические работы начнутся в 02:00",
+        "announceDescription": "Короткое сообщение, показываемое пользователям в поддерживаемых клиентах подписки",
+        "announceUrl": "Ссылка на объявление",
+        "announceUrlPlaceholder": "https://status.example.com",
+        "announceUrlDescription": "Необязательная ссылка с дополнительной информацией об объявлении",
         "hostStatusFilter": "Фильтр статуса хоста",
         "hostStatusFilterDescription": "Фильтровать хосты на основе их статуса"
       },
diff --git a/dashboard/public/statics/locales/zh.json b/dashboard/public/statics/locales/zh.json
@@ -179,6 +179,12 @@
         "profileTitle": "配置文件标题",
         "profileTitlePlaceholder": "输入配置文件标题",
         "profileTitleDescription": "显示在客户端中的配置文件名称",
+        "announce": "公告内容",
+        "announcePlaceholder": "服务将于 02:00 进行维护",
+        "announceDescription": "在支持的订阅客户端中展示给用户的简短消息",
+        "announceUrl": "公告链接",
+        "announceUrlPlaceholder": "https://status.example.com",
+        "announceUrlDescription": "可选的链接，用于提供更多公告细节",
         "hostStatusFilter": "主机状态过滤",
         "hostStatusFilterDescription": "仅包含活跃主机在订阅中"
       },
diff --git a/dashboard/src/pages/_dashboard.settings.subscriptions.tsx b/dashboard/src/pages/_dashboard.settings.subscriptions.tsx
@@ -10,7 +10,7 @@ import { Switch } from '@/components/ui/switch'
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'
 import { Separator } from '@/components/ui/separator'
 import { Badge } from '@/components/ui/badge'
-import { Plus, Trash2, Filter, FileText, Link, Clock, HelpCircle, User, Settings, Code, FileCode2, Sword, Shield, Lock, GripVertical, RotateCcw } from 'lucide-react'
+import { Plus, Trash2, Filter, FileText, Link, Clock, HelpCircle, User, Settings, Code, FileCode2, Sword, Shield, Lock, GripVertical, RotateCcw, Megaphone, ExternalLink } from 'lucide-react'
 import { useSettingsContext } from './_dashboard.settings'
 import { ConfigFormat } from '@/service/api'
 import { toast } from 'sonner'
@@ -28,6 +28,8 @@ const subscriptionSchema = z.object({
   update_interval: z.number().min(1, 'Update interval must be at least 1 hour').max(168, 'Update interval cannot exceed 168 hours (1 week)').optional(),
   support_url: z.string().url('Please enter a valid URL').optional().or(z.literal('')),
   profile_title: z.string().optional(),
+  announce: z.string().max(128, 'Announcement must be 128 characters or less').optional(),
+  announce_url: z.string().url('Please enter a valid URL').optional().or(z.literal('')),
   host_status_filter: z.boolean(),
   rules: z.array(
     z.object({
@@ -432,6 +434,8 @@ export default function SubscriptionSettings() {
       update_interval: 24,
       support_url: '',
       profile_title: '',
+      announce: '',
+      announce_url: '',
       host_status_filter: false,
       rules: [],
       applications: [],
@@ -517,6 +521,8 @@ export default function SubscriptionSettings() {
         update_interval: subscriptionData.update_interval || 24,
         support_url: subscriptionData.support_url || '',
         profile_title: subscriptionData.profile_title || '',
+        announce: subscriptionData.announce || '',
+        announce_url: subscriptionData.announce_url || '',
         host_status_filter: subscriptionData.host_status_filter || false,
         rules: subscriptionData.rules || [],
         applications: subscriptionData.applications || [],
@@ -570,6 +576,8 @@ export default function SubscriptionSettings() {
           url_prefix: data.url_prefix?.trim() || undefined,
           support_url: data.support_url?.trim() || undefined,
           profile_title: data.profile_title?.trim() || undefined,
+          announce: data.announce?.trim() || undefined,
+          announce_url: data.announce_url?.trim() || undefined,
           // Include processed applications
           applications: processedApplications,
         },
@@ -643,6 +651,8 @@ export default function SubscriptionSettings() {
         update_interval: subscriptionData.update_interval || 24,
         support_url: subscriptionData.support_url || '',
         profile_title: subscriptionData.profile_title || '',
+        announce: subscriptionData.announce || '',
+        announce_url: subscriptionData.announce_url || '',
         host_status_filter: subscriptionData.host_status_filter || false,
         rules: subscriptionData.rules || [],
         applications: subscriptionData.applications || [],
@@ -898,6 +908,42 @@ export default function SubscriptionSettings() {
                   </FormItem>
                 )}
               />
+
+              <FormField
+                control={form.control}
+                name="announce"
+                render={({ field }) => (
+                  <FormItem className="space-y-2">
+                    <FormLabel className="flex items-center gap-2 text-sm font-medium">
+                      <Megaphone className="h-4 w-4" />
+                      {t('settings.subscriptions.general.announce')}
+                    </FormLabel>
+                    <FormControl>
+                      <Input maxLength={128} placeholder={t('settings.subscriptions.general.announcePlaceholder')} {...field} />
+                    </FormControl>
+                    <FormDescription className="text-sm text-muted-foreground">{t('settings.subscriptions.general.announceDescription')}</FormDescription>
+                    <FormMessage />
+                  </FormItem>
+                )}
+              />
+
+              <FormField
+                control={form.control}
+                name="announce_url"
+                render={({ field }) => (
+                  <FormItem className="space-y-2">
+                    <FormLabel className="flex items-center gap-2 text-sm font-medium">
+                      <ExternalLink className="h-4 w-4" />
+                      {t('settings.subscriptions.general.announceUrl')}
+                    </FormLabel>
+                    <FormControl>
+                      <Input type="url" placeholder={t('settings.subscriptions.general.announceUrlPlaceholder')} {...field} className="font-mono" />
+                    </FormControl>
+                    <FormDescription className="text-sm text-muted-foreground">{t('settings.subscriptions.general.announceUrlDescription')}</FormDescription>
+                    <FormMessage />
+                  </FormItem>
+                )}
+              />
             </div>
 
             <FormField
diff --git a/dashboard/src/service/api/index.ts b/dashboard/src/service/api/index.ts
@@ -890,6 +890,9 @@ export interface SubscriptionOutput {
   update_interval?: number
   support_url?: string
   profile_title?: string
+  /** @maxLength 128 */
+  announce?: string
+  announce_url?: string
   host_status_filter: boolean
   rules: SubRule[]
   manual_sub_request?: SubFormatEnable
@@ -901,6 +904,9 @@ export interface SubscriptionInput {
   update_interval?: number
   support_url?: string
   profile_title?: string
+  /** @maxLength 128 */
+  announce?: string
+  announce_url?: string
   host_status_filter: boolean
   rules: SubRule[]
   manual_sub_request?: SubFormatEnable
