@spacemade/ui 0.0.1

package/scripts/defs/cms-definition.mjs

@@ -0,0 +1,1393 @@
+import {
+  createCrudScaffoldDefinition,
+  field,
+} from '../crud-scaffold/src/generator.mjs'
+
+const status = {
+  deployment: ['draft', 'provisioning', 'active', 'paused', 'failed', 'deleted'],
+  jobType: ['deploy', 'update', 'backup', 'delete', 'clone'],
+  job: ['queued', 'running', 'completed', 'failed'],
+  backupType: ['manual', 'scheduled'],
+  backup: ['pending', 'completed', 'failed'],
+}
+
+const deploymentLaunchServiceSource = `import type { NextApiRequest } from 'next'
+import { Op } from 'sequelize'
+import { Deployment } from '@lib/cms/models'
+import {
+  Product,
+  ProductPlan,
+  ProductVersion,
+  Provider,
+  ProviderSetting,
+  StripeSubscriptionStatus,
+  Subscription,
+} from '@lib/models'
+import {
+  requireActiveOrgId,
+  type RequestWithOrg,
+} from '@lib/middleware/with-active-org'
+import { ProductVersionResourceSpecService } from '@lib/service/product/product-version-resource-spec.service'
+
+const ACTIVE_STATUSES = [
+  StripeSubscriptionStatus.Trialing,
+  StripeSubscriptionStatus.Active,
+  StripeSubscriptionStatus.PastDue,
+  StripeSubscriptionStatus.Unpaid,
+]
+
+type DeploymentOption = {
+  key: string
+  label: string
+  providerId: string | null
+  providerSettingId: string
+  providerSettingName: string
+  providerKey: string | null
+  providerLabel: string | null
+  specFormat: string | null
+  resourceUrl: string | null
+  isDefault: boolean
+}
+
+type LaunchableProduct = {
+  product: Product
+  productPlan: ProductPlan
+  productVersion: ProductVersion
+  subscriptionId: string
+  deploymentOptions: DeploymentOption[]
+}
+
+function buildDeploymentOptions(
+  productVersion: ProductVersion,
+  providerSettings: ProviderSetting[]
+): DeploymentOption[] {
+  return providerSettings
+    .map((setting) => ({
+      setting,
+      provider: setting.provider instanceof Provider ? setting.provider : null,
+    }))
+    .filter((item): item is { setting: ProviderSetting; provider: Provider } => item.provider instanceof Provider)
+    .map(({ setting, provider }) => ({
+      setting,
+      provider,
+      providerSpec: ProductVersionResourceSpecService.getProviderSpec(productVersion, provider.key),
+    }))
+    .filter(({ providerSpec }) => providerSpec || !productVersion.resource_spec)
+    .map(({ setting, provider, providerSpec }) => ({
+      key: [provider.id, setting.id].join(':'),
+      label: [provider.label, setting.name].filter(Boolean).join(' - '),
+      providerId: provider.id,
+      providerSettingId: setting.id,
+      providerSettingName: setting.name,
+      providerKey: provider.key,
+      providerLabel: provider.label,
+      specFormat: typeof providerSpec?.specFormat === 'string' ? providerSpec.specFormat : null,
+      resourceUrl: typeof providerSpec?.resourceUrl === 'string' ? providerSpec.resourceUrl : productVersion.resource_url,
+      isDefault: !!setting.is_default,
+    }))
+}
+
+function deploymentOptionKey(
+  subscriptionId: string | null,
+  productPlanId: string | null,
+  productVersionId: string | null,
+  providerId: string | null,
+  providerSettingId: string | null
+) {
+  return [
+    subscriptionId || '',
+    productPlanId || '',
+    productVersionId || '',
+    providerId || '',
+    providerSettingId || '',
+  ].join(':')
+}
+
+export class DeploymentLaunchService {
+  public async listLaunchableProducts(req: NextApiRequest) {
+    const orgId = requireActiveOrgId(req as RequestWithOrg)
+
+    const subscriptions = await Subscription.findAll({
+      where: {
+        org_id: orgId,
+        status: { [Op.in]: ACTIVE_STATUSES as any },
+      },
+      include: [
+        {
+          model: ProductPlan,
+          as: 'productPlans',
+          include: [
+            {
+              model: Product,
+              as: 'product',
+              include: [
+                {
+                  model: ProductVersion,
+                  as: 'versions',
+                  required: false,
+                  where: { version_status: 'active' },
+                },
+              ],
+            },
+          ],
+        },
+      ],
+      order: [
+        ['created_at', 'DESC'],
+        [{ model: ProductPlan, as: 'productPlans' }, { model: Product, as: 'product' }, { model: ProductVersion, as: 'versions' }, 'rank', 'ASC'],
+        [{ model: ProductPlan, as: 'productPlans' }, { model: Product, as: 'product' }, { model: ProductVersion, as: 'versions' }, 'name', 'DESC'],
+      ],
+    })
+
+    const subscribedVersions = subscriptions.flatMap((subscription) => {
+      const plans = Array.isArray(subscription.productPlans) ? subscription.productPlans : []
+
+      return plans
+        .filter((plan) => plan.product instanceof Product)
+        .flatMap((plan) => {
+          const product = plan.product as Product
+          const versions = Array.isArray(product.versions) ? product.versions : []
+
+          return versions
+            .filter((version) => version instanceof ProductVersion)
+            .map((version) => ({
+              subscription,
+              plan,
+              product,
+              version,
+            }))
+        })
+    })
+
+    if (subscribedVersions.length === 0) {
+      return { results: [], count: 0 }
+    }
+
+    const planIds = [...new Set(subscribedVersions.map((item) => item.plan.id))]
+    const versionIds = [...new Set(subscribedVersions.map((item) => item.version.id))]
+    const subscriptionIds = [...new Set(subscribedVersions.map((item) => item.subscription.id))]
+
+    const deployments = await Deployment.findAll({
+      where: {
+        org_id: orgId,
+        subscription_id: { [Op.in]: subscriptionIds },
+        product_plan_id: { [Op.in]: planIds },
+        product_version_id: { [Op.in]: versionIds },
+        status: { [Op.ne]: 'deleted' },
+      } as any,
+      attributes: ['id', 'subscription_id', 'product_plan_id', 'product_version_id', 'provider_id', 'provider_setting_id'],
+    })
+    const deployedKeys = new Set(
+      deployments.map((deployment) =>
+        deploymentOptionKey(
+          deployment.subscription_id,
+          deployment.product_plan_id,
+          deployment.product_version_id,
+          deployment.provider_id,
+          deployment.provider_setting_id
+        )
+      )
+    )
+
+    const providerSettings = await ProviderSetting.findAll({
+      where: { org_id: orgId },
+      include: [
+        {
+          model: Provider,
+          as: 'provider',
+          required: true,
+          where: { status: 'active' },
+        },
+      ],
+      order: [
+        ['is_default', 'DESC'],
+        ['name', 'ASC'],
+      ],
+    })
+    const results: LaunchableProduct[] = subscribedVersions
+      .map((item) => {
+        const providerOptions = buildDeploymentOptions(item.version, providerSettings)
+        const deploymentOptions = providerOptions.filter((option) => {
+          const key = deploymentOptionKey(
+            item.subscription.id,
+            item.plan.id,
+            item.version.id,
+            option.providerId,
+            option.providerSettingId
+          )
+          return !deployedKeys.has(key)
+        })
+
+        return {
+          product: item.product,
+          productPlan: item.plan,
+          productVersion: item.version,
+          subscriptionId: item.subscription.id,
+          deploymentOptions,
+        }
+      })
+      .filter((item) => item.deploymentOptions.length > 0)
+
+    return {
+      results,
+      count: results.length,
+    }
+  }
+}
+
+export const deploymentLaunchService = new DeploymentLaunchService()
+`
+
+const deploymentPageSource = ({ ns, plural, key, options, resource }) => `import type { NextPage } from 'next'
+import { useEffect, useMemo } from 'react'
+import {
+  Drawer,
+  DrawerBody,
+  DrawerCloseButton,
+  DrawerContent,
+  DrawerFooter,
+  DrawerHeader,
+  DrawerOverlay,
+  useDisclosure,
+} from '@chakra-ui/react'
+import { FieldValues, SubmitHandler, useForm } from 'react-hook-form'
+import { toast } from 'react-toastify'
+import WithAuth from '@components/hoc/WithAuth'
+import Button from '@components/common/button/Button'
+import Input from '@components/common/forms/Input'
+import Select from '@components/common/forms/Select'
+import SideNavLayout from '@components/common/layout/SideNavLayout'
+import ProjectPickerNav from '@components/projects/ProjectPickerNav'
+import { useSearchAndFilterCommon } from '@hooks'
+import { useRouter } from '@lib/next-router'
+${options.sideNav?.resourceSidebar !== false ? `import { ${ns.pascal}SideNav } from '${options.src.importRoot}/components/${ns.pascal}SideNav'\n` : ''}import { ${ns.pascal}ResourceTable } from '${options.src.importRoot}/components/${ns.pascal}ResourceTable'
+import { ${ns.camel}Resources } from '${options.src.importRoot}/config/${ns.resourcesFile}'
+import {
+  useCreate${resource.name}Mutation,
+  useDelete${resource.name}Mutation,
+  useGet${plural}Query,
+  useGetLaunchableDeploymentProductsQuery,
+  type LaunchableDeploymentOption,
+  type LaunchableDeploymentProduct,
+} from '${options.src.importRoot}/store/slice/api/${options.store.apiSliceName}'
+import { useGetActiveProjectQuery } from '@store/slice/api/projectApiSlice'
+
+type LaunchProductOption = {
+  value: string
+  label: string
+  item: LaunchableDeploymentProduct
+}
+
+type LaunchProviderOption = {
+  value: string
+  label: string
+  option: LaunchableDeploymentOption
+}
+
+function slugify(value: string) {
+  return value
+    .trim()
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+}
+
+function launchKey(item: LaunchableDeploymentProduct, option: LaunchableDeploymentOption) {
+  return [
+    item.subscriptionId,
+    item.productPlan.id,
+    item.productVersion.id,
+    option.providerId || '',
+    option.providerSettingId,
+  ].join(':')
+}
+
+function productKey(item: LaunchableDeploymentProduct) {
+  return [
+    item.subscriptionId,
+    item.product.id,
+    item.productPlan.id,
+    item.productVersion.id,
+  ].join(':')
+}
+
+type CreateDeploymentDrawerProps = {
+  isOpen: boolean
+  isLoadingProducts: boolean
+  launchableProducts?: { results: LaunchableDeploymentProduct[] }
+  activeProjectId?: string
+  onClose: () => void
+  onCreated: () => void
+  createDeployment: ReturnType<typeof useCreate${resource.name}Mutation>[0]
+}
+
+function CreateDeploymentDrawer({
+  isOpen,
+  isLoadingProducts,
+  launchableProducts,
+  activeProjectId,
+  onClose,
+  onCreated,
+  createDeployment,
+}: CreateDeploymentDrawerProps) {
+  const {
+    register,
+    control,
+    getValues,
+    handleSubmit,
+    reset,
+    setValue,
+    watch,
+    formState: { errors, isSubmitting },
+  } = useForm<FieldValues>()
+
+  const productOptions = useMemo<LaunchProductOption[]>(() => {
+    return (launchableProducts?.results || []).map((item) => ({
+      value: productKey(item),
+      label: [item.product.name, item.productPlan.name, item.productVersion.name]
+        .filter(Boolean)
+        .join(' / '),
+      item,
+    }))
+  }, [launchableProducts])
+  const selectedProductKey = String(watch('productKey') || '')
+  const selectedProduct = productOptions.find((option) => option.value === selectedProductKey)
+  const providerOptions = useMemo<LaunchProviderOption[]>(() => {
+    if (!selectedProduct) return []
+
+    return selectedProduct.item.deploymentOptions
+      .filter((option) => option.providerId && option.providerSettingId)
+      .map((option) => ({
+        value: launchKey(selectedProduct.item, option),
+        label: [
+          option.providerSettingName || option.providerLabel || option.label,
+          option.specFormat,
+        ]
+          .filter(Boolean)
+          .join(' / '),
+        option,
+      }))
+  }, [selectedProduct])
+
+  useEffect(() => {
+    if (!isOpen) return
+
+    reset({
+      productKey: productOptions[0]?.value || '',
+      providerKey: '',
+      name: '',
+    })
+  }, [isOpen, productOptions, reset])
+
+  useEffect(() => {
+    const currentProviderKey = String(getValues('providerKey') || '')
+    if (currentProviderKey && !providerOptions.some((option) => option.value === currentProviderKey)) {
+      setValue('providerKey', '')
+    }
+  }, [getValues, providerOptions, setValue, selectedProductKey])
+
+  const onSubmit: SubmitHandler<FieldValues> = async (values) => {
+    const selectedProductOption = productOptions.find((option) => option.value === values.productKey)
+    const selectedProviderOption = providerOptions.find((option) => option.value === values.providerKey)
+
+    if (!selectedProductOption || !selectedProviderOption) {
+      toast.error('Select a product and provider connection.')
+      return
+    }
+
+    const item = selectedProductOption.item
+    const option = selectedProviderOption.option
+    const name = String(values.name || '').trim() || [item.product.name, item.productVersion.name, option.label]
+      .filter(Boolean)
+      .join(' - ')
+    const slug = slugify([item.product.slug || item.product.name, item.productVersion.name, option.key, Date.now().toString(36)].join(' '))
+
+    try {
+      await createDeployment({
+        payload: {
+          productId: item.product.id,
+          productPlanId: item.productPlan.id,
+          productVersionId: item.productVersion.id,
+          subscriptionId: item.subscriptionId,
+          providerId: option.providerId,
+          providerSettingId: option.providerSettingId,
+          deploymentValues: {
+            providerSettingName: option.providerSettingName,
+            providerKey: option.providerKey,
+            providerLabel: option.providerLabel,
+            specFormat: option.specFormat,
+            resourceUrl: option.resourceUrl,
+          },
+          name,
+          slug,
+          status: 'provisioning',
+          ...(activeProjectId ? { projectId: activeProjectId } : {}),
+        } as any,
+      }).unwrap()
+
+      toast.success('Deployment created.')
+      onCreated()
+      onClose()
+    } catch {
+      toast.error('Deployment could not be created.')
+    }
+  }
+
+  return (
+    <Drawer isOpen={isOpen} onClose={onClose} size="lg">
+      <DrawerOverlay />
+      <DrawerContent className="drawer">
+        <DrawerCloseButton />
+        <DrawerHeader>Create Deployment</DrawerHeader>
+        <DrawerBody>
+          <form id="create-deployment-form" onSubmit={handleSubmit(onSubmit)}>
+            <div className="mb-4 mt-3">
+              <label htmlFor="productKey">Product</label>
+              <p className="small mt-1 text-muted">
+                Select a subscribed product version to deploy
+              </p>
+              <Select
+                register={register('productKey', { required: 'This field is required' })}
+                label="Product"
+                options={productOptions}
+                control={control}
+                getValues={getValues}
+                setFirstAsDefault={false}
+                errors={errors}
+                isLoading={isLoadingProducts}
+                isDisabled={isLoadingProducts || productOptions.length === 0}
+                onChange={() => setValue('providerKey', '')}
+              />
+            </div>
+
+            <div className="mb-4">
+              <label htmlFor="providerKey">Provider Connection</label>
+              <p className="small mt-1 text-muted">
+                Select the connected provider account for this deployment
+              </p>
+              <Select
+                register={register('providerKey', { required: 'This field is required' })}
+                label="Provider Connection"
+                options={providerOptions}
+                control={control}
+                getValues={getValues}
+                setFirstAsDefault={false}
+                errors={errors}
+                isDisabled={!selectedProduct || providerOptions.length === 0}
+              />
+            </div>
+
+            <div className="mb-4">
+              <label htmlFor="name">Name</label>
+              <p className="small mt-1 text-muted">
+                Optionally set a friendly name for this deployment
+              </p>
+              <Input
+                register={register('name')}
+                errors={errors}
+                placeholder="Deployment name"
+                label="Name"
+                getValues={getValues}
+              />
+            </div>
+          </form>
+        </DrawerBody>
+        <DrawerFooter>
+          <Button onClick={onClose}>Cancel</Button>
+          <Button
+            type="submit"
+            color="primary"
+            className="text-white"
+            form="create-deployment-form"
+            isLoading={isSubmitting}
+            disabled={isSubmitting || productOptions.length === 0}
+          >
+            Save
+          </Button>
+        </DrawerFooter>
+      </DrawerContent>
+    </Drawer>
+  )
+}
+
+const ${resource.name}Page: NextPage = () => {
+  const router = useRouter()
+  const createDialog = useDisclosure()
+  const resource = ${ns.camel}Resources.${key}
+  const {
+    query: { q, limit, page },
+  } = router
+  const {
+    getLimitFromQuery,
+    calculateProperPageNumber,
+  } = useSearchAndFilterCommon()
+  const pageLimit = getLimitFromQuery(limit, 50)
+  const search = q?.toString()
+  const { data: activeProjectData } = useGetActiveProjectQuery()
+  const activeProjectId =
+    typeof activeProjectData?.projectId === 'string'
+      ? activeProjectData.projectId.trim()
+      : undefined
+  const detailHref = (item: Record<string, any>) =>
+    [
+      resource.href,
+      encodeURIComponent(String(item.id || '')),
+      encodeURIComponent(slugify(String(item.name || item.slug || item.id))),
+    ].join('/')
+  const {
+    data: launchableProducts,
+    isFetching: isFetchingLaunchable,
+    refetch: refetchLaunchableProducts,
+  } = useGetLaunchableDeploymentProductsQuery()
+  const {
+    data,
+    isFetching,
+    isLoading,
+    refetch: refetchDeployments,
+  } = useGet${plural}Query({
+    q: search,
+    nameLike: search,
+    limit: pageLimit,
+    page: calculateProperPageNumber(page),
+    ...(activeProjectId ? { projectId: activeProjectId } : {}),
+  })
+  const [createDeployment] = useCreate${resource.name}Mutation()
+  const [deleteDeployment] = useDelete${resource.name}Mutation()
+  const launchableCount = launchableProducts?.results.length || 0
+
+  const handleCreated = () => {
+    refetchLaunchableProducts()
+    refetchDeployments()
+  }
+
+  const handleDelete = async (item: Record<string, any>) => {
+    if (!item.id || !window.confirm('Delete this deployment?')) return
+
+    try {
+      await deleteDeployment({ id: String(item.id) }).unwrap()
+      toast.success('Deployment deleted.')
+      refetchLaunchableProducts()
+      refetchDeployments()
+    } catch {
+      toast.error('Deployment could not be deleted.')
+    }
+  }
+
+  return (
+    <SideNavLayout
+      useMainContentAreaId={false}
+      mainNavMode="list"
+      sidebarTopContent={(isCollapsed) => (
+        <ProjectPickerNav isCollapsed={isCollapsed} appPath={resource.href} />
+      )}
+${options.sideNav?.resourceSidebar !== false ? `      sidebarContent={(isCollapsed) => (!isCollapsed ? <${ns.pascal}SideNav /> : null)}` : ''}
+    >
+      <div className="mt-5 w-100">
+        <div className="d-flex align-items-start justify-content-between gap-3">
+          <div>
+            <h1 className="mb-2">{resource.title}</h1>
+            <p className="text-muted mb-0">{resource.description}</p>
+          </div>
+        </div>
+
+        <${ns.pascal}ResourceTable
+          resource={resource}
+          data={data}
+          isFetching={isFetching}
+          isLoading={isLoading}
+          onCreate={createDialog.onOpen}
+          onRowClick={(item) => item.id ? router.push(detailHref(item)) : undefined}
+          onDelete={handleDelete}
+        />
+
+        <CreateDeploymentDrawer
+          isOpen={createDialog.isOpen}
+          isLoadingProducts={isFetchingLaunchable}
+          launchableProducts={launchableProducts}
+          activeProjectId={activeProjectId}
+          onClose={createDialog.onClose}
+          onCreated={handleCreated}
+          createDeployment={createDeployment}
+        />
+      </div>
+    </SideNavLayout>
+  )
+}
+
+${resource.name}Page.getInitialProps = async () => {
+  return {
+    pageTitle: '${resource.title}',
+  }
+}
+
+export default WithAuth(${resource.name}Page)
+`
+
+const deploymentUsersPageSource = ({ ns, options, resource }) => `import type { NextPage } from 'next'
+import Link from 'next/link'
+import { useEffect, useMemo } from 'react'
+import { useDisclosure } from '@chakra-ui/react'
+import SideNavLayout from '@components/common/layout/SideNavLayout'
+import WithAuth from '@components/hoc/WithAuth'
+import UserGrid from '@components/user/grid/UserGrid'
+import AddUserModal from '@components/user/modal/AddUserModal'
+import UpgradeUserLimitModal from '@components/user/modal/UpgradeUserLimitModal'
+import { UpdatePlanModal } from '@components/billing/modal/UpdatePlanModal'
+import { useUserAuthContext } from '@context/UserAuthContext'
+import { useRouter } from '@lib/next-router'
+import { useListOrgsQuery, useListOrgMembershipsQuery } from '@store/slice/api/orgApiSlice'
+import { useGetSubscriptionQuery } from '@store/slice/api/stripeApiSlice'
+${options.sideNav?.resourceSidebar !== false ? `import { ${ns.pascal}SideNav } from '${options.src.importRoot}/components/${ns.pascal}SideNav'\n` : ''}import { ${ns.camel}Resources } from '${options.src.importRoot}/config/${ns.resourcesFile}'
+import { useGetOne${resource.name}Query } from '${options.src.importRoot}/store/slice/api/${options.store.apiSliceName}'
+
+const ${resource.name}UsersPage: NextPage = () => {
+  const router = useRouter()
+  const { user, activeOrgId } = useUserAuthContext()
+  const resource = ${ns.camel}Resources.deployment
+  const id = typeof router.query.id === 'string' ? router.query.id : ''
+  const { data: deployment } = useGetOne${resource.name}Query({ id }, { skip: !id })
+  const {
+    isOpen: isOpenAddUserModal,
+    onOpen: onOpenAddUserModal,
+    onClose: onCloseAddUserModal,
+  } = useDisclosure()
+  const {
+    isOpen: isOpenUpgradeModal,
+    onOpen: onOpenUpgradeModal,
+    onClose: onCloseUpgradeModal,
+  } = useDisclosure()
+  const {
+    isOpen: isOpenPlanModal,
+    onOpen: onOpenPlanModal,
+    onClose: onClosePlanModal,
+  } = useDisclosure()
+
+  const { data: orgMembershipsData, isLoading: isLoadingOrgs } = useListOrgsQuery(undefined, {
+    skip: !user?.id,
+  })
+
+  const orgMemberships = useMemo(
+    () => orgMembershipsData ?? user?.orgMemberships ?? [],
+    [orgMembershipsData, user?.orgMemberships]
+  )
+
+  const activeMembership = useMemo(() => {
+    if (!orgMemberships.length) return null
+    return (
+      orgMemberships.find((membership) => membership.orgId === activeOrgId) ||
+      orgMemberships.find((membership) => membership.org?.orgType === 'personal') ||
+      orgMemberships[0] ||
+      null
+    )
+  }, [activeOrgId, orgMemberships])
+
+  const activeOrgOwnerId = activeMembership?.org?.ownerId ?? null
+  const resolvedOrgId = activeMembership?.orgId || activeOrgId
+
+  const { data: membersData } = useListOrgMembershipsQuery(
+    { orgId: resolvedOrgId!, limit: 1, page: 1 },
+    { skip: !resolvedOrgId }
+  )
+
+  const { data: subData } = useGetSubscriptionQuery()
+
+  const { planName, maxUsers, isHardCapped, currentUserCount } = useMemo(() => {
+    const subscriptions = (subData as any)?.subscriptions ?? []
+    const activeSub = subscriptions[0]
+    const plan = activeSub?.productPlans?.find((item: any) => item.product?.type === 'plan')
+    const product = plan?.product
+    const userLimit = product?.limits?.users ?? null
+
+    return {
+      planName: product?.name ?? '',
+      maxUsers:
+        typeof userLimit?.includedUnits === 'number'
+          ? userLimit.includedUnits
+          : userLimit?.includedUnits == null
+            ? null
+            : Number(userLimit.includedUnits),
+      isHardCapped: userLimit?.hardCap === true,
+      currentUserCount: membersData?.count ?? 0,
+    }
+  }, [membersData, subData])
+
+  const isAtUserLimit =
+    isHardCapped && maxUsers !== null && currentUserCount >= maxUsers
+
+  const handleAddUser = () => {
+    if (isAtUserLimit) {
+      onOpenUpgradeModal()
+    } else {
+      onOpenAddUserModal()
+    }
+  }
+
+  const handleUpgrade = () => {
+    onCloseUpgradeModal()
+    onOpenPlanModal()
+  }
+
+  const resolveDetailHref = (href: string) =>
+    href
+      .replaceAll('{id}', encodeURIComponent(id))
+      .replaceAll(':id', encodeURIComponent(id))
+      .replaceAll('{name}', encodeURIComponent(String(router.query.name || deployment?.name || id)))
+      .replaceAll(':name', encodeURIComponent(String(router.query.name || deployment?.name || id)))
+
+  useEffect(() => {
+    if (!user?.id || isLoadingOrgs) return
+    const activeOrg = activeMembership?.org
+    const isPersonalOrg =
+      activeOrg?.orgType === 'personal' ||
+      (!!activeOrg?.slug && !!user?.name && activeOrg.slug === user.name)
+
+    if (isPersonalOrg) {
+      router.replace('/')
+    }
+  }, [activeMembership, isLoadingOrgs, router, user?.id, user?.name])
+
+  return (
+    <SideNavLayout
+      useMainContentAreaId={false}
+      mainNavMode="list"
+      renderMainNav={() => null}
+      sidebarTopContent={() => (
+        <>
+          <h2 className="sidebar-heading">{resource.title}</h2>
+          <ul className="sidebar-list mb-5">
+            <li className="sidebar-item" title={'Back to ' + resource.title}>
+              <Link href={resource.href} className="sidebar-link">
+                <i className="bi bi-arrow-left" /> <span>Back</span>
+              </Link>
+            </li>
+          </ul>
+        </>
+      )}
+      sidebarContent={(isCollapsed) =>
+        !isCollapsed ? (
+          <>
+${options.sideNav?.resourceSidebar !== false ? `            <${ns.pascal}SideNav />` : ''}
+            <nav className="sidebar-section mt-4" aria-label="Deployment navigation">
+              <ul className="sidebar-list">
+                {resource.detailSidebarItems.map((item) => {
+                  const isActive = item.label === 'Users'
+
+                  return (
+                    <li key={item.href} className={'sidebar-item' + (isActive ? ' active' : '')} title={item.label}>
+                      <Link href={resolveDetailHref(item.href)} className="sidebar-link">
+                        {item.icon ? <i className={item.icon} /> : null} <span>{item.label}</span>
+                      </Link>
+                    </li>
+                  )
+                })}
+              </ul>
+            </nav>
+          </>
+        ) : null
+      }
+    >
+      <div className="mt-5 w-100">
+        <div className="mb-4">
+          <h1 className="mb-2">Users</h1>
+          <p className="text-muted mb-0">
+            Manage users and invitations for {String((deployment as any)?.name || 'this deployment')}.
+          </p>
+        </div>
+
+        <UserGrid
+          onCreate={handleAddUser}
+          orgId={resolvedOrgId}
+          orgOwnerId={activeOrgOwnerId}
+        />
+      </div>
+
+      <AddUserModal
+        isOpen={isOpenAddUserModal}
+        onClose={onCloseAddUserModal}
+        orgId={resolvedOrgId}
+      />
+
+      <UpgradeUserLimitModal
+        isOpen={isOpenUpgradeModal}
+        onClose={onCloseUpgradeModal}
+        onUpgrade={handleUpgrade}
+        currentPlanName={planName}
+        maxUsers={maxUsers ?? 0}
+        currentUserCount={currentUserCount}
+      />
+
+      <UpdatePlanModal
+        isOpen={isOpenPlanModal}
+        onClose={onClosePlanModal}
+      />
+    </SideNavLayout>
+  )
+}
+
+${resource.name}UsersPage.getInitialProps = async () => ({
+  pageTitle: 'Deployment Users',
+})
+
+export default WithAuth(${resource.name}UsersPage)
+`
+
+const deploymentChildResourcePageSource = ({ ns, options, resource, childPage }) => `import type { NextPage } from 'next'
+import Link from 'next/link'
+import SideNavLayout from '@components/common/layout/SideNavLayout'
+import WithAuth from '@components/hoc/WithAuth'
+import { useSearchAndFilterCommon } from '@hooks'
+import { useRouter } from '@lib/next-router'
+${options.sideNav?.resourceSidebar !== false ? `import { ${ns.pascal}SideNav } from '${options.src.importRoot}/components/${ns.pascal}SideNav'\n` : ''}import { ${ns.pascal}ResourceTable } from '${options.src.importRoot}/components/${ns.pascal}ResourceTable'
+import { ${ns.camel}Resources } from '${options.src.importRoot}/config/${ns.resourcesFile}'
+import {
+  useGetOne${resource.name}Query,
+  ${childPage.listHook},
+} from '${options.src.importRoot}/store/slice/api/${options.store.apiSliceName}'
+
+const ${resource.name}${childPage.componentSuffix}Page: NextPage = () => {
+  const router = useRouter()
+  const resource = ${ns.camel}Resources.deployment
+  const childResource = ${ns.camel}Resources.${childPage.resourceKey}
+  const id = typeof router.query.id === 'string' ? router.query.id : ''
+  const {
+    query: { q, limit, page },
+  } = router
+  const {
+    getLimitFromQuery,
+    calculateProperPageNumber,
+  } = useSearchAndFilterCommon()
+  const pageLimit = getLimitFromQuery(limit, 50)
+  const search = q?.toString()
+  const { data: deployment } = useGetOne${resource.name}Query({ id }, { skip: !id })
+  const { data, isFetching, isLoading } = ${childPage.listHook}({
+    q: search,
+    nameLike: search,
+    limit: pageLimit,
+    page: calculateProperPageNumber(page),
+    deploymentId: id,
+  }, { skip: !id } as any)
+  const detailName = String(router.query.name || (deployment as any)?.name || id)
+
+  const resolveDetailHref = (href: string) =>
+    href
+      .replaceAll('{id}', encodeURIComponent(id))
+      .replaceAll(':id', encodeURIComponent(id))
+      .replaceAll('{name}', encodeURIComponent(detailName))
+      .replaceAll(':name', encodeURIComponent(detailName))
+
+  return (
+    <SideNavLayout
+      useMainContentAreaId={false}
+      mainNavMode="list"
+      renderMainNav={() => null}
+      sidebarTopContent={() => (
+        <>
+          <h2 className="sidebar-heading">{resource.title}</h2>
+          <ul className="sidebar-list mb-5">
+            <li className="sidebar-item" title={'Back to ' + resource.title}>
+              <Link href={resource.href} className="sidebar-link">
+                <i className="bi bi-arrow-left" /> <span>Back</span>
+              </Link>
+            </li>
+          </ul>
+        </>
+      )}
+      sidebarContent={(isCollapsed) =>
+        !isCollapsed ? (
+          <>
+${options.sideNav?.resourceSidebar !== false ? `            <${ns.pascal}SideNav />` : ''}
+            <nav className="sidebar-section mt-4" aria-label="Deployment navigation">
+              <ul className="sidebar-list">
+                {resource.detailSidebarItems.map((item) => {
+                  const isActive = item.label === '${childPage.activeLabel}'
+
+                  return (
+                    <li key={item.href} className={'sidebar-item' + (isActive ? ' active' : '')} title={item.label}>
+                      <Link href={resolveDetailHref(item.href)} className="sidebar-link">
+                        {item.icon ? <i className={item.icon} /> : null} <span>{item.label}</span>
+                      </Link>
+                    </li>
+                  )
+                })}
+              </ul>
+            </nav>
+          </>
+        ) : null
+      }
+    >
+      <div className="mt-5 w-100">
+        <div className="mb-4">
+          <h1 className="mb-2">${childPage.title}</h1>
+          <p className="text-muted mb-0">
+            View ${childPage.description.toLowerCase()} for {String((deployment as any)?.name || 'this deployment')}.
+          </p>
+        </div>
+
+        <${ns.pascal}ResourceTable
+          resource={childResource}
+          data={data}
+          isFetching={isFetching}
+          isLoading={isLoading}
+          onRowClick={(item) => item.id ? router.push(childResource.href + '/' + item.id) : undefined}
+        />
+      </div>
+    </SideNavLayout>
+  )
+}
+
+${resource.name}${childPage.componentSuffix}Page.getInitialProps = async () => ({
+  pageTitle: '${childPage.pageTitle}',
+})
+
+export default WithAuth(${resource.name}${childPage.componentSuffix}Page)
+`
+
+const resources = [
+  {
+    name: 'DeploymentTemplate',
+    slug: 'deployment-template',
+    route: 'cms-templates',
+    responseKey: 'deploymentTemplate',
+    title: 'Templates',
+    icon: 'bi bi-layout-text-window-reverse',
+    description: 'Manage reusable deployment blueprints and starter site configurations.',
+    bullets: [
+      'Version templates',
+      'Control active starter blueprints',
+      'Attach templates to deployment creation flows',
+    ],
+    searchFields: ['name', 'slug', 'description'],
+    fields: [
+      field.uuid('org_id', { nullable: true, references: 'org', skipSchema: true, hideInTable: true }),
+      field.string('name', { required: true, minLength: 2 }),
+      field.string('slug', { required: true, regex: 'SLUG_REGEX' }),
+      field.text('description', { nullable: true }),
+      field.string('version', { required: true }),
+      field.boolean('is_active', { defaultValue: true }),
+    ],
+  },
+  {
+    name: 'Deployment',
+    slug: 'deployment',
+    route: 'cms-deployments',
+    responseKey: 'deployment',
+    title: 'Deployments',
+    icon: 'bi bi-rocket-takeoff',
+    detailRoute: '[id]/[name]',
+    description: 'Manage product deployment lifecycle operations including create, update, backup, clone, and delete.',
+    pageSource: deploymentPageSource,
+    tableColumns: [
+      { key: 'name', label: 'Name' },
+      { key: 'status', label: 'Status' },
+      { key: 'createdAt', label: 'On' },
+    ],
+    detailActions: [
+      { label: 'Templates', href: '/templates', icon: 'bi bi-layout-text-window-reverse' },
+    ],
+    detailSidebarItems: [
+      { label: 'Jobs', href: '/deployments/{id}/{name}/jobs', icon: 'bi bi-list-check' },
+      { label: 'Backup Jobs', href: '/deployments/{id}/{name}/backups', icon: 'bi bi-archive' },
+      { label: 'Users', href: '/deployments/{id}/{name}/users', icon: 'bi bi-people' },
+    ],
+    detailPages: [
+      {
+        path: 'jobs',
+        resourceKey: 'deploymentJob',
+        title: 'Jobs',
+        description: 'deployment jobs',
+        activeLabel: 'Jobs',
+        componentSuffix: 'Jobs',
+        pageTitle: 'Deployment Jobs',
+        listHook: 'useGetCmsDeploymentJobsQuery',
+        pageSource: deploymentChildResourcePageSource,
+      },
+      {
+        path: 'backups',
+        resourceKey: 'deploymentBackup',
+        title: 'Backup Jobs',
+        description: 'backup jobs',
+        activeLabel: 'Backup Jobs',
+        componentSuffix: 'Backups',
+        pageTitle: 'Deployment Backup Jobs',
+        listHook: 'useGetCmsBackupsQuery',
+        pageSource: deploymentChildResourcePageSource,
+      },
+      { path: 'users', pageSource: deploymentUsersPageSource },
+    ],
+    bullets: [
+      'Create and launch subscribed products',
+      'Track status and operational health',
+      'Attach each deployment to the core site that handles domains and routing',
+    ],
+    searchFields: ['name', 'slug', 'status', 'runtime_key'],
+    fields: [
+      field.uuid('org_id', { nullable: true, references: 'org', skipSchema: true, hideInTable: true }),
+      field.uuid('project_id', { nullable: true, references: 'project', skipSchema: true, hideInTable: true }),
+      field.uuid('site_id', {
+        nullable: true,
+        references: 'site',
+        validate: {
+          model: 'Site',
+          importRoot: '@lib/models',
+          message: 'Site Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+            { column: 'org_id', value: 'scopedValues.org_id' },
+          ],
+        },
+      }),
+      field.uuid('product_id', {
+        required: true,
+        references: 'product',
+        onDelete: 'RESTRICT',
+        validate: {
+          model: 'Product',
+          importRoot: '@lib/models',
+          message: 'Product Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+          ],
+        },
+      }),
+      field.uuid('product_plan_id', {
+        nullable: true,
+        references: 'product_plan',
+        validate: {
+          model: 'ProductPlan',
+          importRoot: '@lib/models',
+          message: 'ProductPlan Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+            { column: 'product_id', value: 'payload.product_id ?? record?.product_id' },
+          ],
+        },
+      }),
+      field.uuid('product_version_id', {
+        nullable: true,
+        references: 'product_version',
+        validate: {
+          model: 'ProductVersion',
+          importRoot: '@lib/models',
+          message: 'ProductVersion Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+            { column: 'product_id', value: 'payload.product_id ?? record?.product_id' },
+          ],
+        },
+      }),
+      field.uuid('subscription_id', {
+        nullable: true,
+        references: 'product_subscription',
+        validate: {
+          model: 'Subscription',
+          importRoot: '@lib/models',
+          message: 'Subscription Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+            { column: 'org_id', value: 'scopedValues.org_id' },
+          ],
+        },
+      }),
+      field.uuid('provider_id', {
+        required: true,
+        references: 'provider',
+        onDelete: 'RESTRICT',
+        validate: {
+          model: 'Provider',
+          importRoot: '@lib/models',
+          message: 'Provider Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+            { column: 'status', value: "'active'" },
+          ],
+        },
+      }),
+      field.uuid('provider_setting_id', {
+        required: true,
+        references: 'provider_settings',
+        onDelete: 'RESTRICT',
+        validate: {
+          model: 'ProviderSetting',
+          importRoot: '@lib/models',
+          message: 'ProviderSetting Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+            { column: 'org_id', value: 'scopedValues.org_id' },
+            { column: 'provider_id', value: 'payload.provider_id ?? record?.provider_id' },
+          ],
+        },
+      }),
+      field.json('deployment_values', { nullable: true, hideInTable: true }),
+      field.string('name', { required: true, minLength: 2 }),
+      field.string('slug', { required: true, regex: 'SLUG_REGEX' }),
+      field.enum('status', status.deployment, { defaultValue: 'draft' }),
+      field.uuid('template_id', {
+        nullable: true,
+        references: 'deployment_template',
+        validate: {
+          model: 'DeploymentTemplate',
+          message: 'DeploymentTemplate Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+            { column: 'org_id', value: 'scopedValues.org_id' },
+          ],
+        },
+      }),
+      field.string('runtime_key', { nullable: true }),
+      field.uuid('owner_user_id', {
+        nullable: true,
+        references: 'user',
+        validate: {
+          model: 'User',
+          importRoot: '@lib/models',
+          message: 'User Not Found',
+          where: [
+            { column: 'id', value: '$value' },
+          ],
+        },
+      }),
+    ],
+    serviceValidate: `
+  const subscribedSubscriptionId = payload.subscription_id !== undefined ? payload.subscription_id : record?.subscription_id
+  const subscribedProductPlanId = payload.product_plan_id !== undefined ? payload.product_plan_id : record?.product_plan_id
+  const subscribedProductVersionId = payload.product_version_id !== undefined ? payload.product_version_id : record?.product_version_id
+  const subscribedProductId = payload.product_id !== undefined ? payload.product_id : record?.product_id
+
+  if (subscribedSubscriptionId && subscribedProductPlanId) {
+    const subscribedPlan = await ProductPlan.findOne({
+      where: {
+        id: subscribedProductPlanId,
+        product_id: subscribedProductId,
+      },
+      include: [
+        {
+          model: Subscription,
+          as: 'subscriptions',
+          required: true,
+          attributes: ['id'],
+          where: {
+            id: subscribedSubscriptionId,
+            org_id: scopedValues.org_id,
+          },
+          through: { attributes: [] },
+        },
+      ],
+    })
+
+    if (!(subscribedPlan instanceof ProductPlan)) {
+      throw NotFoundError('Subscribed ProductPlan Not Found')
+    }
+  }
+
+  if (subscribedProductVersionId && subscribedProductId) {
+    const subscribedVersion = await ProductVersion.findOne({
+      where: {
+        id: subscribedProductVersionId,
+        product_id: subscribedProductId,
+      },
+    })
+
+    if (!(subscribedVersion instanceof ProductVersion)) {
+      throw NotFoundError('ProductVersion Not Found')
+    }
+  }`,
+    collectionActions: [
+      {
+        name: 'launchableProducts',
+        route: 'cms-deployments/launchable-products',
+        serviceFile: 'deployment-launch',
+        serviceInstance: 'deploymentLaunchService',
+        serviceMethod: 'listLaunchableProducts',
+        httpMethod: 'GET',
+        serviceSource: deploymentLaunchServiceSource,
+        storeImports: [
+          "import type { Product, ProductPlan, ProductVersion } from '@store/model'",
+        ],
+        storeTypes: `export type LaunchableDeploymentOption = {
+  key: string
+  label: string
+  providerId: string | null
+  providerSettingId: string
+  providerSettingName: string
+  providerKey: string | null
+  providerLabel: string | null
+  specFormat: string | null
+  resourceUrl: string | null
+  isDefault: boolean
+}
+
+export type LaunchableDeploymentProduct = {
+  product: Product
+  productPlan: ProductPlan
+  productVersion: ProductVersion
+  subscriptionId: string
+  deploymentOptions: LaunchableDeploymentOption[]
+}`,
+        storeEndpoint: `    getLaunchableDeploymentProducts: builder.query<ApiPagingResponse<LaunchableDeploymentProduct>, void>({
+      query: () => '/cms-deployments/launchable-products',
+      transformResponse: (res) => keysToCamel(res),
+    }),`,
+        storeHook: 'useGetLaunchableDeploymentProductsQuery',
+      },
+    ],
+  },
+  {
+    name: 'DeploymentJob',
+    slug: 'deployment-job',
+    route: 'cms-deployment-jobs',
+    responseKey: 'deploymentJob',
+    title: 'Deployment Jobs',
+    icon: 'bi bi-list-check',
+    description: 'Track deployment creation, update, backup, clone, and delete operations.',
+    listFilters: ['deployment_id'],
+    bullets: [
+      'Queue deployment operations',
+      'Capture execution state and errors',
+      'Attach operational payloads to each job',
+    ],
+    searchFields: ['job_type', 'status', 'error_message'],
+    fields: [
+      field.uuid('org_id', { nullable: true, references: 'org', skipSchema: true, hideInTable: true }),
+      field.uuid('project_id', { nullable: true, references: 'project', skipSchema: true, hideInTable: true }),
+      field.uuid('deployment_id', { required: true, references: 'deployment', onDelete: 'CASCADE' }),
+      field.uuid('product_id', { nullable: true, references: 'product' }),
+      field.uuid('product_version_id', { nullable: true, references: 'product_version' }),
+      field.uuid('subscription_id', { nullable: true, references: 'product_subscription' }),
+      field.uuid('provider_id', { nullable: true, references: 'provider' }),
+      field.enum('job_type', status.jobType, { required: true }),
+      field.enum('status', status.job, { defaultValue: 'queued' }),
+      field.json('payload', { nullable: true }),
+      field.date('started_at', { nullable: true }),
+      field.date('finished_at', { nullable: true }),
+      field.text('error_message', { nullable: true }),
+    ],
+  },
+  {
+    name: 'DeploymentBackup',
+    slug: 'deployment-backup',
+    route: 'cms-backups',
+    responseKey: 'deploymentBackup',
+    title: 'Backups',
+    icon: 'bi bi-cloud-arrow-up',
+    description: 'Track backup and restore artifacts for deployments.',
+    listFilters: ['deployment_id'],
+    bullets: [
+      'Record manual and scheduled backups',
+      'Track backup storage keys',
+      'Surface backup completion state',
+    ],
+    searchFields: ['backup_type', 'storage_key', 'status'],
+    fields: [
+      field.uuid('org_id', { nullable: true, references: 'org', skipSchema: true, hideInTable: true }),
+      field.uuid('project_id', { nullable: true, references: 'project', skipSchema: true, hideInTable: true }),
+      field.uuid('deployment_id', { required: true, references: 'deployment', onDelete: 'CASCADE' }),
+      field.enum('backup_type', status.backupType, { required: true }),
+      field.string('storage_key', { required: true }),
+      field.enum('status', status.backup, { defaultValue: 'pending' }),
+    ],
+  },
+]
+
+const associations = [
+  { source: 'Org', method: 'hasMany', target: 'DeploymentTemplate', options: "{ foreignKey: 'org_id', sourceKey: 'id', as: 'deploymentTemplates' }" },
+  { source: 'DeploymentTemplate', method: 'belongsTo', target: 'Org', options: "{ foreignKey: 'org_id', as: 'org' }" },
+  { source: 'Org', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'org_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'Org', options: "{ foreignKey: 'org_id', as: 'org' }" },
+  { source: 'Project', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'project_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'Project', options: "{ foreignKey: 'project_id', as: 'project' }" },
+  { source: 'User', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'owner_user_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'User', options: "{ foreignKey: 'owner_user_id', as: 'owner' }" },
+  { source: 'Site', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'site_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'Site', options: "{ foreignKey: 'site_id', as: 'site' }" },
+  { source: 'Product', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'product_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'Product', options: "{ foreignKey: 'product_id', as: 'product' }" },
+  { source: 'ProductPlan', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'product_plan_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'ProductPlan', options: "{ foreignKey: 'product_plan_id', as: 'productPlan' }" },
+  { source: 'ProductVersion', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'product_version_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'ProductVersion', options: "{ foreignKey: 'product_version_id', as: 'productVersion' }" },
+  { source: 'Subscription', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'subscription_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'Subscription', options: "{ foreignKey: 'subscription_id', as: 'subscription' }" },
+  { source: 'Provider', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'provider_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'Provider', options: "{ foreignKey: 'provider_id', as: 'provider' }" },
+  { source: 'ProviderSetting', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'provider_setting_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'ProviderSetting', options: "{ foreignKey: 'provider_setting_id', as: 'providerSetting' }" },
+  { source: 'DeploymentTemplate', method: 'hasMany', target: 'Deployment', options: "{ foreignKey: 'template_id', sourceKey: 'id', as: 'deployments' }" },
+  { source: 'Deployment', method: 'belongsTo', target: 'DeploymentTemplate', options: "{ foreignKey: 'template_id', as: 'template' }" },
+  { source: 'Deployment', method: 'hasMany', target: 'DeploymentJob', options: "{ foreignKey: 'deployment_id', as: 'jobs', onDelete: 'CASCADE' }" },
+  { source: 'DeploymentJob', method: 'belongsTo', target: 'Deployment', options: "{ foreignKey: 'deployment_id', as: 'deployment' }" },
+  { source: 'Org', method: 'hasMany', target: 'DeploymentJob', options: "{ foreignKey: 'org_id', sourceKey: 'id', as: 'deploymentJobs' }" },
+  { source: 'DeploymentJob', method: 'belongsTo', target: 'Org', options: "{ foreignKey: 'org_id', as: 'org' }" },
+  { source: 'Project', method: 'hasMany', target: 'DeploymentJob', options: "{ foreignKey: 'project_id', sourceKey: 'id', as: 'deploymentJobs' }" },
+  { source: 'DeploymentJob', method: 'belongsTo', target: 'Project', options: "{ foreignKey: 'project_id', as: 'project' }" },
+  { source: 'Product', method: 'hasMany', target: 'DeploymentJob', options: "{ foreignKey: 'product_id', sourceKey: 'id', as: 'deploymentJobs' }" },
+  { source: 'DeploymentJob', method: 'belongsTo', target: 'Product', options: "{ foreignKey: 'product_id', as: 'product' }" },
+  { source: 'ProductVersion', method: 'hasMany', target: 'DeploymentJob', options: "{ foreignKey: 'product_version_id', sourceKey: 'id', as: 'deploymentJobs' }" },
+  { source: 'DeploymentJob', method: 'belongsTo', target: 'ProductVersion', options: "{ foreignKey: 'product_version_id', as: 'productVersion' }" },
+  { source: 'Subscription', method: 'hasMany', target: 'DeploymentJob', options: "{ foreignKey: 'subscription_id', sourceKey: 'id', as: 'deploymentJobs' }" },
+  { source: 'DeploymentJob', method: 'belongsTo', target: 'Subscription', options: "{ foreignKey: 'subscription_id', as: 'subscription' }" },
+  { source: 'Provider', method: 'hasMany', target: 'DeploymentJob', options: "{ foreignKey: 'provider_id', sourceKey: 'id', as: 'deploymentJobs' }" },
+  { source: 'DeploymentJob', method: 'belongsTo', target: 'Provider', options: "{ foreignKey: 'provider_id', as: 'provider' }" },
+  { source: 'Deployment', method: 'hasMany', target: 'DeploymentBackup', options: "{ foreignKey: 'deployment_id', as: 'backups', onDelete: 'CASCADE' }" },
+  { source: 'DeploymentBackup', method: 'belongsTo', target: 'Deployment', options: "{ foreignKey: 'deployment_id', as: 'deployment' }" },
+  { source: 'Org', method: 'hasMany', target: 'DeploymentBackup', options: "{ foreignKey: 'org_id', sourceKey: 'id', as: 'deploymentBackups' }" },
+  { source: 'DeploymentBackup', method: 'belongsTo', target: 'Org', options: "{ foreignKey: 'org_id', as: 'org' }" },
+  { source: 'Project', method: 'hasMany', target: 'DeploymentBackup', options: "{ foreignKey: 'project_id', sourceKey: 'id', as: 'deploymentBackups' }" },
+  { source: 'DeploymentBackup', method: 'belongsTo', target: 'Project', options: "{ foreignKey: 'project_id', as: 'project' }" },
+]
+
+export const cmsDefinition = createCrudScaffoldDefinition({
+  title: 'CMS',
+  routePrefix: 'cms-',
+  resources,
+  associations,
+  migrationPrefix: '20260615090',
+  doneMessage: 'CMS deployment system scaffold complete.\nRun again with --force to overwrite existing generated files.',
+  namespace: {
+    camel: 'cms',
+    kebab: 'cms',
+    pascal: 'Cms',
+    title: 'CMS',
+  },
+  scope: {
+    resource: 'deployments',
+    org: { field: 'org_id' },
+    project: { field: 'project_id', picker: true },
+  },
+  api: {
+    root: 'api/lib/cms',
+    importRoot: '@lib/cms',
+    migrationRoot: 'api/lib/cms/migrations',
+  },
+  externalModelImports: {
+    ProviderSetting: '@lib/models',
+  },
+  src: {
+    root: 'src/cms',
+    importRoot: '@/cms',
+  },
+  store: {
+    apiSliceName: 'cmsApiSlice',
+    reducerPath: 'api/cms',
+    insertAfterApiSlice: 'pageApiSlice',
+  },
+  sideNav: {
+    appKey: 'deployments',
+    label: 'Deployments',
+    title: 'Deployments',
+    icon: 'bi bi-rocket-takeoff',
+    primaryRoute: 'cms-deployments',
+    activeRoutes: ['cms-deployments'],
+    previousAdditionalItemKeys: ['deployment-jobs'],
+    resourceSidebar: false,
+    previousAppKeys: ['cms'],
+  },
+  permissions: {
+    appKey: 'deployments',
+    label: 'Deployments',
+    actions: ['read', 'create', 'update', 'delete'],
+    previousAppKeys: ['cms'],
+    insertAfterAppKey: 'providers',
+  },
+})
+
+export default cmsDefinition