fix: delete unused old files

* feat: added activity filters for state and assignee

* chore: removed unused funtion

* chore: lint fix

.codespellrc

@@ -0,0 +1,7 @@
+[codespell]
+# Ref: https://github.com/codespell-project/codespell#using-a-config-file
+skip = .git*,*.svg,i18n,*-lock.yaml,*.css,.codespellrc,migrations,*.js,*.map,*.mjs
+check-hidden = true
+# ignore all CamelCase and camelCase
+ignore-regex = \b[A-Za-z][a-z]+[A-Z][a-zA-Z]+\b
+ignore-words-list = tread

.dockerignore

@@ -61,3 +61,9 @@ temp/
 # Misc
 *.pem
 *.key
+
+# React Router - https://github.com/remix-run/react-router-templates/blob/dc79b1a065f59f3bfd840d4ef75cc27689b611e6/default/.dockerignore
+.react-router/
+build/
+node_modules/
+README.md

.github/workflows/codespell.yml

@@ -0,0 +1,25 @@
+# Codespell configuration is within .codespellrc
+---
+name: Codespell
+
+on:
+  push:
+    branches: [preview]
+  pull_request:
+    branches: [preview]
+
+permissions:
+  contents: read
+
+jobs:
+  codespell:
+    name: Check for spelling errors
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Annotate locations with typos
+        uses: codespell-project/codespell-problem-matcher@v1
+      - name: Codespell
+        uses: codespell-project/actions-codespell@v2

.github/workflows/docker-smoke.yml

@@ -1,167 +0,0 @@
-name: Docker build and smoke test for apps
-
-on:
-  workflow_dispatch:
-  pull_request:
-    branches: ["preview"]
-    paths:
-      - "apps/web/**"
-      - "apps/space/**"
-      - "apps/admin/**"
-      - "apps/live/**"
-      - "packages/**"
-      - "turbo.json"
-      - "pnpm-lock.yaml"
-      - "pnpm-workspace.yaml"
-      - ".github/workflows/docker-smoke.yml"
-  push:
-    branches: ["preview"]
-    paths:
-      - "apps/web/**"
-      - "apps/space/**"
-      - "apps/admin/**"
-      - "apps/live/**"
-      - "packages/**"
-      - "turbo.json"
-      - "pnpm-lock.yaml"
-      - "pnpm-workspace.yaml"
-      - ".github/workflows/docker-smoke.yml"
-
-permissions:
-  contents: read
-
-concurrency:
-  group: docker-smoke-${{ github.workflow }}-${{ github.ref }}
-  cancel-in-progress: true
-
-jobs:
-  determine-matrix:
-    name: Determine matrix
-    runs-on: ubuntu-latest
-    outputs:
-      matrix: ${{ steps.build-matrix.outputs.matrix }}
-      has_targets: ${{ steps.build-matrix.outputs.has_targets }}
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Detect changed paths
-        id: changes
-        uses: dorny/paths-filter@v3
-        with:
-          filters: |
-            web:
-              - 'apps/web/**'
-            space:
-              - 'apps/space/**'
-            admin:
-              - 'apps/admin/**'
-            live:
-              - 'apps/live/**'
-            common:
-              - 'turbo.json'
-              - 'pnpm-lock.yaml'
-              - 'pnpm-workspace.yaml'
-              - '.github/workflows/docker-smoke.yml'
-              - 'packages/**'
-
-      - name: Build matrix
-        id: build-matrix
-        uses: actions/github-script@v7
-        with:
-          script: |
-            const include = [];
-            const eventName = context.eventName;
-            const anyCommon = '${{ steps.changes.outputs.common }}' === 'true';
-            const changed = {
-              web: '${{ steps.changes.outputs.web }}' === 'true',
-              space: '${{ steps.changes.outputs.space }}' === 'true',
-              admin: '${{ steps.changes.outputs.admin }}' === 'true',
-              live: '${{ steps.changes.outputs.live }}' === 'true',
-            };
-            const add = (name, dockerfile, image, container, port, path, env_flags = "") => include.push({ name, dockerfile, image, container, host_port: port, path, env_flags });
-            const buildAll = anyCommon || eventName === 'push' || eventName === 'workflow_dispatch';
-            if (buildAll || changed.web) add('web', 'apps/web/Dockerfile.web', 'plane-web:ci-smoke', 'plane-web-ci', 3001, '/');
-            if (buildAll || changed.space) add('space', 'apps/space/Dockerfile.space', 'plane-space:ci-smoke', 'plane-space-ci', 3002, '/spaces');
-            if (buildAll || changed.admin) add('admin', 'apps/admin/Dockerfile.admin', 'plane-admin:ci-smoke', 'plane-admin-ci', 3003, '/god-mode');
-            if (buildAll || changed.live) add('live', 'apps/live/Dockerfile.live', 'plane-live:ci-smoke', 'plane-live-ci', 3004, '/live/health', '-e NODE_ENV=production -e LIVE_BASE_PATH=/live');
-            const hasTargets = include.length > 0;
-            if (!hasTargets) {
-              core.warning('No changes detected for any app. Matrix is empty. Skipping smoke tests.');
-            }
-            core.setOutput('matrix', JSON.stringify({ include }));
-            core.setOutput('has_targets', String(hasTargets));
-  smoke:
-    name: Build and smoke test ${{ matrix.name }}
-    runs-on: ubuntu-latest
-    needs: determine-matrix
-    if: ${{ needs.determine-matrix.outputs.has_targets == 'true' }}
-    timeout-minutes: 25
-
-    strategy:
-      fail-fast: false
-      matrix: ${{ fromJSON(needs.determine-matrix.outputs.matrix) }}
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Show Docker version
-        run: |
-          docker version
-          docker info
-
-      - name: Run scripts/smoke.sh for ${{ matrix.name }}
-        shell: bash
-        run: |
-          set -euo pipefail
-          svc="${{ matrix.name }}"
-          case "$svc" in
-            web)
-              export WEB_PORT=${{ matrix.host_port }}
-              export WEB_PATH='${{ matrix.path }}'
-              ;;
-            admin)
-              export ADMIN_PORT=${{ matrix.host_port }}
-              export ADMIN_PATH='${{ matrix.path }}'
-              export ADMIN_BASE_PATH='/god-mode'
-              ;;
-            space)
-              export SPACE_PORT=${{ matrix.host_port }}
-              export SPACE_PATH='${{ matrix.path }}'
-              export SPACE_BASE_PATH='/spaces'
-              ;;
-            live)
-              export LIVE_PORT=${{ matrix.host_port }}
-              export LIVE_PATH='${{ matrix.path }}'
-              export LIVE_BASE_PATH='/live'
-              ;;
-          esac
-          export MAX_WAIT=120
-          export SLEEP_INTERVAL=2
-          export NODE_ENV=production
-          set +e
-          output="$(bash scripts/smoke.sh up --services "$svc")"
-          status=$?
-          set -e
-          echo "$output"
-          if [ $status -ne 0 ]; then
-            echo "smoke.sh exited non-zero ($status)"
-            exit $status
-          fi
-          if echo "$output" | grep -qi "failure(s)"; then
-            echo "::group::Container logs ($svc)"
-            docker ps -a || true
-            docker logs "plane-${svc}-smoke" || true
-            echo "::endgroup::"
-            exit 1
-          fi
-
-      - name: Cleanup smoke containers (${{ matrix.name }})
-        if: always()
-        run: |
-          bash scripts/smoke.sh down

.gitignore

@@ -16,9 +16,10 @@ node_modules
 /out/
 
 # Production
-/build
 dist/
 out/
+build/
+.react-router/
 
 # Misc
 .DS_Store
@@ -99,3 +100,5 @@ dev-editor
 *.rdb.gz
 
 storybook-static
+
+CLAUDE.md

.mise.toml

@@ -0,0 +1,2 @@
+[tools]
+node = "22.18.0"

apps/admin/.eslintrc.js

@@ -1,4 +1,18 @@
 module.exports = {
   root: true,
   extends: ["@plane/eslint-config/next.js"],
+  rules: {
+    "no-duplicate-imports": "off",
+    "import/no-duplicates": ["error", { "prefer-inline": false }],
+    "import/consistent-type-specifier-style": ["error", "prefer-top-level"],
+    "@typescript-eslint/no-import-type-side-effects": "error",
+    "@typescript-eslint/consistent-type-imports": [
+      "error",
+      {
+        prefer: "type-imports",
+        fixStyle: "separate-type-imports",
+        disallowTypeAnnotations: false,
+      },
+    ],
+  },
 };

apps/admin/app/(all)/(dashboard)/ai/form.tsx

@@ -1,12 +1,13 @@
 "use client";
-import { FC } from "react";
+import type { FC } from "react";
 import { useForm } from "react-hook-form";
 import { Lightbulb } from "lucide-react";
 import { Button } from "@plane/propel/button";
-import { IFormattedInstanceConfiguration, TInstanceAIConfigurationKeys } from "@plane/types";
-import { TOAST_TYPE, setToast } from "@plane/ui";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import type { IFormattedInstanceConfiguration, TInstanceAIConfigurationKeys } from "@plane/types";
 // components
-import { ControllerInput, TControllerInputFormField } from "@/components/common/controller-input";
+import type { TControllerInputFormField } from "@/components/common/controller-input";
+import { ControllerInput } from "@/components/common/controller-input";
 // hooks
 import { useInstance } from "@/hooks/store";
 

apps/admin/app/(all)/(dashboard)/ai/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   title: "Artificial Intelligence Settings - God Mode",

apps/admin/app/(all)/(dashboard)/authentication/github/form.tsx

@@ -1,20 +1,25 @@
 "use client";
 
-import { FC, useState } from "react";
+import type { FC } from "react";
+import { useState } from "react";
 import { isEmpty } from "lodash-es";
 import Link from "next/link";
 import { useForm } from "react-hook-form";
+import { Monitor } from "lucide-react";
 // plane internal packages
 import { API_BASE_URL } from "@plane/constants";
 import { Button, getButtonStyling } from "@plane/propel/button";
-import { IFormattedInstanceConfiguration, TInstanceGithubAuthenticationConfigurationKeys } from "@plane/types";
-import { TOAST_TYPE, setToast } from "@plane/ui";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import type { IFormattedInstanceConfiguration, TInstanceGithubAuthenticationConfigurationKeys } from "@plane/types";
+
 import { cn } from "@plane/utils";
 // components
 import { CodeBlock } from "@/components/common/code-block";
 import { ConfirmDiscardModal } from "@/components/common/confirm-discard-modal";
-import { ControllerInput, TControllerInputFormField } from "@/components/common/controller-input";
-import { CopyField, TCopyField } from "@/components/common/copy-field";
+import type { TControllerInputFormField } from "@/components/common/controller-input";
+import { ControllerInput } from "@/components/common/controller-input";
+import type { TCopyField } from "@/components/common/copy-field";
+import { CopyField } from "@/components/common/copy-field";
 // hooks
 import { useInstance } from "@/hooks/store";
 
@@ -102,7 +107,7 @@ export const InstanceGithubConfigForm: FC<Props> = (props) => {
     },
   ];
 
-  const GITHUB_SERVICE_FIELD: TCopyField[] = [
+  const GITHUB_COMMON_SERVICE_DETAILS: TCopyField[] = [
     {
       key: "Origin_URL",
       label: "Origin URL",
@@ -122,6 +127,9 @@ export const InstanceGithubConfigForm: FC<Props> = (props) => {
         </>
       ),
     },
+  ];
+
+  const GITHUB_SERVICE_DETAILS: TCopyField[] = [
     {
       key: "Callback_URI",
       label: "Callback URI",
@@ -209,12 +217,29 @@ export const InstanceGithubConfigForm: FC<Props> = (props) => {
               </div>
             </div>
           </div>
-          <div className="col-span-2 md:col-span-1">
-            <div className="flex flex-col gap-y-4 px-6 pt-1.5 pb-4 bg-custom-background-80/60 rounded-lg">
-              <div className="pt-2 text-xl font-medium">Plane-provided details for GitHub</div>
-              {GITHUB_SERVICE_FIELD.map((field) => (
-                <CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
-              ))}
+          <div className="col-span-2 md:col-span-1 flex flex-col gap-y-6">
+            <div className="pt-2 text-xl font-medium">Plane-provided details for GitHub</div>
+
+            <div className="flex flex-col gap-y-4">
+              {/* common service details */}
+              <div className="flex flex-col gap-y-4 px-6 py-4 bg-custom-background-80 rounded-lg">
+                {GITHUB_COMMON_SERVICE_DETAILS.map((field) => (
+                  <CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
+                ))}
+              </div>
+
+              {/* web service details */}
+              <div className="flex flex-col rounded-lg overflow-hidden">
+                <div className="px-6 py-3 bg-custom-background-80/60 font-medium text-xs uppercase flex items-center gap-x-3 text-custom-text-200">
+                  <Monitor className="w-3 h-3" />
+                  Web
+                </div>
+                <div className="px-6 py-4 flex flex-col gap-y-4 bg-custom-background-80">
+                  {GITHUB_SERVICE_DETAILS.map((field) => (
+                    <CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
+                  ))}
+                </div>
+              </div>
             </div>
           </div>
         </div>

apps/admin/app/(all)/(dashboard)/authentication/github/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   title: "GitHub Authentication - God Mode",

apps/admin/app/(all)/(dashboard)/authentication/github/page.tsx

@@ -6,7 +6,8 @@ import Image from "next/image";
 import { useTheme } from "next-themes";
 import useSWR from "swr";
 // plane internal packages
-import { Loader, ToggleSwitch, setPromiseToast } from "@plane/ui";
+import { setPromiseToast } from "@plane/propel/toast";
+import { Loader, ToggleSwitch } from "@plane/ui";
 import { resolveGeneralTheme } from "@plane/utils";
 // components
 import { AuthenticationMethodCard } from "@/components/authentication/authentication-method-card";

apps/admin/app/(all)/(dashboard)/authentication/gitlab/form.tsx

@@ -1,18 +1,21 @@
-import { FC, useState } from "react";
+import type { FC } from "react";
+import { useState } from "react";
 import { isEmpty } from "lodash-es";
 import Link from "next/link";
 import { useForm } from "react-hook-form";
 // plane internal packages
 import { API_BASE_URL } from "@plane/constants";
 import { Button, getButtonStyling } from "@plane/propel/button";
-import { IFormattedInstanceConfiguration, TInstanceGitlabAuthenticationConfigurationKeys } from "@plane/types";
-import { TOAST_TYPE, setToast } from "@plane/ui";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import type { IFormattedInstanceConfiguration, TInstanceGitlabAuthenticationConfigurationKeys } from "@plane/types";
 import { cn } from "@plane/utils";
 // components
 import { CodeBlock } from "@/components/common/code-block";
 import { ConfirmDiscardModal } from "@/components/common/confirm-discard-modal";
-import { ControllerInput, TControllerInputFormField } from "@/components/common/controller-input";
-import { CopyField, TCopyField } from "@/components/common/copy-field";
+import type { TControllerInputFormField } from "@/components/common/controller-input";
+import { ControllerInput } from "@/components/common/controller-input";
+import type { TCopyField } from "@/components/common/copy-field";
+import { CopyField } from "@/components/common/copy-field";
 // hooks
 import { useInstance } from "@/hooks/store";
 

apps/admin/app/(all)/(dashboard)/authentication/gitlab/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   title: "GitLab Authentication - God Mode",

apps/admin/app/(all)/(dashboard)/authentication/gitlab/page.tsx

@@ -4,7 +4,8 @@ import { useState } from "react";
 import { observer } from "mobx-react";
 import Image from "next/image";
 import useSWR from "swr";
-import { Loader, ToggleSwitch, setPromiseToast } from "@plane/ui";
+import { setPromiseToast } from "@plane/propel/toast";
+import { Loader, ToggleSwitch } from "@plane/ui";
 // components
 import { AuthenticationMethodCard } from "@/components/authentication/authentication-method-card";
 // hooks

apps/admin/app/(all)/(dashboard)/authentication/google/form.tsx

@@ -1,19 +1,23 @@
 "use client";
-import { FC, useState } from "react";
+import type { FC } from "react";
+import { useState } from "react";
 import { isEmpty } from "lodash-es";
 import Link from "next/link";
 import { useForm } from "react-hook-form";
+import { Monitor } from "lucide-react";
 // plane internal packages
 import { API_BASE_URL } from "@plane/constants";
 import { Button, getButtonStyling } from "@plane/propel/button";
-import { IFormattedInstanceConfiguration, TInstanceGoogleAuthenticationConfigurationKeys } from "@plane/types";
-import { TOAST_TYPE, setToast } from "@plane/ui";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import type { IFormattedInstanceConfiguration, TInstanceGoogleAuthenticationConfigurationKeys } from "@plane/types";
 import { cn } from "@plane/utils";
 // components
 import { CodeBlock } from "@/components/common/code-block";
 import { ConfirmDiscardModal } from "@/components/common/confirm-discard-modal";
-import { ControllerInput, TControllerInputFormField } from "@/components/common/controller-input";
-import { CopyField, TCopyField } from "@/components/common/copy-field";
+import type { TControllerInputFormField } from "@/components/common/controller-input";
+import { ControllerInput } from "@/components/common/controller-input";
+import type { TCopyField } from "@/components/common/copy-field";
+import { CopyField } from "@/components/common/copy-field";
 // hooks
 import { useInstance } from "@/hooks/store";
 
@@ -91,7 +95,7 @@ export const InstanceGoogleConfigForm: FC<Props> = (props) => {
     },
   ];
 
-  const GOOGLE_SERVICE_DETAILS: TCopyField[] = [
+  const GOOGLE_COMMON_SERVICE_DETAILS: TCopyField[] = [
     {
       key: "Origin_URL",
       label: "Origin URL",
@@ -111,6 +115,9 @@ export const InstanceGoogleConfigForm: FC<Props> = (props) => {
         </p>
       ),
     },
+  ];
+
+  const GOOGLE_SERVICE_DETAILS: TCopyField[] = [
     {
       key: "Callback_URI",
       label: "Callback URI",
@@ -196,12 +203,29 @@ export const InstanceGoogleConfigForm: FC<Props> = (props) => {
               </div>
             </div>
           </div>
-          <div className="col-span-2 md:col-span-1">
-            <div className="flex flex-col gap-y-4 px-6 pt-1.5 pb-4 bg-custom-background-80/60 rounded-lg">
-              <div className="pt-2 text-xl font-medium">Plane-provided details for Google</div>
-              {GOOGLE_SERVICE_DETAILS.map((field) => (
-                <CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
-              ))}
+          <div className="col-span-2 md:col-span-1 flex flex-col gap-y-6">
+            <div className="pt-2 text-xl font-medium">Plane-provided details for Google</div>
+
+            <div className="flex flex-col gap-y-4">
+              {/* common service details */}
+              <div className="flex flex-col gap-y-4 px-6 py-4 bg-custom-background-80 rounded-lg">
+                {GOOGLE_COMMON_SERVICE_DETAILS.map((field) => (
+                  <CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
+                ))}
+              </div>
+
+              {/* web service details */}
+              <div className="flex flex-col rounded-lg overflow-hidden">
+                <div className="px-6 py-3 bg-custom-background-80/60 font-medium text-xs uppercase flex items-center gap-x-3 text-custom-text-200">
+                  <Monitor className="w-3 h-3" />
+                  Web
+                </div>
+                <div className="px-6 py-4 flex flex-col gap-y-4 bg-custom-background-80">
+                  {GOOGLE_SERVICE_DETAILS.map((field) => (
+                    <CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
+                  ))}
+                </div>
+              </div>
             </div>
           </div>
         </div>

apps/admin/app/(all)/(dashboard)/authentication/google/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   title: "Google Authentication - God Mode",

apps/admin/app/(all)/(dashboard)/authentication/google/page.tsx

@@ -4,7 +4,8 @@ import { useState } from "react";
 import { observer } from "mobx-react";
 import Image from "next/image";
 import useSWR from "swr";
-import { Loader, ToggleSwitch, setPromiseToast } from "@plane/ui";
+import { setPromiseToast } from "@plane/propel/toast";
+import { Loader, ToggleSwitch } from "@plane/ui";
 // components
 import { AuthenticationMethodCard } from "@/components/authentication/authentication-method-card";
 // hooks

apps/admin/app/(all)/(dashboard)/authentication/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   title: "Authentication Settings - Plane Web",

apps/admin/app/(all)/(dashboard)/authentication/page.tsx

@@ -4,8 +4,9 @@ import { useState } from "react";
 import { observer } from "mobx-react";
 import useSWR from "swr";
 // plane internal packages
-import { TInstanceConfigurationKeys } from "@plane/types";
-import { Loader, ToggleSwitch, setPromiseToast } from "@plane/ui";
+import { setPromiseToast } from "@plane/propel/toast";
+import type { TInstanceConfigurationKeys } from "@plane/types";
+import { Loader, ToggleSwitch } from "@plane/ui";
 import { cn } from "@plane/utils";
 // hooks
 import { useInstance } from "@/hooks/store";

apps/admin/app/(all)/(dashboard)/email/email-config-form.tsx

@@ -1,14 +1,17 @@
 "use client";
 
-import React, { FC, useMemo, useState } from "react";
+import type { FC } from "react";
+import React, { useMemo, useState } from "react";
 import { useForm } from "react-hook-form";
 // types
 import { Button } from "@plane/propel/button";
-import { IFormattedInstanceConfiguration, TInstanceEmailConfigurationKeys } from "@plane/types";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import type { IFormattedInstanceConfiguration, TInstanceEmailConfigurationKeys } from "@plane/types";
 // ui
-import { CustomSelect, TOAST_TYPE, setToast } from "@plane/ui";
+import { CustomSelect } from "@plane/ui";
 // components
-import { ControllerInput, TControllerInputFormField } from "@/components/common/controller-input";
+import type { TControllerInputFormField } from "@/components/common/controller-input";
+import { ControllerInput } from "@/components/common/controller-input";
 // hooks
 import { useInstance } from "@/hooks/store";
 // local components

apps/admin/app/(all)/(dashboard)/email/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 interface EmailLayoutProps {
   children: ReactNode;

apps/admin/app/(all)/(dashboard)/email/page.tsx

@@ -3,7 +3,8 @@
 import { useEffect, useState } from "react";
 import { observer } from "mobx-react";
 import useSWR from "swr";
-import { Loader, setToast, TOAST_TYPE, ToggleSwitch } from "@plane/ui";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import { Loader, ToggleSwitch } from "@plane/ui";
 // hooks
 import { useInstance } from "@/hooks/store";
 // components

apps/admin/app/(all)/(dashboard)/email/test-email-modal.tsx

@@ -1,4 +1,5 @@
-import React, { FC, useEffect, useState } from "react";
+import type { FC } from "react";
+import React, { useEffect, useState } from "react";
 import { Dialog, Transition } from "@headlessui/react";
 // plane imports
 import { Button } from "@plane/propel/button";

apps/admin/app/(all)/(dashboard)/general/form.tsx

@@ -1,13 +1,14 @@
 "use client";
-import { FC } from "react";
+import type { FC } from "react";
 import { observer } from "mobx-react";
 import { Controller, useForm } from "react-hook-form";
 import { Telescope } from "lucide-react";
 // types
 import { Button } from "@plane/propel/button";
-import { IInstance, IInstanceAdmin } from "@plane/types";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import type { IInstance, IInstanceAdmin } from "@plane/types";
 // ui
-import { Input, TOAST_TYPE, ToggleSwitch, setToast } from "@plane/ui";
+import { Input, ToggleSwitch } from "@plane/ui";
 // components
 import { ControllerInput } from "@/components/common/controller-input";
 import { useInstance } from "@/hooks/store";

apps/admin/app/(all)/(dashboard)/general/intercom.tsx

@@ -1,10 +1,11 @@
 "use client";
 
-import { FC, useState } from "react";
+import type { FC } from "react";
+import { useState } from "react";
 import { observer } from "mobx-react";
 import useSWR from "swr";
 import { MessageSquare } from "lucide-react";
-import { IFormattedInstanceConfiguration } from "@plane/types";
+import type { IFormattedInstanceConfiguration } from "@plane/types";
 import { ToggleSwitch } from "@plane/ui";
 // hooks
 import { useInstance } from "@/hooks/store";

apps/admin/app/(all)/(dashboard)/general/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   title: "General Settings - God Mode",

apps/admin/app/(all)/(dashboard)/header.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { FC } from "react";
+import type { FC } from "react";
 import { observer } from "mobx-react";
 import { usePathname } from "next/navigation";
 import { Menu, Settings } from "lucide-react";

apps/admin/app/(all)/(dashboard)/image/form.tsx

@@ -1,9 +1,9 @@
 "use client";
-import { FC } from "react";
+import type { FC } from "react";
 import { useForm } from "react-hook-form";
 import { Button } from "@plane/propel/button";
-import { IFormattedInstanceConfiguration, TInstanceImageConfigurationKeys } from "@plane/types";
-import { TOAST_TYPE, setToast } from "@plane/ui";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
+import type { IFormattedInstanceConfiguration, TInstanceImageConfigurationKeys } from "@plane/types";
 // components
 import { ControllerInput } from "@/components/common/controller-input";
 // hooks

apps/admin/app/(all)/(dashboard)/image/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 interface ImageLayoutProps {
   children: ReactNode;

apps/admin/app/(all)/(dashboard)/layout.tsx

@@ -1,6 +1,7 @@
 "use client";
 
-import { FC, ReactNode, useEffect } from "react";
+import type { FC, ReactNode } from "react";
+import { useEffect } from "react";
 import { observer } from "mobx-react";
 import { useRouter } from "next/navigation";
 // components

apps/admin/app/(all)/(dashboard)/sidebar-help-section.tsx

@@ -1,13 +1,14 @@
 "use client";
 
-import { FC, useState, useRef } from "react";
+import type { FC } from "react";
+import { useState, useRef } from "react";
 import { observer } from "mobx-react";
 import Link from "next/link";
-import { ExternalLink, FileText, HelpCircle, MoveLeft } from "lucide-react";
+import { ExternalLink, HelpCircle, MoveLeft } from "lucide-react";
 import { Transition } from "@headlessui/react";
 // plane internal packages
 import { WEB_BASE_URL } from "@plane/constants";
-import { DiscordIcon, GithubIcon } from "@plane/propel/icons";
+import { DiscordIcon, GithubIcon, PageIcon } from "@plane/propel/icons";
 import { Tooltip } from "@plane/propel/tooltip";
 import { cn } from "@plane/utils";
 // hooks
@@ -20,7 +21,7 @@ const helpOptions = [
   {
     name: "Documentation",
     href: "https://docs.plane.so/",
-    Icon: FileText,
+    Icon: PageIcon,
   },
   {
     name: "Join our Discord",
@@ -110,7 +111,7 @@ export const AdminSidebarHelpSection: FC = observer(() => {
                     <Link href={href} key={name} target="_blank">
                       <div className="flex items-center gap-x-2 rounded px-2 py-1 text-xs hover:bg-custom-background-80">
                         <div className="grid flex-shrink-0 place-items-center">
-                          <Icon className="h-3.5 w-3.5 text-custom-text-200" size={14} />
+                          <Icon className="h-3.5 w-3.5 text-custom-text-200" width={14} height={14} />
                         </div>
                         <span className="text-xs">{name}</span>
                       </div>

apps/admin/app/(all)/(dashboard)/sidebar.tsx

@@ -1,6 +1,7 @@
 "use client";
 
-import { FC, useEffect, useRef } from "react";
+import type { FC } from "react";
+import { useEffect, useRef } from "react";
 import { observer } from "mobx-react";
 // plane helpers
 import { useOutsideClickDetector } from "@plane/hooks";

apps/admin/app/(all)/(dashboard)/workspace/create/form.tsx

@@ -5,10 +5,11 @@ import { Controller, useForm } from "react-hook-form";
 // plane imports
 import { WEB_BASE_URL, ORGANIZATION_SIZE, RESTRICTED_URLS } from "@plane/constants";
 import { Button, getButtonStyling } from "@plane/propel/button";
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
 import { InstanceWorkspaceService } from "@plane/services";
-import { IWorkspace } from "@plane/types";
+import type { IWorkspace } from "@plane/types";
 // components
-import { CustomSelect, Input, setToast, TOAST_TYPE } from "@plane/ui";
+import { CustomSelect, Input } from "@plane/ui";
 // hooks
 import { useWorkspace } from "@/hooks/store";
 

apps/admin/app/(all)/(dashboard)/workspace/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 
 export const metadata: Metadata = {
   title: "Workspace Management - God Mode",

apps/admin/app/(all)/(dashboard)/workspace/page.tsx

@@ -7,8 +7,10 @@ import useSWR from "swr";
 import { Loader as LoaderIcon } from "lucide-react";
 // types
 import { Button, getButtonStyling } from "@plane/propel/button";
-import { TInstanceConfigurationKeys } from "@plane/types";
-import { Loader, setPromiseToast, ToggleSwitch } from "@plane/ui";
+import { setPromiseToast } from "@plane/propel/toast";
+import type { TInstanceConfigurationKeys } from "@plane/types";
+import { Loader, ToggleSwitch } from "@plane/ui";
+
 import { cn } from "@plane/utils";
 // components
 import { WorkspaceListItem } from "@/components/workspace/list-item";

apps/admin/app/(all)/(home)/auth-banner.tsx

@@ -1,7 +1,7 @@
-import { FC } from "react";
+import type { FC } from "react";
 import { Info, X } from "lucide-react";
 // plane constants
-import { TAdminAuthErrorInfo } from "@plane/constants";
+import type { TAdminAuthErrorInfo } from "@plane/constants";
 
 type TAuthBanner = {
   bannerData: TAdminAuthErrorInfo | undefined;

apps/admin/app/(all)/(home)/auth-helpers.tsx

@@ -1,10 +1,11 @@
-import { ReactNode } from "react";
+import type { ReactNode } from "react";
 import Image from "next/image";
 import Link from "next/link";
 import { KeyRound, Mails } from "lucide-react";
 // plane packages
-import { SUPPORT_EMAIL, EAdminAuthErrorCodes, TAdminAuthErrorInfo } from "@plane/constants";
-import { TGetBaseAuthenticationModeProps, TInstanceAuthenticationModes } from "@plane/types";
+import type { TAdminAuthErrorInfo } from "@plane/constants";
+import { SUPPORT_EMAIL, EAdminAuthErrorCodes } from "@plane/constants";
+import type { TGetBaseAuthenticationModeProps, TInstanceAuthenticationModes } from "@plane/types";
 import { resolveGeneralTheme } from "@plane/utils";
 // components
 import { EmailCodesConfiguration } from "@/components/authentication/email-config-switch";

apps/admin/app/(all)/(home)/sign-in-form.tsx

@@ -1,10 +1,12 @@
 "use client";
 
-import { FC, useEffect, useMemo, useState } from "react";
+import type { FC } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { useSearchParams } from "next/navigation";
 import { Eye, EyeOff } from "lucide-react";
 // plane internal packages
-import { API_BASE_URL, EAdminAuthErrorCodes, TAdminAuthErrorInfo } from "@plane/constants";
+import type { EAdminAuthErrorCodes, TAdminAuthErrorInfo } from "@plane/constants";
+import { API_BASE_URL } from "@plane/constants";
 import { Button } from "@plane/propel/button";
 import { AuthService } from "@plane/services";
 import { Input, Spinner } from "@plane/ui";

apps/admin/app/(all)/instance.provider.tsx

@@ -1,4 +1,4 @@
-import { FC, ReactNode } from "react";
+import type { FC, ReactNode } from "react";
 import { observer } from "mobx-react";
 import useSWR from "swr";
 // hooks

apps/admin/app/(all)/store.provider.tsx

@@ -1,6 +1,7 @@
 "use client";
 
-import { ReactNode, createContext } from "react";
+import type { ReactNode } from "react";
+import { createContext } from "react";
 // plane admin store
 import { RootStore } from "@/plane-admin/store/root.store";
 

apps/admin/app/(all)/toast.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { useTheme } from "next-themes";
-import { Toast } from "@plane/ui";
+import { Toast } from "@plane/propel/toast";
 import { resolveGeneralTheme } from "@plane/utils";
 
 export const ToastWithTheme = () => {

apps/admin/app/(all)/user.provider.tsx

@@ -1,6 +1,7 @@
 "use client";
 
-import { FC, ReactNode, useEffect } from "react";
+import type { FC, ReactNode } from "react";
+import { useEffect } from "react";
 import { observer } from "mobx-react";
 import useSWR from "swr";
 // hooks

apps/admin/app/layout.tsx

@@ -1,5 +1,5 @@
-import { ReactNode } from "react";
-import { Metadata } from "next";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
 // plane imports
 import { ADMIN_BASE_PATH } from "@plane/constants";
 // styles

apps/admin/ce/components/authentication/authentication-modes.tsx

@@ -3,7 +3,7 @@ import Image from "next/image";
 import { useTheme } from "next-themes";
 import { KeyRound, Mails } from "lucide-react";
 // types
-import {
+import type {
   TGetBaseAuthenticationModeProps,
   TInstanceAuthenticationMethodKeys,
   TInstanceAuthenticationModes,

apps/admin/core/components/authentication/authentication-method-card.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { FC } from "react";
+import type { FC } from "react";
 // helpers
 import { cn } from "@plane/utils";
 

apps/admin/core/components/authentication/email-config-switch.tsx

@@ -3,7 +3,7 @@
 import React from "react";
 import { observer } from "mobx-react";
 // hooks
-import { TInstanceAuthenticationMethodKeys } from "@plane/types";
+import type { TInstanceAuthenticationMethodKeys } from "@plane/types";
 import { ToggleSwitch } from "@plane/ui";
 import { useInstance } from "@/hooks/store";
 // ui

apps/admin/core/components/authentication/github-config.tsx

@@ -7,7 +7,7 @@ import Link from "next/link";
 import { Settings2 } from "lucide-react";
 // plane internal packages
 import { getButtonStyling } from "@plane/propel/button";
-import { TInstanceAuthenticationMethodKeys } from "@plane/types";
+import type { TInstanceAuthenticationMethodKeys } from "@plane/types";
 import { ToggleSwitch } from "@plane/ui";
 import { cn } from "@plane/utils";
 // hooks

apps/admin/core/components/authentication/gitlab-config.tsx

@@ -7,7 +7,7 @@ import Link from "next/link";
 import { Settings2 } from "lucide-react";
 // plane internal packages
 import { getButtonStyling } from "@plane/propel/button";
-import { TInstanceAuthenticationMethodKeys } from "@plane/types";
+import type { TInstanceAuthenticationMethodKeys } from "@plane/types";
 import { ToggleSwitch } from "@plane/ui";
 import { cn } from "@plane/utils";
 // hooks

apps/admin/core/components/authentication/google-config.tsx

@@ -7,7 +7,7 @@ import Link from "next/link";
 import { Settings2 } from "lucide-react";
 // plane internal packages
 import { getButtonStyling } from "@plane/propel/button";
-import { TInstanceAuthenticationMethodKeys } from "@plane/types";
+import type { TInstanceAuthenticationMethodKeys } from "@plane/types";
 import { ToggleSwitch } from "@plane/ui";
 import { cn } from "@plane/utils";
 // hooks

apps/admin/core/components/authentication/password-config-switch.tsx

@@ -3,7 +3,7 @@
 import React from "react";
 import { observer } from "mobx-react";
 // hooks
-import { TInstanceAuthenticationMethodKeys } from "@plane/types";
+import type { TInstanceAuthenticationMethodKeys } from "@plane/types";
 import { ToggleSwitch } from "@plane/ui";
 import { useInstance } from "@/hooks/store";
 // ui

apps/admin/core/components/common/banner.tsx

@@ -1,4 +1,4 @@
-import { FC } from "react";
+import type { FC } from "react";
 import { AlertCircle, CheckCircle2 } from "lucide-react";
 
 type TBanner = {

apps/admin/core/components/common/controller-input.tsx

@@ -1,7 +1,8 @@
 "use client";
 
 import React, { useState } from "react";
-import { Controller, Control } from "react-hook-form";
+import type { Control } from "react-hook-form";
+import { Controller } from "react-hook-form";
 // icons
 import { Eye, EyeOff } from "lucide-react";
 // plane internal packages

apps/admin/core/components/common/copy-field.tsx

@@ -4,8 +4,7 @@ import React from "react";
 // ui
 import { Copy } from "lucide-react";
 import { Button } from "@plane/propel/button";
-import { TOAST_TYPE, setToast } from "@plane/ui";
-// icons
+import { TOAST_TYPE, setToast } from "@plane/propel/toast";
 
 type Props = {
   label: string;

apps/admin/core/components/instance/failure.tsx

@@ -1,5 +1,5 @@
 "use client";
-import { FC } from "react";
+import type { FC } from "react";
 import { observer } from "mobx-react";
 import Image from "next/image";
 import { useTheme } from "next-themes";

apps/admin/core/components/instance/instance-not-ready.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { FC } from "react";
+import type { FC } from "react";
 import Image from "next/image";
 import Link from "next/link";
 import { Button } from "@plane/propel/button";

apps/admin/core/components/instance/setup-form.tsx

@@ -1,6 +1,7 @@
 "use client";
 
-import { FC, useEffect, useMemo, useState } from "react";
+import type { FC } from "react";
+import { useEffect, useMemo, useState } from "react";
 import { useSearchParams } from "next/navigation";
 // icons
 import { Eye, EyeOff } from "lucide-react";

apps/admin/core/hooks/store/use-instance.tsx

@@ -1,7 +1,7 @@
 import { useContext } from "react";
 // store
 import { StoreContext } from "@/app/(all)/store.provider";
-import { IInstanceStore } from "@/store/instance.store";
+import type { IInstanceStore } from "@/store/instance.store";
 
 export const useInstance = (): IInstanceStore => {
   const context = useContext(StoreContext);

apps/admin/core/hooks/store/use-theme.tsx

@@ -1,7 +1,7 @@
 import { useContext } from "react";
 // store
 import { StoreContext } from "@/app/(all)/store.provider";
-import { IThemeStore } from "@/store/theme.store";
+import type { IThemeStore } from "@/store/theme.store";
 
 export const useTheme = (): IThemeStore => {
   const context = useContext(StoreContext);

apps/admin/core/hooks/store/use-user.tsx

@@ -1,7 +1,7 @@
 import { useContext } from "react";
 // store
 import { StoreContext } from "@/app/(all)/store.provider";
-import { IUserStore } from "@/store/user.store";
+import type { IUserStore } from "@/store/user.store";
 
 export const useUser = (): IUserStore => {
   const context = useContext(StoreContext);

apps/admin/core/hooks/store/use-workspace.tsx

@@ -1,7 +1,7 @@
 import { useContext } from "react";
 // store
 import { StoreContext } from "@/app/(all)/store.provider";
-import { IWorkspaceStore } from "@/store/workspace.store";
+import type { IWorkspaceStore } from "@/store/workspace.store";
 
 export const useWorkspace = (): IWorkspaceStore => {
   const context = useContext(StoreContext);

apps/admin/core/store/instance.store.ts

@@ -1,9 +1,10 @@
 import { set } from "lodash-es";
 import { observable, action, computed, makeObservable, runInAction } from "mobx";
 // plane internal packages
-import { EInstanceStatus, TInstanceStatus } from "@plane/constants";
+import type { TInstanceStatus } from "@plane/constants";
+import { EInstanceStatus } from "@plane/constants";
 import { InstanceService } from "@plane/services";
-import {
+import type {
   IInstance,
   IInstanceAdmin,
   IInstanceConfiguration,
@@ -12,7 +13,7 @@ import {
   IInstanceConfig,
 } from "@plane/types";
 // root store
-import { CoreRootStore } from "@/store/root.store";
+import type { CoreRootStore } from "@/store/root.store";
 
 export interface IInstanceStore {
   // issues

apps/admin/core/store/root.store.ts

@@ -1,9 +1,13 @@
 import { enableStaticRendering } from "mobx-react";
 // stores
-import { IInstanceStore, InstanceStore } from "./instance.store";
-import { IThemeStore, ThemeStore } from "./theme.store";
-import { IUserStore, UserStore } from "./user.store";
-import { IWorkspaceStore, WorkspaceStore } from "./workspace.store";
+import type { IInstanceStore } from "./instance.store";
+import { InstanceStore } from "./instance.store";
+import type { IThemeStore } from "./theme.store";
+import { ThemeStore } from "./theme.store";
+import type { IUserStore } from "./user.store";
+import { UserStore } from "./user.store";
+import type { IWorkspaceStore } from "./workspace.store";
+import { WorkspaceStore } from "./workspace.store";
 
 enableStaticRendering(typeof window === "undefined");
 

apps/admin/core/store/theme.store.ts

@@ -1,6 +1,6 @@
 import { action, observable, makeObservable } from "mobx";
 // root store
-import { CoreRootStore } from "@/store/root.store";
+import type { CoreRootStore } from "@/store/root.store";
 
 type TTheme = "dark" | "light";
 export interface IThemeStore {

apps/admin/core/store/user.store.ts

@@ -1,10 +1,11 @@
 import { action, observable, runInAction, makeObservable } from "mobx";
 // plane internal packages
-import { EUserStatus, TUserStatus } from "@plane/constants";
+import type { TUserStatus } from "@plane/constants";
+import { EUserStatus } from "@plane/constants";
 import { AuthService, UserService } from "@plane/services";
-import { IUser } from "@plane/types";
+import type { IUser } from "@plane/types";
 // root store
-import { CoreRootStore } from "@/store/root.store";
+import type { CoreRootStore } from "@/store/root.store";
 
 export interface IUserStore {
   // observables

apps/admin/core/store/workspace.store.ts

@@ -2,9 +2,9 @@ import { set } from "lodash-es";
 import { action, observable, runInAction, makeObservable, computed } from "mobx";
 // plane imports
 import { InstanceWorkspaceService } from "@plane/services";
-import { IWorkspace, TLoader, TPaginationInfo } from "@plane/types";
+import type { IWorkspace, TLoader, TPaginationInfo } from "@plane/types";
 // root store
-import { CoreRootStore } from "@/store/root.store";
+import type { CoreRootStore } from "@/store/root.store";
 
 export interface IWorkspaceStore {
   // observables

apps/admin/package.json

@@ -46,10 +46,9 @@
     "@plane/tailwind-config": "workspace:*",
     "@plane/typescript-config": "workspace:*",
     "@types/lodash-es": "catalog:",
-    "@types/node": "18.16.1",
+    "@types/node": "catalog:",
     "@types/react": "catalog:",
     "@types/react-dom": "catalog:",
-    "@types/uuid": "^9.0.8",
     "typescript": "catalog:"
   }
 }

apps/admin/styles/globals.css

@@ -111,6 +111,27 @@
     --color-sidebar-shadow-2xl: var(--color-shadow-2xl);
     --color-sidebar-shadow-3xl: var(--color-shadow-3xl);
     --color-sidebar-shadow-4xl: var(--color-shadow-4xl);
+
+    /* toast theme */
+    --color-toast-success-text: 178, 221, 181;
+    --color-toast-error-text: 206, 44, 49;
+    --color-toast-warning-text: 255, 186, 24;
+    --color-toast-info-text: 141, 164, 239;
+    --color-toast-loading-text: 255, 255, 255;
+    --color-toast-secondary-text: 185, 187, 198;
+    --color-toast-tertiary-text: 139, 141, 152;
+
+    --color-toast-success-background: 46, 46, 46;
+    --color-toast-error-background: 46, 46, 46;
+    --color-toast-warning-background: 46, 46, 46;
+    --color-toast-info-background: 46, 46, 46;
+    --color-toast-loading-background: 46, 46, 46;
+
+    --color-toast-success-border: 42, 126, 59;
+    --color-toast-error-border: 100, 23, 35;
+    --color-toast-warning-border: 79, 52, 34;
+    --color-toast-info-border: 58, 91, 199;
+    --color-toast-loading-border: 96, 100, 108;
   }
 
   [data-theme="light"],
@@ -221,27 +242,6 @@
     --color-border-200: 38, 38, 38; /* subtle border- 2 */
     --color-border-300: 46, 46, 46; /* strong border- 1 */
     --color-border-400: 58, 58, 58; /* strong border- 2 */
-
-    /* toast theme */
-    --color-toast-success-text: 178, 221, 181;
-    --color-toast-error-text: 206, 44, 49;
-    --color-toast-warning-text: 255, 186, 24;
-    --color-toast-info-text: 141, 164, 239;
-    --color-toast-loading-text: 255, 255, 255;
-    --color-toast-secondary-text: 185, 187, 198;
-    --color-toast-tertiary-text: 139, 141, 152;
-
-    --color-toast-success-background: 46, 46, 46;
-    --color-toast-error-background: 46, 46, 46;
-    --color-toast-warning-background: 46, 46, 46;
-    --color-toast-info-background: 46, 46, 46;
-    --color-toast-loading-background: 46, 46, 46;
-
-    --color-toast-success-border: 42, 126, 59;
-    --color-toast-error-border: 100, 23, 35;
-    --color-toast-warning-border: 79, 52, 34;
-    --color-toast-info-border: 58, 91, 199;
-    --color-toast-loading-border: 96, 100, 108;
   }
 
   [data-theme="dark-contrast"] {

apps/api/plane/api/serializers/cycle.py

@@ -4,7 +4,7 @@ from rest_framework import serializers
 
 # Module imports
 from .base import BaseSerializer
-from plane.db.models import Cycle, CycleIssue
+from plane.db.models import Cycle, CycleIssue, User
 from plane.utils.timezone_converter import convert_to_utc
 
 
@@ -16,6 +16,13 @@ class CycleCreateSerializer(BaseSerializer):
     and UTC normalization for time-bound iteration planning and sprint management.
     """
 
+    owned_by = serializers.PrimaryKeyRelatedField(
+        queryset=User.objects.all(),
+        required=False,
+        allow_null=True,
+        help_text="User who owns the cycle. If not provided, defaults to the current user.",
+    )
+
     def __init__(self, *args, **kwargs):
         super().__init__(*args, **kwargs)
         project = self.context.get("project")
@@ -72,6 +79,10 @@ class CycleCreateSerializer(BaseSerializer):
                 date=str(data.get("end_date", None).date()),
                 project_id=project_id,
             )
+
+        if not data.get("owned_by"):
+            data["owned_by"] = self.context["request"].user
+
         return data
 
 

apps/api/plane/api/serializers/intake.py

@@ -1,4 +1,4 @@
-# Module improts
+# Module imports
 from .base import BaseSerializer
 from .issue import IssueExpandSerializer
 from plane.db.models import IntakeIssue, Issue

apps/api/plane/api/views/cycle.py

@@ -307,7 +307,8 @@ class CycleListCreateAPIEndpoint(BaseAPIView):
         if (request.data.get("start_date", None) is None and request.data.get("end_date", None) is None) or (
             request.data.get("start_date", None) is not None and request.data.get("end_date", None) is not None
         ):
-            serializer = CycleCreateSerializer(data=request.data)
+
+            serializer = CycleCreateSerializer(data=request.data, context={"request": request})
             if serializer.is_valid():
                 if (
                     request.data.get("external_id")
@@ -332,7 +333,7 @@ class CycleListCreateAPIEndpoint(BaseAPIView):
                         },
                         status=status.HTTP_409_CONFLICT,
                     )
-                serializer.save(project_id=project_id, owned_by=request.user)
+                serializer.save(project_id=project_id)
                 # Send the model activity
                 model_activity.delay(
                     model_name="cycle",
@@ -518,7 +519,7 @@ class CycleDetailAPIEndpoint(BaseAPIView):
                     status=status.HTTP_400_BAD_REQUEST,
                 )
 
-        serializer = CycleUpdateSerializer(cycle, data=request.data, partial=True)
+        serializer = CycleUpdateSerializer(cycle, data=request.data, partial=True, context={"request": request})
         if serializer.is_valid():
             if (
                 request.data.get("external_id")

apps/api/plane/app/views/cycle/base.py

@@ -1196,7 +1196,7 @@ class CycleAnalyticsEndpoint(BaseAPIView):
         if the issues were transferred to the new cycle, then the progress_snapshot will be present
         return the progress_snapshot data in the analytics for each date
             
-        else issues were not transferred to the new cycle then generate the stats from the cycle isssue bridge tables
+        else issues were not transferred to the new cycle then generate the stats from the cycle issue bridge tables
         """
 
         if cycle.progress_snapshot:

apps/api/plane/app/views/project/member.py

@@ -48,7 +48,7 @@ class ProjectMemberViewSet(BaseViewSet):
         # Check if the members array is empty
         if not len(members):
             return Response(
-                {"error": "Atleast one member is required"},
+                {"error": "At least one member is required"},
                 status=status.HTTP_400_BAD_REQUEST,
             )
 

apps/api/plane/app/views/timezone/base.py

@@ -99,7 +99,7 @@ class TimezoneEndpoint(APIView):
             ("Tunis", "Africa/Tunis"),  # UTC+01:00
             (
                 "Eastern European Time (Cairo, Helsinki, Kyiv)",
-                "Europe/Kiev",
+                "Europe/Kyiv",
             ),  # UTC+02:00 (DST: UTC+03:00)
             ("Athens", "Europe/Athens"),  # UTC+02:00 (DST: UTC+03:00)
             ("Jerusalem", "Asia/Jerusalem"),  # UTC+02:00 (DST: UTC+03:00)

apps/api/plane/authentication/adapter/error.py

@@ -48,7 +48,7 @@ AUTHENTICATION_ERROR_CODES = {
     "INCORRECT_OLD_PASSWORD": 5135,
     "MISSING_PASSWORD": 5138,
     "INVALID_NEW_PASSWORD": 5140,
-    # set passowrd
+    # set password
     "PASSWORD_ALREADY_SET": 5145,
     # Admin
     "ADMIN_ALREADY_EXIST": 5150,

apps/api/plane/bgtasks/cleanup_task.py

@@ -410,7 +410,8 @@ def get_webhook_logs_queryset():
             "response_headers",
             "retry_count",
         )
-        .iterator(chunk_size=BATCH_SIZE)
+        .order_by("created_at")
+        .iterator(chunk_size=100)
     )
 
 

apps/api/plane/bgtasks/export_task.py

@@ -1,82 +1,24 @@
 # Python imports
-import csv
 import io
-import json
 import zipfile
 from typing import List
+from collections import defaultdict
 import boto3
 from botocore.client import Config
 from uuid import UUID
-from datetime import datetime, date
 
 # Third party imports
 from celery import shared_task
 
-
 # Django imports
 from django.conf import settings
 from django.utils import timezone
-from openpyxl import Workbook
-from django.db.models import F, Prefetch
-
-from collections import defaultdict
+from django.db.models import Prefetch
 
 # Module imports
-from plane.db.models import ExporterHistory, Issue, FileAsset, Label, User, IssueComment
+from plane.db.models import ExporterHistory, Issue, IssueRelation
 from plane.utils.exception_logger import log_exception
-
-
-def dateTimeConverter(time: datetime) -> str | None:
-    """
-    Convert a datetime object to a formatted string.
-    """
-    if time:
-        return time.strftime("%a, %d %b %Y %I:%M:%S %Z%z")
-
-
-def dateConverter(time: date) -> str | None:
-    """
-    Convert a date object to a formatted string.
-    """
-    if time:
-        return time.strftime("%a, %d %b %Y")
-
-
-def create_csv_file(data: List[List[str]]) -> str:
-    """
-    Create a CSV file from the provided data.
-    """
-    csv_buffer = io.StringIO()
-    csv_writer = csv.writer(csv_buffer, delimiter=",", quoting=csv.QUOTE_ALL)
-
-    for row in data:
-        csv_writer.writerow(row)
-
-    csv_buffer.seek(0)
-    return csv_buffer.getvalue()
-
-
-def create_json_file(data: List[dict]) -> str:
-    """
-    Create a JSON file from the provided data.
-    """
-    return json.dumps(data)
-
-
-def create_xlsx_file(data: List[List[str]]) -> bytes:
-    """
-    Create an XLSX file from the provided data.
-    """
-    workbook = Workbook()
-    sheet = workbook.active
-
-    for row in data:
-        sheet.append(row)
-
-    xlsx_buffer = io.BytesIO()
-    workbook.save(xlsx_buffer)
-    xlsx_buffer.seek(0)
-    return xlsx_buffer.getvalue()
+from plane.utils.exporters import Exporter, IssueExportSchema
 
 
 def create_zip_file(files: List[tuple[str, str | bytes]]) -> io.BytesIO:
@@ -118,7 +60,9 @@ def upload_to_s3(zip_file: io.BytesIO, workspace_id: UUID, token_id: str, slug:
         # Generate presigned url for the uploaded file with different base
         presign_s3 = boto3.client(
             "s3",
-            endpoint_url=f"{settings.AWS_S3_URL_PROTOCOL}//{str(settings.AWS_S3_CUSTOM_DOMAIN).replace('/uploads', '')}/",  # noqa: E501
+            endpoint_url=(
+                f"{settings.AWS_S3_URL_PROTOCOL}//{str(settings.AWS_S3_CUSTOM_DOMAIN).replace('/uploads', '')}/"
+            ),
             aws_access_key_id=settings.AWS_ACCESS_KEY_ID,
             aws_secret_access_key=settings.AWS_SECRET_ACCESS_KEY,
             config=Config(signature_version="s3v4"),
@@ -176,187 +120,6 @@ def upload_to_s3(zip_file: io.BytesIO, workspace_id: UUID, token_id: str, slug:
     exporter_instance.save(update_fields=["status", "url", "key"])
 
 
-def generate_table_row(issue: dict) -> List[str]:
-    """
-    Generate a table row from an issue dictionary.
-    """
-    return [
-        f"""{issue["project_identifier"]}-{issue["sequence_id"]}""",
-        issue["project_name"],
-        issue["name"],
-        issue["description"],
-        issue["state_name"],
-        dateConverter(issue["start_date"]),
-        dateConverter(issue["target_date"]),
-        issue["priority"],
-        issue["created_by"],
-        ", ".join(issue["labels"]) if issue["labels"] else "",
-        issue["cycle_name"],
-        issue["cycle_start_date"],
-        issue["cycle_end_date"],
-        ", ".join(issue.get("module_name", "")) if issue.get("module_name") else "",
-        dateTimeConverter(issue["created_at"]),
-        dateTimeConverter(issue["updated_at"]),
-        dateTimeConverter(issue["completed_at"]),
-        dateTimeConverter(issue["archived_at"]),
-        (
-            ", ".join(
-                [
-                    f"{comment['comment']} ({comment['created_at']} by {comment['created_by']})"
-                    for comment in issue["comments"]
-                ]
-            )
-            if issue["comments"]
-            else ""
-        ),
-        issue["estimate"] if issue["estimate"] else "",
-        ", ".join(issue["link"]) if issue["link"] else "",
-        ", ".join(issue["assignees"]) if issue["assignees"] else "",
-        issue["subscribers_count"] if issue["subscribers_count"] else "",
-        issue["attachment_count"] if issue["attachment_count"] else "",
-        ", ".join(issue["attachment_links"]) if issue["attachment_links"] else "",
-    ]
-
-
-def generate_json_row(issue: dict) -> dict:
-    """
-    Generate a JSON row from an issue dictionary.
-    """
-    return {
-        "ID": f"""{issue["project_identifier"]}-{issue["sequence_id"]}""",
-        "Project": issue["project_name"],
-        "Name": issue["name"],
-        "Description": issue["description"],
-        "State": issue["state_name"],
-        "Start Date": dateConverter(issue["start_date"]),
-        "Target Date": dateConverter(issue["target_date"]),
-        "Priority": issue["priority"],
-        "Created By": (f"{issue['created_by']}" if issue["created_by"] else ""),
-        "Assignee": issue["assignees"],
-        "Labels": issue["labels"],
-        "Cycle Name": issue["cycle_name"],
-        "Cycle Start Date": issue["cycle_start_date"],
-        "Cycle End Date": issue["cycle_end_date"],
-        "Module Name": issue["module_name"],
-        "Created At": dateTimeConverter(issue["created_at"]),
-        "Updated At": dateTimeConverter(issue["updated_at"]),
-        "Completed At": dateTimeConverter(issue["completed_at"]),
-        "Archived At": dateTimeConverter(issue["archived_at"]),
-        "Comments": issue["comments"],
-        "Estimate": issue["estimate"],
-        "Link": issue["link"],
-        "Subscribers Count": issue["subscribers_count"],
-        "Attachment Count": issue["attachment_count"],
-        "Attachment Links": issue["attachment_links"],
-    }
-
-
-def update_json_row(rows: List[dict], row: dict) -> None:
-    """
-    Update the json row with the new assignee and label.
-    """
-    matched_index = next(
-        (index for index, existing_row in enumerate(rows) if existing_row["ID"] == row["ID"]),
-        None,
-    )
-
-    if matched_index is not None:
-        existing_assignees, existing_labels = (
-            rows[matched_index]["Assignee"],
-            rows[matched_index]["Labels"],
-        )
-        assignee, label = row["Assignee"], row["Labels"]
-
-        if assignee is not None and (existing_assignees is None or label not in existing_assignees):
-            rows[matched_index]["Assignee"] += f", {assignee}"
-        if label is not None and (existing_labels is None or label not in existing_labels):
-            rows[matched_index]["Labels"] += f", {label}"
-    else:
-        rows.append(row)
-
-
-def update_table_row(rows: List[List[str]], row: List[str]) -> None:
-    """
-    Update the table row with the new assignee and label.
-    """
-    matched_index = next(
-        (index for index, existing_row in enumerate(rows) if existing_row[0] == row[0]),
-        None,
-    )
-
-    if matched_index is not None:
-        existing_assignees, existing_labels = rows[matched_index][7:9]
-        assignee, label = row[7:9]
-
-        if assignee is not None and (existing_assignees is None or label not in existing_assignees):
-            rows[matched_index][8] += f", {assignee}"
-        if label is not None and (existing_labels is None or label not in existing_labels):
-            rows[matched_index][8] += f", {label}"
-    else:
-        rows.append(row)
-
-
-def generate_csv(
-    header: List[str],
-    project_id: str,
-    issues: List[dict],
-    files: List[tuple[str, str | bytes]],
-) -> None:
-    """
-    Generate CSV export for all the passed issues.
-    """
-    rows = [header]
-    for issue in issues:
-        row = generate_table_row(issue)
-        update_table_row(rows, row)
-    csv_file = create_csv_file(rows)
-    files.append((f"{project_id}.csv", csv_file))
-
-
-def generate_json(
-    header: List[str],
-    project_id: str,
-    issues: List[dict],
-    files: List[tuple[str, str | bytes]],
-) -> None:
-    """
-    Generate JSON export for all the passed issues.
-    """
-    rows = []
-    for issue in issues:
-        row = generate_json_row(issue)
-        update_json_row(rows, row)
-    json_file = create_json_file(rows)
-    files.append((f"{project_id}.json", json_file))
-
-
-def generate_xlsx(
-    header: List[str],
-    project_id: str,
-    issues: List[dict],
-    files: List[tuple[str, str | bytes]],
-) -> None:
-    """
-    Generate XLSX export for all the passed issues.
-    """
-    rows = [header]
-    for issue in issues:
-        row = generate_table_row(issue)
-
-        update_table_row(rows, row)
-    xlsx_file = create_xlsx_file(rows)
-    files.append((f"{project_id}.xlsx", xlsx_file))
-
-
-def get_created_by(obj: Issue | IssueComment) -> str:
-    """
-    Get the created by user for the given object.
-    """
-    if obj.created_by:
-        return f"{obj.created_by.first_name} {obj.created_by.last_name}"
-    return ""
-
-
 @shared_task
 def issue_export_task(
     provider: str,
@@ -377,7 +140,7 @@ def issue_export_task(
         exporter_instance.status = "processing"
         exporter_instance.save(update_fields=["status"])
 
-        # Base query to get the issues
+        # Build base queryset for issues
         workspace_issues = (
             Issue.objects.filter(
                 workspace__id=workspace_id,
@@ -390,7 +153,6 @@ def issue_export_task(
                 "project",
                 "workspace",
                 "state",
-                "parent",
                 "created_by",
                 "estimate_point",
             )
@@ -400,144 +162,51 @@ def issue_export_task(
                 "issue_module__module",
                 "issue_comments",
                 "assignees",
-                Prefetch(
-                    "assignees",
-                    queryset=User.objects.only("first_name", "last_name").distinct(),
-                    to_attr="assignee_details",
-                ),
-                Prefetch(
-                    "labels",
-                    queryset=Label.objects.only("name").distinct(),
-                    to_attr="label_details",
-                ),
                 "issue_subscribers",
                 "issue_link",
+                Prefetch(
+                    "issue_relation",
+                    queryset=IssueRelation.objects.select_related("related_issue", "related_issue__project"),
+                ),
+                Prefetch(
+                    "issue_related",
+                    queryset=IssueRelation.objects.select_related("issue", "issue__project"),
+                ),
+                Prefetch(
+                    "parent",
+                    queryset=Issue.objects.select_related("type", "project"),
+                ),
             )
         )
 
-        # Get the attachments for the issues
-        file_assets = FileAsset.objects.filter(
-            issue_id__in=workspace_issues.values_list("id", flat=True),
-            entity_type=FileAsset.EntityTypeContext.ISSUE_ATTACHMENT,
-        ).annotate(work_item_id=F("issue_id"), asset_id=F("id"))
-
-        # Create a dictionary to store the attachments for the issues
-        attachment_dict = defaultdict(list)
-        for asset in file_assets:
-            attachment_dict[asset.work_item_id].append(asset.asset_id)
-
-        # Create a list to store the issues data
-        issues_data = []
-
-        # Iterate over the issues
-        for issue in workspace_issues:
-            attachments = attachment_dict.get(issue.id, [])
-
-            issue_data = {
-                "id": issue.id,
-                "project_identifier": issue.project.identifier,
-                "project_name": issue.project.name,
-                "project_id": issue.project.id,
-                "sequence_id": issue.sequence_id,
-                "name": issue.name,
-                "description": issue.description_stripped,
-                "priority": issue.priority,
-                "start_date": issue.start_date,
-                "target_date": issue.target_date,
-                "state_name": issue.state.name if issue.state else None,
-                "created_at": issue.created_at,
-                "updated_at": issue.updated_at,
-                "completed_at": issue.completed_at,
-                "archived_at": issue.archived_at,
-                "module_name": [module.module.name for module in issue.issue_module.all()],
-                "created_by": get_created_by(issue),
-                "labels": [label.name for label in issue.label_details],
-                "comments": [
-                    {
-                        "comment": comment.comment_stripped,
-                        "created_at": dateConverter(comment.created_at),
-                        "created_by": get_created_by(comment),
-                    }
-                    for comment in issue.issue_comments.all()
-                ],
-                "estimate": issue.estimate_point.value if issue.estimate_point and issue.estimate_point.value else "",
-                "link": [link.url for link in issue.issue_link.all()],
-                "assignees": [f"{assignee.first_name} {assignee.last_name}" for assignee in issue.assignee_details],
-                "subscribers_count": issue.issue_subscribers.count(),
-                "attachment_count": len(attachments),
-                "attachment_links": [
-                    f"/api/assets/v2/workspaces/{issue.workspace.slug}/projects/{issue.project_id}/issues/{issue.id}/attachments/{asset}/"
-                    for asset in attachments
-                ],
-            }
-
-            # Get Cycles data for the issue
-            cycle = issue.issue_cycle.last()
-            if cycle:
-                # Update cycle data
-                issue_data["cycle_name"] = cycle.cycle.name
-                issue_data["cycle_start_date"] = dateConverter(cycle.cycle.start_date)
-                issue_data["cycle_end_date"] = dateConverter(cycle.cycle.end_date)
-            else:
-                issue_data["cycle_name"] = ""
-                issue_data["cycle_start_date"] = ""
-                issue_data["cycle_end_date"] = ""
-
-            issues_data.append(issue_data)
-
-            # CSV header
-        header = [
-            "ID",
-            "Project",
-            "Name",
-            "Description",
-            "State",
-            "Start Date",
-            "Target Date",
-            "Priority",
-            "Created By",
-            "Labels",
-            "Cycle Name",
-            "Cycle Start Date",
-            "Cycle End Date",
-            "Module Name",
-            "Created At",
-            "Updated At",
-            "Completed At",
-            "Archived At",
-            "Comments",
-            "Estimate",
-            "Link",
-            "Assignees",
-            "Subscribers Count",
-            "Attachment Count",
-            "Attachment Links",
-        ]
-
-        # Map the provider to the function
-        EXPORTER_MAPPER = {
-            "csv": generate_csv,
-            "json": generate_json,
-            "xlsx": generate_xlsx,
-        }
+        # Create exporter for the specified format
+        try:
+            exporter = Exporter(
+                format_type=provider,
+                schema_class=IssueExportSchema,
+                options={"list_joiner": ", "},
+            )
+        except ValueError as e:
+            # Invalid format type
+            exporter_instance = ExporterHistory.objects.get(token=token_id)
+            exporter_instance.status = "failed"
+            exporter_instance.reason = str(e)
+            exporter_instance.save(update_fields=["status", "reason"])
+            return
 
         files = []
         if multiple:
-            project_dict = defaultdict(list)
-            for issue in issues_data:
-                project_dict[str(issue["project_id"])].append(issue)
-
+            # Export each project separately with its own queryset
             for project_id in project_ids:
-                issues = project_dict.get(str(project_id), [])
-
-                exporter = EXPORTER_MAPPER.get(provider)
-                if exporter is not None:
-                    exporter(header, project_id, issues, files)
-
+                project_issues = workspace_issues.filter(project_id=project_id)
+                export_filename = f"{slug}-{project_id}"
+                filename, content = exporter.export(export_filename, project_issues)
+                files.append((filename, content))
         else:
-            exporter = EXPORTER_MAPPER.get(provider)
-            if exporter is not None:
-                exporter(header, workspace_id, issues_data, files)
+            # Export all issues in a single file
+            export_filename = f"{slug}-{workspace_id}"
+            filename, content = exporter.export(export_filename, workspace_issues)
+            files.append((filename, content))
 
         zip_buffer = create_zip_file(files)
         upload_to_s3(zip_buffer, workspace_id, token_id, slug)

apps/api/plane/bgtasks/webhook_task.py

@@ -48,6 +48,8 @@ from plane.db.models import (
 )
 from plane.license.utils.instance_value import get_email_configuration
 from plane.utils.exception_logger import log_exception
+from plane.settings.mongo import MongoConnection
+
 
 SERIALIZER_MAPPER = {
     "project": ProjectSerializer,
@@ -84,6 +86,58 @@ def get_issue_prefetches():
     ]
 
 
+
+def save_webhook_log(
+    webhook: Webhook,
+    request_method: str,
+    request_headers: str,
+    request_body: str,
+    response_status: str,
+    response_headers: str,
+    response_body: str,
+    retry_count: int,
+    event_type: str,
+) -> None:
+
+    # webhook_logs
+    mongo_collection = MongoConnection.get_collection("webhook_logs")
+    
+    log_data = {
+        "workspace_id": str(webhook.workspace_id),
+        "webhook": str(webhook.id),
+        "event_type": str(event_type),
+        "request_method": str(request_method),
+        "request_headers": str(request_headers),
+        "request_body": str(request_body),
+        "response_status": str(response_status),
+        "response_headers": str(response_headers),
+        "response_body": str(response_body),
+        "retry_count": retry_count,
+    }
+
+    mongo_save_success = False
+    if mongo_collection is not None:
+        try:
+            # insert the log data into the mongo collection
+            mongo_collection.insert_one(log_data)
+            logger.info("Webhook log saved successfully to mongo")
+            mongo_save_success = True
+        except Exception as e:
+            log_exception(e)
+            logger.error(f"Failed to save webhook log: {e}")
+            mongo_save_success = False
+
+    # if the mongo save is not successful, save the log data into the database
+    if not mongo_save_success:
+        try:
+            # insert the log data into the database
+            WebhookLog.objects.create(**log_data)
+            logger.info("Webhook log saved successfully to database")
+        except Exception as e:
+            log_exception(e)
+            logger.error(f"Failed to save webhook log: {e}")
+
+
 def get_model_data(event: str, event_id: Union[str, List[str]], many: bool = False) -> Dict[str, Any]:
     """
     Retrieve and serialize model data based on the event type.
@@ -273,32 +327,30 @@ def webhook_send_task(
         response = requests.post(webhook.url, headers=headers, json=payload, timeout=30)
 
         # Log the webhook request
-        WebhookLog.objects.create(
-            workspace_id=str(webhook.workspace_id),
-            webhook=str(webhook.id),
-            event_type=str(event),
-            request_method=str(action),
-            request_headers=str(headers),
-            request_body=str(payload),
-            response_status=str(response.status_code),
-            response_headers=str(response.headers),
-            response_body=str(response.text),
-            retry_count=str(self.request.retries),
+        save_webhook_log(
+            webhook=webhook,
+            request_method=action,
+            request_headers=headers,
+            request_body=payload,
+            response_status=response.status_code,
+            response_headers=response.headers,
+            response_body=response.text,
+            retry_count=self.request.retries,
+            event_type=event,
         )
         logger.info(f"Webhook {webhook.id} sent successfully")
     except requests.RequestException as e:
         # Log the failed webhook request
-        WebhookLog.objects.create(
-            workspace_id=str(webhook.workspace_id),
-            webhook=str(webhook.id),
-            event_type=str(event),
-            request_method=str(action),
-            request_headers=str(headers),
-            request_body=str(payload),
+        save_webhook_log(
+            webhook=webhook,
+            request_method=action,
+            request_headers=headers,
+            request_body=payload,
             response_status=500,
             response_headers="",
             response_body=str(e),
-            retry_count=str(self.request.retries),
+            retry_count=self.request.retries,
+            event_type=event,
         )
         logger.error(f"Webhook {webhook.id} failed with error: {e}")
         # Retry logic

apps/api/plane/bgtasks/workspace_seed_task.py

@@ -5,9 +5,11 @@ import time
 import uuid
 from typing import Dict
 import logging
+from datetime import timedelta
 
 # Django imports
 from django.conf import settings
+from django.utils import timezone
 
 # Third party imports
 from celery import shared_task
@@ -25,6 +27,13 @@ from plane.db.models import (
     IssueLabel,
     IssueSequence,
     IssueActivity,
+    Page,
+    ProjectPage,
+    Cycle,
+    Module,
+    CycleIssue,
+    ModuleIssue,
+    IssueView,
 )
 
 logger = logging.getLogger("plane.worker")
@@ -116,13 +125,33 @@ def create_project_and_member(workspace: Workspace) -> Dict[int, uuid.UUID]:
                     user_id=workspace_member["member_id"],
                     workspace_id=workspace.id,
                     display_filters={
-                        "group_by": None,
-                        "order_by": "sort_order",
-                        "type": None,
-                        "sub_issue": True,
-                        "show_empty_groups": True,
                         "layout": "list",
-                        "calendar_date_range": "",
+                        "calendar": {"layout": "month", "show_weekends": False},
+                        "group_by": "state",
+                        "order_by": "sort_order",
+                        "sub_issue": True,
+                        "sub_group_by": None,
+                        "show_empty_groups": True,
+                    },
+                    display_properties={
+                        "key": True,
+                        "link": True,
+                        "cycle": False,
+                        "state": True,
+                        "labels": False,
+                        "modules": False,
+                        "assignee": True,
+                        "due_date": False,
+                        "estimate": True,
+                        "priority": True,
+                        "created_on": True,
+                        "issue_type": True,
+                        "start_date": False,
+                        "updated_on": True,
+                        "customer_count": True,
+                        "sub_issue_count": False,
+                        "attachment_count": False,
+                        "customer_request_count": True,
                     },
                     created_by_id=workspace.created_by_id,
                 )
@@ -205,6 +234,8 @@ def create_project_issues(
     project_map: Dict[int, uuid.UUID],
     states_map: Dict[int, uuid.UUID],
     labels_map: Dict[int, uuid.UUID],
+    cycles_map: Dict[int, uuid.UUID],
+    module_map: Dict[int, uuid.UUID],
 ) -> None:
     """Creates issues and their associated records for each project.
 
@@ -234,6 +265,8 @@ def create_project_issues(
         labels = issue_seed.pop("labels")
         project_id = issue_seed.pop("project_id")
         state_id = issue_seed.pop("state_id")
+        cycle_id = issue_seed.pop("cycle_id")
+        module_ids = issue_seed.pop("module_ids")
 
         issue = Issue.objects.create(
             **issue_seed,
@@ -259,6 +292,7 @@ def create_project_issues(
             epoch=time.time(),
         )
 
+        # Create issue labels
         for label_id in labels:
             IssueLabel.objects.create(
                 issue=issue,
@@ -268,10 +302,172 @@ def create_project_issues(
                 created_by_id=workspace.created_by_id,
             )
 
+        # Create cycle issues
+        if cycle_id:
+            CycleIssue.objects.create(
+                issue=issue,
+                cycle_id=cycles_map[cycle_id],
+                project_id=project_map[project_id],
+                workspace_id=workspace.id,
+                created_by_id=workspace.created_by_id,
+            )
+
+        # Create module issues
+        if module_ids:
+            for module_id in module_ids:
+                ModuleIssue.objects.create(
+                    issue=issue,
+                    module_id=module_map[module_id],
+                    project_id=project_map[project_id],
+                    workspace_id=workspace.id,
+                    created_by_id=workspace.created_by_id,
+                )
+
         logger.info(f"Task: workspace_seed_task -> Issue {issue_id} created")
     return
 
 
+def create_pages(workspace: Workspace, project_map: Dict[int, uuid.UUID]) -> None:
+    """Creates pages for each project in the workspace.
+
+    Args:
+        workspace: The workspace containing the projects
+        project_map: Mapping of seed project IDs to actual project IDs
+    """
+    page_seeds = read_seed_file("pages.json")
+
+    if not page_seeds:
+        return
+
+    for page_seed in page_seeds:
+        page_id = page_seed.pop("id")
+
+        page = Page.objects.create(
+            workspace_id=workspace.id,
+            is_global=False,
+            access=page_seed.get("access", Page.PUBLIC_ACCESS),
+            name=page_seed.get("name"),
+            description=page_seed.get("description", {}),
+            description_html=page_seed.get("description_html", "<p></p>"),
+            description_binary=page_seed.get("description_binary", None),
+            description_stripped=page_seed.get("description_stripped", None),
+            created_by_id=workspace.created_by_id,
+            updated_by_id=workspace.created_by_id,
+            owned_by_id=workspace.created_by_id,
+        )
+
+        logger.info(f"Task: workspace_seed_task -> Page {page_id} created")
+        if page_seed.get("project_id") and page_seed.get("type") == "PROJECT":
+            ProjectPage.objects.create(
+                workspace_id=workspace.id,
+                project_id=project_map[page_seed.get("project_id")],
+                page_id=page.id,
+                created_by_id=workspace.created_by_id,
+                updated_by_id=workspace.created_by_id,
+            )
+
+            logger.info(f"Task: workspace_seed_task -> Project Page {page_id} created")
+    return
+
+
+def create_cycles(workspace: Workspace, project_map: Dict[int, uuid.UUID]) -> Dict[int, uuid.UUID]:
+    # Create cycles
+    cycle_seeds = read_seed_file("cycles.json")
+    if not cycle_seeds:
+        return
+
+    cycle_map: Dict[int, uuid.UUID] = {}
+
+    for cycle_seed in cycle_seeds:
+        cycle_id = cycle_seed.pop("id")
+        project_id = cycle_seed.pop("project_id")
+        type = cycle_seed.pop("type")
+
+        if type == "CURRENT":
+            start_date = timezone.now()
+            end_date = start_date + timedelta(days=14)
+
+        if type == "UPCOMING":
+            # Get the last cycle
+            last_cycle = Cycle.objects.filter(project_id=project_map[project_id]).order_by("-end_date").first()
+            if last_cycle:
+                start_date = last_cycle.end_date + timedelta(days=1)
+                end_date = start_date + timedelta(days=14)
+            else:
+                start_date = timezone.now() + timedelta(days=14)
+                end_date = start_date + timedelta(days=14)
+
+        cycle = Cycle.objects.create(
+            **cycle_seed,
+            start_date=start_date,
+            end_date=end_date,
+            project_id=project_map[project_id],
+            workspace=workspace,
+            created_by_id=workspace.created_by_id,
+            owned_by_id=workspace.created_by_id,
+        )
+
+        cycle_map[cycle_id] = cycle.id
+        logger.info(f"Task: workspace_seed_task -> Cycle {cycle_id} created")
+    return cycle_map
+
+
+def create_modules(workspace: Workspace, project_map: Dict[int, uuid.UUID]) -> None:
+    """Creates modules for each project in the workspace.
+
+    Args:
+        workspace: The workspace containing the projects
+        project_map: Mapping of seed project IDs to actual project IDs
+    """
+    module_seeds = read_seed_file("modules.json")
+    if not module_seeds:
+        return
+
+    module_map: Dict[int, uuid.UUID] = {}
+
+    for index, module_seed in enumerate(module_seeds):
+        module_id = module_seed.pop("id")
+        project_id = module_seed.pop("project_id")
+
+        start_date = timezone.now() + timedelta(days=index * 2)
+        end_date = start_date + timedelta(days=14)
+
+        module = Module.objects.create(
+            **module_seed,
+            start_date=start_date,
+            target_date=end_date,
+            project_id=project_map[project_id],
+            workspace=workspace,
+            created_by_id=workspace.created_by_id,
+        )
+        module_map[module_id] = module.id
+        logger.info(f"Task: workspace_seed_task -> Module {module_id} created")
+    return module_map
+
+
+def create_views(workspace: Workspace, project_map: Dict[int, uuid.UUID]) -> None:
+    """Creates views for each project in the workspace.
+
+    Args:
+        workspace: The workspace containing the projects
+        project_map: Mapping of seed project IDs to actual project IDs
+    """
+
+    view_seeds = read_seed_file("views.json")
+    if not view_seeds:
+        return
+
+    for view_seed in view_seeds:
+        project_id = view_seed.pop("project_id")
+        IssueView.objects.create(
+            **view_seed,
+            project_id=project_map[project_id],
+            workspace=workspace,
+            created_by_id=workspace.created_by_id,
+            owned_by_id=workspace.created_by_id,
+        )
+
+
 @shared_task
 def workspace_seed(workspace_id: uuid.UUID) -> None:
     """Seeds a new workspace with initial project data.
@@ -299,8 +495,20 @@ def workspace_seed(workspace_id: uuid.UUID) -> None:
         # Create project labels
         label_map = create_project_labels(workspace, project_map)
 
+        # Create project cycles
+        cycle_map = create_cycles(workspace, project_map)
+
+        # Create project modules
+        module_map = create_modules(workspace, project_map)
+
         # create project issues
-        create_project_issues(workspace, project_map, state_map, label_map)
+        create_project_issues(workspace, project_map, state_map, label_map, cycle_map, module_map)
+
+        # create project views
+        create_views(workspace, project_map)
+
+        # create project pages
+        create_pages(workspace, project_map)
 
         logger.info(f"Task: workspace_seed_task -> Workspace {workspace_id} seeded successfully")
         return

apps/api/plane/db/management/commands/activate_user.py

@@ -31,4 +31,4 @@ class Command(BaseCommand):
         user.is_active = True
         user.save()
 
-        self.stdout.write(self.style.SUCCESS("User activated succesfully"))
+        self.stdout.write(self.style.SUCCESS("User activated successfully"))

apps/api/plane/db/management/commands/reset_password.py

@@ -59,4 +59,4 @@ class Command(BaseCommand):
         user.is_password_autoset = False
         user.save()
 
-        self.stdout.write(self.style.SUCCESS("User password updated succesfully"))
+        self.stdout.write(self.style.SUCCESS("User password updated successfully"))

apps/api/plane/db/management/commands/update_bucket.py

@@ -70,7 +70,7 @@ class Command(BaseCommand):
         try:
             s3_client.delete_object(Bucket=bucket_name, Key="test_permission_check.txt")
         except ClientError:
-            self.stdout.write("Coudn't delete test object")
+            self.stdout.write("Couldn't delete test object")
 
         # 4. Test s3:PutBucketPolicy (attempt to put a bucket policy)
         try:

apps/api/plane/db/models/issue.py

@@ -273,6 +273,21 @@ class IssueRelationChoices(models.TextChoices):
     IMPLEMENTED_BY = "implemented_by", "Implemented By"
 
 
+# Bidirectional relation pairs: (forward, reverse)
+# Defined after class to avoid enum metaclass conflicts
+IssueRelationChoices._RELATION_PAIRS = (
+    ("blocked_by", "blocking"),
+    ("relates_to", "relates_to"),  # symmetric
+    ("duplicate", "duplicate"),  # symmetric
+    ("start_before", "start_after"),
+    ("finish_before", "finish_after"),
+    ("implemented_by", "implements"),
+)
+
+# Generate reverse mapping from pairs
+IssueRelationChoices._REVERSE_MAPPING = {forward: reverse for forward, reverse in IssueRelationChoices._RELATION_PAIRS}
+
+
 class IssueRelation(ProjectBaseModel):
     issue = models.ForeignKey(Issue, related_name="issue_relation", on_delete=models.CASCADE)
     related_issue = models.ForeignKey(Issue, related_name="issue_related", on_delete=models.CASCADE)

apps/api/plane/middleware/logger.py

@@ -12,7 +12,6 @@ from rest_framework.request import Request
 from plane.utils.ip_address import get_client_ip
 from plane.db.models import APIActivityLog
 
-
 api_logger = logging.getLogger("plane.api.request")
 
 

apps/api/plane/middleware/request_body_size.py

@@ -0,0 +1,27 @@
+from django.core.exceptions import RequestDataTooBig
+from django.http import JsonResponse
+
+
+class RequestBodySizeLimitMiddleware:
+    """
+    Middleware to catch RequestDataTooBig exceptions and return
+    413 Request Entity Too Large instead of 400 Bad Request.
+    """
+
+    def __init__(self, get_response):
+        self.get_response = get_response
+
+    def __call__(self, request):
+        try:
+            _ = request.body
+        except RequestDataTooBig:
+            return JsonResponse(
+                {
+                    "error": "REQUEST_BODY_TOO_LARGE",
+                    "detail": "The size of the request body exceeds the maximum allowed size.",
+                },
+                status=413,
+            )
+
+        # If body size is OK, continue with the request
+        return self.get_response(request)

apps/api/plane/seeds/data/cycles.json

@@ -0,0 +1,18 @@
+[
+    {
+        "id": 1,
+        "name": "Cycle 1: Getting Started with Plane",
+        "project_id": 1,
+        "sort_order": 1,
+        "timezone": "UTC",
+        "type": "CURRENT"
+    },
+    {
+        "id": 2,
+        "name": "Cycle 2: Collaboration & Customization",
+        "project_id": 1,
+        "sort_order": 2,
+        "timezone": "UTC",
+        "type": "UPCOMING"
+    }
+]

apps/api/plane/seeds/data/issues.json

@@ -6,10 +6,12 @@
     "description_html": "<p class=\"editor-paragraph-block\">Hey there! This demo project is your playground to get hands-on with Plane. We've set this up so you can click around and see how everything works without worrying about breaking anything.</p><p class=\"editor-paragraph-block\">Each work item is designed to make you familiar with the basics of using Plane. Just follow along card by card at your own pace.</p><p class=\"editor-paragraph-block\">First thing to try</p><ol class=\"list-decimal pl-7 space-y-[--list-spacing-y] tight\" data-tight=\"true\"><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Look in the <strong>Properties</strong> section below where it says <strong>State: Todo</strong>.</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Click on it and change it to <strong>Done</strong> from the dropdown. Alternatively, you can drag and drop the card to the Done column.</p></li></ol>",
     "description_stripped": "Hey there! This demo project is your playground to get hands-on with Plane. We've set this up so you can click around and see how everything works without worrying about breaking anything.Each work item is designed to make you familiar with the basics of using Plane. Just follow along card by card at your own pace.First thing to tryLook in the Properties section below where it says State: Todo.Click on it and change it to Done from the dropdown. Alternatively, you can drag and drop the card to the Done column.",
     "sort_order": 1000,
-    "state_id": 3,
+    "state_id": 4,
     "labels": [],
-    "priority": "none",
-    "project_id": 1
+    "priority": "urgent",
+    "project_id": 1,
+    "cycle_id": 1,
+    "module_ids": [1]
   },
   {
     "id": 2,
@@ -19,8 +21,10 @@
     "sort_order": 2000,
     "state_id": 2,
     "labels": [2],
-    "priority": "none",
-    "project_id": 1
+    "priority": "high",
+    "project_id": 1,
+    "cycle_id": 1,
+    "module_ids": [1]
   },
   {
     "id": 3,
@@ -31,8 +35,10 @@
     "sort_order": 3000,
     "state_id": 1,
     "labels": [],
-    "priority": "none",
-    "project_id": 1
+    "priority": "high",
+    "project_id": 1,
+    "cycle_id": 1,
+    "module_ids": [1, 2]
   },
   {
     "id": 4,
@@ -41,10 +47,12 @@
     "description_html": "<p class=\"editor-paragraph-block\">A work item is the fundamental building block of your project. Think of these as the actionable tasks that move your project forward.</p><p class=\"editor-paragraph-block\">Ready to add something to your project's to-do list? Here's how:</p><ol class=\"list-decimal pl-7 space-y-[--list-spacing-y] tight\" data-tight=\"true\"><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Click the <strong>Add work item</strong> button in the top-right corner of the Work Items page.</p><image-component src=\"https://media.docs.plane.so/seed_assets/41.png\" width=\"1085.380859375px\" height=\"482.53758375605696px\" id=\"ba055bc3-4162-4750-9ad4-9434fc0e7121\" aspectratio=\"2.249318801089918\"></image-component></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Give your task a clear title and add any details in the description.</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Set up the essentials:</p><ul class=\"list-disc pl-7 space-y-[--list-spacing-y] tight\" data-tight=\"true\"><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Assign it to a team member (or yourself!)</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Choose a priority level</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Add start and due dates if there's a timeline</p></li></ul></li></ol><div data-emoji-unicode=\"128161\" data-emoji-url=\"https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f4a1.png\" data-logo-in-use=\"emoji\" data-background=\"green\" data-block-type=\"callout-component\"><p class=\"editor-paragraph-block\"><strong>Tip:</strong> Save time by using the keyboard shortcut <strong>C</strong> from anywhere in your project to quickly create a new work item!</p></div><div class=\"py-4 border-custom-border-400\" data-type=\"horizontalRule\"><div></div></div><p class=\"editor-paragraph-block\">Want to dive deeper into all the things you can do with work items? Check out our <a target=\"_blank\" rel=\"noopener noreferrer nofollow\" class=\"text-custom-primary-300 underline underline-offset-[3px] hover:text-custom-primary-500 transition-colors cursor-pointer\" href=\"https://docs.plane.so/core-concepts/issues/overview\">documentation</a>.</p>",
     "description_stripped": "A work item is the fundamental building block of your project. Think of these as the actionable tasks that move your project forward.Ready to add something to your project's to-do list? Here's how:Click the Add work item button in the top-right corner of the Work Items page.Give your task a clear title and add any details in the description.Set up the essentials:Assign it to a team member (or yourself!)Choose a priority levelAdd start and due dates if there's a timelineTip: Save time by using the keyboard shortcut C from anywhere in your project to quickly create a new work item!Want to dive deeper into all the things you can do with work items? Check out our documentation.",
     "sort_order": 4000,
-    "state_id": 1,
+    "state_id": 3,
     "labels": [2],
-    "priority": "none",
-    "project_id": 1
+    "priority": "high",
+    "project_id": 1,
+    "cycle_id": 1,
+    "module_ids": [1, 2]
   },
   {
     "id": 5,
@@ -53,10 +61,12 @@
     "description_html": "<p class=\"editor-paragraph-block\">Plane offers multiple ways to look at your work items depending on what you need to see. Let's explore how to change views and customize them!</p><image-component src=\"https://media.docs.plane.so/seed_assets/51.png\" aspectratio=\"4.489130434782608\"></image-component><h2 class=\"editor-heading-block\">Switch between layouts</h2><ol class=\"list-decimal pl-7 space-y-[--list-spacing-y] tight\" data-tight=\"true\"><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Look at the top toolbar in your project. You'll see several layout icons.</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Click any of these icons to instantly switch between layouts.</p></li></ol><div data-emoji-unicode=\"128161\" data-emoji-url=\"https://cdn.jsdelivr.net/npm/emoji-datasource-apple/img/apple/64/1f4a1.png\" data-logo-in-use=\"emoji\" data-background=\"green\" data-block-type=\"callout-component\"><p class=\"editor-paragraph-block\"><strong>Tip:</strong> Different layouts work best for different needs. Try Board view for tracking progress, Calendar for deadline management, and Gantt for timeline planning! See <a target=\"_blank\" rel=\"noopener noreferrer nofollow\" class=\"text-custom-primary-300 underline underline-offset-[3px] hover:text-custom-primary-500 transition-colors cursor-pointer\" href=\"https://docs.plane.so/core-concepts/issues/layouts\"><strong>Layouts</strong></a> for more info.</p></div><h2 class=\"editor-heading-block\">Filter and display options</h2><p class=\"editor-paragraph-block\">Need to focus on specific work?</p><ol class=\"list-decimal pl-7 space-y-[--list-spacing-y] tight\" data-tight=\"true\"><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Click the <strong>Filters</strong> dropdown in the toolbar. Select criteria and choose which items to show.</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Click the <strong>Display</strong> dropdown to tailor how the information appears in your layout</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Created the perfect setup? Save it for later by clicking the the <strong>Save View</strong> button.</p></li><li class=\"not-prose space-y-2\"><p class=\"editor-paragraph-block\">Access saved views anytime from the <strong>Views</strong> section in your sidebar.</p></li></ol>",
     "description_stripped": "Plane offers multiple ways to look at your work items depending on what you need to see. Let's explore how to change views and customize them!Switch between layoutsLook at the top toolbar in your project. You'll see several layout icons.Click any of these icons to instantly switch between layouts.Tip: Different layouts work best for different needs. Try Board view for tracking progress, Calendar for deadline management, and Gantt for timeline planning! See Layouts for more info.Filter and display optionsNeed to focus on specific work?Click the Filters dropdown in the toolbar. Select criteria and choose which items to show.Click the Display dropdown to tailor how the information appears in your layoutCreated the perfect setup? Save it for later by clicking the the Save View button.Access saved views anytime from the Views section in your sidebar.",
     "sort_order": 5000,
-    "state_id": 1,
+    "state_id": 3,
     "labels": [],
     "priority": "none",
-    "project_id": 1
+    "project_id": 1,
+    "cycle_id": 2,
+    "module_ids": [2]
   },
   {
     "id": 6,
@@ -67,8 +77,10 @@
     "sort_order": 6000,
     "state_id": 1,
     "labels": [2],
-    "priority": "none",
-    "project_id": 1
+    "priority": "low",
+    "project_id": 1,
+    "cycle_id": 2,
+    "module_ids": [2, 3]
   },
   {
     "id": 7,
@@ -80,6 +92,8 @@
     "state_id": 1,
     "labels": [],
     "priority": "none",
-    "project_id": 1
+    "project_id": 1,
+    "cycle_id": 2,
+    "module_ids": [2, 3]
   }
 ]

apps/api/plane/seeds/data/modules.json

@@ -0,0 +1,26 @@
+[
+    {
+        "id": 1,
+        "name": "Core Workflow (System)",
+        "project_id": 1,
+        "sort_order": 1,
+        "status": "planned",
+        "description": "Manage, visualize, and track your work items across views."
+    },
+    {
+        "id": 2,
+        "name": "Onboarding Flow (Feature)",
+        "project_id": 1,
+        "sort_order": 2,
+        "status": "backlog",
+        "description": "Everything about getting started - creating a project, inviting teammates."
+    },
+    {
+        "id": 3,
+        "name": "Workspace Setup (Area)",
+        "project_id": 1,
+        "sort_order": 3,
+        "status": "in-progress",
+        "description": "The personalization layer - settings, labels, automations."
+    }
+]

apps/api/plane/seeds/data/views.json

@@ -0,0 +1,14 @@
+[
+    {
+        "id": 1,
+        "name": "Project Urgent Tasks",
+        "description": "Project Urgent Tasks",
+        "access": 1,
+        "filters": {},
+        "project_id": 1,
+        "display_filters": {"layout": "list", "calendar": {"layout": "month", "show_weekends": false}, "group_by": "state", "order_by": "sort_order", "sub_issue": false, "sub_group_by": null, "show_empty_groups": false},
+        "display_properties": {"key": true, "link": true, "cycle": true, "state": true, "labels": true, "modules": true, "assignee": true, "due_date": true, "estimate": true, "priority": true, "created_on": true, "issue_type": true, "start_date": true, "updated_on": true, "customer_count": true, "sub_issue_count": true, "attachment_count": true, "customer_request_count": true},
+        "sort_order": 75535,
+        "rich_filters": {"priority__in": "urgent"}
+    }
+]

apps/api/plane/settings/common.py

@@ -62,6 +62,7 @@ MIDDLEWARE = [
     "django.middleware.clickjacking.XFrameOptionsMiddleware",
     "crum.CurrentRequestUserMiddleware",
     "django.middleware.gzip.GZipMiddleware",
+    "plane.middleware.request_body_size.RequestBodySizeLimitMiddleware",
     "plane.middleware.logger.APITokenLogMiddleware",
     "plane.middleware.logger.RequestLoggerMiddleware",
 ]

apps/api/plane/tests/contract/api/test_cycles.py

@@ -0,0 +1,382 @@
+import pytest
+from rest_framework import status
+from django.db import IntegrityError
+from django.utils import timezone
+from datetime import datetime, timedelta
+from uuid import uuid4
+
+from plane.db.models import Cycle, Project, ProjectMember
+
+
+@pytest.fixture
+def project(db, workspace, create_user):
+    """Create a test project with the user as a member"""
+    project = Project.objects.create(
+        name="Test Project",
+        identifier="TP",
+        workspace=workspace,
+        created_by=create_user,
+    )
+    ProjectMember.objects.create(
+        project=project,
+        member=create_user,
+        role=20,  # Admin role
+        is_active=True,
+    )
+    return project
+
+
+@pytest.fixture
+def cycle_data():
+    """Sample cycle data for tests"""
+    return {
+        "name": "Test Cycle",
+        "description": "A test cycle for unit tests",
+    }
+
+
+@pytest.fixture
+def draft_cycle_data():
+    """Sample draft cycle data (no dates)"""
+    return {
+        "name": "Draft Cycle",
+        "description": "A draft cycle without dates",
+    }
+
+
+@pytest.fixture
+def create_cycle(db, project, create_user):
+    """Create a test cycle"""
+    return Cycle.objects.create(
+        name="Existing Cycle",
+        description="An existing cycle",
+        start_date=timezone.now() + timedelta(days=1),
+        end_date=timezone.now() + timedelta(days=7),
+        project=project,
+        workspace=project.workspace,
+        owned_by=create_user,
+    )
+
+
+
+
+@pytest.mark.contract
+class TestCycleListCreateAPIEndpoint:
+    """Test Cycle List and Create API Endpoint"""
+
+    def get_cycle_url(self, workspace_slug, project_id):
+        """Helper to get cycle endpoint URL"""
+        return f"/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/"
+
+    @pytest.mark.django_db
+    def test_create_cycle_success(self, api_key_client, workspace, project, cycle_data):
+        """Test successful cycle creation"""
+        url = self.get_cycle_url(workspace.slug, project.id)
+
+        response = api_key_client.post(url, cycle_data, format="json")
+
+        assert response.status_code == status.HTTP_201_CREATED
+
+        assert Cycle.objects.count() == 1
+
+        created_cycle = Cycle.objects.first()
+        assert created_cycle.name == cycle_data["name"]
+        assert created_cycle.description == cycle_data["description"]
+        assert created_cycle.project == project
+        assert created_cycle.owned_by_id is not None
+
+
+    @pytest.mark.django_db
+    def test_create_cycle_invalid_data(self, api_key_client, workspace, project):
+        """Test cycle creation with invalid data"""
+        url = self.get_cycle_url(workspace.slug, project.id)
+
+        # Test with empty data
+        response = api_key_client.post(url, {}, format="json")
+        assert response.status_code == status.HTTP_400_BAD_REQUEST
+
+        # Test with missing name
+        response = api_key_client.post(url, {"description": "Test cycle"}, format="json")
+        assert response.status_code == status.HTTP_400_BAD_REQUEST
+
+    @pytest.mark.django_db
+    def test_create_cycle_invalid_date_combination(self, api_key_client, workspace, project):
+        """Test cycle creation with invalid date combination (only start_date)"""
+        url = self.get_cycle_url(workspace.slug, project.id)
+
+        invalid_data = {
+            "name": "Invalid Cycle",
+            "start_date": (timezone.now() + timedelta(days=1)).isoformat(),
+            # Missing end_date
+        }
+
+        response = api_key_client.post(url, invalid_data, format="json")
+        assert response.status_code == status.HTTP_400_BAD_REQUEST
+        assert "Both start date and end date are either required or are to be null" in response.data["error"]
+
+    @pytest.mark.django_db
+    def test_create_cycle_with_external_id(self, api_key_client, workspace, project):
+        """Test creating cycle with external ID"""
+        url = self.get_cycle_url(workspace.slug, project.id)
+
+        cycle_data = {
+            "name": "External Cycle",
+            "description": "A cycle with external ID",
+            "external_id": "ext-123",
+            "external_source": "github",
+        }
+
+        response = api_key_client.post(url, cycle_data, format="json")
+
+        assert response.status_code == status.HTTP_201_CREATED
+        created_cycle = Cycle.objects.first()
+        assert created_cycle.external_id == "ext-123"
+        assert created_cycle.external_source == "github"
+
+    @pytest.mark.django_db
+    def test_create_cycle_duplicate_external_id(self, api_key_client, workspace, project, create_user):
+        """Test creating cycle with duplicate external ID"""
+        url = self.get_cycle_url(workspace.slug, project.id)
+
+        # Create first cycle
+        Cycle.objects.create(
+            name="First Cycle",
+            project=project,
+            workspace=workspace,
+            external_id="ext-123",
+            external_source="github",
+            owned_by=create_user,
+        )
+
+        # Try to create second cycle with same external ID
+        cycle_data = {
+            "name": "Second Cycle",
+            "external_id": "ext-123",
+            "external_source": "github",
+            "owned_by": create_user.id,
+        }
+
+        response = api_key_client.post(url, cycle_data, format="json")
+
+        assert response.status_code == status.HTTP_409_CONFLICT
+        assert "same external id" in response.data["error"]
+
+    @pytest.mark.django_db
+    def test_list_cycles_success(self, api_key_client, workspace, project, create_cycle, create_user):
+        """Test successful cycle listing"""
+        url = self.get_cycle_url(workspace.slug, project.id)
+
+        # Create additional cycles
+        Cycle.objects.create(
+            name="Cycle 2",
+            project=project,
+            workspace=workspace,
+            start_date=timezone.now() + timedelta(days=10),
+            end_date=timezone.now() + timedelta(days=17),
+            owned_by=create_user,
+        )
+        Cycle.objects.create(
+            name="Cycle 3",
+            project=project,
+            workspace=workspace,
+            start_date=timezone.now() + timedelta(days=20),
+            end_date=timezone.now() + timedelta(days=27),
+            owned_by=create_user,
+        )
+
+        response = api_key_client.get(url)
+
+        assert response.status_code == status.HTTP_200_OK
+        assert "results" in response.data
+        assert len(response.data["results"]) == 3  # Including create_cycle fixture
+
+    @pytest.mark.django_db
+    def test_list_cycles_with_view_filter(self, api_key_client, workspace, project, create_user):
+        """Test cycle listing with different view filters"""
+        url = self.get_cycle_url(workspace.slug, project.id)
+
+        # Create cycles in different states
+        now = timezone.now()
+        
+        # Current cycle (started but not ended)
+        Cycle.objects.create(
+            name="Current Cycle",
+            project=project,
+            workspace=workspace,
+            start_date=now - timedelta(days=1),
+            end_date=now + timedelta(days=6),
+            owned_by=create_user,
+        )
+        
+        # Upcoming cycle
+        Cycle.objects.create(
+            name="Upcoming Cycle",
+            project=project,
+            workspace=workspace,
+            start_date=now + timedelta(days=1),
+            end_date=now + timedelta(days=8),
+            owned_by=create_user,
+        )
+        
+        # Completed cycle
+        Cycle.objects.create(
+            name="Completed Cycle",
+            project=project,
+            workspace=workspace,
+            start_date=now - timedelta(days=10),
+            end_date=now - timedelta(days=3),
+            owned_by=create_user,
+        )
+        
+        # Draft cycle
+        Cycle.objects.create(
+            name="Draft Cycle",
+            project=project,
+            workspace=workspace,
+            owned_by=create_user,
+        )
+
+        # Test current cycles
+        response = api_key_client.get(url, {"cycle_view": "current"})
+        assert response.status_code == status.HTTP_200_OK
+        assert len(response.data) == 1
+        assert response.data[0]["name"] == "Current Cycle"
+
+        # Test upcoming cycles
+        response = api_key_client.get(url, {"cycle_view": "upcoming"})
+        assert response.status_code == status.HTTP_200_OK
+        assert len(response.data["results"]) == 1
+        assert response.data["results"][0]["name"] == "Upcoming Cycle"
+
+        # Test completed cycles
+        response = api_key_client.get(url, {"cycle_view": "completed"})
+        assert response.status_code == status.HTTP_200_OK
+        assert len(response.data["results"]) == 1
+        assert response.data["results"][0]["name"] == "Completed Cycle"
+
+        # Test draft cycles
+        response = api_key_client.get(url, {"cycle_view": "draft"})
+        assert response.status_code == status.HTTP_200_OK
+        assert len(response.data["results"]) == 1
+        assert response.data["results"][0]["name"] == "Draft Cycle"
+
+
+@pytest.mark.contract
+class TestCycleDetailAPIEndpoint:
+    """Test Cycle Detail API Endpoint"""
+
+    def get_cycle_detail_url(self, workspace_slug, project_id, cycle_id):
+        """Helper to get cycle detail endpoint URL"""
+        return f"/api/v1/workspaces/{workspace_slug}/projects/{project_id}/cycles/{cycle_id}/"
+
+    @pytest.mark.django_db
+    def test_get_cycle_success(self, api_key_client, workspace, project, create_cycle):
+        """Test successful cycle retrieval"""
+        url = self.get_cycle_detail_url(workspace.slug, project.id, create_cycle.id)
+
+        response = api_key_client.get(url)
+
+        assert response.status_code == status.HTTP_200_OK
+        assert str(response.data["id"]) == str(create_cycle.id)
+        assert response.data["name"] == create_cycle.name
+        assert response.data["description"] == create_cycle.description
+
+    @pytest.mark.django_db
+    def test_get_cycle_not_found(self, api_key_client, workspace, project):
+        """Test getting non-existent cycle"""
+        fake_id = uuid4()
+        url = self.get_cycle_detail_url(workspace.slug, project.id, fake_id)
+
+        response = api_key_client.get(url)
+        assert response.status_code == status.HTTP_404_NOT_FOUND
+
+    @pytest.mark.django_db
+    def test_update_cycle_success(self, api_key_client, workspace, project, create_cycle):
+        """Test successful cycle update"""
+        url = self.get_cycle_detail_url(workspace.slug, project.id, create_cycle.id)
+
+        update_data = {
+            "name": f"Updated Cycle {uuid4()}",
+            "description": "Updated description",
+        }
+
+        response = api_key_client.patch(url, update_data, format="json")
+
+        assert response.status_code == status.HTTP_200_OK
+
+        create_cycle.refresh_from_db()
+        assert create_cycle.name == update_data["name"]
+        assert create_cycle.description == update_data["description"]
+
+    @pytest.mark.django_db
+    def test_update_cycle_invalid_data(self, api_key_client, workspace, project, create_cycle):
+        """Test cycle update with invalid data"""
+        url = self.get_cycle_detail_url(workspace.slug, project.id, create_cycle.id)
+
+        update_data = {"name": ""}
+        response = api_key_client.patch(url, update_data, format="json")
+
+        # This might be 400 if name is required, or 200 if empty names are allowed
+        assert response.status_code in [status.HTTP_400_BAD_REQUEST, status.HTTP_200_OK]
+
+    @pytest.mark.django_db
+    def test_update_cycle_with_external_id_conflict(self, api_key_client, workspace, project, create_cycle, create_user ):
+        """Test cycle update with conflicting external ID"""
+        url = self.get_cycle_detail_url(workspace.slug, project.id, create_cycle.id)
+
+        # Create another cycle with external ID
+        Cycle.objects.create(
+            name="Another Cycle",
+            project=project,
+            workspace=workspace,
+            external_id="ext-456",
+            external_source="github",
+            owned_by=create_user,
+        )
+
+        # Try to update cycle with same external ID
+        update_data = {
+            "external_id": "ext-456",
+            "external_source": "github",
+        }
+
+        response = api_key_client.patch(url, update_data, format="json")
+
+        assert response.status_code == status.HTTP_409_CONFLICT
+        assert "same external id" in response.data["error"]
+
+    @pytest.mark.django_db
+    def test_delete_cycle_success(self, api_key_client, workspace, project, create_cycle):
+        """Test successful cycle deletion"""
+        url = self.get_cycle_detail_url(workspace.slug, project.id, create_cycle.id)
+
+        response = api_key_client.delete(url)
+
+        assert response.status_code == status.HTTP_204_NO_CONTENT
+        assert not Cycle.objects.filter(id=create_cycle.id).exists()
+
+    @pytest.mark.django_db
+    def test_cycle_metrics_annotation(self, api_key_client, workspace, project, create_cycle):
+        """Test that cycle includes issue metrics annotations"""
+        url = self.get_cycle_detail_url(workspace.slug, project.id, create_cycle.id)
+
+        response = api_key_client.get(url)
+
+        assert response.status_code == status.HTTP_200_OK
+        
+        # Check that metrics are included in response
+        cycle_data = response.data
+        assert "total_issues" in cycle_data
+        assert "completed_issues" in cycle_data
+        assert "cancelled_issues" in cycle_data
+        assert "started_issues" in cycle_data
+        assert "unstarted_issues" in cycle_data
+        assert "backlog_issues" in cycle_data
+        
+        # All should be 0 for a new cycle
+        assert cycle_data["total_issues"] == 0
+        assert cycle_data["completed_issues"] == 0
+        assert cycle_data["cancelled_issues"] == 0
+        assert cycle_data["started_issues"] == 0
+        assert cycle_data["unstarted_issues"] == 0
+        assert cycle_data["backlog_issues"] == 0

apps/api/plane/utils/exporters/README.md

@@ -0,0 +1,496 @@
+# 📊 Exporters
+
+A flexible and extensible data export utility for exporting Django model data in multiple formats (CSV, JSON, XLSX).
+
+## 🎯 Overview
+
+The exporters module provides a schema-based approach to exporting data with support for:
+
+- **📄 Multiple formats**: CSV, JSON, and XLSX (Excel)
+- **🔒 Type-safe field definitions**: StringField, NumberField, DateField, DateTimeField, BooleanField, ListField, JSONField
+- **⚡ Custom transformations**: Field-level transformations and custom preparer methods
+- **🔗 Dotted path notation**: Easy access to nested attributes and related models
+- **🎨 Format-specific handling**: Automatic formatting based on export format (e.g., lists as arrays in JSON, comma-separated in CSV)
+
+## 🚀 Quick Start
+
+### Basic Usage
+
+```python
+from plane.utils.exporters import Exporter, ExportSchema, StringField, NumberField
+
+# Define a schema
+class UserExportSchema(ExportSchema):
+    name = StringField(source="username", label="User Name")
+    email = StringField(source="email", label="Email Address")
+    posts_count = NumberField(label="Total Posts")
+
+    def prepare_posts_count(self, obj):
+        return obj.posts.count()
+
+# Export data - just pass the queryset!
+users = User.objects.all()
+exporter = Exporter(format_type="csv", schema_class=UserExportSchema)
+filename, content = exporter.export("users_export", users)
+```
+
+### Exporting Issues
+
+```python
+from plane.utils.exporters import Exporter, IssueExportSchema
+
+# Get issues with prefetched relations
+issues = Issue.objects.filter(project_id=project_id).prefetch_related(
+    'assignee_details',
+    'label_details',
+    'issue_module',
+    # ... other relations
+)
+
+# Export as XLSX - pass the queryset directly!
+exporter = Exporter(format_type="xlsx", schema_class=IssueExportSchema)
+filename, content = exporter.export("issues", issues)
+
+# Export with custom fields only
+exporter = Exporter(format_type="json", schema_class=IssueExportSchema)
+filename, content = exporter.export("issues_filtered", issues, fields=["id", "name", "state_name", "assignees"])
+```
+
+### Exporting Multiple Projects Separately
+
+```python
+# Export each project to a separate file
+for project_id in project_ids:
+    project_issues = issues.filter(project_id=project_id)
+    exporter = Exporter(format_type="csv", schema_class=IssueExportSchema)
+    filename, content = exporter.export(f"issues-{project_id}", project_issues)
+    # Save or upload the file
+```
+
+## 📝 Schema Definition
+
+### Field Types
+
+#### 📝 StringField
+
+Converts values to strings.
+
+```python
+name = StringField(source="name", label="Name", default="N/A")
+```
+
+#### 🔢 NumberField
+
+Handles numeric values (int, float).
+
+```python
+count = NumberField(source="items_count", label="Count", default=0)
+```
+
+#### 📅 DateField
+
+Formats date objects as `%a, %d %b %Y` (e.g., "Mon, 01 Jan 2024").
+
+```python
+start_date = DateField(source="start_date", label="Start Date")
+```
+
+#### ⏰ DateTimeField
+
+Formats datetime objects as `%a, %d %b %Y %I:%M:%S %Z%z`.
+
+```python
+created_at = DateTimeField(source="created_at", label="Created At")
+```
+
+#### ✅ BooleanField
+
+Converts values to boolean.
+
+```python
+is_active = BooleanField(source="is_active", label="Active", default=False)
+```
+
+#### 📋 ListField
+
+Handles list/array values. In CSV/XLSX, lists are joined with a separator (default: `", "`). In JSON, they remain as arrays.
+
+```python
+tags = ListField(source="tags", label="Tags")
+assignees = ListField(label="Assignees")  # Custom preparer can populate this
+```
+
+#### 🗂️ JSONField
+
+Handles complex JSON-serializable objects (dicts, lists of dicts). In CSV/XLSX, they're serialized as JSON strings. In JSON, they remain as objects.
+
+```python
+metadata = JSONField(source="metadata", label="Metadata")
+comments = JSONField(label="Comments")
+```
+
+### ⚙️ Field Parameters
+
+All field types support these parameters:
+
+- **`source`**: Dotted path string to the attribute (e.g., `"project.name"`)
+- **`default`**: Default value when field is None
+- **`label`**: Display name in export headers
+
+### 🔗 Dotted Path Notation
+
+Access nested attributes using dot notation:
+
+```python
+project_name = StringField(source="project.name", label="Project")
+owner_email = StringField(source="created_by.email", label="Owner Email")
+```
+
+### 🎯 Custom Preparers
+
+For complex logic, define `prepare_{field_name}` methods:
+
+```python
+class MySchema(ExportSchema):
+    assignees = ListField(label="Assignees")
+
+    def prepare_assignees(self, obj):
+        return [f"{u.first_name} {u.last_name}" for u in obj.assignee_details]
+```
+
+Preparers take precedence over field definitions.
+
+### ⚡ Custom Transformations with Preparer Methods
+
+For any custom logic or transformations, use `prepare_<field_name>` methods:
+
+```python
+class MySchema(ExportSchema):
+    name = StringField(source="name", label="Name (Uppercase)")
+    status = StringField(label="Status")
+
+    def prepare_name(self, obj):
+        """Transform the name field to uppercase."""
+        return obj.name.upper() if obj.name else ""
+
+    def prepare_status(self, obj):
+        """Compute status based on model state."""
+        return "Active" if obj.is_active else "Inactive"
+```
+
+## 📦 Export Formats
+
+### 📊 CSV Format
+
+- Fields are quoted with `QUOTE_ALL`
+- Lists are joined with `", "` (customizable with `list_joiner` option)
+- JSON objects are serialized as JSON strings
+- File extension: `.csv`
+
+```python
+exporter = Exporter(
+    format_type="csv",
+    schema_class=MySchema,
+    options={"list_joiner": "; "}  # Custom separator
+)
+```
+
+### 📋 JSON Format
+
+- Lists remain as arrays
+- Objects remain as nested structures
+- Preserves data types
+- File extension: `.json`
+
+```python
+exporter = Exporter(format_type="json", schema_class=MySchema)
+filename, content = exporter.export("data", records)
+# content is a JSON string: '[{"field": "value"}, ...]'
+```
+
+### 📗 XLSX Format
+
+- Creates Excel-compatible files using openpyxl
+- Lists are joined with `", "` (customizable with `list_joiner` option)
+- JSON objects are serialized as JSON strings
+- File extension: `.xlsx`
+- Returns binary content (bytes)
+
+```python
+exporter = Exporter(format_type="xlsx", schema_class=MySchema)
+filename, content = exporter.export("data", records)
+# content is bytes
+```
+
+## 🔧 Advanced Usage
+
+### 📦 Using Context for Pre-fetched Data
+
+Pass context data to schemas to avoid N+1 queries. Override `get_context_data()` in your schema:
+
+```python
+class MySchema(ExportSchema):
+    attachment_count = NumberField(label="Attachments")
+
+    def prepare_attachment_count(self, obj):
+        attachments_dict = self.context.get("attachments_dict", {})
+        return len(attachments_dict.get(obj.id, []))
+
+    @classmethod
+    def get_context_data(cls, queryset):
+        """Pre-fetch all attachments in one query."""
+        attachments_dict = get_attachments_dict(queryset)
+        return {"attachments_dict": attachments_dict}
+
+# The Exporter automatically uses get_context_data() when serializing
+queryset = MyModel.objects.all()
+exporter = Exporter(format_type="csv", schema_class=MySchema)
+filename, content = exporter.export("data", queryset)
+```
+
+### 🔌 Registering Custom Formatters
+
+Add support for new export formats:
+
+```python
+from plane.utils.exporters import Exporter, BaseFormatter
+
+class XMLFormatter(BaseFormatter):
+    def format(self, filename, records, schema_class, options=None):
+        # Implementation
+        return (f"{filename}.xml", xml_content)
+
+# Register the formatter
+Exporter.register_formatter("xml", XMLFormatter)
+
+# Use it
+exporter = Exporter(format_type="xml", schema_class=MySchema)
+```
+
+### ✅ Checking Available Formats
+
+```python
+formats = Exporter.get_available_formats()
+# Returns: ['csv', 'json', 'xlsx']
+```
+
+### 🔍 Filtering Fields
+
+Pass a `fields` parameter to export only specific fields:
+
+```python
+# Export only specific fields
+exporter = Exporter(format_type="csv", schema_class=MySchema)
+filename, content = exporter.export(
+    "filtered_data",
+    queryset,
+    fields=["id", "name", "email"]
+)
+```
+
+### 🎯 Extending Schemas
+
+Create extended schemas by inheriting from existing ones and overriding `get_context_data()`:
+
+```python
+class ExtendedIssueExportSchema(IssueExportSchema):
+    custom_field = JSONField(label="Custom Data")
+
+    def prepare_custom_field(self, obj):
+        # Use pre-fetched data from context
+        return self.context.get("custom_data", {}).get(obj.id, {})
+
+    @classmethod
+    def get_context_data(cls, queryset):
+        # Get parent context (attachments, etc.)
+        context = super().get_context_data(queryset)
+
+        # Add your custom pre-fetched data
+        context["custom_data"] = fetch_custom_data(queryset)
+
+        return context
+```
+
+### 💾 Manual Serialization
+
+If you need to serialize data without exporting, you can use the schema directly:
+
+```python
+# Serialize a queryset to a list of dicts
+data = MySchema.serialize_queryset(queryset, fields=["id", "name"])
+
+# Or serialize a single object
+schema = MySchema()
+obj_data = schema.serialize(obj)
+```
+
+## 💡 Example: IssueExportSchema
+
+The `IssueExportSchema` demonstrates a complete implementation:
+
+```python
+from plane.utils.exporters import Exporter, IssueExportSchema
+
+# Simple export - just pass the queryset!
+issues = Issue.objects.filter(project_id=project_id)
+exporter = Exporter(format_type="csv", schema_class=IssueExportSchema)
+filename, content = exporter.export("issues", issues)
+
+# Export specific fields only
+filename, content = exporter.export(
+    "issues_filtered",
+    issues,
+    fields=["id", "name", "state_name", "assignees", "labels"]
+)
+
+# Export multiple projects to separate files
+for project_id in project_ids:
+    project_issues = issues.filter(project_id=project_id)
+    filename, content = exporter.export(f"issues-{project_id}", project_issues)
+    # Save or upload each file
+```
+
+Key features:
+
+- 🔗 Access to related models via dotted paths
+- 🎯 Custom preparers for complex fields
+- 📎 Context-based attachment handling via `get_context_data()`
+- 📋 List and JSON field handling
+- 📅 Date/datetime formatting
+
+## ✨ Best Practices
+
+1. **🚄 Avoid N+1 Queries**: Override `get_context_data()` to pre-fetch related data:
+
+   ```python
+   @classmethod
+   def get_context_data(cls, queryset):
+       return {
+           "attachments": get_attachments_dict(queryset),
+           "comments": get_comments_dict(queryset),
+       }
+   ```
+
+2. **🏷️ Use Labels**: Provide descriptive labels for better export headers:
+
+   ```python
+   created_at = DateTimeField(source="created_at", label="Created At")
+   ```
+
+3. **🛡️ Handle None Values**: Set appropriate defaults for fields that might be None:
+
+   ```python
+   count = NumberField(source="count", default=0)
+   ```
+
+4. **🎯 Use Preparers for Complex Logic**: Keep field definitions simple and use preparers for complex transformations:
+
+   ```python
+   def prepare_assignees(self, obj):
+       return [f"{u.first_name} {u.last_name}" for u in obj.assignee_details]
+   ```
+
+5. **⚡ Pass QuerySets Directly**: Let the Exporter handle serialization:
+
+   ```python
+   # Good - Exporter handles serialization
+   exporter.export("data", queryset)
+
+   # Avoid - Manual serialization unless needed
+   data = MySchema.serialize_queryset(queryset)
+   exporter.export("data", data)
+   ```
+
+6. **📦 Filter QuerySets, Not Data**: For multiple exports, filter the queryset instead of the serialized data:
+
+   ```python
+   # Good - efficient, only serializes what's needed
+   for project_id in project_ids:
+       project_issues = issues.filter(project_id=project_id)
+       exporter.export(f"project-{project_id}", project_issues)
+
+   # Avoid - serializes all data upfront
+   all_data = MySchema.serialize_queryset(issues)
+   for project_id in project_ids:
+       project_data = [d for d in all_data if d['project_id'] == project_id]
+       exporter.export(f"project-{project_id}", project_data)
+   ```
+
+## 📚 API Reference
+
+### 📊 Exporter
+
+**`__init__(format_type, schema_class, options=None)`**
+
+- `format_type`: Export format ('csv', 'json', 'xlsx')
+- `schema_class`: Schema class defining fields
+- `options`: Optional dict of format-specific options
+
+**`export(filename, data, fields=None)`**
+
+- `filename`: Filename without extension
+- `data`: Django QuerySet or list of dicts
+- `fields`: Optional list of field names to include
+- Returns: `(filename_with_extension, content)`
+- `content` is str for CSV/JSON, bytes for XLSX
+
+**`get_available_formats()`** (class method)
+
+- Returns: List of available format types
+
+**`register_formatter(format_type, formatter_class)`** (class method)
+
+- Register a custom formatter
+
+### 📝 ExportSchema
+
+**`__init__(context=None)`**
+
+- `context`: Optional dict accessible in preparer methods via `self.context` for pre-fetched data
+
+**`serialize(obj, fields=None)`**
+
+- Returns: Dict of serialized field values for a single object
+
+**`serialize_queryset(queryset, fields=None)`** (class method)
+
+- `queryset`: QuerySet of objects to serialize
+- `fields`: Optional list of field names to include
+- Returns: List of dicts with serialized data
+
+**`get_context_data(queryset)`** (class method)
+
+- Override to pre-fetch related data for the queryset
+- Returns: Dict of context data
+
+### 🔧 ExportField
+
+Base class for all field types. Subclass to create custom field types.
+
+**`get_value(obj, context)`**
+
+- Returns: Formatted value for the field
+
+**`_format_value(raw)`**
+
+- Override in subclasses for type-specific formatting
+
+## 🧪 Testing
+
+```python
+# Test exporting a queryset
+queryset = MyModel.objects.all()
+exporter = Exporter(format_type="json", schema_class=MySchema)
+filename, content = exporter.export("test", queryset)
+assert filename == "test.json"
+assert isinstance(content, str)
+
+# Test with field filtering
+filename, content = exporter.export("test", queryset, fields=["id", "name"])
+data = json.loads(content)
+assert all(set(item.keys()) == {"id", "name"} for item in data)
+
+# Test manual serialization
+data = MySchema.serialize_queryset(queryset)
+assert len(data) == queryset.count()
+```

apps/api/plane/utils/exporters/__init__.py

@@ -0,0 +1,38 @@
+"""Export utilities for various data formats."""
+
+from .exporter import Exporter
+from .formatters import BaseFormatter, CSVFormatter, JSONFormatter, XLSXFormatter
+from .schemas import (
+    BooleanField,
+    DateField,
+    DateTimeField,
+    ExportField,
+    ExportSchema,
+    IssueExportSchema,
+    JSONField,
+    ListField,
+    NumberField,
+    StringField,
+)
+
+__all__ = [
+    # Core Exporter
+    "Exporter",
+    # Schemas
+    "ExportSchema",
+    "ExportField",
+    "StringField",
+    "NumberField",
+    "DateField",
+    "DateTimeField",
+    "BooleanField",
+    "ListField",
+    "JSONField",
+    # Formatters
+    "BaseFormatter",
+    "CSVFormatter",
+    "JSONFormatter",
+    "XLSXFormatter",
+    # Issue Schema
+    "IssueExportSchema",
+]

apps/api/plane/utils/exporters/exporter.py

@@ -0,0 +1,72 @@
+from typing import Any, Dict, List, Type, Union
+
+from django.db.models import QuerySet
+
+from .formatters import CSVFormatter, JSONFormatter, XLSXFormatter
+
+
+class Exporter:
+    """Generic exporter class that handles data exports using different formatters."""
+
+    # Available formatters
+    FORMATTERS = {
+        "csv": CSVFormatter,
+        "json": JSONFormatter,
+        "xlsx": XLSXFormatter,
+    }
+
+    def __init__(self, format_type: str, schema_class: Type, options: Dict[str, Any] = None):
+        """Initialize exporter with specified format type and schema.
+
+        Args:
+            format_type: The export format (csv, json, xlsx)
+            schema_class: The schema class to use for field definitions
+            options: Optional formatting options
+        """
+        if format_type not in self.FORMATTERS:
+            raise ValueError(f"Unsupported format: {format_type}. Available: {list(self.FORMATTERS.keys())}")
+
+        self.format_type = format_type
+        self.schema_class = schema_class
+        self.formatter = self.FORMATTERS[format_type]()
+        self.options = options or {}
+
+    def export(
+        self,
+        filename: str,
+        data: Union[QuerySet, List[dict]],
+        fields: List[str] = None,
+    ) -> tuple[str, str | bytes]:
+        """Export data using the configured formatter and return (filename, content).
+
+        Args:
+            filename: The filename for the export (without extension)
+            data: Either a Django QuerySet or a list of already-serialized dicts
+            fields: Optional list of field names to include in export
+
+        Returns:
+            Tuple of (filename_with_extension, content)
+        """
+        # Serialize the queryset if needed
+        if isinstance(data, QuerySet):
+            records = self.schema_class.serialize_queryset(data, fields=fields)
+        else:
+            # Already serialized data
+            records = data
+
+        # Merge fields into options for the formatter
+        format_options = {**self.options}
+        if fields:
+            format_options["fields"] = fields
+
+        return self.formatter.format(filename, records, self.schema_class, format_options)
+
+    @classmethod
+    def get_available_formats(cls) -> List[str]:
+        """Get list of available export formats."""
+        return list(cls.FORMATTERS.keys())
+
+    @classmethod
+    def register_formatter(cls, format_type: str, formatter_class: type) -> None:
+        """Register a new formatter for a format type."""
+        cls.FORMATTERS[format_type] = formatter_class

apps/api/plane/utils/exporters/formatters.py

@@ -0,0 +1,199 @@
+import csv
+import io
+import json
+from typing import Any, Dict, List, Type
+
+from openpyxl import Workbook
+
+
+class BaseFormatter:
+    """Base class for export formatters."""
+
+    def format(
+        self,
+        filename: str,
+        records: List[dict],
+        schema_class: Type,
+        options: Dict[str, Any] | None = None,
+    ) -> tuple[str, str | bytes]:
+        """Format records for export.
+
+        Args:
+            filename: The filename for the export (without extension)
+            records: List of records to export
+            schema_class: Schema class to extract field order and labels
+            options: Optional formatting options
+
+        Returns:
+            Tuple of (filename_with_extension, content)
+        """
+        raise NotImplementedError
+
+    @staticmethod
+    def _get_field_info(schema_class: Type) -> tuple[List[str], Dict[str, str]]:
+        """Extract field order and labels from schema.
+
+        Args:
+            schema_class: Schema class with field definitions
+
+        Returns:
+            Tuple of (field_order, field_labels)
+        """
+        if not hasattr(schema_class, "_declared_fields"):
+            raise ValueError(f"Schema class {schema_class.__name__} must have _declared_fields attribute")
+
+        # Get order and labels from schema
+        field_order = list(schema_class._declared_fields.keys())
+        field_labels = {
+            name: field.label if field.label else name.replace("_", " ").title()
+            for name, field in schema_class._declared_fields.items()
+        }
+
+        return field_order, field_labels
+
+
+class CSVFormatter(BaseFormatter):
+    """Formatter for CSV exports."""
+
+    @staticmethod
+    def _format_field_value(value: Any, list_joiner: str = ", ") -> str:
+        """Format a field value for CSV output."""
+        if value is None:
+            return ""
+        if isinstance(value, list):
+            return list_joiner.join(str(v) for v in value)
+        if isinstance(value, dict):
+            # For complex objects, serialize as JSON
+            return json.dumps(value)
+        return str(value)
+
+    def _generate_table_row(
+        self, record: dict, field_order: List[str], options: Dict[str, Any] | None = None
+    ) -> List[str]:
+        """Generate a CSV row from a record."""
+        opts = options or {}
+        list_joiner = opts.get("list_joiner", ", ")
+        return [self._format_field_value(record.get(field, ""), list_joiner) for field in field_order]
+
+    def _create_csv_file(self, data: List[List[str]]) -> str:
+        """Create CSV file content from row data."""
+        buf = io.StringIO()
+        writer = csv.writer(buf, delimiter=",", quoting=csv.QUOTE_ALL)
+        for row in data:
+            writer.writerow(row)
+        buf.seek(0)
+        return buf.getvalue()
+
+    def format(self, filename, records, schema_class, options: Dict[str, Any] | None = None) -> tuple[str, str]:
+        if not records:
+            return (f"{filename}.csv", "")
+
+        # Get field order and labels from schema
+        field_order, field_labels = self._get_field_info(schema_class)
+
+        # Filter to requested fields if specified
+        opts = options or {}
+        requested_fields = opts.get("fields")
+        if requested_fields:
+            field_order = [f for f in field_order if f in requested_fields]
+
+        header = [field_labels[field] for field in field_order]
+
+        rows = [header]
+        for record in records:
+            row = self._generate_table_row(record, field_order, options)
+            rows.append(row)
+        content = self._create_csv_file(rows)
+        return (f"{filename}.csv", content)
+
+
+class JSONFormatter(BaseFormatter):
+    """Formatter for JSON exports."""
+
+    def _generate_json_row(
+        self, record: dict, field_labels: Dict[str, str], field_order: List[str], options: Dict[str, Any] | None = None
+    ) -> dict:
+        """Generate a JSON object from a record.
+
+        Preserves data types - lists stay as arrays, dicts stay as objects.
+        """
+        return {field_labels[field]: record.get(field) for field in field_order if field in record}
+
+    def format(self, filename, records, schema_class, options: Dict[str, Any] | None = None) -> tuple[str, str]:
+        if not records:
+            return (f"{filename}.json", "[]")
+
+        # Get field order and labels from schema
+        field_order, field_labels = self._get_field_info(schema_class)
+
+        # Filter to requested fields if specified
+        opts = options or {}
+        requested_fields = opts.get("fields")
+        if requested_fields:
+            field_order = [f for f in field_order if f in requested_fields]
+
+        rows: List[dict] = []
+        for record in records:
+            row = self._generate_json_row(record, field_labels, field_order, options)
+            rows.append(row)
+        content = json.dumps(rows)
+        return (f"{filename}.json", content)
+
+
+class XLSXFormatter(BaseFormatter):
+    """Formatter for XLSX (Excel) exports."""
+
+    @staticmethod
+    def _format_field_value(value: Any, list_joiner: str = ", ") -> str:
+        """Format a field value for XLSX output."""
+        if value is None:
+            return ""
+        if isinstance(value, list):
+            return list_joiner.join(str(v) for v in value)
+        if isinstance(value, dict):
+            # For complex objects, serialize as JSON
+            return json.dumps(value)
+        return str(value)
+
+    def _generate_table_row(
+        self, record: dict, field_order: List[str], options: Dict[str, Any] | None = None
+    ) -> List[str]:
+        """Generate an XLSX row from a record."""
+        opts = options or {}
+        list_joiner = opts.get("list_joiner", ", ")
+        return [self._format_field_value(record.get(field, ""), list_joiner) for field in field_order]
+
+    def _create_xlsx_file(self, data: List[List[str]]) -> bytes:
+        """Create XLSX file content from row data."""
+        wb = Workbook()
+        sh = wb.active
+        for row in data:
+            sh.append(row)
+        out = io.BytesIO()
+        wb.save(out)
+        out.seek(0)
+        return out.getvalue()
+
+    def format(self, filename, records, schema_class, options: Dict[str, Any] | None = None) -> tuple[str, bytes]:
+        if not records:
+            # Create empty workbook
+            content = self._create_xlsx_file([])
+            return (f"{filename}.xlsx", content)
+
+        # Get field order and labels from schema
+        field_order, field_labels = self._get_field_info(schema_class)
+
+        # Filter to requested fields if specified
+        opts = options or {}
+        requested_fields = opts.get("fields")
+        if requested_fields:
+            field_order = [f for f in field_order if f in requested_fields]
+
+        header = [field_labels[field] for field in field_order]
+
+        rows = [header]
+        for record in records:
+            row = self._generate_table_row(record, field_order, options)
+            rows.append(row)
+        content = self._create_xlsx_file(rows)
+        return (f"{filename}.xlsx", content)

apps/api/plane/utils/exporters/schemas/__init__.py

@@ -0,0 +1,30 @@
+"""Export schemas for various data types."""
+
+from .base import (
+    BooleanField,
+    DateField,
+    DateTimeField,
+    ExportField,
+    ExportSchema,
+    JSONField,
+    ListField,
+    NumberField,
+    StringField,
+)
+from .issue import IssueExportSchema
+
+__all__ = [
+    # Base field types
+    "ExportField",
+    "StringField",
+    "NumberField",
+    "DateField",
+    "DateTimeField",
+    "BooleanField",
+    "ListField",
+    "JSONField",
+    # Base schema
+    "ExportSchema",
+    # Issue schema
+    "IssueExportSchema",
+]

apps/api/plane/utils/exporters/schemas/base.py

@@ -0,0 +1,234 @@
+from dataclasses import dataclass, field
+from typing import Any, Dict, List, Optional
+
+from django.db.models import QuerySet
+
+
+@dataclass
+class ExportField:
+    """Base export field class for generic fields."""
+
+    source: Optional[str] = None
+    default: Any = ""
+    label: Optional[str] = None  # Display name for export headers
+
+    def get_value(self, obj: Any, context: Dict[str, Any]) -> Any:
+        raw: Any
+        if self.source:
+            raw = self._resolve_dotted_path(obj, self.source)
+        else:
+            raw = obj
+
+        return self._format_value(raw)
+
+    def _format_value(self, raw: Any) -> Any:
+        """Format the raw value. Override in subclasses for type-specific formatting."""
+        return raw if raw is not None else self.default
+
+    def _resolve_dotted_path(self, obj: Any, path: str) -> Any:
+        current = obj
+        for part in path.split("."):
+            if current is None:
+                return None
+            if hasattr(current, part):
+                current = getattr(current, part)
+            elif isinstance(current, dict):
+                current = current.get(part)
+            else:
+                return None
+        return current
+
+
+@dataclass
+class StringField(ExportField):
+    """Export field for string values."""
+
+    default: str = ""
+
+    def _format_value(self, raw: Any) -> str:
+        if raw is None:
+            return self.default
+        return str(raw)
+
+
+@dataclass
+class DateField(ExportField):
+    """Export field for date values with automatic conversion."""
+
+    default: str = ""
+
+    def _format_value(self, raw: Any) -> str:
+        if raw is None:
+            return self.default
+        # Convert date to formatted string
+        if hasattr(raw, "strftime"):
+            return raw.strftime("%a, %d %b %Y")
+        return str(raw)
+
+
+@dataclass
+class DateTimeField(ExportField):
+    """Export field for datetime values with automatic conversion."""
+
+    default: str = ""
+
+    def _format_value(self, raw: Any) -> str:
+        if raw is None:
+            return self.default
+        # Convert datetime to formatted string
+        if hasattr(raw, "strftime"):
+            return raw.strftime("%a, %d %b %Y %I:%M:%S %Z%z")
+        return str(raw)
+
+
+@dataclass
+class NumberField(ExportField):
+    """Export field for numeric values."""
+
+    default: Any = ""
+
+    def _format_value(self, raw: Any) -> Any:
+        if raw is None:
+            return self.default
+        return raw
+
+
+@dataclass
+class BooleanField(ExportField):
+    """Export field for boolean values."""
+
+    default: bool = False
+
+    def _format_value(self, raw: Any) -> bool:
+        if raw is None:
+            return self.default
+        return bool(raw)
+
+
+@dataclass
+class ListField(ExportField):
+    """Export field for list/array values.
+
+    Returns the list as-is by default. The formatter will handle conversion to strings
+    when needed (e.g., CSV/XLSX will join with separator, JSON will keep as array).
+    """
+
+    default: Optional[List] = field(default_factory=list)
+
+    def _format_value(self, raw: Any) -> List[Any]:
+        if raw is None:
+            return self.default if self.default is not None else []
+        if isinstance(raw, (list, tuple)):
+            return list(raw)
+        return [raw]  # Wrap single items in a list
+
+
+@dataclass
+class JSONField(ExportField):
+    """Export field for complex JSON-serializable values (dicts, lists of dicts, etc).
+
+    Preserves the structure as-is for JSON exports. For CSV/XLSX, the formatter
+    will handle serialization (e.g., JSON stringify).
+    """
+
+    default: Any = field(default_factory=dict)
+
+    def _format_value(self, raw: Any) -> Any:
+        if raw is None:
+            return self.default
+        # Return as-is - should be JSON-serializable
+        return raw
+
+
+class ExportSchemaMeta(type):
+    def __new__(mcls, name, bases, attrs):
+        declared: Dict[str, ExportField] = {
+            key: value for key, value in list(attrs.items()) if isinstance(value, ExportField)
+        }
+        for key in declared.keys():
+            attrs.pop(key)
+        cls = super().__new__(mcls, name, bases, attrs)
+        base_fields: Dict[str, ExportField] = {}
+        for base in bases:
+            if hasattr(base, "_declared_fields"):
+                base_fields.update(base._declared_fields)
+        base_fields.update(declared)
+        cls._declared_fields = base_fields
+        return cls
+
+
+class ExportSchema(metaclass=ExportSchemaMeta):
+    """Base schema for exporting data in various formats.
+
+    Subclasses should define fields as class attributes and can override:
+    - prepare_<field_name> methods for custom field serialization
+    - get_context_data() class method to pre-fetch related data for the queryset
+    """
+
+    def __init__(self, context: Optional[Dict[str, Any]] = None) -> None:
+        self.context = context or {}
+
+    def serialize(self, obj: Any, fields: Optional[List[str]] = None) -> Dict[str, Any]:
+        """Serialize a single object.
+
+        Args:
+            obj: The object to serialize
+            fields: Optional list of field names to include. If None, all fields are serialized.
+
+        Returns:
+            Dictionary of serialized data
+        """
+        output: Dict[str, Any] = {}
+        # Determine which fields to process
+        fields_to_process = fields if fields else list(self._declared_fields.keys())
+
+        for field_name in fields_to_process:
+            # Skip if field doesn't exist in schema
+            if field_name not in self._declared_fields:
+                continue
+
+            export_field = self._declared_fields[field_name]
+
+            # Prefer explicit preparer methods if present
+            preparer = getattr(self, f"prepare_{field_name}", None)
+            if callable(preparer):
+                output[field_name] = preparer(obj)
+                continue
+
+            output[field_name] = export_field.get_value(obj, self.context)
+        return output
+
+    @classmethod
+    def get_context_data(cls, queryset: QuerySet) -> Dict[str, Any]:
+        """Get context data for serialization. Override in subclasses to pre-fetch related data.
+
+        Args:
+            queryset: QuerySet of objects to be serialized
+
+        Returns:
+            Dictionary of context data to be passed to the schema instance
+        """
+        return {}
+
+    @classmethod
+    def serialize_queryset(cls, queryset: QuerySet, fields: List[str] = None) -> List[Dict[str, Any]]:
+        """Serialize a queryset of objects to export data.
+
+        Args:
+            queryset: QuerySet of objects to serialize
+            fields: Optional list of field names to include. Defaults to all fields.
+
+        Returns:
+            List of dictionaries containing serialized data
+        """
+        # Get context data (can be extended by subclasses)
+        context = cls.get_context_data(queryset)
+
+        # Serialize each object, passing fields to only process requested fields
+        schema = cls(context=context)
+        data = []
+        for obj in queryset:
+            obj_data = schema.serialize(obj, fields=fields)
+            data.append(obj_data)
+
+        return data

apps/api/plane/utils/exporters/schemas/issue.py

@@ -0,0 +1,206 @@
+from collections import defaultdict
+from typing import Any, Dict, List, Optional
+
+from django.db.models import F, QuerySet
+
+from plane.db.models import CycleIssue, FileAsset
+
+from .base import (
+    DateField,
+    DateTimeField,
+    ExportSchema,
+    JSONField,
+    ListField,
+    NumberField,
+    StringField,
+)
+
+
+def get_issue_attachments_dict(issues_queryset: QuerySet) -> Dict[str, List[str]]:
+    """Get attachments dictionary for the given issues queryset.
+
+    Args:
+        issues_queryset: Queryset of Issue objects
+
+    Returns:
+        Dictionary mapping issue IDs to lists of attachment IDs
+    """
+    file_assets = FileAsset.objects.filter(
+        issue_id__in=issues_queryset.values_list("id", flat=True),
+        entity_type=FileAsset.EntityTypeContext.ISSUE_ATTACHMENT,
+    ).annotate(work_item_id=F("issue_id"), asset_id=F("id"))
+
+    attachment_dict = defaultdict(list)
+    for asset in file_assets:
+        attachment_dict[asset.work_item_id].append(asset.asset_id)
+
+    return attachment_dict
+
+
+def get_issue_last_cycles_dict(issues_queryset: QuerySet) -> Dict[str, Optional[CycleIssue]]:
+    """Get the last cycle for each issue in the given queryset.
+
+    Args:
+        issues_queryset: Queryset of Issue objects
+
+    Returns:
+        Dictionary mapping issue IDs to their last CycleIssue object
+    """
+    # Fetch all cycle issues for the given issues, ordered by created_at descending
+    # select_related is used to fetch cycle data in the same query
+    cycle_issues = (
+        CycleIssue.objects.filter(issue_id__in=issues_queryset.values_list("id", flat=True))
+        .select_related("cycle")
+        .order_by("issue_id", "-created_at")
+    )
+
+    # Keep only the last (most recent) cycle for each issue
+    last_cycles_dict = {}
+    for cycle_issue in cycle_issues:
+        if cycle_issue.issue_id not in last_cycles_dict:
+            last_cycles_dict[cycle_issue.issue_id] = cycle_issue
+
+    return last_cycles_dict
+
+
+class IssueExportSchema(ExportSchema):
+    """Schema for exporting issue data in various formats."""
+
+    @staticmethod
+    def _get_created_by(obj) -> str:
+        """Get the created by user for the given object."""
+        try:
+            if getattr(obj, "created_by", None):
+                return f"{obj.created_by.first_name} {obj.created_by.last_name}"
+        except Exception:
+            pass
+        return ""
+
+    @staticmethod
+    def _format_date(date_obj) -> str:
+        """Format date object to string."""
+        if date_obj and hasattr(date_obj, "strftime"):
+            return date_obj.strftime("%a, %d %b %Y")
+        return ""
+
+    # Field definitions with display labels
+    id = StringField(label="ID")
+    project_identifier = StringField(source="project.identifier", label="Project Identifier")
+    project_name = StringField(source="project.name", label="Project")
+    project_id = StringField(source="project.id", label="Project ID")
+    sequence_id = NumberField(source="sequence_id", label="Sequence ID")
+    name = StringField(source="name", label="Name")
+    description = StringField(source="description_stripped", label="Description")
+    priority = StringField(source="priority", label="Priority")
+    start_date = DateField(source="start_date", label="Start Date")
+    target_date = DateField(source="target_date", label="Target Date")
+    state_name = StringField(label="State")
+    created_at = DateTimeField(source="created_at", label="Created At")
+    updated_at = DateTimeField(source="updated_at", label="Updated At")
+    completed_at = DateTimeField(source="completed_at", label="Completed At")
+    archived_at = DateTimeField(source="archived_at", label="Archived At")
+    module_name = ListField(label="Module Name")
+    created_by = StringField(label="Created By")
+    labels = ListField(label="Labels")
+    comments = JSONField(label="Comments")
+    estimate = StringField(label="Estimate")
+    link = ListField(label="Link")
+    assignees = ListField(label="Assignees")
+    subscribers_count = NumberField(label="Subscribers Count")
+    attachment_count = NumberField(label="Attachment Count")
+    attachment_links = ListField(label="Attachment Links")
+    cycle_name = StringField(label="Cycle Name")
+    cycle_start_date = DateField(label="Cycle Start Date")
+    cycle_end_date = DateField(label="Cycle End Date")
+    parent = StringField(label="Parent")
+    relations = JSONField(label="Relations")
+
+    def prepare_id(self, i):
+        return f"{i.project.identifier}-{i.sequence_id}"
+
+    def prepare_state_name(self, i):
+        return i.state.name if i.state else None
+
+    def prepare_module_name(self, i):
+        return [m.module.name for m in i.issue_module.all()]
+
+    def prepare_created_by(self, i):
+        return self._get_created_by(i)
+
+    def prepare_labels(self, i):
+        return [label.name for label in i.labels.all()]
+
+    def prepare_comments(self, i):
+        return [
+            {
+                "comment": comment.comment_stripped,
+                "created_at": self._format_date(comment.created_at),
+                "created_by": self._get_created_by(comment),
+            }
+            for comment in i.issue_comments.all()
+        ]
+
+    def prepare_estimate(self, i):
+        return i.estimate_point.value if i.estimate_point and i.estimate_point.value else ""
+
+    def prepare_link(self, i):
+        return [link.url for link in i.issue_link.all()]
+
+    def prepare_assignees(self, i):
+        return [f"{u.first_name} {u.last_name}" for u in i.assignees.all()]
+
+    def prepare_subscribers_count(self, i):
+        return i.issue_subscribers.count()
+
+    def prepare_attachment_count(self, i):
+        return len((self.context.get("attachments_dict") or {}).get(i.id, []))
+
+    def prepare_attachment_links(self, i):
+        return [
+            f"/api/assets/v2/workspaces/{i.workspace.slug}/projects/{i.project_id}/issues/{i.id}/attachments/{asset}/"
+            for asset in (self.context.get("attachments_dict") or {}).get(i.id, [])
+        ]
+
+    def prepare_cycle_name(self, i):
+        cycles_dict = self.context.get("cycles_dict") or {}
+        last_cycle = cycles_dict.get(i.id)
+        return last_cycle.cycle.name if last_cycle else ""
+
+    def prepare_cycle_start_date(self, i):
+        cycles_dict = self.context.get("cycles_dict") or {}
+        last_cycle = cycles_dict.get(i.id)
+        return last_cycle.cycle.start_date if last_cycle else None
+
+    def prepare_cycle_end_date(self, i):
+        cycles_dict = self.context.get("cycles_dict") or {}
+        last_cycle = cycles_dict.get(i.id)
+        return last_cycle.cycle.end_date if last_cycle else None
+
+    def prepare_parent(self, i):
+        if not i.parent:
+            return ""
+        return f"{i.parent.project.identifier}-{i.parent.sequence_id}"
+
+    def prepare_relations(self, i):
+        # Should show reverse relation as well
+        from plane.db.models.issue import IssueRelationChoices
+
+        relations = {
+            r.relation_type: f"{r.related_issue.project.identifier}-{r.related_issue.sequence_id}"
+            for r in i.issue_relation.all()
+        }
+        reverse_relations = {}
+        for relation in i.issue_related.all():
+            reverse_relations[IssueRelationChoices._REVERSE_MAPPING[relation.relation_type]] = (
+                f"{relation.issue.project.identifier}-{relation.issue.sequence_id}"
+            )
+        relations.update(reverse_relations)
+        return relations
+
+    @classmethod
+    def get_context_data(cls, queryset: QuerySet) -> Dict[str, Any]:
+        """Get context data for issue serialization."""
+        return {
+            "attachments_dict": get_issue_attachments_dict(queryset),
+            "cycles_dict": get_issue_last_cycles_dict(queryset),
+        }

apps/api/plane/utils/filters/__init__.py

@@ -3,8 +3,8 @@
 # Import all utilities from base modules
 from .filter_backend import ComplexFilterBackend
 from .converters import LegacyToRichFiltersConverter
-from .filterset import IssueFilterSet
+from .filterset import BaseFilterSet, IssueFilterSet
 
 
 # Public API exports
-__all__ = ["ComplexFilterBackend", "LegacyToRichFiltersConverter", "IssueFilterSet"]
+__all__ = ["ComplexFilterBackend", "LegacyToRichFiltersConverter", "BaseFilterSet", "IssueFilterSet"]