feat: implement database backup service, API, and UI

Author: lcomplete

app/client/src/api/api.ts

@@ -1361,18 +1361,30 @@ export interface GlobalSetting {
      * @memberof GlobalSetting
      */
     'changedOpenApiKey'?: boolean;
-    /**
-     *
-     * @type {string}
-     * @memberof GlobalSetting
-     */
-    'backupPath'?: string;
-    /**
-     *
-     * @type {number}
-     * @memberof GlobalSetting
-     */
-    'backupKeepDays'?: number;
+     /**
+      *
+      * @type {string}
+      * @memberof GlobalSetting
+      */
+     'backupPath'?: string;
+     /**
+      *
+      * @type {boolean}
+      * @memberof GlobalSetting
+      */
+     'enableDatabaseBackup'?: boolean;
+     /**
+      *
+      * @type {number}
+      * @memberof GlobalSetting
+      */
+     'backupKeepCount'?: number;
+     /**
+      *
+      * @type {string}
+      * @memberof GlobalSetting
+      */
+     'backupTime'?: string;
     /**
      * 
      * @type {number}

app/client/src/api/databaseBackup.ts

@@ -0,0 +1,25 @@
+import axios from "axios";
+
+export interface DatabaseBackupInfo {
+  fileName?: string;
+  createdAt?: string;
+  sizeBytes?: number;
+}
+
+type ApiResult<T> = {
+  code: number;
+  message?: string;
+  data: T;
+};
+
+export async function fetchDatabaseBackups(): Promise<DatabaseBackupInfo[]> {
+  const res = await axios.get<ApiResult<DatabaseBackupInfo[]>>("/api/setting/general/database-backups");
+  if (res.data.code !== 0) {
+    throw new Error(res.data.message || "Failed to fetch database backups.");
+  }
+  return res.data.data || [];
+}
+
+export function getDatabaseBackupDownloadUrl(fileName: string): string {
+  return `/api/setting/general/database-backups/download?fileName=${encodeURIComponent(fileName)}`;
+}

app/client/src/components/PageFilters.tsx

@@ -67,6 +67,8 @@ export type PageFilterOptions = {
   contentFilterType?: number,
   startDate?: string
   endDate?: string
+  hideSortFilter?: boolean
+  hideOrderFilter?: boolean
   showAllArticles?: boolean
   showAllArticlesOption?: boolean
   includeArchived?: boolean
@@ -92,7 +94,7 @@ function parseDateTimeString(dateStr: string | undefined) {
 
 export default function PageFilters(props: PageFilterProps) {
   const {options, onChange} = props;
-  const {sortFields, defaultSortValue, asc, hideContentTypeFilter, contentFilterType, startDate, endDate, showAllArticles, showAllArticlesOption, includeArchived, includeArchivedOption} = options;
+  const {sortFields, defaultSortValue, asc, hideContentTypeFilter, contentFilterType, startDate, endDate, hideSortFilter, hideOrderFilter, showAllArticles, showAllArticlesOption, includeArchived, includeArchivedOption} = options;
   const [pickerAnchorEl, setPickerAnchorEl] = React.useState(null);
   const parsedStart = parseDateTimeString(startDate);
   const parsedEnd = parseDateTimeString(endDate);
@@ -227,8 +229,8 @@ export default function PageFilters(props: PageFilterProps) {
   const contentLabel = contentLabelMap[contentFilterType || 0];
   const sortLabel = getSortLabel(defaultSortValue);
   const orderLabel = asc ? t('page:sortOldest') : t('page:sortNewest');
-  const showSort = sortFields.length > 1 || isPhone;
-  const showOrder = defaultSortValue !== 'VOTE_SCORE';
+  const showSort = !hideSortFilter && (sortFields.length > 1 || isPhone);
+  const showOrder = !hideOrderFilter && defaultSortValue !== 'VOTE_SCORE';
   const hasFilterChanges = !isDeepEqual(initialOptionsRef.current, options);
 
   function handleSortByChange(event, value) {

app/client/src/components/SearchBox.tsx

@@ -36,6 +36,7 @@ type SearchBoxProps = Readonly<{
   onSelectedKeywordsChange?: (keywords: string[]) => void;
   focusSignal?: number;
   defaultSearchText?: string;
+  searchParamsToKeep?: string[];
 }>;
 
 const defaultSearchOptions: SearchOption[] = [
@@ -107,7 +108,8 @@ export default function SearchBox({
   selectedKeywords,
   onSelectedKeywordsChange,
   focusSignal,
-  defaultSearchText
+  defaultSearchText,
+  searchParamsToKeep = []
 }: SearchBoxProps) {
   const [focus, setFocus] = useState(false);
   const [params] = useSearchParams();
@@ -194,16 +196,24 @@ export default function SearchBox({
       return;
     }
 
-    // use set search params
+    const nextSearchParams: Record<string, string> = {
+      'q': submitText,
+      'op': searchOptions
+        .filter((option) => defaultSearchOptionKeywords.has(option.keyword))
+        .map((option) => option.keyword)
+        .join(',')
+    };
+
+    searchParamsToKeep.forEach((paramName) => {
+      const paramValue = params.get(paramName);
+      if (paramValue) {
+        nextSearchParams[paramName] = paramValue;
+      }
+    });
+
     navigate({
       pathname: "/search",
-      search: `?${createSearchParams({
-        'q': submitText,
-        'op': searchOptions
-          .filter((option) => defaultSearchOptionKeywords.has(option.keyword))
-          .map((option) => option.keyword)
-          .join(',')
-      })}`
+      search: `?${createSearchParams(nextSearchParams)}`
     });
   }