feat: plans migration

backend/data/src/main/kotlin/io/tolgee/component/CurrentDateProvider.kt

@@ -16,6 +16,8 @@ import org.springframework.stereotype.Component
 import org.springframework.transaction.PlatformTransactionManager
 import java.sql.Timestamp
 import java.time.Duration
+import java.time.LocalDate
+import java.time.ZoneId.systemDefault
 import java.time.ZonedDateTime
 import java.time.format.DateTimeFormatter
 import java.time.temporal.TemporalAccessor
@@ -84,6 +86,11 @@ class CurrentDateProvider(
       return forcedDate ?: Date()
     }
 
+  val localDate: LocalDate
+      get() {
+        return (forcedDate ?: date).toInstant().atZone(systemDefault()).toLocalDate()
+      }
+
   override fun getNow(): Optional<TemporalAccessor> {
     return Optional.of(date.toInstant())
   }

backend/data/src/main/kotlin/io/tolgee/component/SchedulingManager.kt

@@ -3,6 +3,7 @@ package io.tolgee.component
 import io.tolgee.util.Logging
 import io.tolgee.util.logger
 import jakarta.annotation.PreDestroy
+import org.springframework.scheduling.support.CronTrigger
 import org.springframework.stereotype.Component
 import java.time.Duration
 import java.util.*
@@ -46,6 +47,19 @@ class SchedulingManager(
     return id
   }
 
+  fun scheduleWithCron(
+    runnable: Runnable,
+    cron: String,
+  ): String {
+    val future = taskScheduler.schedule(runnable, CronTrigger(cron))
+    if (future == null) {
+      throw IllegalStateException("Future from scheduler was null")
+    }
+    val id = UUID.randomUUID().toString()
+    scheduledTasks[id] = future
+    return id
+  }
+
   @PreDestroy
   fun cancelAll() {
     Companion.cancelAll()

backend/data/src/main/kotlin/io/tolgee/constants/Message.kt

@@ -307,8 +307,9 @@ enum class Message {
   SUGGESTION_CANT_BE_PLURAL,
   SUGGESTION_MUST_BE_PLURAL,
   DUPLICATE_SUGGESTION,
-
   UNSUPPORTED_MEDIA_TYPE,
+  PLAN_MIGRATION_NOT_FOUND,
+  PLAN_HAS_MIGRATIONS,
   ;
 
   val code: String

backend/data/src/main/resources/I18n_en.properties

@@ -113,3 +113,16 @@ notifications.email.security-settings-link=Check your security settings <a href=
 notifications.email.mfa.MFA_ENABLED=Multi-factor authentication has been enabled for your account.
 notifications.email.mfa.MFA_DISABLED=Multi-factor authentication has been disabled for your account.
 notifications.email.password-changed=Password has been changed for your account.
+
+notifications.email.plan-migration-subject=Your 🐁 plan will be updated on {0}
+notifications.email.plan-migration-body=Hello! 👋<br/><br/>\
+We’d like to let you know that starting {0}, your current plan will be automatically updated.<br/>\
+Current plan: {1} (€{2}/mo)<br/>\
+New plan: {3} (€{4}/mo)<br/>\
+<br/>\
+If you’d prefer to switch to a different plan, you can easily do so in <a href="{5}">Subscriptions</a>\
+<br/><br/>\
+If you’re not happy with this change, please email us at <a href="mailto:{6}">{6}</a> and we’ll try to find a solution together.\
+<br/><br/>\
+Regards,<br/>\
+Tolgee

backend/testing/src/main/kotlin/io/tolgee/fixtures/EmailTestUtil.kt

@@ -66,6 +66,10 @@ class EmailTestUtil() {
     verify(javaMailSender).send(any<MimeMessage>())
   }
 
+  fun verifyTimesEmailSent(num: Int) {
+    verify(javaMailSender, times(num)).send(any<MimeMessage>())
+  }
+
   val assertEmailTo: AbstractStringAssert<*>
     get() {
       @Suppress("CAST_NEVER_SUCCEEDS")

e2e/cypress/support/dataCyType.d.ts

@@ -80,6 +80,9 @@ declare namespace DataCy {
         "administration-plan-field-stripe-product" |
         "administration-plan-field-stripe-product-name" |
         "administration-plan-selector" |
+        "administration-plans-create-migration" |
+        "administration-plans-edit-migration" |
+        "administration-plans-item-is-migrating-badge" |
         "administration-subscriptions-active-self-hosted-ee-plan" |
         "administration-subscriptions-assign-plan-save-button" |
         "administration-subscriptions-cloud-plan-name" |
@@ -263,6 +266,7 @@ declare namespace DataCy {
         "create-task-submit" |
         "dashboard-projects-list-item" |
         "default-namespace-select" |
+        "delete-plan-migration-button" |
         "delete-user-button" |
         "developer-menu-content-delivery" |
         "developer-menu-storage" |
@@ -558,6 +562,7 @@ declare namespace DataCy {
         "permissions-menu-save" |
         "plan-limit-dialog-close" |
         "plan-limit-exceeded-popover" |
+        "plan-migration-tooltip-detail" |
         "plan_seat_limit_exceeded_while_accepting_invitation_message" |
         "project-ai-prompt-dialog-description-input" |
         "project-ai-prompt-dialog-save" |
@@ -677,6 +682,7 @@ declare namespace DataCy {
         "signup-error-free-seat-limit" |
         "signup-error-plan-seat-limit" |
         "signup-error-seats-spending-limit" |
+        "source-plan-selector" |
         "spending-limit-dialog-close" |
         "spending-limit-exceeded-popover" |
         "sso-migration-info-text" |
@@ -708,6 +714,7 @@ declare namespace DataCy {
         "suggestions-list" |
         "tag-autocomplete-input" |
         "tag-autocomplete-option" |
+        "target-plan-selector" |
         "task-date-picker" |
         "task-detail" |
         "task-detail-author" |

webapp/src/component/common/FullWidthTooltip.tsx

@@ -0,0 +1,11 @@
+import { styled, Tooltip, tooltipClasses, TooltipProps } from '@mui/material';
+
+export const FullWidthTooltip = styled(
+  ({ className, ...props }: TooltipProps) => (
+    <Tooltip {...props} classes={{ popper: className }} />
+  )
+)({
+  [`& .${tooltipClasses.tooltip}`]: {
+    maxWidth: 'none',
+  },
+});

webapp/src/component/common/table/PaginatedHateoasTable.tsx

@@ -1,4 +1,4 @@
-import React, { FC, JSXElementConstructor } from 'react';
+import React, { FC, JSXElementConstructor, ReactNode } from 'react';
 import {
   HateoasListData,
   HateoasPaginatedData,
@@ -8,7 +8,7 @@ import {
   PaginatedHateoasList,
   PaginatedHateoasListProps,
 } from '../list/PaginatedHateoasList';
-import { Table, TableBody } from '@mui/material';
+import { Table, TableBody, TableHead } from '@mui/material';
 
 export type PaginatedHateoasTableProps<
   WrapperComponent extends
@@ -19,7 +19,9 @@ export type PaginatedHateoasTableProps<
 > = Omit<
   PaginatedHateoasListProps<WrapperComponent, typeof Table, TData, TItem>,
   'listComponent'
->;
+> & {
+  tableHead?: ReactNode;
+};
 
 export const PaginatedHateoasTable = <
   WrapperComponent extends
@@ -30,17 +32,31 @@ export const PaginatedHateoasTable = <
 >(
   props: PaginatedHateoasTableProps<WrapperComponent, TData, TItem>
 ) => {
+  const { tableHead, ...rest } = props;
   return (
     <PaginatedHateoasList
-      listComponent={PaginatedHateoasTableListComponent}
-      {...props}
+      listComponent={(listProps) => (
+        <PaginatedHateoasTableListComponent
+          tableHead={tableHead}
+          {...listProps}
+        />
+      )}
+      {...rest}
     />
   );
 };
 
-const PaginatedHateoasTableListComponent: FC = ({ children }) => {
+interface PaginatedHateoasTableListComponentProps {
+  children: ReactNode;
+  tableHead?: ReactNode;
+}
+
+const PaginatedHateoasTableListComponent: FC<
+  PaginatedHateoasTableListComponentProps
+> = ({ children, tableHead }) => {
   return (
     <Table>
+      {tableHead && <TableHead>{tableHead}</TableHead>}
       <TableBody>{children}</TableBody>
     </Table>
   );

webapp/src/component/layout/HeaderBar.tsx

@@ -32,6 +32,7 @@ export type HeaderBarProps = {
   switcher?: ReactNode;
   maxWidth?: BaseViewWidth;
   initialSearch?: string;
+  customButtons?: ReactNode[];
 };
 
 export const HeaderBar: React.VFC<HeaderBarProps> = (props) => {
@@ -81,6 +82,12 @@ export const HeaderBar: React.VFC<HeaderBarProps> = (props) => {
                   {props.switcher}
                 </Box>
               )}
+              {props.customButtons &&
+                props.customButtons.map((button, index) => (
+                  <Box key={index} display="flex" alignItems="center">
+                    {button}
+                  </Box>
+                ))}
               {props.addComponent
                 ? props.addComponent
                 : (props.onAdd || props.addLinkTo) && (

webapp/src/constants/GlobalValidationSchema.tsx

@@ -39,6 +39,14 @@ Yup.setLocale({
       />
     ),
   },
+  number: {
+    min: ({ min }) => (
+      <T
+        keyName="validation_schema_number_min_message"
+        params={{ min: min.toString() }}
+      />
+    ),
+  },
 });
 
 export class Validation {
@@ -521,6 +529,12 @@ export class Validation {
         .required()
         .matches(/^#[0-9A-F]{6}$/i, t('validation_invalid_hex_color')),
     });
+
+  static readonly PLAN_MIRATION_FORM = () =>
+    Yup.object().shape({
+      monthlyOffsetDays: Yup.number().required().min(0),
+      yearlyOffsetDays: Yup.number().required().min(0),
+    });
 }
 
 let GLOBAL_VALIDATION_DEBOUNCE_TIMER: any = undefined;

webapp/src/constants/links.tsx

@@ -63,6 +63,7 @@ export enum PARAMS {
   TRANSLATION_ID = 'translationId',
   PLAN_ID = 'planId',
   TA_ID = 'taId',
+  PLAN_MIGRATION_ID = 'migrationId',
 }
 
 export class LINKS {
@@ -246,6 +247,26 @@ export class LINKS {
     'create'
   );
 
+  static ADMINISTRATION_BILLING_CLOUD_PLAN_MIGRATION_CREATE = Link.ofParent(
+    LINKS.ADMINISTRATION_BILLING_CLOUD_PLANS,
+    'create-migration'
+  );
+
+  static ADMINISTRATION_BILLING_CLOUD_PLAN_MIGRATION_EDIT = Link.ofParent(
+    LINKS.ADMINISTRATION_BILLING_CLOUD_PLANS,
+    'migration/' + p(PARAMS.PLAN_MIGRATION_ID)
+  );
+
+  static ADMINISTRATION_BILLING_EE_PLAN_MIGRATION_CREATE = Link.ofParent(
+    LINKS.ADMINISTRATION_BILLING_EE_PLANS,
+    'create-migration'
+  );
+
+  static ADMINISTRATION_BILLING_EE_PLAN_MIGRATION_EDIT = Link.ofParent(
+    LINKS.ADMINISTRATION_BILLING_EE_PLANS,
+    'migration/' + p(PARAMS.PLAN_MIGRATION_ID)
+  );
+
   /**
    * Organizations
    */

webapp/src/ee/billing/administration/subscriptionPlans/components/migration/CreatePlanMigrationForm.tsx

@@ -0,0 +1,28 @@
+import {
+  CreatePlanMigrationFormData,
+  PlanMigrationForm,
+} from './PlanMigrationForm';
+import { PlanType } from 'tg.ee.module/billing/administration/subscriptionPlans/components/migration/types';
+
+const emptyDefaultValues: CreatePlanMigrationFormData = {
+  enabled: true,
+  sourcePlanId: 0,
+  targetPlanId: 0,
+  monthlyOffsetDays: 14,
+  yearlyOffsetDays: 30,
+};
+
+type Props = {
+  onSubmit: (values: CreatePlanMigrationFormData) => void;
+  loading?: boolean;
+  planType?: PlanType;
+};
+
+export const CreatePlanMigrationForm: React.FC<Props> = (props) => {
+  return (
+    <PlanMigrationForm<CreatePlanMigrationFormData>
+      defaultValues={emptyDefaultValues}
+      {...props}
+    />
+  );
+};

webapp/src/ee/billing/administration/subscriptionPlans/components/migration/EditPlanMigrationForm.tsx

@@ -0,0 +1,32 @@
+import { PlanMigrationForm, PlanMigrationFormData } from './PlanMigrationForm';
+import { components } from 'tg.service/billingApiSchema.generated';
+import { PlanType } from 'tg.ee.module/billing/administration/subscriptionPlans/components/migration/types';
+
+type CloudPlanMigrationModel = components['schemas']['CloudPlanMigrationModel'];
+type SelfHostedEePlanMigrationModel =
+  components['schemas']['AdministrationSelfHostedEePlanMigrationModel'];
+
+type Props = {
+  onSubmit: (values: PlanMigrationFormData) => void;
+  loading?: boolean;
+  onDelete?: (id: number) => void;
+  migration: CloudPlanMigrationModel | SelfHostedEePlanMigrationModel;
+  planType?: PlanType;
+};
+
+export const EditPlanMigrationForm: React.FC<Props> = (props) => {
+  const { migration } = props;
+  const initialValues: PlanMigrationFormData = {
+    enabled: migration.enabled,
+    sourcePlanFree: migration.sourcePlan.free,
+    targetPlanId: migration.targetPlan.id,
+    monthlyOffsetDays: migration.monthlyOffsetDays,
+    yearlyOffsetDays: migration.yearlyOffsetDays,
+  };
+  return (
+    <PlanMigrationForm<PlanMigrationFormData>
+      defaultValues={initialValues}
+      {...props}
+    />
+  );
+};