feat: trigger setting guide with instance createdTime (#1871)

Author: caoxing9

apps/nestjs-backend/src/features/setting/setting.service.ts

@@ -17,7 +17,7 @@
 import { Injectable } from '@nestjs/common';
 import type { Prisma } from '@teable/db-main-prisma';
 import { PrismaService } from '@teable/db-main-prisma';
-import type { ISettingVo } from '@teable/openapi';
+import { SettingKey, type ISettingVo } from '@teable/openapi';
 import { isArray } from 'lodash';
 import { ClsService } from 'nestjs-cls';
 import type { IClsStore } from '../../types/cls';
@@ -60,6 +60,14 @@ export class SettingService {
       }
     }
 
+    const instanceData = await this.prismaService.setting.findFirst({
+      where: { name: SettingKey.INSTANCE_ID },
+      select: {
+        createdTime: true,
+      },
+    });
+    res.createdTime = instanceData?.createdTime;
+
     return res as ISettingVo;
   }
 

apps/nextjs-app/src/features/app/blocks/space/FreshSettingGuideDialog.tsx

@@ -1,20 +1,27 @@
 import { useSession } from '@teable/sdk/hooks';
 import { Button, Dialog, DialogContent } from '@teable/ui-lib/shadcn';
+import dayjs from 'dayjs';
 import Image from 'next/image';
 import { useRouter } from 'next/router';
 import { useTranslation } from 'next-i18next';
 import { useState } from 'react';
 import { useLocalStorage } from 'react-use';
 import { useBrand } from '../../hooks/useBrand';
 import { useIsCloud } from '../../hooks/useIsCloud';
+import { useSetting } from '../../hooks/useSetting';
 
 export const FreshSettingGuideDialog = () => {
   const isCloud = useIsCloud();
   const {
     user: { isAdmin },
   } = useSession();
+
+  const { createdTime } = useSetting();
+
   const [freshAdmin, setFreshAdmin] = useLocalStorage('freshAdmin', true);
-  const showGuideModal = Boolean(freshAdmin && isAdmin && !isCloud);
+  const showGuideModal = Boolean(
+    freshAdmin && isAdmin && !isCloud && dayjs().isAfter(dayjs(createdTime).add(4, 'hour'))
+  );
   const [isModalOpen, setIsModalOpen] = useState(showGuideModal);
   const { t } = useTranslation('common');
   const router = useRouter();
@@ -54,7 +61,10 @@ export const FreshSettingGuideDialog = () => {
             </p>
           </div>
           <Button
-            onClick={() => router.push('/admin/setting')}
+            onClick={() => {
+              router.push('/admin/setting');
+              setFreshAdmin(false);
+            }}
             className="h-[44px] w-[194px] self-center"
           >
             {t('admin.action.goToConfiguration')}

apps/nextjs-app/src/features/app/hooks/useSetting.ts

@@ -16,6 +16,7 @@ export const useSetting = () => {
     disallowSpaceInvitation = false,
     webSearchEnabled = false,
     appGenerationEnabled = false,
+    createdTime,
   } = setting ?? {};
 
   return {
@@ -24,5 +25,6 @@ export const useSetting = () => {
     disallowSpaceInvitation: !user.isAdmin && (isLoading || disallowSpaceInvitation),
     webSearchEnabled,
     appGenerationEnabled,
+    createdTime,
   };
 };

packages/openapi/src/admin/setting/get-public.ts

@@ -30,6 +30,7 @@ export const publicSettingVoSchema = settingVoSchema
     disallowSpaceInvitation: true,
     enableEmailVerification: true,
     enableWaitlist: true,
+    createdTime: true,
   })
   .merge(
     z.object({

packages/openapi/src/admin/setting/get.ts

@@ -19,6 +19,7 @@ export const settingVoSchema = z.object({
   automationMailTransportConfig: mailTransportConfigSchema.nullable().optional(),
   appConfig: appConfigSchema.nullable().optional(),
   webSearchConfig: webSearchConfigSchema.nullable().optional(),
+  createdTime: z.string().optional(),
 });
 
 export type ISettingVo = z.infer<typeof settingVoSchema>;