✨ feat: Add console announcements and FAQ management system
- Add SettingsAnnouncements component with full CRUD operations for system announcements * Support multiple announcement types (default, ongoing, success, warning, error) * Include publish date, content, type classification and additional notes * Implement batch operations and pagination for better data management * Add real-time preview with relative time display and date formatting - Add SettingsFAQ component for comprehensive FAQ management * Support question-answer pairs with rich text content * Include full editing, deletion and creation capabilities * Implement batch delete operations and paginated display * Add validation for complete Q&A information - Integrate announcement and FAQ modules into DashboardSetting * Add unified configuration interface in admin console * Implement auto-refresh functionality for real-time updates * Add loading states and error handling for better UX - Enhance backend API support in controller and setting modules * Add validation functions for console settings * Include time and sorting utilities for announcement management * Extend API endpoints for announcement and FAQ data persistence - Improve frontend infrastructure * Add new translation keys for internationalization support * Update utility functions for date/time formatting * Enhance CSS styles for better component presentation * Add icons and visual improvements for announcements and FAQ sections This implementation provides administrators with comprehensive tools to manage system-wide announcements and user FAQ content through an intuitive console interface.
This commit is contained in:
Apple\Apple
@@ -6,7 +6,9 @@ import (
|
||||
"net/url"
|
||||
"one-api/common"
|
||||
"regexp"
|
||||
"sort"
|
||||
"strings"
|
||||
"time"
|
||||
)
|
||||
|
||||
// ValidateConsoleSettings 验证控制台设置信息格式
|
||||
@@ -18,6 +20,10 @@ func ValidateConsoleSettings(settingsStr string, settingType string) error {
|
||||
switch settingType {
|
||||
case "ApiInfo":
|
||||
return validateApiInfo(settingsStr)
|
||||
case "Announcements":
|
||||
return validateAnnouncements(settingsStr)
|
||||
case "FAQ":
|
||||
return validateFAQ(settingsStr)
|
||||
default:
|
||||
return fmt.Errorf("未知的设置类型：%s", settingType)
|
||||
}
|
||||
@@ -138,4 +144,184 @@ func GetApiInfo() []map[string]interface{} {
|
||||
}
|
||||
|
||||
return apiInfo
|
||||
}
|
||||
|
||||
// validateAnnouncements 验证系统公告格式
|
||||
func validateAnnouncements(announcementsStr string) error {
|
||||
var announcementsList []map[string]interface{}
|
||||
if err := json.Unmarshal([]byte(announcementsStr), &announcementsList); err != nil {
|
||||
return fmt.Errorf("系统公告格式错误：%s", err.Error())
|
||||
}
|
||||
|
||||
// 验证数组长度
|
||||
if len(announcementsList) > 100 {
|
||||
return fmt.Errorf("系统公告数量不能超过100个")
|
||||
}
|
||||
|
||||
// 允许的类型值
|
||||
validTypes := map[string]bool{
|
||||
"default": true, "ongoing": true, "success": true, "warning": true, "error": true,
|
||||
}
|
||||
|
||||
for i, announcement := range announcementsList {
|
||||
// 检查必填字段
|
||||
content, ok := announcement["content"].(string)
|
||||
if !ok || content == "" {
|
||||
return fmt.Errorf("第%d个公告缺少内容字段", i+1)
|
||||
}
|
||||
|
||||
// 检查发布日期字段
|
||||
publishDate, exists := announcement["publishDate"]
|
||||
if !exists {
|
||||
return fmt.Errorf("第%d个公告缺少发布日期字段", i+1)
|
||||
}
|
||||
|
||||
publishDateStr, ok := publishDate.(string)
|
||||
if !ok || publishDateStr == "" {
|
||||
return fmt.Errorf("第%d个公告的发布日期不能为空", i+1)
|
||||
}
|
||||
|
||||
// 验证ISO日期格式
|
||||
if _, err := time.Parse(time.RFC3339, publishDateStr); err != nil {
|
||||
return fmt.Errorf("第%d个公告的发布日期格式错误", i+1)
|
||||
}
|
||||
|
||||
// 验证可选字段
|
||||
if announcementType, exists := announcement["type"]; exists {
|
||||
if typeStr, ok := announcementType.(string); ok {
|
||||
if !validTypes[typeStr] {
|
||||
return fmt.Errorf("第%d个公告的类型值不合法", i+1)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 验证字段长度
|
||||
if len(content) > 500 {
|
||||
return fmt.Errorf("第%d个公告的内容长度不能超过500字符", i+1)
|
||||
}
|
||||
|
||||
if extra, exists := announcement["extra"]; exists {
|
||||
if extraStr, ok := extra.(string); ok && len(extraStr) > 200 {
|
||||
return fmt.Errorf("第%d个公告的说明长度不能超过200字符", i+1)
|
||||
}
|
||||
}
|
||||
|
||||
// 检查并过滤危险字符（防止XSS）
|
||||
dangerousChars := []string{"<script", "<iframe", "javascript:", "onload=", "onerror=", "onclick="}
|
||||
for _, dangerous := range dangerousChars {
|
||||
if strings.Contains(strings.ToLower(content), dangerous) {
|
||||
return fmt.Errorf("第%d个公告的内容包含不允许的内容", i+1)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// validateFAQ 验证常见问答格式
|
||||
func validateFAQ(faqStr string) error {
|
||||
var faqList []map[string]interface{}
|
||||
if err := json.Unmarshal([]byte(faqStr), &faqList); err != nil {
|
||||
return fmt.Errorf("常见问答格式错误：%s", err.Error())
|
||||
}
|
||||
|
||||
// 验证数组长度
|
||||
if len(faqList) > 100 {
|
||||
return fmt.Errorf("常见问答数量不能超过100个")
|
||||
}
|
||||
|
||||
for i, faq := range faqList {
|
||||
// 检查必填字段
|
||||
title, ok := faq["title"].(string)
|
||||
if !ok || title == "" {
|
||||
return fmt.Errorf("第%d个问答缺少标题字段", i+1)
|
||||
}
|
||||
|
||||
content, ok := faq["content"].(string)
|
||||
if !ok || content == "" {
|
||||
return fmt.Errorf("第%d个问答缺少内容字段", i+1)
|
||||
}
|
||||
|
||||
// 验证字段长度
|
||||
if len(title) > 200 {
|
||||
return fmt.Errorf("第%d个问答的标题长度不能超过200字符", i+1)
|
||||
}
|
||||
|
||||
if len(content) > 1000 {
|
||||
return fmt.Errorf("第%d个问答的内容长度不能超过1000字符", i+1)
|
||||
}
|
||||
|
||||
// 检查并过滤危险字符（防止XSS）
|
||||
dangerousChars := []string{"<script", "<iframe", "javascript:", "onload=", "onerror=", "onclick="}
|
||||
for _, dangerous := range dangerousChars {
|
||||
if strings.Contains(strings.ToLower(title), dangerous) {
|
||||
return fmt.Errorf("第%d个问答的标题包含不允许的内容", i+1)
|
||||
}
|
||||
if strings.Contains(strings.ToLower(content), dangerous) {
|
||||
return fmt.Errorf("第%d个问答的内容包含不允许的内容", i+1)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
return nil
|
||||
}
|
||||
|
||||
// GetAnnouncements 获取系统公告列表（返回最新的前20条）
|
||||
func GetAnnouncements() []map[string]interface{} {
|
||||
common.OptionMapRWMutex.RLock()
|
||||
announcementsStr, exists := common.OptionMap["Announcements"]
|
||||
common.OptionMapRWMutex.RUnlock()
|
||||
|
||||
if !exists || announcementsStr == "" {
|
||||
return []map[string]interface{}{}
|
||||
}
|
||||
|
||||
var announcements []map[string]interface{}
|
||||
if err := json.Unmarshal([]byte(announcementsStr), &announcements); err != nil {
|
||||
return []map[string]interface{}{}
|
||||
}
|
||||
|
||||
// 按发布日期降序排序（最新的在前）
|
||||
sort.Slice(announcements, func(i, j int) bool {
|
||||
dateI, okI := announcements[i]["publishDate"].(string)
|
||||
dateJ, okJ := announcements[j]["publishDate"].(string)
|
||||
|
||||
if !okI || !okJ {
|
||||
return false
|
||||
}
|
||||
|
||||
timeI, errI := time.Parse(time.RFC3339, dateI)
|
||||
timeJ, errJ := time.Parse(time.RFC3339, dateJ)
|
||||
|
||||
if errI != nil || errJ != nil {
|
||||
return false
|
||||
}
|
||||
|
||||
return timeI.After(timeJ)
|
||||
})
|
||||
|
||||
// 限制返回前20条
|
||||
if len(announcements) > 20 {
|
||||
announcements = announcements[:20]
|
||||
}
|
||||
|
||||
return announcements
|
||||
}
|
||||
|
||||
// GetFAQ 获取常见问答列表
|
||||
func GetFAQ() []map[string]interface{} {
|
||||
common.OptionMapRWMutex.RLock()
|
||||
faqStr, exists := common.OptionMap["FAQ"]
|
||||
common.OptionMapRWMutex.RUnlock()
|
||||
|
||||
if !exists || faqStr == "" {
|
||||
return []map[string]interface{}{}
|
||||
}
|
||||
|
||||
var faq []map[string]interface{}
|
||||
if err := json.Unmarshal([]byte(faqStr), &faq); err != nil {
|
||||
return []map[string]interface{}{}
|
||||
}
|
||||
|
||||
return faq
|
||||
}
|
||||
Reference in New Issue
Block a user