fix: merge conflicts from ce to ee

This commit is contained in:
sriramveeraghanta
2025-10-16 15:26:34 +05:30
6700 changed files with 626625 additions and 7477 deletions
+13 -1
View File
@@ -29,9 +29,10 @@ AWS_S3_BUCKET_NAME="uploads"
FILE_SIZE_LIMIT=5242880
# GPT settings
SILO_BASE_URL=
OPENAI_API_BASE="https://api.openai.com/v1" # deprecated
OPENAI_API_KEY="sk-" # deprecated
GPT_ENGINE="gpt-3.5-turbo" # deprecated
GPT_ENGINE="gpt-4o-mini" # deprecated
# Settings related to Docker
DOCKERIZED=1 # deprecated
@@ -52,5 +53,16 @@ CERT_ACME_DNS=
# Force HTTPS for handling SSL Termination
MINIO_ENDPOINT_SSL=0
# Imports Config
SILO_BASE_URL=
# Force HTTPS for handling SSL Termination
MINIO_ENDPOINT_SSL=0
# API key rate limit
API_KEY_RATE_LIMIT="60/minute"
# Mongo DB
MONGO_DB_URL="mongodb://plane-mongodb:27017/"
SILO_DB=silo
SILO_DB_URL=postgresql://plane:plane@plane-db/silo
+127
View File
@@ -0,0 +1,127 @@
name: "Build and Push Docker Image"
description: "Reusable action for building and pushing Docker images"
inputs:
docker-username:
description: "The Dockerhub username"
required: true
dockerhub-token:
description: "The Dockerhub Token"
required: true
# Docker Image Options
docker-image-owner:
description: "The owner of the Docker image"
required: true
docker-image-name:
description: "The name of the Docker image"
required: true
build-context:
description: "The build context"
required: true
default: "."
dockerfile-path:
description: "The path to the Dockerfile"
required: true
build-args:
description: "The build arguments"
required: false
default: ""
# Buildx Options
buildx-driver:
description: "Buildx driver"
required: true
default: "docker-container"
buildx-version:
description: "Buildx version"
required: true
default: "latest"
buildx-platforms:
description: "Buildx platforms"
required: true
default: "linux/amd64"
buildx-endpoint:
description: "Buildx endpoint"
required: true
default: "default"
# Release Build Options
build-release:
description: "Flag to publish release"
required: false
default: "false"
build-prerelease:
description: "Flag to publish prerelease"
required: false
default: "false"
release-version:
description: "The release version"
required: false
default: "latest"
runs:
using: "composite"
steps:
- name: Set Docker Tag
shell: bash
env:
IMG_OWNER: ${{ inputs.docker-image-owner }}
IMG_NAME: ${{ inputs.docker-image-name }}
BUILD_RELEASE: ${{ inputs.build-release }}
IS_PRERELEASE: ${{ inputs.build-prerelease }}
REL_VERSION: ${{ inputs.release-version }}
run: |
FLAT_BRANCH_VERSION=$(echo "${{ github.ref_name }}" | sed 's/[^a-zA-Z0-9.-]//g')
if [ "${{ env.BUILD_RELEASE }}" == "true" ]; then
semver_regex="^v([0-9]+)\.([0-9]+)\.([0-9]+)(-[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$"
if [[ ! ${{ env.REL_VERSION }} =~ $semver_regex ]]; then
echo "Invalid Release Version Format : ${{ env.REL_VERSION }}"
echo "Please provide a valid SemVer version"
echo "e.g. v1.2.3 or v1.2.3-alpha-1"
echo "Exiting the build process"
exit 1 # Exit with status 1 to fail the step
fi
TAG=${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:${{ env.REL_VERSION }}
if [ "${{ env.IS_PRERELEASE }}" != "true" ]; then
TAG=${TAG},${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:stable
fi
elif [ "${{ env.TARGET_BRANCH }}" == "master" ]; then
TAG=${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:latest
else
TAG=${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:${FLAT_BRANCH_VERSION}
fi
echo "DOCKER_TAGS=${TAG}" >> $GITHUB_ENV
- name: Login to Docker Hub
uses: docker/login-action@v3
with:
username: ${{ inputs.docker-username }}
password: ${{ inputs.dockerhub-token}}
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3
with:
driver: ${{ inputs.buildx-driver }}
version: ${{ inputs.buildx-version }}
endpoint: ${{ inputs.buildx-endpoint }}
- name: Check out the repo
uses: actions/checkout@v4
- name: Build and Push Docker Image
uses: docker/[email protected]
with:
context: ${{ inputs.build-context }}
file: ${{ inputs.dockerfile-path }}
platforms: ${{ inputs.buildx-platforms }}
tags: ${{ env.DOCKER_TAGS }}
push: true
build-args: ${{ inputs.build-args }}
env:
DOCKER_BUILDKIT: 1
DOCKER_USERNAME: ${{ inputs.docker-username }}
DOCKER_PASSWORD: ${{ inputs.dockerhub-token }}
+168
View File
@@ -0,0 +1,168 @@
name: "Build and Push Docker Image"
description: "Reusable action for building and pushing Docker images"
inputs:
docker-username:
description: "The Dockerhub username"
required: true
dockerhub-token:
description: "The Dockerhub Token"
required: true
# Harbor Options
harbor-push:
description: "Flag to push to Harbor"
required: false
default: "false"
harbor-username:
description: "The Harbor username"
required: false
harbor-token:
description: "The Harbor token"
required: false
harbor-registry:
description: "The Harbor registry"
required: false
default: "registry.plane.tools"
harbor-project:
description: "The Harbor project"
required: false
# Docker Image Options
docker-image-owner:
description: "The owner of the Docker image"
required: true
docker-image-name:
description: "The name of the Docker image"
required: true
build-context:
description: "The build context"
required: true
default: "."
dockerfile-path:
description: "The path to the Dockerfile"
required: true
build-args:
description: "The build arguments"
required: false
default: ""
# Buildx Options
buildx-driver:
description: "Buildx driver"
required: true
default: "docker-container"
buildx-version:
description: "Buildx version"
required: true
default: "latest"
buildx-platforms:
description: "Buildx platforms"
required: true
default: "linux/amd64"
buildx-endpoint:
description: "Buildx endpoint"
required: true
default: "default"
# Release Build Options
build-release:
description: "Flag to publish release"
required: false
default: "false"
build-prerelease:
description: "Flag to publish prerelease"
required: false
default: "false"
release-version:
description: "The release version"
required: false
default: "latest"
runs:
using: "composite"
steps:
- name: Set Docker Tag
shell: bash
env:
IMG_OWNER: ${{ inputs.docker-image-owner }}
IMG_NAME: ${{ inputs.docker-image-name }}
HARBOR_PUSH: ${{ inputs.harbor-push }}
HARBOR_REGISTRY: ${{ inputs.harbor-registry }}
HARBOR_PROJECT: ${{ inputs.harbor-project }}
BUILD_RELEASE: ${{ inputs.build-release }}
IS_PRERELEASE: ${{ inputs.build-prerelease }}
REL_VERSION: ${{ inputs.release-version }}
run: |
FLAT_BRANCH_VERSION=$(echo "${{ github.ref_name }}" | sed 's/[^a-zA-Z0-9.-]//g')
if [ "${{ env.BUILD_RELEASE }}" == "true" ]; then
semver_regex="^v([0-9]+)\.([0-9]+)\.([0-9]+)(-[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$"
if [[ ! ${{ env.REL_VERSION }} =~ $semver_regex ]]; then
echo "Invalid Release Version Format : ${{ env.REL_VERSION }}"
echo "Please provide a valid SemVer version"
echo "e.g. v1.2.3 or v1.2.3-alpha-1"
echo "Exiting the build process"
exit 1 # Exit with status 1 to fail the step
fi
TAG=${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:${{ env.REL_VERSION }}
if [ "${{ env.HARBOR_PUSH }}" == "true" ]; then
TAG=${TAG},${{ env.HARBOR_REGISTRY }}/${{ env.HARBOR_PROJECT }}/${{ env.IMG_NAME }}:${{ env.REL_VERSION }}
fi
if [ "${{ env.IS_PRERELEASE }}" != "true" ]; then
TAG=${TAG},${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:stable
if [ "${{ env.HARBOR_PUSH }}" == "true" ]; then
TAG=${TAG},${{ env.HARBOR_REGISTRY }}/${{ env.HARBOR_PROJECT }}/${{ env.IMG_NAME }}:stable
fi
fi
elif [ "${{ env.TARGET_BRANCH }}" == "master" ]; then
TAG=${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:latest
if [ "${{ env.HARBOR_PUSH }}" == "true" ]; then
TAG=${TAG},${{ env.HARBOR_REGISTRY }}/${{ env.HARBOR_PROJECT }}/${{ env.IMG_NAME }}:latest
fi
else
TAG=${{ env.IMG_OWNER }}/${{ env.IMG_NAME }}:${FLAT_BRANCH_VERSION}
if [ "${{ env.HARBOR_PUSH }}" == "true" ]; then
TAG=${TAG},${{ env.HARBOR_REGISTRY }}/${{ env.HARBOR_PROJECT }}/${{ env.IMG_NAME }}:${FLAT_BRANCH_VERSION}
fi
fi
echo "DOCKER_TAGS=${TAG}" >> $GITHUB_ENV
- name: Login to Docker Hub
uses: docker/login-action@v3
with:
username: ${{ inputs.docker-username }}
password: ${{ inputs.dockerhub-token}}
- name: Login to Harbor
if: ${{ inputs.harbor-push }} == "true"
uses: docker/login-action@v3
with:
username: ${{ inputs.harbor-username }}
password: ${{ inputs.harbor-token }}
registry: ${{ inputs.harbor-registry }}
- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3
with:
driver: ${{ inputs.buildx-driver }}
version: ${{ inputs.buildx-version }}
endpoint: ${{ inputs.buildx-endpoint }}
- name: Check out the repo
uses: actions/checkout@v4
- name: Build and Push Docker Image
uses: docker/[email protected]
with:
context: ${{ inputs.build-context }}
file: ${{ inputs.dockerfile-path }}
platforms: ${{ inputs.buildx-platforms }}
tags: ${{ env.DOCKER_TAGS }}
push: true
build-args: ${{ inputs.build-args }}
env:
DOCKER_BUILDKIT: 1
DOCKER_USERNAME: ${{ inputs.docker-username }}
DOCKER_PASSWORD: ${{ inputs.dockerhub-token }}
+305
View File
@@ -0,0 +1,305 @@
name: AMI Build - AWS
on:
workflow_dispatch:
inputs:
ami_prefix:
description: 'AMI Prefix'
required: true
default: 'plane-commercial'
prime_host:
description: 'Prime Host'
required: true
default: 'https://prime.plane.so'
ami_publish_region:
description: 'AMI Publish Regions (comma separated)'
type: string
required: true
default: 'us-east-1'
mark_manifest_latest:
description: 'Mark manifest as latest'
type: boolean
required: false
default: false
env:
# Inputs
AMI_PREFIX: ${{ inputs.ami_prefix || 'plane-commercial' }}
PRIME_HOST: ${{ inputs.prime_host || 'https://prime.plane.so' }}
AMI_PUBLISH_REGION: ${{ inputs.ami_publish_region || 'us-east-1' }}
# Inputs by Devops
AWS_MANIFEST_BUCKET: 'plane-terraform-marketplace'
AWS_VPC_CIDR: '10.34.0.0/16'
AWS_SUBNET_CIDR: '10.34.1.0/24'
AWS_VPC_REGION: 'us-east-1'
AWS_BASE_IMAGE_OWNER: '099720109477'
# Secrets
AWS_ACCESS_KEY: ${{ secrets.MARKETPLACE_AWS_ACCESS_KEY_ID }}
AWS_SECRET_KEY: ${{ secrets.MARKETPLACE_AWS_SECRET_ACCESS_KEY }}
# Constants
CURRENT_MANIFEST_FILE: 'ee-docker-aws-ami-manifest.json'
EE_PACKER_FILE: 'ee-docker-aws-ami.pkr.hcl'
CF_TEMPLATE_FILE: deployments/ami/commercial/ee-cloudformation-template.yaml
CF_OUTPUT_FILE: deployments/ami/commercial/plane-commercial-cloudformation.yaml
MARK_MANIFEST_LATEST: ${{ inputs.mark_manifest_latest || false }}
jobs:
build_ami:
runs-on: ubuntu-22.04
steps:
- name: Checkout Repository
uses: actions/checkout@v4
- name: Configure AWS Credentials
uses: aws-actions/configure-aws-credentials@v4
with:
aws-access-key-id: ${{ env.AWS_ACCESS_KEY }}
aws-secret-access-key: ${{ env.AWS_SECRET_KEY }}
aws-region: ${{ env.AWS_VPC_REGION }}
- name: Setup `packer`
uses: hashicorp/setup-packer@main
id: setup
with:
version: latest
- name: Copy Upload Assets
run: |
mkdir -p plane-dist
cp deployments/ami/commercial/cloudinit-ee/* plane-dist/
- name: Run `packer init`
id: init
run: "packer init ./deployments/ami/commercial/${{ env.EE_PACKER_FILE }}"
- name: Run `packer validate`
id: validate
run: "packer validate ./deployments/ami/commercial/${{ env.EE_PACKER_FILE }}"
- name: Make Variables File
id: make_variables_file
run: |
touch variables.pkrvars.hcl
echo "aws_region = \"${AWS_VPC_REGION}\"" >> variables.pkrvars.hcl
echo "ami_name_prefix = \"${AMI_PREFIX}\"" >> variables.pkrvars.hcl
echo "vpc_cidr = \"${AWS_VPC_CIDR}\"" >> variables.pkrvars.hcl
echo "subnet_cidr = \"${AWS_SUBNET_CIDR}\"" >> variables.pkrvars.hcl
echo "base_image_owner = \"${AWS_BASE_IMAGE_OWNER}\"" >> variables.pkrvars.hcl
echo "prime_host = \"${PRIME_HOST}\"" >> variables.pkrvars.hcl
echo "instance_type = \"t3a.xlarge\"" >> variables.pkrvars.hcl
echo "manifest_file_name = \"${{ env.CURRENT_MANIFEST_FILE }}\"" >> variables.pkrvars.hcl
# split AMI_PUBLISH_REGION by comma and add to ami_regions
ami_regions=$(echo "${AMI_PUBLISH_REGION}" | sed 's/[[:space:]]*,[[:space:]]*/\n/g' | jq -R . | jq -s -c .)
echo "ami_regions = ${ami_regions}" >> variables.pkrvars.hcl
cat variables.pkrvars.hcl
- name: Run `packer build`
id: build
run: |
packer build \
-var "aws_access_key=${{ env.AWS_ACCESS_KEY }}" \
-var "aws_secret_key=${{ env.AWS_SECRET_KEY }}" \
-var-file=variables.pkrvars.hcl \
./deployments/ami/commercial/${{ env.EE_PACKER_FILE }}
- name: Extract AMI Information and Create Summary
id: ami_info
run: |
# Extract AMI details from manifest
AMI_STRING=$(jq -r '.builds[-1].artifact_id' ${{env.CURRENT_MANIFEST_FILE}})
AMI_NAME=$(jq -r '.builds[-1].custom_data.ami_name' ${{env.CURRENT_MANIFEST_FILE}})
BUILD_TIME=$(jq -r '.builds[-1].custom_data.build_time' ${{env.CURRENT_MANIFEST_FILE}})
# Create array of AMI information
declare -a AMI_INFO
IFS=',' read -ra AMI_ARRAY <<< "$AMI_STRING"
for ami in "${AMI_ARRAY[@]}"; do
REGION=$(echo "$ami" | cut -d ":" -f1)
AMI_ID=$(echo "$ami" | cut -d ":" -f2)
AMI_INFO+=("$REGION:$AMI_ID")
done
# Add git information to manifest
jq --arg branch "${{ github.ref_name }}" \
--arg commit "${{ github.sha }}" \
--arg build_time "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" \
'.builds[-1].custom_data += {git_branch: $branch, git_commit: $commit, build_timestamp: $build_time}' \
${{env.CURRENT_MANIFEST_FILE}} > temp-manifest.json
mv temp-manifest.json ${{env.CURRENT_MANIFEST_FILE}}
- name: Store Manifest in S3
run: |
# Also store a versioned copy
aws s3 cp ${{env.CURRENT_MANIFEST_FILE}} "s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-manifest-${{ github.sha }}.json"
- name: Store Manifest in S3 as latest
if: ${{ env.MARK_MANIFEST_LATEST == 'true' }}
run: |
# Store the current manifest as latest
aws s3 cp ${{env.CURRENT_MANIFEST_FILE}} s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-manifest-latest.json || true
- name: Upload Build Manifest as Artifact
uses: actions/upload-artifact@v4
with:
name: ee-docker-aws-ami-manifest
path: ${{env.CURRENT_MANIFEST_FILE}}
retention-days: 30
- name: Tag AMIs
run: |
# Extract AMI string again
AMI_STRING=$(jq -r '.builds[-1].artifact_id' ${{env.CURRENT_MANIFEST_FILE}})
# Process and tag each AMI in its respective region
IFS=',' read -ra AMI_ARRAY <<< "$AMI_STRING"
for ami in "${AMI_ARRAY[@]}"; do
REGION=$(echo "$ami" | cut -d ":" -f1)
AMI_ID=$(echo "$ami" | cut -d ":" -f2)
echo "Tagging AMI ${AMI_ID} in region ${REGION}"
aws ec2 create-tags \
--region "$REGION" \
--resources "$AMI_ID" \
--tags \
Key=GitBranch,Value=${{ github.ref_name }} \
Key=GitCommit,Value=${{ github.sha }} \
Key=BuildTime,Value=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
done
- name: Update CloudFormation Template
run: |
# Install yq if not present
if ! command -v yq &> /dev/null; then
echo "Installing yq..."
sudo wget -qO /usr/local/bin/yq https://github.com/mikefarah/yq/releases/latest/download/yq_linux_amd64
sudo chmod +x /usr/local/bin/yq
fi
if ! command -v jq &> /dev/null; then
echo "Error: jq is required but not installed. Please install jq to continue."
exit 1
fi
ARTIFACT_ID=$(jq -r '.builds[0].artifact_id' "${{ env.CURRENT_MANIFEST_FILE }}")
if [[ "$ARTIFACT_ID" == "null" || -z "$ARTIFACT_ID" ]]; then
echo "Error: Could not extract artifact_id from manifest file"
exit 1
fi
echo "Found artifact_id: $ARTIFACT_ID"
REGIONS=()
AMIS=()
# Split by comma and process each region:ami pair
IFS=',' read -ra PAIRS <<< "$ARTIFACT_ID"
for pair in "${PAIRS[@]}"; do
# Trim whitespace
pair=$(echo "$pair" | xargs)
# Split by colon to get region and ami
IFS=':' read -ra REGION_AMI <<< "$pair"
if [[ ${#REGION_AMI[@]} -eq 2 ]]; then
region="${REGION_AMI[0]}"
ami="${REGION_AMI[1]}"
REGIONS+=("$region")
AMIS+=("$ami")
echo " $region -> $ami"
fi
done
# Check if we found any AMI mappings
if [[ ${#REGIONS[@]} -eq 0 ]]; then
echo "Error: No valid region:ami pairs found in artifact_id"
exit 1
fi
# Copy the original template to output file
cp "${{ env.CF_TEMPLATE_FILE }}" "${{ env.CF_OUTPUT_FILE }}"
echo "Regions: ${REGIONS[@]}"
echo "AMIs: ${AMIS[@]}"
echo "Updating AMI IDs in template..."
REGION_RESTRICTIONS=()
# Update AMI IDs for each region found in the manifest
REGIONS_STRING=""
for i in "${!REGIONS[@]}"; do
region="${REGIONS[$i]}"
ami_id="${AMIS[$i]}"
echo " Updating $region with AMI: $ami_id"
REGIONS_STRING+="${region}, "
yq eval ".Parameters.AMIId.Default = \"${ami_id}\"" -i "${{ env.CF_OUTPUT_FILE }}"
done
cat "${{ env.CF_OUTPUT_FILE }}"
echo "Updated template saved as: ${{ env.CF_OUTPUT_FILE }}"
- name: Store CloudFormation Template in S3
run: |
# Store the current manifest as latest
aws s3 cp ${{env.CF_OUTPUT_FILE}} s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/cloudformation/plane-commercial-cloudformation-latest.yaml
date_string=$(date +%d%b%Y)
aws s3 cp ${{env.CF_OUTPUT_FILE}} s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/cloudformation/plane-commercial-cloudformation-${date_string}.yaml
- name: Upload Updated CloudFormation Template
uses: actions/upload-artifact@v4
with:
name: cloudformation-template
path: ${{ env.CF_OUTPUT_FILE }}
retention-days: 30
- name: Print Build Summary
id: print_build_summary
run: |
# Extract AMI details from manifest
AMI_STRING=$(jq -r '.builds[-1].artifact_id' ${{env.CURRENT_MANIFEST_FILE}})
AMI_NAME=$(jq -r '.builds[-1].custom_data.ami_name' ${{env.CURRENT_MANIFEST_FILE}})
BUILD_TIME=$(jq -r '.builds[-1].custom_data.build_time' ${{env.CURRENT_MANIFEST_FILE}})
# Create array of AMI information
declare -a AMI_INFO
IFS=',' read -ra AMI_ARRAY <<< "$AMI_STRING"
for ami in "${AMI_ARRAY[@]}"; do
REGION=$(echo "$ami" | cut -d ":" -f1)
AMI_ID=$(echo "$ami" | cut -d ":" -f2)
AMI_INFO+=("$REGION:$AMI_ID")
done
# Create build summary with all AMIs
{
echo "### 🌎 Regional AMI Distribution"
echo "| Region | AMI ID |"
echo "| --- | --- |"
for ami_info in "${AMI_INFO[@]}"; do
region=${ami_info%:*}
ami_id=${ami_info#*:}
echo "| \`${region}\` | \`${ami_id}\` |"
done
} >> $GITHUB_STEP_SUMMARY
date_string=$(date +%d%b%Y)
{
echo "### 📁 S3 Files"
echo "| File | Path | "
echo "| --- | --- |"
echo "| Latest CF Template | \`s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/cloudformation/plane-commercial-cloudformation-latest.yaml\` |"
echo "| CF Template | \`s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/cloudformation/plane-commercial-cloudformation-${date_string}.yaml\` |"
echo "| Current Manifest | \`s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-manifest-${{ github.sha }}.json\` |"
echo "| Latest Manifest | \`s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-manifest-latest.json\` |"
} >> $GITHUB_STEP_SUMMARY
# Console output for logs
echo "✅ AMI built successfully!"
echo "🔹 AMI Information:"
for ami_info in "${AMI_INFO[@]}"; do
region=${ami_info%:*}
ami_id=${ami_info#*:}
echo " • Region: ${region}, AMI ID: ${ami_id}"
done
@@ -0,0 +1,180 @@
name: AMI Build - DigitalOcean
on:
push:
branches:
- appliance-digitalocean
workflow_dispatch:
inputs:
ami_prefix:
description: 'AMI Prefix'
required: true
default: 'plane-commercial'
prime_host:
description: 'Prime Host'
required: true
default: 'https://prime.plane.so'
mark_manifest_latest:
description: 'Mark manifest as latest'
type: boolean
required: false
default: false
env:
# Inputs
AMI_PREFIX: ${{ inputs.ami_prefix || 'plane-commercial' }}
PRIME_HOST: ${{ inputs.prime_host || 'https://prime.plane.so' }}
# Inputs by Devops
AWS_MANIFEST_BUCKET: 'plane-terraform-marketplace'
AWS_VPC_REGION: 'us-east-1'
# Secrets
AWS_ACCESS_KEY: ${{ secrets.MARKETPLACE_AWS_ACCESS_KEY_ID }}
AWS_SECRET_KEY: ${{ secrets.MARKETPLACE_AWS_SECRET_ACCESS_KEY }}
# Constants
CURRENT_MANIFEST_FILE: 'ee-docker-digital-ocean-manifest.json'
EE_PACKER_FILE: 'ee-docker-digital-ocean.pkr.hcl'
MARK_MANIFEST_LATEST: ${{ inputs.mark_manifest_latest || false }}
jobs:
build_ami:
runs-on: ubuntu-22.04
steps:
- name: Checkout Repository
uses: actions/checkout@v4
- name: Configure AWS Credentials
uses: aws-actions/configure-aws-credentials@v4
with:
aws-access-key-id: ${{ env.AWS_ACCESS_KEY }}
aws-secret-access-key: ${{ env.AWS_SECRET_KEY }}
aws-region: ${{ env.AWS_VPC_REGION }}
- name: Setup `packer`
uses: hashicorp/setup-packer@main
id: setup
with:
version: latest
- name: Copy Upload Assets
run: |
mkdir -p plane-dist
cp deployments/ami/commercial/cloudinit-ee/* plane-dist/
- name: Run `packer init`
id: init
run: "packer init ./deployments/ami/commercial/${{ env.EE_PACKER_FILE }}"
- name: Run `packer validate`
id: validate
run: "packer validate ./deployments/ami/commercial/${{ env.EE_PACKER_FILE }}"
- name: Make Variables File
id: make_variables_file
run: |
touch variables.pkrvars.hcl
echo "ami_name_prefix = \"${AMI_PREFIX}\"" >> variables.pkrvars.hcl
echo "prime_host = \"${PRIME_HOST}\"" >> variables.pkrvars.hcl
echo "instance_type = \"s-2vcpu-4gb\"" >> variables.pkrvars.hcl
echo "manifest_file_name = \"${{ env.CURRENT_MANIFEST_FILE }}\"" >> variables.pkrvars.hcl
cat variables.pkrvars.hcl
- name: Run `packer build`
id: build
run: |
packer build \
-var "api_token=${{ secrets.MARKETPLACE_DIGITAL_OCEAN_API_TOKEN }}" \
-var-file=variables.pkrvars.hcl \
./deployments/ami/commercial/${{ env.EE_PACKER_FILE }}
- name: Extract AMI Information and Create Summary
id: ami_info
run: |
# Extract AMI details from manifest
AMI_STRING=$(jq -r '.builds[-1].artifact_id' ${{env.CURRENT_MANIFEST_FILE}})
AMI_NAME=$(jq -r '.builds[-1].custom_data.ami_name' ${{env.CURRENT_MANIFEST_FILE}})
BUILD_TIME=$(jq -r '.builds[-1].custom_data.build_time' ${{env.CURRENT_MANIFEST_FILE}})
# Create array of AMI information
declare -a AMI_INFO
IFS=',' read -ra AMI_ARRAY <<< "$AMI_STRING"
for ami in "${AMI_ARRAY[@]}"; do
REGION=$(echo "$ami" | cut -d ":" -f1)
AMI_ID=$(echo "$ami" | cut -d ":" -f2)
AMI_INFO+=("$REGION:$AMI_ID")
done
# Add git information to manifest
jq --arg branch "${{ github.ref_name }}" \
--arg commit "${{ github.sha }}" \
--arg build_time "$(date -u +"%Y-%m-%dT%H:%M:%SZ")" \
'.builds[-1].custom_data += {git_branch: $branch, git_commit: $commit, build_timestamp: $build_time}' \
${{env.CURRENT_MANIFEST_FILE}} > temp-manifest.json
mv temp-manifest.json ${{env.CURRENT_MANIFEST_FILE}}
- name: Store Manifest in S3
run: |
# Also store a versioned copy
aws s3 cp ${{env.CURRENT_MANIFEST_FILE}} "s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-digitalocean-manifest-${{ github.sha }}.json"
- name: Store Manifest in S3 as latest
if: ${{ env.MARK_MANIFEST_LATEST == 'true' }}
run: |
# Store the current manifest as latest
aws s3 cp ${{env.CURRENT_MANIFEST_FILE}} s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-digitalocean-manifest-latest.json || true
- name: Upload Build Manifest as Artifact
uses: actions/upload-artifact@v4
with:
name: ee-docker-digital-ocean-manifest
path: ${{env.CURRENT_MANIFEST_FILE}}
retention-days: 30
- name: Print Build Summary
id: print_build_summary
run: |
# Extract AMI details from manifest
AMI_STRING=$(jq -r '.builds[-1].artifact_id' ${{env.CURRENT_MANIFEST_FILE}})
AMI_NAME=$(jq -r '.builds[-1].custom_data.ami_name' ${{env.CURRENT_MANIFEST_FILE}})
BUILD_TIME=$(jq -r '.builds[-1].custom_data.build_time' ${{env.CURRENT_MANIFEST_FILE}})
# Create array of AMI information
declare -a AMI_INFO
IFS=',' read -ra AMI_ARRAY <<< "$AMI_STRING"
for ami in "${AMI_ARRAY[@]}"; do
REGION=$(echo "$ami" | cut -d ":" -f1)
AMI_ID=$(echo "$ami" | cut -d ":" -f2)
AMI_INFO+=("$REGION:$AMI_ID")
done
# Create build summary with all AMIs
{
echo "### 🌎 Regional AMI Distribution"
echo "| Region | AMI ID |"
echo "| --- | --- |"
for ami_info in "${AMI_INFO[@]}"; do
region=${ami_info%:*}
ami_id=${ami_info#*:}
echo "| \`${region}\` | \`${ami_id}\` |"
done
} >> $GITHUB_STEP_SUMMARY
date_string=$(date +%d%b%Y)
{
echo "### 📁 S3 Files"
echo "| File | Path | "
echo "| --- | --- |"
echo "| Current Manifest | \`s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-manifest-${{ github.sha }}.json\` |"
echo "| Latest Manifest | \`s3://${{ env.AWS_MANIFEST_BUCKET }}/plane-commercial/ami/manifests/plane-commercial-manifest-latest.json\` |"
} >> $GITHUB_STEP_SUMMARY
# Console output for logs
echo "✅ AMI built successfully!"
echo "🔹 AMI Information:"
for ami_info in "${AMI_INFO[@]}"; do
region=${ami_info%:*}
ami_id=${ami_info#*:}
echo " • Region: ${region}, AMI ID: ${ami_id}"
done
+395
View File
@@ -0,0 +1,395 @@
name: Branch Build Cloud
on:
workflow_dispatch:
inputs:
build_type:
description: "Type of build to run"
required: true
type: choice
default: "Build"
options:
- "Build"
- "Release"
releaseVersion:
description: "Release Version"
type: string
default: v0.0.0-cloud
useVaultSecrets:
description: "Use Vault Secrets"
type: boolean
default: false
required: true
isPrerelease:
description: "Is Pre-release"
type: boolean
default: false
required: true
env:
TARGET_BRANCH: ${{ github.ref_name }}
VAULT_KP_PREFIX: plane-ee-cloud-builds
BUILD_TYPE: ${{ github.event.inputs.build_type }}
RELEASE_VERSION: ${{ github.event.inputs.releaseVersion }}
IS_PRERELEASE: ${{ github.event.inputs.isPrerelease }}
jobs:
branch_build_setup:
name: Build Setup
runs-on: ubuntu-22.04
outputs:
gh_branch_name: ${{ steps.set_env_variables.outputs.TARGET_BRANCH }}
gh_buildx_driver: ${{ steps.set_env_variables.outputs.BUILDX_DRIVER }}
gh_buildx_version: ${{ steps.set_env_variables.outputs.BUILDX_VERSION }}
gh_buildx_platforms: ${{ steps.set_env_variables.outputs.BUILDX_PLATFORMS }}
gh_buildx_endpoint: ${{ steps.set_env_variables.outputs.BUILDX_ENDPOINT }}
dh_img_web: ${{ steps.set_env_variables.outputs.DH_IMG_WEB }}
dh_img_space: ${{ steps.set_env_variables.outputs.DH_IMG_SPACE }}
dh_img_admin: ${{ steps.set_env_variables.outputs.DH_IMG_ADMIN }}
dh_img_live: ${{ steps.set_env_variables.outputs.DH_IMG_LIVE }}
dh_img_silo: ${{ steps.set_env_variables.outputs.DH_IMG_SILO }}
dh_img_backend: ${{ steps.set_env_variables.outputs.DH_IMG_BACKEND }}
dh_img_email: ${{ steps.set_env_variables.outputs.DH_IMG_EMAIL }}
dh_img_pi: ${{ steps.set_env_variables.outputs.dh_img_pi }}
harbor_push: ${{ steps.set_env_variables.outputs.HARBOR_PUSH }}
build_type: ${{steps.set_env_variables.outputs.BUILD_TYPE}}
build_release: ${{ steps.set_env_variables.outputs.BUILD_RELEASE }}
build_prerelease: ${{ steps.set_env_variables.outputs.BUILD_PRERELEASE }}
release_version: ${{ steps.set_env_variables.outputs.RELEASE_VERSION }}
vault_secrets: ${{ steps.get_vault_secrets.outputs.VAULT_SECRETS }}
build_args: ${{ steps.prepare_build_args.outputs.BUILD_ARGS }}
steps:
- id: set_env_variables
name: Set Environment Variables
run: |
echo "BUILDX_DRIVER=docker-container" >> $GITHUB_OUTPUT
echo "BUILDX_VERSION=latest" >> $GITHUB_OUTPUT
echo "BUILDX_PLATFORMS=linux/amd64" >> $GITHUB_OUTPUT
echo "BUILDX_ENDPOINT=" >> $GITHUB_OUTPUT
BR_NAME=$( echo "${{ env.TARGET_BRANCH }}" | sed 's/[^a-zA-Z0-9.-]//g')
echo "TARGET_BRANCH=$BR_NAME" >> $GITHUB_OUTPUT
echo "DH_IMG_WEB=web-cloud" >> $GITHUB_OUTPUT
echo "DH_IMG_SPACE=space-cloud" >> $GITHUB_OUTPUT
echo "DH_IMG_ADMIN=admin-cloud" >> $GITHUB_OUTPUT
echo "DH_IMG_LIVE=live-cloud" >> $GITHUB_OUTPUT
echo "DH_IMG_SILO=silo-cloud" >> $GITHUB_OUTPUT
echo "DH_IMG_BACKEND=backend-cloud" >> $GITHUB_OUTPUT
echo "DH_IMG_EMAIL=email-cloud" >> $GITHUB_OUTPUT
echo "dh_img_pi=plane-pi-cloud" >> $GITHUB_OUTPUT
echo "BUILD_TYPE=${{env.BUILD_TYPE}}" >> $GITHUB_OUTPUT
BUILD_RELEASE=false
BUILD_PRERELEASE=false
RELVERSION="latest"
if [ "${{ env.BUILD_TYPE }}" == "Release" ]; then
FLAT_RELEASE_VERSION=$(echo "${{ env.RELEASE_VERSION }}" | sed 's/[^a-zA-Z0-9.-]//g')
echo "FLAT_RELEASE_VERSION=${FLAT_RELEASE_VERSION}" >> $GITHUB_OUTPUT
semver_regex="^v([0-9]+)\.([0-9]+)\.([0-9]+)(-[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*)?$"
if [[ ! $FLAT_RELEASE_VERSION =~ $semver_regex ]]; then
echo "Invalid Release Version Format : $FLAT_RELEASE_VERSION"
echo "Please provide a valid SemVer version"
echo "e.g. v1.2.3 or v1.2.3-alpha-1"
echo "Exiting the build process"
exit 1 # Exit with status 1 to fail the step
fi
BUILD_RELEASE=true
RELVERSION=$FLAT_RELEASE_VERSION
if [ "${{ env.IS_PRERELEASE }}" == "true" ]; then
BUILD_PRERELEASE=true
fi
fi
echo "BUILD_RELEASE=${BUILD_RELEASE}" >> $GITHUB_OUTPUT
echo "BUILD_PRERELEASE=${BUILD_PRERELEASE}" >> $GITHUB_OUTPUT
echo "RELEASE_VERSION=${RELVERSION}" >> $GITHUB_OUTPUT
- name: Tailscale
uses: tailscale/github-action@v2
if: ${{github.event.inputs.useVaultSecrets == 'true'}}
with:
oauth-client-id: ${{ secrets.TAILSCALE_OAUTH_CLIENT_ID }}
oauth-secret: ${{ secrets.TAILSCALE_OAUTH_CLIENT_SECRET }}
tags: tag:ci
- name: Get the ENV values from Vault
id: get_vault_secrets
if: ${{github.event.inputs.useVaultSecrets == 'true'}}
run: |
if [ "${{ env.TARGET_BRANCH }}" == "master" ]; then
ENV_NAME="prod"
else
ENV_NAME="stage"
fi
curl -fsSL \
--header "X-Vault-Token: ${{ secrets.VAULT_TOKEN }}" \
--request GET \
${{ vars.VAULT_HOST }}/v1/kv/git-builds/data/${{ env.VAULT_KP_PREFIX }}-${ENV_NAME} | jq .data.data > vault_secrets.json
if [ $? != 0 ]; then
echo "Failed to get the ENV values from Vault"
exit 1
fi
VAULT_SECRETS=$(cat vault_secrets.json | base64 -w 0)
echo "VAULT_SECRETS=${VAULT_SECRETS}" >> $GITHUB_OUTPUT
- name: Prepare Docker Build Args
id: prepare_build_args
if: ${{github.event.inputs.useVaultSecrets == 'true'}}
run: |
BUILD_ARGS=""
add_build_arg() {
if [ -n "$2" ]; then
BUILD_ARGS="$BUILD_ARGS $1=$2"
fi
}
add_build_arg "NEXT_PUBLIC_API_BASE_URL" "${{ env.NEXT_PUBLIC_API_BASE_URL }}"
add_build_arg "NEXT_PUBLIC_API_BASE_PATH" "${{ env.NEXT_PUBLIC_API_BASE_PATH }}"
add_build_arg "NEXT_PUBLIC_ADMIN_BASE_URL" "${{ env.NEXT_PUBLIC_ADMIN_BASE_URL }}"
add_build_arg "NEXT_PUBLIC_ADMIN_BASE_PATH" "${{ env.NEXT_PUBLIC_ADMIN_BASE_PATH }}"
add_build_arg "NEXT_PUBLIC_SPACE_BASE_URL" "${{ env.NEXT_PUBLIC_SPACE_BASE_URL }}"
add_build_arg "NEXT_PUBLIC_SPACE_BASE_PATH" "${{ env.NEXT_PUBLIC_SPACE_BASE_PATH }}"
add_build_arg "NEXT_PUBLIC_LIVE_BASE_URL" "${{ env.NEXT_PUBLIC_LIVE_BASE_URL }}"
add_build_arg "NEXT_PUBLIC_LIVE_BASE_PATH" "${{ env.NEXT_PUBLIC_LIVE_BASE_PATH }}"
add_build_arg "NEXT_PUBLIC_SILO_BASE_URL" "${{ env.NEXT_PUBLIC_SILO_BASE_URL }}"
add_build_arg "NEXT_PUBLIC_SILO_BASE_PATH" "${{ env.NEXT_PUBLIC_SILO_BASE_PATH }}"
add_build_arg "NEXT_PUBLIC_WEB_BASE_URL" "${{ env.NEXT_PUBLIC_WEB_BASE_URL }}"
add_build_arg "SENTRY_AUTH_TOKEN" "${{ secrets.SENTRY_AUTH_TOKEN }}"
echo "BUILD_ARGS=$BUILD_ARGS" >> $GITHUB_OUTPUT
branch_build_push_admin:
name: Build-Push Admin Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- name: Admin Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_admin }}
build-context: .
dockerfile-path: ./apps/admin/Dockerfile.admin
buildx-driver: ${{ needs.branch_build_setup.outputs.gh_buildx_driver }}
buildx-version: ${{ needs.branch_build_setup.outputs.gh_buildx_version }}
buildx-platforms: ${{ needs.branch_build_setup.outputs.gh_buildx_platforms }}
buildx-endpoint: ${{ needs.branch_build_setup.outputs.gh_buildx_endpoint }}
build-args: ${{ needs.branch_build_setup.outputs.build_args }}
branch_build_push_web:
name: Build-Push Web Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- name: Load Vault Secrets
run: |
echo ${{ needs.branch_build_setup.outputs.vault_secrets }} | base64 -d > vault_secrets.json
jq -r 'to_entries|map("\(.key)=\(.value|tostring)")|.[]' vault_secrets.json >> $GITHUB_ENV
- name: Web Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_web }}
build-context: .
dockerfile-path: ./apps/web/Dockerfile.web
buildx-driver: ${{ needs.branch_build_setup.outputs.gh_buildx_driver }}
buildx-version: ${{ needs.branch_build_setup.outputs.gh_buildx_version }}
buildx-platforms: ${{ needs.branch_build_setup.outputs.gh_buildx_platforms }}
buildx-endpoint: ${{ needs.branch_build_setup.outputs.gh_buildx_endpoint }}
build-args: ${{ needs.branch_build_setup.outputs.build_args }}
branch_build_push_space:
name: Build-Push Space Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- name: Load Vault Secrets
run: |
echo ${{ needs.branch_build_setup.outputs.vault_secrets }} | base64 -d > vault_secrets.json
jq -r 'to_entries|map("\(.key)=\(.value|tostring)")|.[]' vault_secrets.json >> $GITHUB_ENV
- name: Space Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_space }}
build-context: .
dockerfile-path: ./apps/space/Dockerfile.space
buildx-driver: ${{ needs.branch_build_setup.outputs.gh_buildx_driver }}
buildx-version: ${{ needs.branch_build_setup.outputs.gh_buildx_version }}
buildx-platforms: ${{ needs.branch_build_setup.outputs.gh_buildx_platforms }}
buildx-endpoint: ${{ needs.branch_build_setup.outputs.gh_buildx_endpoint }}
build-args: ${{ needs.branch_build_setup.outputs.build_args }}
branch_build_push_live:
name: Build-Push Live Collaboration Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- name: Live Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_live }}
build-context: .
dockerfile-path: ./apps/live/Dockerfile.live
buildx-driver: ${{ needs.branch_build_setup.outputs.gh_buildx_driver }}
buildx-version: ${{ needs.branch_build_setup.outputs.gh_buildx_version }}
buildx-platforms: ${{ needs.branch_build_setup.outputs.gh_buildx_platforms }}
buildx-endpoint: ${{ needs.branch_build_setup.outputs.gh_buildx_endpoint }}
branch_build_push_silo:
name: Build-Push Silo Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- name: Silo Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_silo }}
build-context: .
dockerfile-path: ./apps/silo/Dockerfile.silo
branch_build_push_api:
name: Build-Push API Server Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- name: Backend Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_backend }}
build-context: ./apps/api
dockerfile-path: ./apps/api/Dockerfile.api
buildx-driver: ${{ needs.branch_build_setup.outputs.gh_buildx_driver }}
buildx-version: ${{ needs.branch_build_setup.outputs.gh_buildx_version }}
buildx-platforms: ${{ needs.branch_build_setup.outputs.gh_buildx_platforms }}
buildx-endpoint: ${{ needs.branch_build_setup.outputs.gh_buildx_endpoint }}
branch_build_push_email:
name: Build-Push Email Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- id: checkout_files
name: Checkout Files
uses: actions/checkout@v4
- name: Email Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_email }}
build-context: ./apps/email
dockerfile-path: ./apps/email/Dockerfile
buildx-driver: ${{ needs.branch_build_setup.outputs.gh_buildx_driver }}
buildx-version: ${{ needs.branch_build_setup.outputs.gh_buildx_version }}
buildx-platforms: ${{ needs.branch_build_setup.outputs.gh_buildx_platforms }}
buildx-endpoint: ${{ needs.branch_build_setup.outputs.gh_buildx_endpoint }}
branch_build_push_plane_pi:
name: Build-Push Plane PI Docker Image
runs-on: ubuntu-22.04
needs: [branch_build_setup]
steps:
- name: Plane PI Build and Push
uses: makeplane/actions/[email protected]
with:
build-release: ${{ needs.branch_build_setup.outputs.build_release }}
build-prerelease: ${{ needs.branch_build_setup.outputs.build_prerelease }}
release-version: ${{ needs.branch_build_setup.outputs.release_version }}
dockerhub-username: ${{ secrets.DOCKERHUB_USERNAME }}
dockerhub-token: ${{ secrets.DOCKERHUB_TOKEN }}
docker-image-owner: makeplane
docker-image-name: ${{ needs.branch_build_setup.outputs.dh_img_pi }}
build-context: ./apps/pi
dockerfile-path: ./apps/pi/Dockerfile.api
buildx-driver: ${{ needs.branch_build_setup.outputs.gh_buildx_driver }}
buildx-version: ${{ needs.branch_build_setup.outputs.gh_buildx_version }}
buildx-platforms: ${{ needs.branch_build_setup.outputs.gh_buildx_platforms }}
buildx-endpoint: ${{ needs.branch_build_setup.outputs.gh_buildx_endpoint }}
publish_release:
if: ${{ needs.branch_build_setup.outputs.build_type == 'Release' }}
name: Build Release
runs-on: ubuntu-22.04
needs:
[
branch_build_setup,
branch_build_push_admin,
branch_build_push_web,
branch_build_push_space,
branch_build_push_live,
branch_build_push_silo,
branch_build_push_api,
branch_build_push_email,
branch_build_push_plane_pi,
]
env:
REL_VERSION: ${{ needs.branch_build_setup.outputs.release_version }}
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Create Release
id: create_release
uses: softprops/[email protected]
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} # This token is provided by Actions, you do not need to create your own token
with:
tag_name: ${{ env.REL_VERSION }}
name: ${{ env.REL_VERSION }}
draft: false
prerelease: ${{ env.IS_PRERELEASE }}
generate_release_notes: true
File diff suppressed because it is too large Load Diff
@@ -49,5 +49,5 @@ jobs:
- name: Check Affected format
run: pnpm turbo run check:format --affected
- name: Build Affected
run: pnpm turbo run build --affected
# - name: Build Affected
# run: pnpm turbo run build --affected
+55
View File
@@ -0,0 +1,55 @@
name: Sync from Community Repo
on:
# schedule:
# - cron: "*/30 * * * *" # Runs every 30 minutes
workflow_dispatch:
inputs:
source_branch:
description: "Source branch in Community repo"
required: true
default: "preview"
target_branch:
description: "Target branch in Enterprise repo"
required: true
default: "preview"
jobs:
sync-from-community-repo:
runs-on: ubuntu-latest
steps:
- name: Checkout enterprise repository
uses: actions/checkout@v2
with:
fetch-depth: 0
- name: Set branch names
run: |
echo "SOURCE_BRANCH=${{ github.event.inputs.source_branch || 'preview' }}" >> $GITHUB_ENV
echo "TARGET_BRANCH=${{ github.event.inputs.target_branch || 'preview' }}" >> $GITHUB_ENV
echo "SYNC_BRANCH=sync-${{ github.run_id }}" >> $GITHUB_ENV
- name: Create sync branch
run: git checkout -b ${{ env.SYNC_BRANCH }}
- name: Fetch from community repository
run: |
git config user.name github-actions
git config user.email [email protected]
git remote add community https://github.com/makeplane/plane.git
git reset --hard community/${{ env.SOURCE_BRANCH }}
- name: Create Pull Request
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
PR_TITLE="Sync changes from community repo"
EXISTING_PR=$(gh pr list --base ${{ env.TARGET_BRANCH }} --head ${{ env.SYNC_BRANCH }} --json number --jq '.[0].number')
if [ -z "$EXISTING_PR" ]; then
pr_url=$(gh pr create --base ${{ env.TARGET_BRANCH }} --head ${{ env.SYNC_BRANCH }} --title "$PR_TITLE" --body "This PR syncs changes from the community repository's ${{ env.SOURCE_BRANCH }} branch.")
echo "New Pull Request created: $pr_url"
else
echo "Pull Request already exists with number: $EXISTING_PR"
gh pr edit $EXISTING_PR --title "$PR_TITLE" --body "This PR syncs changes from the community repository's ${{ env.SOURCE_BRANCH }} branch. (Updated)"
echo "Existing Pull Request updated"
fi
+5 -1
View File
@@ -41,12 +41,16 @@ jobs:
- name: Create PR to Target Branch
run: |
# Determine target branch based on current branch prefix
TARGET_BRANCH="preview"
PR_TITLE="${{vars.SYNC_PR_TITLE}}"
# get all pull requests and check if there is already a PR
PR_EXISTS=$(gh pr list --base $TARGET_BRANCH --head $CURRENT_BRANCH --state open --json number | jq '.[] | .number')
if [ -n "$PR_EXISTS" ]; then
echo "Pull Request already exists: $PR_EXISTS"
else
echo "Creating new pull request"
PR_URL=$(gh pr create --base $TARGET_BRANCH --head $CURRENT_BRANCH --title "${{ vars.SYNC_PR_TITLE }}" --body "")
PR_URL=$(gh pr create --base $TARGET_BRANCH --head $CURRENT_BRANCH --title "$PR_TITLE" --body "")
echo "Pull Request created: $PR_URL"
fi
+1 -1
View File
@@ -36,8 +36,8 @@ jobs:
GH_TOKEN: ${{ secrets.ACCESS_TOKEN }}
run: |
TARGET_REPO="${{ vars.SYNC_TARGET_REPO }}"
TARGET_BRANCH="${{ vars.SYNC_TARGET_BRANCH_NAME }}"
SOURCE_BRANCH="${{ env.SOURCE_BRANCH_NAME }}"
TARGET_BRANCH="${{ vars.SYNC_TARGET_BRANCH_NAME }}"
git checkout $SOURCE_BRANCH
git remote add target-origin-a "https://[email protected]/$TARGET_REPO.git"
+9 -1
View File
@@ -87,6 +87,7 @@ tmp/
## packages
dist
.flatfile
.temp/
deploy/selfhost/plane-app/
@@ -100,5 +101,12 @@ dev-editor
*.rdb.gz
storybook-static
# Monitor
monitor/prime.key
monitor/prime.key.pub
monitor.db
CLAUDE.md
.cursorrules
.cursor
claude.md
agents.md
+5
View File
@@ -0,0 +1,5 @@
{
"printWidth": 120,
"tabWidth": 2,
"trailingComma": "es5"
}
@@ -0,0 +1,240 @@
import type { FC } from "react";
import { useState } from "react";
import Link from "next/link";
import { useForm } from "react-hook-form";
// plane internal packages
import { Button, getButtonStyling } from "@plane/propel/button";
import { TOAST_TYPE, setToast } from "@plane/propel/toast";
import type { IFormattedInstanceConfiguration, TInstanceOIDCAuthenticationConfigurationKeys } 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 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";
type Props = {
config: IFormattedInstanceConfiguration;
};
type OIDCConfigFormValues = Record<TInstanceOIDCAuthenticationConfigurationKeys, string>;
export const InstanceOIDCConfigForm: FC<Props> = (props) => {
const { config } = props;
// states
const [isDiscardChangesModalOpen, setIsDiscardChangesModalOpen] = useState(false);
// store hooks
const { updateInstanceConfigurations } = useInstance();
// form data
const {
handleSubmit,
control,
reset,
formState: { errors, isDirty, isSubmitting },
} = useForm<OIDCConfigFormValues>({
defaultValues: {
OIDC_CLIENT_ID: config["OIDC_CLIENT_ID"],
OIDC_CLIENT_SECRET: config["OIDC_CLIENT_SECRET"],
OIDC_TOKEN_URL: config["OIDC_TOKEN_URL"],
OIDC_USERINFO_URL: config["OIDC_USERINFO_URL"],
OIDC_AUTHORIZE_URL: config["OIDC_AUTHORIZE_URL"],
OIDC_LOGOUT_URL: config["OIDC_LOGOUT_URL"],
OIDC_PROVIDER_NAME: config["OIDC_PROVIDER_NAME"],
},
});
const originURL = typeof window !== "undefined" ? window.location.origin : "";
const OIDC_FORM_FIELDS: TControllerInputFormField[] = [
{
key: "OIDC_CLIENT_ID",
type: "text",
label: "Client ID",
description: "A unique ID for this Plane app that you register on your IdP",
placeholder: "abc123xyz789",
error: Boolean(errors.OIDC_CLIENT_ID),
required: true,
},
{
key: "OIDC_CLIENT_SECRET",
type: "password",
label: "Client secret",
description: "The secret key that authenticates this Plane app to your IdP",
placeholder: "s3cr3tK3y123!",
error: Boolean(errors.OIDC_CLIENT_SECRET),
required: true,
},
{
key: "OIDC_AUTHORIZE_URL",
type: "text",
label: "Authorize URL",
description: (
<>
The URL that brings up your IdP{"'"}s authentication screen when your users click the{" "}
<CodeBlock>{"Continue with"}</CodeBlock>
</>
),
placeholder: "https://example.com/",
error: Boolean(errors.OIDC_AUTHORIZE_URL),
required: true,
},
{
key: "OIDC_TOKEN_URL",
type: "text",
label: "Token URL",
description: "The URL that talks to the IdP and persists user authentication on Plane",
placeholder: "https://example.com/oauth/token",
error: Boolean(errors.OIDC_TOKEN_URL),
required: true,
},
{
key: "OIDC_USERINFO_URL",
type: "text",
label: "Users' info URL",
description: "The URL that fetches your users' info from your IdP",
placeholder: "https://example.com/userinfo",
error: Boolean(errors.OIDC_USERINFO_URL),
required: true,
},
{
key: "OIDC_LOGOUT_URL",
type: "text",
label: "Logout URL",
description: "Optional field that controls where your users go after they log out of Plane",
placeholder: "https://example.com/logout",
error: Boolean(errors.OIDC_LOGOUT_URL),
required: false,
},
{
key: "OIDC_PROVIDER_NAME",
type: "text",
label: "IdP's name",
description: (
<>
Optional field for the name that your users see on the <CodeBlock>Continue with</CodeBlock> button
</>
),
placeholder: "Okta",
error: Boolean(errors.OIDC_PROVIDER_NAME),
required: false,
},
];
const OIDC_SERVICE_DETAILS: TCopyField[] = [
{
key: "Origin_URI",
label: "Origin URI",
url: `${originURL}/auth/oidc/`,
description:
"We will generate this for this Plane app. Add this as a trusted origin on your IdP's corresponding field.",
},
{
key: "Callback_URI",
label: "Callback URI",
url: `${originURL}/auth/oidc/callback/`,
description: (
<>
We will generate this for you.Add this in the <CodeBlock darkerShade>Sign-in redirect URI</CodeBlock> field of
your IdP.
</>
),
},
{
key: "Logout_URI",
label: "Logout URI",
url: `${originURL}/auth/oidc/logout/`,
description: (
<>
We will generate this for you. Add this in the <CodeBlock darkerShade>Logout redirect URI</CodeBlock> field of
your IdP.
</>
),
},
];
const onSubmit = async (formData: OIDCConfigFormValues) => {
const payload: Partial<OIDCConfigFormValues> = { ...formData };
await updateInstanceConfigurations(payload)
.then((response = []) => {
setToast({
type: TOAST_TYPE.SUCCESS,
title: "Done!",
message: "Your OIDC-based authentication is configured. You should test it now.",
});
reset({
OIDC_CLIENT_ID: response.find((item) => item.key === "OIDC_CLIENT_ID")?.value,
OIDC_CLIENT_SECRET: response.find((item) => item.key === "OIDC_CLIENT_SECRET")?.value,
OIDC_AUTHORIZE_URL: response.find((item) => item.key === "OIDC_AUTHORIZE_URL")?.value,
OIDC_TOKEN_URL: response.find((item) => item.key === "OIDC_TOKEN_URL")?.value,
OIDC_USERINFO_URL: response.find((item) => item.key === "OIDC_USERINFO_URL")?.value,
OIDC_LOGOUT_URL: response.find((item) => item.key === "OIDC_LOGOUT_URL")?.value,
OIDC_PROVIDER_NAME: response.find((item) => item.key === "OIDC_PROVIDER_NAME")?.value,
});
})
.catch((err) => console.error(err));
};
const handleGoBack = (e: React.MouseEvent<HTMLAnchorElement, MouseEvent>) => {
if (isDirty) {
e.preventDefault();
setIsDiscardChangesModalOpen(true);
}
};
return (
<>
<ConfirmDiscardModal
isOpen={isDiscardChangesModalOpen}
onDiscardHref="/authentication"
handleClose={() => setIsDiscardChangesModalOpen(false)}
/>
<div className="flex flex-col gap-8">
<div className="grid grid-cols-2 gap-x-12 gap-y-8 w-full">
<div className="flex flex-col gap-y-4 col-span-2 md:col-span-1 pt-1">
<div className="pt-2.5 text-xl font-medium">IdP-provided details for Plane</div>
{OIDC_FORM_FIELDS.map((field) => (
<ControllerInput
key={field.key}
control={control}
type={field.type}
name={field.key}
label={field.label}
description={field.description}
placeholder={field.placeholder}
error={field.error}
required={field.required}
/>
))}
<div className="flex flex-col gap-1 pt-4">
<div className="flex items-center gap-4">
<Button variant="primary" onClick={handleSubmit(onSubmit)} loading={isSubmitting} disabled={!isDirty}>
{isSubmitting ? "Saving..." : "Save changes"}
</Button>
<Link
href="/authentication"
className={cn(getButtonStyling("neutral-primary", "md"), "font-medium")}
onClick={handleGoBack}
>
Go back
</Link>
</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 your IdP</div>
{OIDC_SERVICE_DETAILS.map((field) => (
<CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
))}
</div>
</div>
</div>
</div>
</>
);
};
@@ -0,0 +1,123 @@
"use client";
import { useState } from "react";
import { observer } from "mobx-react";
import Image from "next/image";
import useSWR from "swr";
// ui
import { setPromiseToast } from "@plane/propel/toast";
import { Loader, ToggleSwitch } from "@plane/ui";
// components
import { AuthenticationMethodCard } from "@/components/authentication/authentication-method-card";
import { PageHeader } from "@/components/common/page-header";
// hooks
import { useInstance } from "@/hooks/store";
// icons
import OIDCLogo from "/public/logos/oidc-logo.svg";
// plane admin hooks
import { useInstanceFlag } from "@/plane-admin/hooks/store/use-instance-flag";
// local components
import { InstanceOIDCConfigForm } from "./form";
const InstanceOIDCAuthenticationPage = observer(() => {
// state
const [isSubmitting, setIsSubmitting] = useState<boolean>(false);
// store
const { fetchInstanceConfigurations, formattedConfig, updateInstanceConfigurations } = useInstance();
// plane admin store
const isOIDCEnabled = useInstanceFlag("OIDC_SAML_AUTH");
// config
const enableOIDCConfig = formattedConfig?.IS_OIDC_ENABLED ?? "";
useSWR("INSTANCE_CONFIGURATIONS", () => fetchInstanceConfigurations());
const updateConfig = async (key: "IS_OIDC_ENABLED", value: string) => {
setIsSubmitting(true);
const payload = {
[key]: value,
};
const updateConfigPromise = updateInstanceConfigurations(payload);
setPromiseToast(updateConfigPromise, {
loading: "Saving Configuration...",
success: {
title: "Configuration saved",
message: () => `OIDC authentication is now ${value ? "active" : "disabled"}.`,
},
error: {
title: "Error",
message: () => "Failed to save configuration",
},
});
await updateConfigPromise
.then(() => {
setIsSubmitting(false);
})
.catch((err) => {
console.error(err);
setIsSubmitting(false);
});
};
if (isOIDCEnabled === false) {
return (
<div className="relative container mx-auto w-full h-full p-4 py-4 my-6 space-y-6 flex flex-col">
<PageHeader title="Authentication - God Mode" />
<div className="text-center text-lg text-gray-500">
<p>OpenID Connect (OIDC) authentication is not enabled for this instance.</p>
<p>Activate any of your workspace to get this feature.</p>
</div>
</div>
);
}
return (
<>
<PageHeader title="Authentication - God Mode" />
<div className="relative container mx-auto w-full h-full p-4 py-4 space-y-6 flex flex-col">
<div className="border-b border-custom-border-100 mx-4 py-4 space-y-1 flex-shrink-0">
<AuthenticationMethodCard
name="OIDC"
description="Authenticate your users via the OpenID connect protocol."
icon={<Image src={OIDCLogo} height={24} width={24} alt="OIDC Logo" />}
config={
<ToggleSwitch
value={Boolean(parseInt(enableOIDCConfig))}
onChange={() => {
if (Boolean(parseInt(enableOIDCConfig)) === true) {
updateConfig("IS_OIDC_ENABLED", "0");
} else {
updateConfig("IS_OIDC_ENABLED", "1");
}
}}
size="sm"
disabled={isSubmitting || !formattedConfig}
/>
}
disabled={isSubmitting || !formattedConfig}
withBorder={false}
/>
</div>
<div className="flex-grow overflow-hidden overflow-y-scroll vertical-scrollbar scrollbar-md px-4">
{formattedConfig ? (
<InstanceOIDCConfigForm config={formattedConfig} />
) : (
<Loader className="space-y-8">
<Loader.Item height="50px" width="25%" />
<Loader.Item height="50px" />
<Loader.Item height="50px" />
<Loader.Item height="50px" />
<Loader.Item height="50px" />
<Loader.Item height="50px" width="50%" />
</Loader>
)}
</div>
</div>
</>
);
});
export default InstanceOIDCAuthenticationPage;
@@ -0,0 +1,239 @@
import type { FC } from "react";
import { useState } from "react";
import Link from "next/link";
import { Controller, useForm } from "react-hook-form";
// plane internal packages
import { Button, getButtonStyling } from "@plane/propel/button";
import { TOAST_TYPE, setToast } from "@plane/propel/toast";
import type { IFormattedInstanceConfiguration, TInstanceSAMLAuthenticationConfigurationKeys } from "@plane/types";
import { TextArea } from "@plane/ui";
import { cn } from "@plane/utils";
// components
import { CodeBlock } from "@/components/common/code-block";
import { ConfirmDiscardModal } from "@/components/common/confirm-discard-modal";
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";
import { SAMLAttributeMappingTable } from "@/plane-admin/components/authentication";
type Props = {
config: IFormattedInstanceConfiguration;
};
type SAMLConfigFormValues = Record<TInstanceSAMLAuthenticationConfigurationKeys, string>;
export const InstanceSAMLConfigForm: FC<Props> = (props) => {
const { config } = props;
// states
const [isDiscardChangesModalOpen, setIsDiscardChangesModalOpen] = useState(false);
// store hooks
const { updateInstanceConfigurations } = useInstance();
// form data
const {
handleSubmit,
control,
reset,
formState: { errors, isDirty, isSubmitting },
} = useForm<SAMLConfigFormValues>({
defaultValues: {
SAML_ENTITY_ID: config["SAML_ENTITY_ID"],
SAML_SSO_URL: config["SAML_SSO_URL"],
SAML_LOGOUT_URL: config["SAML_LOGOUT_URL"],
SAML_CERTIFICATE: config["SAML_CERTIFICATE"],
SAML_PROVIDER_NAME: config["SAML_PROVIDER_NAME"],
},
});
const originURL = typeof window !== "undefined" ? window.location.origin : "";
const SAML_FORM_FIELDS: TControllerInputFormField[] = [
{
key: "SAML_ENTITY_ID",
type: "text",
label: "Entity ID",
description: "A unique ID for this Plane app that you register on your IdP",
placeholder: "70a44354520df8bd9bcd",
error: Boolean(errors.SAML_ENTITY_ID),
required: true,
},
{
key: "SAML_SSO_URL",
type: "text",
label: "SSO URL",
description: (
<>
The URL that brings up your IdP{"'"}s authentication screen when your users click the{" "}
<CodeBlock>{"Continue with"}</CodeBlock> button
</>
),
placeholder: "https://example.com/sso",
error: Boolean(errors.SAML_SSO_URL),
required: true,
},
{
key: "SAML_LOGOUT_URL",
type: "text",
label: "Logout URL",
description: "Optional field that tells your IdP your users have logged out of this Plane app",
placeholder: "https://example.com/logout",
error: Boolean(errors.SAML_LOGOUT_URL),
required: false,
},
{
key: "SAML_PROVIDER_NAME",
type: "text",
label: "IdP's name",
description: (
<>
Optional field for the name that your users see on the <CodeBlock>Continue with</CodeBlock> button
</>
),
placeholder: "Okta",
error: Boolean(errors.SAML_PROVIDER_NAME),
required: false,
},
];
const SAML_SERVICE_DETAILS: TCopyField[] = [
{
key: "Metadata_Information",
label: "Entity ID | Audience | Metadata information",
url: `${originURL}/auth/saml/metadata/`,
description:
"We will generate this bit of the metadata that identifies this Plane app as an authorized service on your IdP.",
},
{
key: "Callback_URI",
label: "Callback URI",
url: `${originURL}/auth/saml/callback/`,
description: (
<>
We will generate this <CodeBlock darkerShade>http-post request</CodeBlock> URL that you should paste into your{" "}
<CodeBlock darkerShade>ACS URL</CodeBlock> or <CodeBlock darkerShade>Sign-in call back URL</CodeBlock> field
on your IdP.
</>
),
},
{
key: "Logout_URI",
label: "Logout URI",
url: `${originURL}/auth/saml/logout/`,
description: (
<>
We will generate this <CodeBlock darkerShade>http-redirect request</CodeBlock> URL that you should paste into
your <CodeBlock darkerShade>SLS URL</CodeBlock> or <CodeBlock darkerShade>Logout URL</CodeBlock>
field on your IdP.
</>
),
},
];
const onSubmit = async (formData: SAMLConfigFormValues) => {
const payload: Partial<SAMLConfigFormValues> = { ...formData };
await updateInstanceConfigurations(payload)
.then((response = []) => {
setToast({
type: TOAST_TYPE.SUCCESS,
title: "Done!",
message: "Your SAML-based authentication is configured. You should test it now.",
});
reset({
SAML_ENTITY_ID: response.find((item) => item.key === "SAML_ENTITY_ID")?.value,
SAML_SSO_URL: response.find((item) => item.key === "SAML_SSO_URL")?.value,
SAML_LOGOUT_URL: response.find((item) => item.key === "SAML_LOGOUT_URL")?.value,
SAML_CERTIFICATE: response.find((item) => item.key === "SAML_CERTIFICATE")?.value,
SAML_PROVIDER_NAME: response.find((item) => item.key === "SAML_PROVIDER_NAME")?.value,
});
})
.catch((err) => console.error(err));
};
const handleGoBack = (e: React.MouseEvent<HTMLAnchorElement, MouseEvent>) => {
if (isDirty) {
e.preventDefault();
setIsDiscardChangesModalOpen(true);
}
};
return (
<>
<ConfirmDiscardModal
isOpen={isDiscardChangesModalOpen}
onDiscardHref="/authentication"
handleClose={() => setIsDiscardChangesModalOpen(false)}
/>
<div className="flex flex-col gap-8">
<div className="grid grid-cols-2 gap-x-12 gap-y-8 w-full">
<div className="flex flex-col gap-y-4 col-span-2 md:col-span-1 pt-1">
<div className="pt-2.5 text-xl font-medium">IdP-provided details for Plane</div>
{SAML_FORM_FIELDS.map((field) => (
<ControllerInput
key={field.key}
control={control}
type={field.type}
name={field.key}
label={field.label}
description={field.description}
placeholder={field.placeholder}
error={field.error}
required={field.required}
/>
))}
<div className="flex flex-col gap-1">
<h4 className="text-sm">SAML certificate</h4>
<Controller
control={control}
name="SAML_CERTIFICATE"
rules={{ required: "Certificate is required." }}
render={({ field: { value, onChange } }) => (
<TextArea
id="SAML_CERTIFICATE"
name="SAML_CERTIFICATE"
value={value}
onChange={onChange}
hasError={Boolean(errors.SAML_CERTIFICATE)}
placeholder="---BEGIN CERTIFICATE---\n2yWn1gc7DhOFB9\nr0gbE+\n---END CERTIFICATE---"
className="min-h-[102px] w-full rounded-md font-medium text-sm"
/>
)}
/>
<p className="pt-0.5 text-xs text-custom-text-300">
IdP-generated certificate for signing this Plane app as an authorized service provider for your IdP
</p>
</div>
<div className="flex flex-col gap-1 pt-4">
<div className="flex items-center gap-4">
<Button variant="primary" onClick={handleSubmit(onSubmit)} loading={isSubmitting} disabled={!isDirty}>
{isSubmitting ? "Saving..." : "Save changes"}
</Button>
<Link
href="/authentication"
className={cn(getButtonStyling("neutral-primary", "md"), "font-medium")}
onClick={handleGoBack}
>
Go back
</Link>
</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 your IdP</div>
{SAML_SERVICE_DETAILS.map((field) => (
<CopyField key={field.key} label={field.label} url={field.url} description={field.description} />
))}
<div className="flex flex-col gap-1">
<h4 className="text-sm text-custom-text-200 font-medium">Mapping</h4>
<SAMLAttributeMappingTable />
</div>
</div>
</div>
</div>
</div>
</>
);
};
@@ -0,0 +1,123 @@
"use client";
import { useState } from "react";
import { observer } from "mobx-react";
import Image from "next/image";
import useSWR from "swr";
// ui
import { setPromiseToast } from "@plane/propel/toast";
import { Loader, ToggleSwitch } from "@plane/ui";
// components
import { AuthenticationMethodCard } from "@/components/authentication/authentication-method-card";
import { PageHeader } from "@/components/common/page-header";
// hooks
import { useInstance } from "@/hooks/store";
// icons
import SAMLLogo from "/public/logos/saml-logo.svg";
// plane admin hooks
import { useInstanceFlag } from "@/plane-admin/hooks/store/use-instance-flag";
// local components
import { InstanceSAMLConfigForm } from "./form";
const InstanceSAMLAuthenticationPage = observer(() => {
// state
const [isSubmitting, setIsSubmitting] = useState<boolean>(false);
// store
const { fetchInstanceConfigurations, formattedConfig, updateInstanceConfigurations } = useInstance();
// plane admin store
const isSAMLEnabled = useInstanceFlag("OIDC_SAML_AUTH");
// config
const enableSAMLConfig = formattedConfig?.IS_SAML_ENABLED ?? "";
useSWR("INSTANCE_CONFIGURATIONS", () => fetchInstanceConfigurations());
const updateConfig = async (key: "IS_SAML_ENABLED", value: string) => {
setIsSubmitting(true);
const payload = {
[key]: value,
};
const updateConfigPromise = updateInstanceConfigurations(payload);
setPromiseToast(updateConfigPromise, {
loading: "Saving Configuration...",
success: {
title: "Configuration saved",
message: () => `SAML authentication is now ${value ? "active" : "disabled"}.`,
},
error: {
title: "Error",
message: () => "Failed to save configuration",
},
});
await updateConfigPromise
.then(() => {
setIsSubmitting(false);
})
.catch((err) => {
console.error(err);
setIsSubmitting(false);
});
};
if (isSAMLEnabled === false) {
return (
<div className="relative container mx-auto w-full h-full p-4 py-4 my-6 space-y-6 flex flex-col">
<PageHeader title="Authentication - God Mode" />
<div className="text-center text-lg text-gray-500">
<p>Security Assertion Markup Language (SAML) authentication is not enabled for this instance.</p>
<p>Activate any of your workspace to get this feature.</p>
</div>
</div>
);
}
return (
<>
<PageHeader title="Authentication - God Mode" />
<div className="relative container mx-auto w-full h-full p-4 py-4 space-y-6 flex flex-col">
<div className="border-b border-custom-border-100 mx-4 py-4 space-y-1 flex-shrink-0">
<AuthenticationMethodCard
name="SAML"
description="Authenticate your users via Security Assertion Markup Language
protocol."
icon={<Image src={SAMLLogo} height={24} width={24} alt="SAML Logo" className="pl-0.5" />}
config={
<ToggleSwitch
value={Boolean(parseInt(enableSAMLConfig))}
onChange={() => {
if (Boolean(parseInt(enableSAMLConfig)) === true) {
updateConfig("IS_SAML_ENABLED", "0");
} else {
updateConfig("IS_SAML_ENABLED", "1");
}
}}
size="sm"
disabled={isSubmitting || !formattedConfig}
/>
}
disabled={isSubmitting || !formattedConfig}
withBorder={false}
/>
</div>
<div className="flex-grow overflow-hidden overflow-y-scroll vertical-scrollbar scrollbar-md px-4">
{formattedConfig ? (
<InstanceSAMLConfigForm config={formattedConfig} />
) : (
<Loader className="space-y-8">
<Loader.Item height="50px" width="25%" />
<Loader.Item height="50px" />
<Loader.Item height="50px" />
<Loader.Item height="50px" />
<Loader.Item height="50px" width="50%" />
</Loader>
)}
</div>
</div>
</>
);
});
export default InstanceSAMLAuthenticationPage;
+1 -1
View File
@@ -69,7 +69,7 @@ export const AdminHeader: FC = observer(() => {
return breadcrumbItems;
};
const breadcrumbItems = generateBreadcrumbItems(pathName);
const breadcrumbItems = generateBreadcrumbItems(pathName || "");
return (
<div className="relative z-10 flex h-header w-full flex-shrink-0 flex-row items-center justify-between gap-x-2 gap-y-4 border-b border-custom-sidebar-border-200 bg-custom-sidebar-background-100 p-4">
+12 -1
View File
@@ -4,11 +4,14 @@ import type { FC, ReactNode } from "react";
import { useEffect } from "react";
import { observer } from "mobx-react";
import { useRouter } from "next/navigation";
import useSWR from "swr";
// components
import { LogoSpinner } from "@/components/common/logo-spinner";
import { NewUserPopup } from "@/components/new-user-popup";
// hooks
import { useUser } from "@/hooks/store";
// plane admin hooks
import { useInstanceFeatureFlags } from "@/plane-admin/hooks/store/use-instance-feature-flag";
// local components
import { AdminHeader } from "./header";
import { AdminSidebar } from "./sidebar";
@@ -23,6 +26,14 @@ const AdminLayout: FC<TAdminLayout> = (props) => {
const router = useRouter();
// store hooks
const { isUserLoggedIn } = useUser();
// plane admin hooks
const { fetchInstanceFeatureFlags } = useInstanceFeatureFlags();
// fetching instance feature flags
const { isLoading: flagsLoader, error: flagsError } = useSWR(
`INSTANCE_FEATURE_FLAGS`,
() => fetchInstanceFeatureFlags(),
{ revalidateOnFocus: false, revalidateIfStale: false, errorRetryCount: 1 }
);
useEffect(() => {
if (isUserLoggedIn === false) {
@@ -30,7 +41,7 @@ const AdminLayout: FC<TAdminLayout> = (props) => {
}
}, [router, isUserLoggedIn]);
if (isUserLoggedIn === undefined) {
if ((flagsLoader && !flagsError) || isUserLoggedIn === undefined) {
return (
<div className="relative flex h-screen w-full items-center justify-center">
<LogoSpinner />
@@ -12,7 +12,7 @@ import { DiscordIcon, GithubIcon, PageIcon } from "@plane/propel/icons";
import { Tooltip } from "@plane/propel/tooltip";
import { cn } from "@plane/utils";
// hooks
import { useTheme } from "@/hooks/store";
import { useInstance, useTheme } from "@/hooks/store";
// assets
// eslint-disable-next-line import/order
import packageJson from "package.json";
@@ -39,6 +39,7 @@ export const AdminSidebarHelpSection: FC = observer(() => {
// states
const [isNeedHelpOpen, setIsNeedHelpOpen] = useState(false);
// store
const { instance } = useInstance();
const { isSidebarCollapsed, toggleSidebar } = useTheme();
// refs
const helpOptionsRef = useRef<HTMLDivElement | null>(null);
@@ -131,8 +132,20 @@ export const AdminSidebarHelpSection: FC = observer(() => {
</button>
);
})}
{/* {instance?.latest_version && instance?.current_version != instance?.latest_version && (
<a
href="https://docs.plane.so/docs/changelog"
target="_blank"
className="flex items-center gap-2 px-2 py-1 text-xs font-medium cursor-pointer transition-all border rounded border-custom-primary-100/30 bg-custom-primary-100/20 hover:bg-custom-primary-100/30 text-custom-text-100"
referrerPolicy="no-referrer"
>
<RefreshCcw className="flex-shrink-0 h-3 w-3 text-custom-text-100" />
<div>Updates available</div>
<div className="flex-shrink-0 ml-auto animate-pulse bg-custom-primary-100 !w-2 !h-2 rounded-full" />
</a>
)} */}
</div>
<div className="px-2 pb-1 pt-2 text-[10px]">Version: v{packageJson.version}</div>
<div className="px-2 pb-1 pt-2 text-[10px]">Version: v{instance?.current_version}</div>
</div>
</Transition>
</div>
@@ -65,7 +65,7 @@ export const AdminSidebarMenu = observer(() => {
return (
<div className="flex h-full w-full flex-col gap-2.5 overflow-y-scroll vertical-scrollbar scrollbar-sm px-4 py-4">
{INSTANCE_ADMIN_LINKS.map((item, index) => {
const isActive = item.href === pathName || pathName.includes(item.href);
const isActive = item.href === pathName || pathName?.includes(item.href);
return (
<Link key={index} href={item.href} onClick={handleItemClick}>
<div>
@@ -58,13 +58,13 @@ export const InstanceSetupForm: FC = (props) => {
const {} = props;
// search params
const searchParams = useSearchParams();
const firstNameParam = searchParams.get("first_name") || undefined;
const lastNameParam = searchParams.get("last_name") || undefined;
const companyParam = searchParams.get("company") || undefined;
const emailParam = searchParams.get("email") || undefined;
const isTelemetryEnabledParam = (searchParams.get("is_telemetry_enabled") === "True" ? true : false) || true;
const errorCode = searchParams.get("error_code") || undefined;
const errorMessage = searchParams.get("error_message") || undefined;
const firstNameParam = searchParams?.get("first_name") || undefined;
const lastNameParam = searchParams?.get("last_name") || undefined;
const companyParam = searchParams?.get("company") || undefined;
const emailParam = searchParams?.get("email") || undefined;
const isTelemetryEnabledParam = (searchParams?.get("is_telemetry_enabled") === "True" ? true : false) || true;
const errorCode = searchParams?.get("error_code") || undefined;
const errorMessage = searchParams?.get("error_message") || undefined;
// state
const [showPassword, setShowPassword] = useState({
password: false,
@@ -1 +1,135 @@
export * from "ce/components/authentication/authentication-modes";
import { observer } from "mobx-react";
import Image from "next/image";
import { useTheme } from "next-themes";
import { Mails, KeyRound } from "lucide-react";
import type {
TInstanceAuthenticationMethodKeys as TBaseAuthenticationMethods,
TInstanceAuthenticationModes,
TInstanceEnterpriseAuthenticationMethodKeys,
} from "@plane/types";
import { resolveGeneralTheme } from "@plane/utils";
// plane ce components
import { getAuthenticationModes as getCEAuthenticationModes } from "@/ce/components/authentication/authentication-modes";
// components
import { AuthenticationMethodCard } from "@/components/authentication/authentication-method-card";
import { EmailCodesConfiguration } from "@/components/authentication/email-config-switch";
import { GithubConfiguration } from "@/components/authentication/github-config";
import { GitlabConfiguration } from "@/components/authentication/gitlab-config";
import { GoogleConfiguration } from "@/components/authentication/google-config";
import { PasswordLoginConfiguration } from "@/components/authentication/password-config-switch";
// plane admin components
import { OIDCConfiguration, SAMLConfiguration } from "@/plane-admin/components/authentication";
// images
import { useInstanceFlag } from "@/plane-admin/hooks/store/use-instance-flag";
import githubLightModeImage from "@/public/logos/github-black.png";
import githubDarkModeImage from "@/public/logos/github-white.png";
import GitlabLogo from "@/public/logos/gitlab-logo.svg";
import GoogleLogo from "@/public/logos/google-logo.svg";
import OIDCLogo from "@/public/logos/oidc-logo.svg";
import SAMLLogo from "@/public/logos/saml-logo.svg";
type TInstanceAuthenticationMethodKeys = TBaseAuthenticationMethods | TInstanceEnterpriseAuthenticationMethodKeys;
export type TAuthenticationModeProps = {
disabled: boolean;
updateConfig: (key: TInstanceAuthenticationMethodKeys, value: string) => void;
};
export type TGetAuthenticationModeProps = {
disabled: boolean;
updateConfig: (key: TInstanceAuthenticationMethodKeys, value: string) => void;
resolvedTheme: string | undefined;
};
// Enterprise authentication methods
export const getAuthenticationModes: (props: TGetAuthenticationModeProps) => TInstanceAuthenticationModes[] = ({
disabled,
updateConfig,
resolvedTheme,
}) => [
{
key: "unique-codes",
name: "Unique codes",
description:
"Log in or sign up for Plane using codes sent via email. You need to have set up SMTP to use this method.",
icon: <Mails className="h-6 w-6 p-0.5 text-custom-text-300/80" />,
config: <EmailCodesConfiguration disabled={disabled} updateConfig={updateConfig} />,
},
{
key: "passwords-login",
name: "Passwords",
description: "Allow members to create accounts with passwords and use it with their email addresses to sign in.",
icon: <KeyRound className="h-6 w-6 p-0.5 text-custom-text-300/80" />,
config: <PasswordLoginConfiguration disabled={disabled} updateConfig={updateConfig} />,
},
{
key: "google",
name: "Google",
description: "Allow members to log in or sign up for Plane with their Google accounts.",
icon: <Image src={GoogleLogo} height={20} width={20} alt="Google Logo" />,
config: <GoogleConfiguration disabled={disabled} updateConfig={updateConfig} />,
},
{
key: "github",
name: "GitHub",
description: "Allow members to log in or sign up for Plane with their GitHub accounts.",
icon: (
<Image
src={resolveGeneralTheme(resolvedTheme) === "dark" ? githubDarkModeImage : githubLightModeImage}
height={20}
width={20}
alt="GitHub Logo"
/>
),
config: <GithubConfiguration disabled={disabled} updateConfig={updateConfig} />,
},
{
key: "gitlab",
name: "GitLab",
description: "Allow members to log in or sign up to plane with their GitLab accounts.",
icon: <Image src={GitlabLogo} height={20} width={20} alt="GitLab Logo" />,
config: <GitlabConfiguration disabled={disabled} updateConfig={updateConfig} />,
},
{
key: "oidc",
name: "OIDC",
description: "Authenticate your users via the OpenID Connect protocol.",
icon: <Image src={OIDCLogo} height={22} width={22} alt="OIDC Logo" />,
config: <OIDCConfiguration disabled={disabled} updateConfig={updateConfig} />,
},
{
key: "saml",
name: "SAML",
description: "Authenticate your users via the Security Assertion Markup Language protocol.",
icon: <Image src={SAMLLogo} height={22} width={22} alt="SAML Logo" className="pl-0.5" />,
config: <SAMLConfiguration disabled={disabled} updateConfig={updateConfig} />,
},
];
export const AuthenticationModes: React.FC<TAuthenticationModeProps> = observer((props) => {
const { disabled, updateConfig } = props;
// next-themes
const { resolvedTheme } = useTheme();
// plane admin hooks
const isOIDCSAMLEnabled = useInstanceFlag("OIDC_SAML_AUTH");
const authenticationModes = isOIDCSAMLEnabled
? getAuthenticationModes({ disabled, updateConfig, resolvedTheme })
: getCEAuthenticationModes({ disabled, updateConfig, resolvedTheme });
return (
<>
{authenticationModes.map((method) => (
<AuthenticationMethodCard
key={method.key}
name={method.name}
description={method.description}
icon={method.icon}
config={method.config}
disabled={disabled}
unavailable={method.unavailable}
/>
))}
</>
);
});
@@ -1 +1,4 @@
export * from "./authentication-modes";
export * from "./oidc-config";
export * from "./saml-config";
export * from "./saml-attribute-mapping-table";
@@ -0,0 +1,58 @@
"use client";
import React from "react";
import { observer } from "mobx-react";
import Link from "next/link";
// icons
import { Settings2 } from "lucide-react";
// plane internal packages
import { getButtonStyling } from "@plane/propel/button";
import type { TInstanceEnterpriseAuthenticationMethodKeys } from "@plane/types";
import { ToggleSwitch } from "@plane/ui";
import { cn } from "@plane/utils";
// hooks
import { useInstance } from "@/hooks/store";
type Props = {
disabled: boolean;
updateConfig: (key: TInstanceEnterpriseAuthenticationMethodKeys, value: string) => void;
};
export const OIDCConfiguration: React.FC<Props> = observer((props) => {
const { disabled, updateConfig } = props;
// store
const { formattedConfig } = useInstance();
// derived values
const enableOIDCConfig = formattedConfig?.IS_OIDC_ENABLED ?? "";
const isOIDCConfigured = !!formattedConfig?.OIDC_CLIENT_ID && !!formattedConfig?.OIDC_CLIENT_SECRET;
return (
<>
{isOIDCConfigured ? (
<div className="flex items-center gap-4">
<Link href="/authentication/oidc" className={cn(getButtonStyling("link-primary", "md"), "font-medium")}>
Edit
</Link>
<ToggleSwitch
value={Boolean(parseInt(enableOIDCConfig))}
onChange={() => {
Boolean(parseInt(enableOIDCConfig)) === true
? updateConfig("IS_OIDC_ENABLED", "0")
: updateConfig("IS_OIDC_ENABLED", "1");
}}
size="sm"
disabled={disabled}
/>
</div>
) : (
<Link
href="/authentication/oidc"
className={cn(getButtonStyling("neutral-primary", "sm"), "text-custom-text-300")}
>
<Settings2 className="h-4 w-4 p-0.5 text-custom-text-300/80" />
Configure
</Link>
)}
</>
);
});
@@ -0,0 +1,28 @@
export const SAMLAttributeMappingTable = () => (
<table className="table-auto border-collapse text-custom-text-200 text-sm">
<thead>
<tr className="text-left">
<th className="border-b border-r border-custom-border-300 px-4 py-1.5">IdP</th>
<th className="border-b border-custom-border-300 px-4 py-1.5">Plane</th>
</tr>
</thead>
<tbody>
<tr>
<td className="border-t border-r border-custom-border-300 px-4 py-1.5">Name ID format</td>
<td className="border-t border-custom-border-300 px-4 py-1.5">emailAddress</td>
</tr>
<tr>
<td className="border-t border-r border-custom-border-300 px-4 py-1.5">first_name</td>
<td className="border-t border-custom-border-300 px-4 py-1.5">user.firstName</td>
</tr>
<tr>
<td className="border-t border-r border-custom-border-300 px-4 py-1.5">last_name</td>
<td className="border-t border-custom-border-300 px-4 py-1.5">user.lastName</td>
</tr>
<tr>
<td className="border-t border-r border-custom-border-300 px-4 py-1.5">email</td>
<td className="border-t border-custom-border-300 px-4 py-1.5">user.email</td>
</tr>
</tbody>
</table>
);
@@ -0,0 +1,58 @@
"use client";
import React from "react";
import { observer } from "mobx-react";
import Link from "next/link";
// icons
import { Settings2 } from "lucide-react";
// plane internal packages
import { getButtonStyling } from "@plane/propel/button";
import type { TInstanceEnterpriseAuthenticationMethodKeys } from "@plane/types";
import { ToggleSwitch } from "@plane/ui";
import { cn } from "@plane/utils";
// hooks
import { useInstance } from "@/hooks/store";
type Props = {
disabled: boolean;
updateConfig: (key: TInstanceEnterpriseAuthenticationMethodKeys, value: string) => void;
};
export const SAMLConfiguration: React.FC<Props> = observer((props) => {
const { disabled, updateConfig } = props;
// store
const { formattedConfig } = useInstance();
// derived values
const enableSAMLConfig = formattedConfig?.IS_SAML_ENABLED ?? "";
const isSAMLConfigured = !!formattedConfig?.SAML_ENTITY_ID && !!formattedConfig?.SAML_CERTIFICATE;
return (
<>
{isSAMLConfigured ? (
<div className="flex items-center gap-4">
<Link href="/authentication/saml" className={cn(getButtonStyling("link-primary", "md"), "font-medium")}>
Edit
</Link>
<ToggleSwitch
value={Boolean(parseInt(enableSAMLConfig))}
onChange={() => {
Boolean(parseInt(enableSAMLConfig)) === true
? updateConfig("IS_SAML_ENABLED", "0")
: updateConfig("IS_SAML_ENABLED", "1");
}}
size="sm"
disabled={disabled}
/>
</div>
) : (
<Link
href="/authentication/saml"
className={cn(getButtonStyling("neutral-primary", "sm"), "text-custom-text-300")}
>
<Settings2 className="h-4 w-4 p-0.5 text-custom-text-300/80" />
Configure
</Link>
)}
</>
);
});
+1 -1
View File
@@ -1 +1 @@
export * from "ce/components/common";
export * from "./upgrade-button";
@@ -0,0 +1,39 @@
"use client";
import React from "react";
// plane internal packages
import { WEB_BASE_URL } from "@plane/constants";
import { Button } from "@plane/propel/button";
import { AlertModalCore } from "@plane/ui";
export const UpgradeButton: React.FC = () => {
// states
const [isActivationModalOpen, setIsActivationModalOpen] = React.useState(false);
// derived values
const redirectionLink = encodeURI(WEB_BASE_URL + "/");
return (
<>
<AlertModalCore
variant="primary"
isOpen={isActivationModalOpen}
handleClose={() => setIsActivationModalOpen(false)}
handleSubmit={() => {
window.open(redirectionLink, "_blank");
setIsActivationModalOpen(false);
}}
isSubmitting={false}
title="Activate workspace"
content="Activate any of your workspace to get this feature."
primaryButtonText={{
loading: "Redirecting...",
default: "Go to Plane",
}}
secondaryButtonText="Close"
/>
<Button variant="primary" size="sm" onClick={() => setIsActivationModalOpen(true)}>
Activate workspace
</Button>
</>
);
};
@@ -0,0 +1,11 @@
import { useContext } from "react";
// context
import { StoreContext } from "@/app/(all)/store.provider";
// plane admin stores
import type { IInstanceFeatureFlagsStore } from "@/plane-admin/store/instance-feature-flags.store";
export const useInstanceFeatureFlags = (): IInstanceFeatureFlagsStore => {
const context = useContext(StoreContext);
if (context === undefined) throw new Error("useInstanceFeatureFlags must be used within StoreProvider");
return context.instanceFeatureFlags;
};
@@ -0,0 +1,13 @@
import { useContext } from "react";
// context
import { StoreContext } from "@/app/(all)/store.provider";
export enum E_FEATURE_FLAGS {
OIDC_SAML_AUTH = "OIDC_SAML_AUTH",
}
export const useInstanceFlag = (flag: keyof typeof E_FEATURE_FLAGS, defaultValue: boolean = false): boolean => {
const context = useContext(StoreContext);
if (context === undefined) throw new Error("useInstanceFlag must be used within StoreProvider");
return context.instanceFeatureFlags.flags?.[E_FEATURE_FLAGS[flag]] ?? defaultValue;
};
@@ -0,0 +1,48 @@
import { set } from "lodash-es";
import { action, makeObservable, observable, runInAction } from "mobx";
// plane imports
import { InstanceFeatureFlagService } from "@plane/services";
import type { TInstanceFeatureFlagsResponse } from "@plane/types";
const instanceFeatureFlagService = new InstanceFeatureFlagService();
type TFeatureFlagsMaps = Record<string, boolean>; // feature flag -> boolean
export interface IInstanceFeatureFlagsStore {
flags: TFeatureFlagsMaps;
// actions
hydrate: (data: any) => void;
fetchInstanceFeatureFlags: () => Promise<TInstanceFeatureFlagsResponse>;
}
export class InstanceFeatureFlagsStore implements IInstanceFeatureFlagsStore {
flags: TFeatureFlagsMaps = {};
constructor() {
makeObservable(this, {
flags: observable,
fetchInstanceFeatureFlags: action,
});
}
hydrate = (data: any) => {
if (data) this.flags = data;
};
fetchInstanceFeatureFlags = async () => {
try {
const response = await instanceFeatureFlagService.list();
runInAction(() => {
if (response) {
Object.keys(response).forEach((key) => {
set(this.flags, key, response[key]);
});
}
});
return response;
} catch (error) {
console.error("Error fetching instance feature flags", error);
throw error;
}
};
}
+27 -1
View File
@@ -1 +1,27 @@
export * from "ce/store/root.store";
import { enableStaticRendering } from "mobx-react";
// stores
import type { IInstanceFeatureFlagsStore } from "@/plane-admin/store/instance-feature-flags.store";
import { InstanceFeatureFlagsStore } from "@/plane-admin/store/instance-feature-flags.store";
import { CoreRootStore } from "@/store/root.store";
// plane admin store
enableStaticRendering(typeof window === "undefined");
export class RootStore extends CoreRootStore {
instanceFeatureFlags: IInstanceFeatureFlagsStore;
constructor() {
super();
this.instanceFeatureFlags = new InstanceFeatureFlagsStore();
}
hydrate(initialData: any) {
super.hydrate(initialData);
this.instanceFeatureFlags.hydrate(initialData.instanceFeatureFlags);
}
resetOnSignOut() {
super.resetOnSignOut();
this.instanceFeatureFlags = new InstanceFeatureFlagsStore();
}
}
+1 -1
View File
@@ -10,7 +10,7 @@
"preview": "next build && next start",
"start": "next start",
"clean": "rm -rf .turbo && rm -rf .next && rm -rf node_modules && rm -rf dist",
"check:lint": "eslint . --max-warnings 19",
"check:lint": "eslint . --max-warnings 20",
"check:types": "tsc --noEmit",
"check:format": "prettier --check \"**/*.{ts,tsx,md,json,css,scss}\"",
"fix:lint": "eslint . --fix",
+3 -2
View File
@@ -11,8 +11,9 @@
"@/app/*": ["app/*"],
"@/*": ["core/*"],
"@/public/*": ["public/*"],
"@/plane-admin/*": ["ce/*"],
"@/styles/*": ["styles/*"]
"@/plane-admin/*": ["ee/*"],
"@/styles/*": ["styles/*"],
"@/ce/*": ["ce/*"]
},
"strictNullChecks": true
},
+4 -2
View File
@@ -39,8 +39,6 @@ DOCKERIZED=1 # deprecated
# set to 1 If using the pre-configured minio setup
USE_MINIO=0
# Email redirections and minio domain settings
WEB_URL="http://localhost:8000"
@@ -60,7 +58,11 @@ APP_BASE_PATH=""
LIVE_BASE_URL="http://localhost:3100"
LIVE_BASE_PATH="/live"
SILO_BASE_URL="http://localhost:3200"
SILO_BASE_PATH="/silo"
LIVE_SERVER_SECRET_KEY="secret-key"
AES_SECRET_KEY="plane-testing-key"
# Hard delete files after days
HARD_DELETE_AFTER_DAYS=60
+1
View File
@@ -0,0 +1 @@
dump.rdb
+2 -1
View File
@@ -4,7 +4,7 @@ FROM python:3.12.10-alpine
ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1
ENV PIP_DISABLE_PIP_VERSION_CHECK=1
ENV INSTANCE_CHANGELOG_URL=https://sites.plane.so/pages/691ef037bcfe416a902e48cb55f59891/
ENV INSTANCE_CHANGELOG_URL=https://sites.plane.so/pages/f366114e9aba4cbfbe4265b8f2b74f65/
# Update system packages for security
RUN apk update && apk upgrade
@@ -31,6 +31,7 @@ RUN apk add --no-cache --virtual .build-deps \
"postgresql-dev" \
"libc-dev" \
"linux-headers" \
"xmlsec-dev"\
&& \
pip install -r requirements.txt --compile --no-cache-dir \
&& \
+36 -19
View File
@@ -1,18 +1,30 @@
FROM python:3.12.5-alpine AS backend
FROM python:3.12.10-alpine
# set environment variables
ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1
ENV PIP_DISABLE_PIP_VERSION_CHECK=1
ENV INSTANCE_CHANGELOG_URL https://sites.plane.so/pages/691ef037bcfe416a902e48cb55f59891/
ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1
ENV PIP_DISABLE_PIP_VERSION_CHECK=1
RUN apk --no-cache add \
"bash~=5.2" \
ENV INSTANCE_CHANGELOG_URL=https://sites.plane.so/pages/f366114e9aba4cbfbe4265b8f2b74f65
# Update system packages for security
RUN apk update && apk upgrade
WORKDIR /code
RUN apk add --no-cache --upgrade \
"libpq" \
"libxslt" \
"nodejs-current" \
"xmlsec" \
"libffi-dev" \
"ca-certificates" \
"openssl"
COPY requirements.txt ./
COPY requirements ./requirements
RUN apk add --no-cache libffi-dev
RUN apk add --no-cache --virtual .build-deps \
"bash~=5.2" \
"g++" \
"gcc" \
@@ -21,18 +33,23 @@ RUN apk --no-cache add \
"make" \
"postgresql-dev" \
"libc-dev" \
"linux-headers"
"linux-headers" \
"xmlsec-dev"\
&& \
pip install -r requirements/local.txt --compile --no-cache-dir \
&& \
apk del .build-deps \
&& \
rm -rf /var/cache/apk/*
WORKDIR /code
# Add in Django deps and generate Django's static files
COPY manage.py manage.py
COPY plane plane/
COPY templates templates/
COPY package.json package.json
COPY requirements.txt ./requirements.txt
ADD requirements ./requirements
# Install the local development settings
RUN pip install -r requirements/local.txt --compile --no-cache-dir
COPY . .
RUN apk --no-cache add "bash~=5.2"
COPY ./bin ./bin/
RUN mkdir -p /code/plane/logs
RUN chmod -R +x /code/bin
+1
View File
@@ -0,0 +1 @@
# API SERVER
+18
View File
@@ -0,0 +1,18 @@
#!/bin/bash
set -e
export SKIP_ENV_VAR=0
python manage.py wait_for_db
# Wait for migrations
python manage.py wait_for_migrations
# Clear Cache before starting to remove stale values
python manage.py clear_cache
# Register instance if INSTANCE_ADMIN_EMAIL is set
if [ -n "$INSTANCE_ADMIN_EMAIL" ]; then
python manage.py setup_instance $INSTANCE_ADMIN_EMAIL
fi
exec gunicorn -w "$GUNICORN_WORKERS" -k uvicorn.workers.UvicornWorker plane.asgi:application --bind 0.0.0.0:"${PORT:-8000}" --max-requests 1200 --max-requests-jitter 1000 --access-logfile -
+39
View File
@@ -0,0 +1,39 @@
#!/bin/bash
set -e
python manage.py wait_for_db
# Wait for migrations
python manage.py wait_for_migrations
# Create the default bucket
#!/bin/bash
# Collect system information
HOSTNAME=$(hostname)
MAC_ADDRESS=$(ip link show | awk '/ether/ {print $2}' | head -n 1)
CPU_INFO=$(cat /proc/cpuinfo)
MEMORY_INFO=$(free -h)
DISK_INFO=$(df -h)
# Concatenate information and compute SHA-256 hash
SIGNATURE=$(echo "$HOSTNAME$MAC_ADDRESS$CPU_INFO$MEMORY_INFO$DISK_INFO" | sha256sum | awk '{print $1}')
# Export the variables
MACHINE_SIGNATURE=${MACHINE_SIGNATURE:-$SIGNATURE}
export SKIP_ENV_VAR=1
# Register instance
python manage.py register_instance_ee "$MACHINE_SIGNATURE"
# Load the configuration variable
python manage.py configure_instance
# Create the default bucket
python manage.py create_bucket
# Clear Cache before starting to remove stale values
python manage.py clear_cache
# Fetch latest information from monitor and update all licenses
python manage.py update_licenses
exec gunicorn -w "$GUNICORN_WORKERS" -k uvicorn.workers.UvicornWorker plane.asgi:application --bind 0.0.0.0:"${PORT:-8000}" --max-requests 1200 --max-requests-jitter 1000 --access-logfile -
+1 -1
View File
@@ -32,4 +32,4 @@ python manage.py create_bucket
# Clear Cache before starting to remove stale values
python manage.py clear_cache
exec gunicorn -w "$GUNICORN_WORKERS" -k uvicorn.workers.UvicornWorker plane.asgi:application --bind 0.0.0.0:"${PORT:-8000}" --max-requests 1200 --max-requests-jitter 1000 --access-logfile -
exec gunicorn -w "$GUNICORN_WORKERS" -k uvicorn.workers.UvicornWorker plane.asgi:application --bind 0.0.0.0:"${PORT:-8000}" --max-requests 1200 --max-requests-jitter 1000 --access-logfile -
+12
View File
@@ -0,0 +1,12 @@
#!/bin/bash
set -e
python manage.py wait_for_db
# Wait for migrations
python manage.py wait_for_migrations
# Run the processes
python manage.py run_automation_consumer \
--queue ${AUTOMATION_EVENT_STREAM_QUEUE_NAME:-plane.event_stream.automations} \
--prefetch ${AUTOMATION_EVENT_STREAM_PREFETCH:-10}
+15
View File
@@ -0,0 +1,15 @@
#!/bin/bash
set -e
python manage.py wait_for_db
# Wait for migrations
python manage.py wait_for_migrations
# Run the processes
python manage.py outbox_poller \
--memory-limit ${OUTBOX_POLLER_MEMORY_LIMIT_MB:-512} \
--interval-min ${OUTBOX_POLLER_INTERVAL_MIN:-0.25} \
--interval-max ${OUTBOX_POLLER_INTERVAL_MAX:-10} \
--batch-size ${OUTBOX_POLLER_BATCH_SIZE:-250} \
--memory-check-interval ${OUTBOX_POLLER_MEMORY_CHECK_INTERVAL:-30}
@@ -11,6 +11,7 @@ from .issue import (
LabelCreateUpdateSerializer,
LabelSerializer,
IssueLinkSerializer,
IssueDetailSerializer,
IssueCommentSerializer,
IssueAttachmentSerializer,
IssueActivitySerializer,
@@ -21,6 +22,11 @@ from .issue import (
IssueCommentCreateSerializer,
IssueLinkCreateSerializer,
IssueLinkUpdateSerializer,
IssueRelationSerializer,
IssueRelationCreateSerializer,
IssueRelationRemoveSerializer,
IssueRelationResponseSerializer,
RelatedIssueSerializer,
)
from .state import StateLiteSerializer, StateSerializer
from .cycle import (
@@ -46,6 +52,7 @@ from .intake import (
IntakeIssueUpdateSerializer,
)
from .estimate import EstimatePointSerializer
from .issue_type import IssueTypeAPISerializer, ProjectIssueTypeAPISerializer
from .asset import (
UserAssetUploadSerializer,
AssetUpdateSerializer,
+267 -8
View File
@@ -12,6 +12,7 @@ from plane.db.models import (
IssueType,
IssueActivity,
IssueAssignee,
IssueRelation,
FileAsset,
IssueComment,
IssueLabel,
@@ -32,6 +33,7 @@ from .cycle import CycleLiteSerializer, CycleSerializer
from .module import ModuleLiteSerializer, ModuleSerializer
from .state import StateLiteSerializer
from .user import UserLiteSerializer
from .issue_type import IssueTypeAPISerializer
# Django imports
from django.core.exceptions import ValidationError
@@ -65,7 +67,7 @@ class IssueSerializer(BaseSerializer):
class Meta:
model = Issue
read_only_fields = ["id", "workspace", "project", "updated_by", "updated_at"]
exclude = ["description", "description_stripped"]
exclude = ["description"]
def validate(self, data):
if (
@@ -237,7 +239,22 @@ class IssueSerializer(BaseSerializer):
updated_by_id = instance.updated_by_id
if assignees is not None:
IssueAssignee.objects.filter(issue=instance).delete()
# Get the current assignees
current_assignees = IssueAssignee.objects.filter(
issue=instance
).values_list("assignee_id", flat=True)
# Get the assignees to add
assignees_to_add = list(set(assignees) - set(current_assignees))
# Get the assignees to remove
assignees_to_remove = list(set(current_assignees) - set(assignees))
# Delete the assignees to remove
IssueAssignee.objects.filter(
issue=instance, assignee_id__in=assignees_to_remove
).delete()
try:
IssueAssignee.objects.bulk_create(
[
@@ -249,7 +266,7 @@ class IssueSerializer(BaseSerializer):
created_by_id=created_by_id,
updated_by_id=updated_by_id,
)
for assignee_id in assignees
for assignee_id in assignees_to_add
],
batch_size=10,
ignore_conflicts=True,
@@ -258,7 +275,23 @@ class IssueSerializer(BaseSerializer):
pass
if labels is not None:
IssueLabel.objects.filter(issue=instance).delete()
# Get the current labels
current_labels = IssueLabel.objects.filter(issue=instance).values_list(
"label_id", flat=True
)
# Get the labels to add
labels_to_add = list(set(labels) - set(current_labels))
# Get the labels to remove
labels_to_remove = list(set(current_labels) - set(labels))
# Delete the labels to remove
IssueLabel.objects.filter(
issue=instance, label_id__in=labels_to_remove
).delete()
# Create the labels to add
try:
IssueLabel.objects.bulk_create(
[
@@ -270,7 +303,7 @@ class IssueSerializer(BaseSerializer):
created_by_id=created_by_id,
updated_by_id=updated_by_id,
)
for label_id in labels
for label_id in labels_to_add
],
batch_size=10,
ignore_conflicts=True,
@@ -312,6 +345,10 @@ class IssueSerializer(BaseSerializer):
str(label) for label in IssueLabel.objects.filter(issue=instance).values_list("label_id", flat=True)
]
if "type" in self.fields:
if "type" in self.expand:
data["type"] = IssueTypeAPISerializer(instance.type).data
return data
@@ -551,7 +588,7 @@ class IssueCommentSerializer(BaseSerializer):
"created_at",
"updated_at",
]
exclude = ["comment_stripped", "comment_json"]
exclude = ["comment_json"]
def validate(self, data):
try:
@@ -681,9 +718,9 @@ class IssueAttachmentUploadSerializer(serializers.Serializer):
)
class IssueSearchSerializer(serializers.Serializer):
class IssueSearchItemSerializer(serializers.Serializer):
"""
Serializer for work item search result data formatting.
Individual issue component for search results.
Provides standardized search result structure including work item identifiers,
project context, and workspace information for search API responses.
@@ -695,3 +732,225 @@ class IssueSearchSerializer(serializers.Serializer):
project__identifier = serializers.CharField(required=True, help_text="Project identifier")
project_id = serializers.CharField(required=True, help_text="Project ID")
workspace__slug = serializers.CharField(required=True, help_text="Workspace slug")
class IssueSearchSerializer(serializers.Serializer):
"""
Search results for work items.
Provides list of issues with their identifiers, names, and project context.
"""
issues = IssueSearchItemSerializer(many=True)
class IssueRelationResponseSerializer(serializers.Serializer):
"""
Serializer for issue relations response showing grouped relation types.
Returns issue IDs organized by relation type for efficient client-side processing.
"""
blocking = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that are blocking this issue",
)
blocked_by = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that this issue is blocked by",
)
duplicate = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that are duplicates of this issue",
)
relates_to = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that relate to this issue",
)
start_after = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that start after this issue",
)
start_before = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that start before this issue",
)
finish_after = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that finish after this issue",
)
finish_before = serializers.ListField(
child=serializers.UUIDField(),
help_text="List of issue IDs that finish before this issue",
)
class IssueRelationCreateSerializer(serializers.Serializer):
"""
Serializer for creating issue relations.
Creates issue relations with the specified relation type and issues.
Validates relation types and ensures proper issue ID format.
"""
RELATION_TYPE_CHOICES = [
("blocking", "Blocking"),
("blocked_by", "Blocked By"),
("duplicate", "Duplicate"),
("relates_to", "Relates To"),
("start_before", "Start Before"),
("start_after", "Start After"),
("finish_before", "Finish Before"),
("finish_after", "Finish After"),
]
relation_type = serializers.ChoiceField(
choices=RELATION_TYPE_CHOICES,
required=True,
help_text="Type of relationship between work items",
)
issues = serializers.ListField(
child=serializers.UUIDField(),
required=True,
min_length=1,
help_text="Array of work item IDs to create relations with",
)
def validate_issues(self, value):
"""Validate that issues list is not empty and contains valid UUIDs."""
if not value:
raise serializers.ValidationError("At least one issue ID is required.")
return value
class IssueRelationRemoveSerializer(serializers.Serializer):
"""
Serializer for removing issue relations.
Removes existing relationships between work items by specifying
the related issue ID.
"""
related_issue = serializers.UUIDField(
required=True, help_text="ID of the related work item to remove relation with"
)
class IssueRelationSerializer(BaseSerializer):
"""
Serializer for issue relationships showing related issue details.
Provides comprehensive information about related issues including
project context, sequence ID, and relationship type.
"""
id = serializers.UUIDField(source="related_issue.id", read_only=True)
project_id = serializers.PrimaryKeyRelatedField(
source="related_issue.project_id", read_only=True
)
sequence_id = serializers.IntegerField(
source="related_issue.sequence_id", read_only=True
)
name = serializers.CharField(source="related_issue.name", read_only=True)
type_id = serializers.UUIDField(source="related_issue.type.id", read_only=True)
relation_type = serializers.CharField(read_only=True)
is_epic = serializers.BooleanField(
source="related_issue.type.is_epic", read_only=True
)
state_id = serializers.UUIDField(source="related_issue.state.id", read_only=True)
priority = serializers.CharField(source="related_issue.priority", read_only=True)
class Meta:
model = IssueRelation
fields = [
"id",
"project_id",
"sequence_id",
"relation_type",
"name",
"type_id",
"is_epic",
"state_id",
"priority",
"created_by",
"created_at",
"updated_at",
"updated_by",
]
read_only_fields = [
"workspace",
"project",
"created_by",
"created_at",
"updated_by",
"updated_at",
]
class RelatedIssueSerializer(BaseSerializer):
"""
Serializer for reverse issue relationships showing issue details.
Provides comprehensive information about the source issue in a relationship
including project context, sequence ID, and relationship type.
"""
id = serializers.UUIDField(source="issue.id", read_only=True)
project_id = serializers.PrimaryKeyRelatedField(
source="issue.project_id", read_only=True
)
sequence_id = serializers.IntegerField(source="issue.sequence_id", read_only=True)
name = serializers.CharField(source="issue.name", read_only=True)
type_id = serializers.UUIDField(source="issue.type.id", read_only=True)
relation_type = serializers.CharField(read_only=True)
is_epic = serializers.BooleanField(source="issue.type.is_epic", read_only=True)
state_id = serializers.UUIDField(source="issue.state.id", read_only=True)
priority = serializers.CharField(source="issue.priority", read_only=True)
class Meta:
model = IssueRelation
fields = [
"id",
"project_id",
"sequence_id",
"relation_type",
"name",
"type_id",
"is_epic",
"state_id",
"priority",
"created_by",
"created_at",
"updated_by",
"updated_at",
]
read_only_fields = [
"workspace",
"project",
"created_by",
"created_at",
"updated_by",
"updated_at",
]
class IssueDetailSerializer(IssueSerializer):
"""
Comprehensive work item serializer with full relationship management.
Handles complete work item lifecycle including assignees, labels, validation,
and related model updates. Supports dynamic field expansion and HTML content processing.
"""
assignees = UserLiteSerializer(many=True)
labels = LabelSerializer(many=True)
type_id = serializers.PrimaryKeyRelatedField(
source="type", queryset=IssueType.objects.all(), required=False, allow_null=True
)
class Meta:
model = Issue
read_only_fields = ["id", "workspace", "project", "updated_by", "updated_at"]
exclude = ["description"]
@@ -0,0 +1,42 @@
# Third party imports
from rest_framework import serializers
# Module imports
from plane.ee.serializers import BaseSerializer
from plane.db.models import IssueType, ProjectIssueType
class IssueTypeAPISerializer(BaseSerializer):
project_ids = serializers.ListField(child=serializers.UUIDField(), required=False)
class Meta:
model = IssueType
fields = "__all__"
read_only_fields = [
"workspace",
"logo_props",
"is_default",
"level",
"deleted_at",
"created_at",
"updated_at",
"created_by",
"updated_by",
]
class ProjectIssueTypeAPISerializer(BaseSerializer):
class Meta:
model = ProjectIssueType
fields = "__all__"
read_only_fields = [
"workspace",
"project",
"level",
"is_default",
"deleted_at",
"created_at",
"updated_at",
"created_by",
"updated_by",
]
+1 -2
View File
@@ -19,7 +19,7 @@ class StateSerializer(BaseSerializer):
class Meta:
model = State
fields = "__all__"
exclude = ["slug"]
read_only_fields = [
"id",
"created_by",
@@ -29,7 +29,6 @@ class StateSerializer(BaseSerializer):
"workspace",
"project",
"deleted_at",
"slug",
]
+10
View File
@@ -1,4 +1,5 @@
from .asset import urlpatterns as asset_patterns
from .customer import urlpatterns as customer_patterns
from .cycle import urlpatterns as cycle_patterns
from .intake import urlpatterns as intake_patterns
from .label import urlpatterns as label_patterns
@@ -8,9 +9,15 @@ from .project import urlpatterns as project_patterns
from .state import urlpatterns as state_patterns
from .user import urlpatterns as user_patterns
from .work_item import urlpatterns as work_item_patterns
from .work_item_type import urlpatterns as work_item_type_patterns
# ee imports
from plane.ee.urls.api import urlpatterns as ee_api_urls
urlpatterns = [
*asset_patterns,
*customer_patterns,
*cycle_patterns,
*intake_patterns,
*label_patterns,
@@ -20,4 +27,7 @@ urlpatterns = [
*state_patterns,
*user_patterns,
*work_item_patterns,
*work_item_type_patterns,
# ee url endpoints
*ee_api_urls,
]
+68
View File
@@ -0,0 +1,68 @@
from django.urls import path
from plane.api.views import (
CustomerAPIEndpoint,
CustomerDetailAPIEndpoint,
CustomerRequestAPIEndpoint,
CustomerRequestDetailAPIEndpoint,
CustomerIssuesAPIEndpoint,
CustomerIssueDetailAPIEndpoint,
CustomerPropertiesAPIEndpoint,
CustomerPropertyDetailAPIEndpoint,
CustomerPropertyValuesAPIEndpoint,
CustomerPropertyValueDetailAPIEndpoint,
)
urlpatterns = [
path(
"workspaces/<str:slug>/customers/",
CustomerAPIEndpoint.as_view(),
name="customer",
),
path(
"workspaces/<str:slug>/customers/<uuid:pk>/",
CustomerDetailAPIEndpoint.as_view(),
name="customer-detail",
),
path(
"workspaces/<str:slug>/customers/<uuid:customer_id>/requests/",
CustomerRequestAPIEndpoint.as_view(),
name="customer-requests",
),
path(
"workspaces/<str:slug>/customers/<uuid:customer_id>/requests/<uuid:pk>/",
CustomerRequestDetailAPIEndpoint.as_view(),
name="customer-requests-detail",
),
path(
"workspaces/<str:slug>/customers/<uuid:customer_id>/issues/",
CustomerIssuesAPIEndpoint.as_view(),
name="customer-issues",
),
path(
"workspaces/<str:slug>/customers/<uuid:customer_id>/issues/<uuid:issue_id>/",
CustomerIssueDetailAPIEndpoint.as_view(),
name="customer-issues-detail",
),
path(
"workspaces/<str:slug>/customer-properties/",
CustomerPropertiesAPIEndpoint.as_view(),
name="customer-properties",
),
path(
"workspaces/<str:slug>/customer-properties/<uuid:pk>/",
CustomerPropertyDetailAPIEndpoint.as_view(),
name="customer-properties-detail",
),
path(
"workspaces/<str:slug>/customers/<uuid:customer_id>/property-values/",
CustomerPropertyValuesAPIEndpoint.as_view(),
name="customer-property-values",
),
path(
"workspaces/<str:slug>/customers/<uuid:customer_id>/property-values/<uuid:property_id>/",
CustomerPropertyValueDetailAPIEndpoint.as_view(),
name="customer-property-values-detail",
),
]
+1 -1
View File
@@ -5,7 +5,7 @@ from plane.api.views import ProjectMemberAPIEndpoint, WorkspaceMemberAPIEndpoint
urlpatterns = [
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/members/",
ProjectMemberAPIEndpoint.as_view(http_method_names=["get"]),
ProjectMemberAPIEndpoint.as_view(http_method_names=["get", "post"]),
name="project-members",
),
path(
+43
View File
@@ -12,6 +12,9 @@ from plane.api.views import (
IssueAttachmentListCreateAPIEndpoint,
IssueAttachmentDetailAPIEndpoint,
WorkspaceIssueAPIEndpoint,
IssueRelationListCreateAPIEndpoint,
IssueRelationRemoveAPIEndpoint,
IssueAttachmentServerEndpoint,
IssueSearchEndpoint,
)
@@ -77,6 +80,26 @@ old_url_patterns = [
IssueAttachmentDetailAPIEndpoint.as_view(http_method_names=["get", "patch", "delete"]),
name="issue-attachment",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/issues/<uuid:issue_id>/issue-attachments/server/",
IssueAttachmentServerEndpoint.as_view(),
name="attachment",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/issues/<uuid:issue_id>/issue-attachments/<uuid:pk>/server/",
IssueAttachmentServerEndpoint.as_view(),
name="attachment",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/issues/<uuid:issue_id>/relations/",
IssueRelationListCreateAPIEndpoint.as_view(http_method_names=["get", "post"]),
name="relation",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/issues/<uuid:issue_id>/relations/remove/",
IssueRelationRemoveAPIEndpoint.as_view(http_method_names=["post"]),
name="relation",
),
]
# New url patterns with work-items as the prefix
@@ -141,6 +164,26 @@ new_url_patterns = [
IssueAttachmentDetailAPIEndpoint.as_view(http_method_names=["get", "patch", "delete"]),
name="work-item-attachment-detail",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/work-items/<uuid:issue_id>/attachments/server/",
IssueAttachmentServerEndpoint.as_view(),
name="work-item-attachment-server",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/work-items/<uuid:issue_id>/attachments/<uuid:pk>/server/",
IssueAttachmentServerEndpoint.as_view(),
name="work-item-attachment-server",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/work-items/<uuid:issue_id>/relations/",
IssueRelationListCreateAPIEndpoint.as_view(http_method_names=["get", "post"]),
name="work-item-relation-list",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/work-items/<uuid:issue_id>/relations/remove/",
IssueRelationRemoveAPIEndpoint.as_view(http_method_names=["post"]),
name="work-item-relation-remove",
),
]
urlpatterns = old_url_patterns + new_url_patterns
+31
View File
@@ -0,0 +1,31 @@
from django.urls import path
from plane.api.views import IssueTypeListCreateAPIEndpoint, IssueTypeDetailAPIEndpoint
old_url_patterns = [
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/issue-types/",
IssueTypeListCreateAPIEndpoint.as_view(http_method_names=["get", "post"]),
name="external-issue-type",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/issue-types/<uuid:type_id>/",
IssueTypeDetailAPIEndpoint.as_view(http_method_names=["get", "patch", "delete"]),
name="external-issue-type-detail",
),
]
new_url_patterns = [
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/work-item-types/",
IssueTypeListCreateAPIEndpoint.as_view(http_method_names=["get", "post"]),
name="external-work-item-type",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/work-item-types/<uuid:type_id>/",
IssueTypeDetailAPIEndpoint.as_view(http_method_names=["get", "patch", "delete"]),
name="external-work-item-type-detail",
),
]
urlpatterns = old_url_patterns + new_url_patterns
+18 -1
View File
@@ -11,6 +11,7 @@ from .state import (
from .issue import (
WorkspaceIssueAPIEndpoint,
IssueAttachmentServerEndpoint,
IssueListCreateAPIEndpoint,
IssueDetailAPIEndpoint,
LabelListCreateAPIEndpoint,
@@ -23,6 +24,8 @@ from .issue import (
IssueActivityDetailAPIEndpoint,
IssueAttachmentListCreateAPIEndpoint,
IssueAttachmentDetailAPIEndpoint,
IssueRelationListCreateAPIEndpoint,
IssueRelationRemoveAPIEndpoint,
IssueSearchEndpoint,
)
@@ -44,6 +47,20 @@ from .module import (
)
from .member import ProjectMemberAPIEndpoint, WorkspaceMemberAPIEndpoint
from .user import UserEndpoint
from .customer import (
CustomerAPIEndpoint,
CustomerDetailAPIEndpoint,
CustomerRequestAPIEndpoint,
CustomerRequestDetailAPIEndpoint,
CustomerIssuesAPIEndpoint,
CustomerIssueDetailAPIEndpoint,
CustomerPropertiesAPIEndpoint,
CustomerPropertyDetailAPIEndpoint,
CustomerPropertyValuesAPIEndpoint,
CustomerPropertyValueDetailAPIEndpoint,
)
from .intake import (
IntakeIssueListCreateAPIEndpoint,
@@ -52,4 +69,4 @@ from .intake import (
from .asset import UserAssetEndpoint, UserServerAssetEndpoint, GenericAssetEndpoint
from .user import UserEndpoint
from .issue_type import IssueTypeListCreateAPIEndpoint, IssueTypeDetailAPIEndpoint
+2
View File
@@ -432,6 +432,8 @@ class GenericAssetEndpoint(BaseAPIView):
status=status.HTTP_400_BAD_REQUEST,
)
size_limit = settings.FILE_SIZE_LIMIT
# Generate presigned URL for GET
storage = S3Storage(request=request, is_server=True)
presigned_url = storage.generate_presigned_url(
+16 -4
View File
@@ -13,11 +13,18 @@ from rest_framework.permissions import IsAuthenticated
from rest_framework.response import Response
# Third party imports
from oauth2_provider.contrib.rest_framework import (
OAuth2Authentication,
IsAuthenticatedOrTokenHasScope,
)
from rest_framework.generics import GenericAPIView
# Module imports
from plane.api.middleware.api_authentication import APIKeyAuthentication
from plane.api.rate_limit import ApiKeyRateThrottle, ServiceTokenRateThrottle
from plane.authentication.rate_limit import OAuthTokenRateThrottle
from plane.authentication.permissions.oauth import OauthApplicationWorkspacePermission
from plane.utils.exception_logger import log_exception
from plane.utils.paginator import BasePaginator
from plane.utils.core.mixins import ReadReplicaControlMixin
@@ -38,9 +45,13 @@ class TimezoneMixin:
class BaseAPIView(TimezoneMixin, GenericAPIView, ReadReplicaControlMixin, BasePaginator):
authentication_classes = [APIKeyAuthentication]
permission_classes = [IsAuthenticated]
authentication_classes = [APIKeyAuthentication, OAuth2Authentication]
permission_classes = [
IsAuthenticated,
IsAuthenticatedOrTokenHasScope,
OauthApplicationWorkspacePermission,
]
required_scopes = ["read", "write"]
use_read_replica = False
@@ -50,7 +61,7 @@ class BaseAPIView(TimezoneMixin, GenericAPIView, ReadReplicaControlMixin, BasePa
return queryset
def get_throttles(self):
throttle_classes = []
throttle_classes = super().get_throttles()
api_key = self.request.headers.get("X-Api-Key")
if api_key:
@@ -61,6 +72,7 @@ class BaseAPIView(TimezoneMixin, GenericAPIView, ReadReplicaControlMixin, BasePa
return throttle_classes
throttle_classes.append(ApiKeyRateThrottle())
throttle_classes.append(OAuthTokenRateThrottle())
return throttle_classes
File diff suppressed because it is too large Load Diff
+92 -1
View File
@@ -1,5 +1,6 @@
# Python imports
import json
from datetime import date, timedelta
# Django imports
from django.core import serializers
@@ -19,6 +20,7 @@ from django.db.models import (
)
from django.db.models.functions import Cast, Concat
from django.db import models
from django.utils.dateparse import parse_date
# Third party imports
from rest_framework import status
@@ -51,6 +53,9 @@ from plane.utils.analytics_plot import burndown_plot
from plane.utils.host import base_host
from .base import BaseAPIView
from plane.bgtasks.webhook_task import model_activity
from plane.ee.bgtasks.entity_issue_state_progress_task import (
entity_issue_state_activity_task,
)
from plane.utils.openapi.decorators import cycle_docs
from plane.utils.openapi import (
CURSOR_PARAMETER,
@@ -77,6 +82,7 @@ from plane.utils.openapi import (
UNARCHIVED_RESPONSE,
REQUIRED_FIELDS_RESPONSE,
)
from plane.ee.models import EntityProgress
class CycleListCreateAPIEndpoint(BaseAPIView):
@@ -906,7 +912,7 @@ class CycleIssueListCreateAPIEndpoint(BaseAPIView):
responses={
200: OpenApiResponse(
description="Cycle work items added",
response=CycleIssueSerializer,
response=CycleIssueSerializer(many=True),
examples=[CYCLE_ISSUE_EXAMPLE],
),
400: REQUIRED_FIELDS_RESPONSE,
@@ -943,12 +949,35 @@ class CycleIssueListCreateAPIEndpoint(BaseAPIView):
]
new_issues = list(set(issues) - set(existing_issues))
issue_cycle_data_added = [
{
"issue_id": str(issue_id),
"cycle_id": str(cycle_id),
}
for issue_id in issues
]
issues_removed = CycleIssue.objects.filter(
issue_id__in=existing_issues,
workspace__slug=slug,
).values("issue_id", "cycle_id")
issue_cycle_data_removed = [
{
"issue_id": str(issue["issue_id"]),
"cycle_id": str(issue["cycle_id"]),
}
for issue in issues_removed
]
# New issues to create
created_records = CycleIssue.objects.bulk_create(
[
CycleIssue(
project_id=project_id,
workspace_id=cycle.workspace_id,
created_by_id=request.user.id,
updated_by_id=request.user.id,
cycle_id=cycle_id,
issue_id=issue,
)
@@ -980,6 +1009,22 @@ class CycleIssueListCreateAPIEndpoint(BaseAPIView):
# Update the cycle issues
CycleIssue.objects.bulk_update(updated_records, ["cycle_id"], batch_size=100)
# For REMOVED
entity_issue_state_activity_task.delay(
issue_cycle_data=issue_cycle_data_removed,
user_id=str(request.user.id),
slug=slug,
action="REMOVED",
)
# For ADDED
entity_issue_state_activity_task.delay(
issue_cycle_data=issue_cycle_data_added,
user_id=str(request.user.id),
slug=slug,
action="ADDED",
)
# Capture Issue Activity
issue_activity.delay(
type="cycle.activity.created",
@@ -1105,6 +1150,18 @@ class CycleIssueDetailAPIEndpoint(BaseAPIView):
current_instance=None,
epoch=int(timezone.now().timestamp()),
)
# Trigger the entity issue state activity task
entity_issue_state_activity_task.delay(
issue_cycle_data=[
{
"issue_id": str(issue_id),
"cycle_id": str(cycle_id),
}
],
user_id=str(self.request.user.id),
slug=slug,
action="REMOVED",
)
return Response(status=status.HTTP_204_NO_CONTENT)
@@ -1538,6 +1595,7 @@ class TransferCycleIssueAPIEndpoint(BaseAPIView):
project_id=project_id,
workspace__slug=slug,
issue__state__group__in=["backlog", "unstarted", "started"],
issue__deleted_at__isnull=True,
)
updated_cycles = []
@@ -1555,6 +1613,39 @@ class TransferCycleIssueAPIEndpoint(BaseAPIView):
cycle_issues = CycleIssue.objects.bulk_update(updated_cycles, ["cycle_id"], batch_size=100)
# EE code
# Extract issue IDs from cycle_issues
issue_ids = [ci.issue_id for ci in updated_cycles]
# Trigger Celery task for REMOVED
entity_issue_state_activity_task.delay(
issue_cycle_data=[
{
"issue_id": str(issue_id),
"cycle_id": str(cycle_id),
}
for issue_id in issue_ids
],
user_id=str(request.user.id),
slug=slug,
action="REMOVED",
)
# Trigger Celery task for ADDED
entity_issue_state_activity_task.delay(
issue_cycle_data=[
{
"issue_id": str(issue_id),
"cycle_id": str(new_cycle_id),
}
for issue_id in issue_ids
],
user_id=str(request.user.id),
slug=slug,
action="ADDED",
)
# EE code end here
# Capture Issue Activity
issue_activity.delay(
type="cycle.activity.created",
+44 -5
View File
@@ -2,12 +2,12 @@
import json
# Django imports
from django.core.serializers.json import DjangoJSONEncoder
from django.utils import timezone
from django.db.models import Q, Value, UUIDField
from django.db.models.functions import Coalesce
from django.contrib.postgres.aggregates import ArrayAgg
from django.contrib.postgres.fields import ArrayField
from django.core.serializers.json import DjangoJSONEncoder
from django.db.models import Q, UUIDField, Value
from django.db.models.functions import Coalesce
from django.utils import timezone
# Third party imports
from rest_framework import status
@@ -23,8 +23,18 @@ from plane.api.serializers import (
)
from plane.app.permissions import ProjectLitePermission
from plane.bgtasks.issue_activities_task import issue_activity
from plane.db.models import Intake, IntakeIssue, Issue, Project, ProjectMember, State
from plane.db.models import (
Intake,
IntakeIssue,
Issue,
Project,
ProjectMember,
State,
IssueType,
)
from plane.utils.host import base_host
from plane.ee.models import IntakeSetting
from plane.ee.utils.workflow import WorkflowStateManager
from .base import BaseAPIView
from plane.db.models.intake import SourceType
from plane.utils.openapi import (
@@ -165,6 +175,11 @@ class IntakeIssueListCreateAPIEndpoint(BaseAPIView):
]:
return Response({"error": "Invalid priority"}, status=status.HTTP_400_BAD_REQUEST)
# Get the issue type
issue_type = IssueType.objects.filter(
project_issue_types__project_id=project_id, is_epic=False, is_default=True
).first()
# create an issue
issue = Issue.objects.create(
name=request.data.get("issue", {}).get("name"),
@@ -172,6 +187,7 @@ class IntakeIssueListCreateAPIEndpoint(BaseAPIView):
description_html=request.data.get("issue", {}).get("description_html", "<p></p>"),
priority=request.data.get("issue", {}).get("priority", "none"),
project_id=project_id,
type=issue_type,
)
# create an intake issue
@@ -295,6 +311,16 @@ class IntakeIssueDetailAPIEndpoint(BaseAPIView):
status=status.HTTP_400_BAD_REQUEST,
)
intake_settings = IntakeSetting.objects.filter(
workspace__slug=slug, project_id=project_id, intake=intake
).first()
if intake_settings is not None and not intake_settings.is_in_app_enabled:
return Response(
{"error": "Creating intake issues is disabled"},
status=status.HTTP_400_BAD_REQUEST,
)
# Get the intake issue
intake_issue = IntakeIssue.objects.get(
issue_id=issue_id,
@@ -344,6 +370,19 @@ class IntakeIssueDetailAPIEndpoint(BaseAPIView):
Value([], output_field=ArrayField(UUIDField())),
),
).get(pk=issue_id, workspace__slug=slug, project_id=project_id)
# Check if state is updated then is the transition allowed
workflow_state_manager = WorkflowStateManager(project_id=project_id, slug=slug)
if request.data.get("state_id") and not workflow_state_manager.validate_state_transition(
issue=issue,
new_state_id=request.data.get("state_id"),
user_id=request.user.id,
):
return Response(
{"error": "State transition is not allowed"},
status=status.HTTP_403_FORBIDDEN,
)
# Only allow guests to edit name and description
if project_member.role <= 5:
issue_data = {
+634 -7
View File
@@ -1,7 +1,7 @@
# Python imports
import json
import uuid
import re
import uuid
# Django imports
from django.core.serializers.json import DjangoJSONEncoder
@@ -40,8 +40,14 @@ from plane.api.serializers import (
IssueAttachmentSerializer,
IssueActivitySerializer,
IssueCommentSerializer,
IssueDetailSerializer,
IssueLinkSerializer,
IssueSerializer,
IssueRelationSerializer,
IssueRelationCreateSerializer,
IssueRelationRemoveSerializer,
IssueRelationResponseSerializer,
RelatedIssueSerializer,
LabelSerializer,
IssueAttachmentUploadSerializer,
IssueSearchSerializer,
@@ -62,6 +68,7 @@ from plane.db.models import (
FileAsset,
IssueComment,
IssueLink,
IssueRelation,
Label,
Project,
ProjectMember,
@@ -72,10 +79,13 @@ from plane.settings.storage import S3Storage
from plane.bgtasks.storage_metadata_task import get_asset_object_metadata
from .base import BaseAPIView
from plane.utils.host import base_host
from plane.utils.issue_relation_mapper import get_actual_relation
from plane.bgtasks.webhook_task import model_activity
from plane.app.permissions import ROLE
from plane.utils.openapi import (
work_item_docs,
issue_docs,
label_docs,
issue_link_docs,
issue_comment_docs,
@@ -141,6 +151,12 @@ from plane.utils.openapi import (
WORKSPACE_NOT_FOUND_RESPONSE,
)
from plane.bgtasks.work_item_link_task import crawl_work_item_link_title
from plane.payment.flags.flag_decorator import check_workspace_feature_flag
from plane.payment.flags.flag import FeatureFlag
from plane.ee.utils.workflow import WorkflowStateManager
from plane.ee.bgtasks.entity_issue_state_progress_task import (
entity_issue_state_activity_task,
)
def user_has_issue_permission(user_id, project_id, issue=None, allowed_roles=None, allow_creator=True):
@@ -190,6 +206,7 @@ class WorkspaceIssueAPIEndpoint(BaseAPIView):
.select_related("parent")
.prefetch_related("assignees")
.prefetch_related("labels")
.prefetch_related("type")
.order_by(self.kwargs.get("order_by", "-created_at"))
).distinct()
@@ -218,6 +235,25 @@ class WorkspaceIssueAPIEndpoint(BaseAPIView):
Retrieve a specific work item using workspace slug, project identifier, and issue identifier.
This endpoint provides workspace-level access to work items.
"""
# ee start
# epics support
if request.GET.get("include_epics") == "true" and issue_identifier and project_identifier:
issue = Issue.issue_and_epics_objects.annotate(
sub_issues_count=Issue.issue_and_epics_objects.filter(parent=OuterRef("id"))
.order_by()
.annotate(count=Func(F("id"), function="Count"))
.values("count")
).get(
workspace__slug=slug,
project__identifier=project_identifier,
sequence_id=issue_identifier,
)
return Response(
IssueSerializer(issue, fields=self.fields, expand=self.expand).data,
status=status.HTTP_200_OK,
)
# ee end
if issue_identifier and project_identifier:
issue = Issue.issue_objects.annotate(
sub_issues_count=Issue.issue_objects.filter(parent=OuterRef("id"))
@@ -423,6 +459,15 @@ class IssueListCreateAPIEndpoint(BaseAPIView):
"default_assignee_id": project.default_assignee_id,
},
)
if request.data.get("state_id"):
workflow_state_manager = WorkflowStateManager(project_id=project_id, slug=slug)
if workflow_state_manager.validate_issue_creation(
state_id=request.data.get("state_id"), user_id=request.user.id
):
return Response(
{"error": "You cannot create a work item in this state"},
status=status.HTTP_403_FORBIDDEN,
)
if serializer.is_valid():
if (
@@ -524,7 +569,7 @@ class IssueDetailAPIEndpoint(BaseAPIView):
responses={
200: OpenApiResponse(
description="List of issues or issue details",
response=IssueSerializer,
response=IssueDetailSerializer,
examples=[ISSUE_EXAMPLE],
),
400: INVALID_REQUEST_RESPONSE,
@@ -544,8 +589,15 @@ class IssueDetailAPIEndpoint(BaseAPIView):
.annotate(count=Func(F("id"), function="Count"))
.values("count")
).get(workspace__slug=slug, project_id=project_id, pk=pk)
# Ensure labels and assignees are always expanded for issue details
# this is required until we find a better way to create issue detail serializer
expand = self.expand or []
required_expansions = {"labels", "assignees"}
expand = list(set(expand) | required_expansions)
return Response(
IssueSerializer(issue, fields=self.fields, expand=self.expand).data,
IssueDetailSerializer(issue, fields=self.fields, expand=expand).data,
status=status.HTTP_200_OK,
)
@@ -612,6 +664,19 @@ class IssueDetailAPIEndpoint(BaseAPIView):
},
partial=True,
)
# Check if state is updated then is the transition allowed
workflow_state_manager = WorkflowStateManager(project_id=project_id, slug=slug)
if request.data.get("state_id") and not workflow_state_manager.validate_state_transition(
issue=issue,
new_state_id=request.data.get("state_id"),
user_id=request.user.id,
):
return Response(
{"error": "State transition is not allowed"},
status=status.HTTP_403_FORBIDDEN,
)
if serializer.is_valid():
# If the serializer is valid, save the issue and dispatch
# the update issue activity worker event.
@@ -625,6 +690,19 @@ class IssueDetailAPIEndpoint(BaseAPIView):
current_instance=current_instance,
epoch=int(timezone.now().timestamp()),
)
cycle_issue = CycleIssue.objects.filter(issue_id=issue.id).first()
if cycle_issue and (request.data.get("state_id") or request.data.get("estimate_point")):
entity_issue_state_activity_task.delay(
issue_cycle_data=[
{
"issue_id": str(issue.id),
"cycle_id": str(cycle_issue.cycle_id),
}
],
user_id=str(request.user.id),
slug=slug,
action="UPDATED",
)
return Response(serializer.data, status=status.HTTP_200_OK)
return Response(
# If the serializer is not valid, respond with 400 bad
@@ -663,6 +741,19 @@ class IssueDetailAPIEndpoint(BaseAPIView):
issue.created_at = request.data.get("created_at", timezone.now())
issue.created_by_id = request.data.get("created_by", request.user.id)
issue.save(update_fields=["created_at", "created_by"])
cycle_issue = CycleIssue.objects.filter(issue_id=issue.id).first()
if cycle_issue and (request.data.get("state_id") or request.data.get("estimate_point")):
entity_issue_state_activity_task.delay(
issue_cycle_data=[
{
"issue_id": str(issue.id),
"cycle_id": str(cycle_issue.cycle_id),
}
],
user_id=str(request.user.id),
slug=slug,
action="UPDATED",
)
issue_activity.delay(
type="issue.activity.created",
@@ -719,6 +810,19 @@ class IssueDetailAPIEndpoint(BaseAPIView):
context={"project_id": project_id, "workspace_id": project.workspace_id},
partial=True,
)
# Check if state is updated then is the transition allowed
workflow_state_manager = WorkflowStateManager(project_id=project_id, slug=slug)
if request.data.get("state_id") and not workflow_state_manager.validate_state_transition(
issue=issue,
new_state_id=request.data.get("state_id"),
user_id=request.user.id,
):
return Response(
{"error": "State transition is not allowed"},
status=status.HTTP_403_FORBIDDEN,
)
if serializer.is_valid():
if (
request.data.get("external_id")
@@ -748,6 +852,19 @@ class IssueDetailAPIEndpoint(BaseAPIView):
current_instance=current_instance,
epoch=int(timezone.now().timestamp()),
)
cycle_issue = CycleIssue.objects.filter(issue_id=pk).first()
if cycle_issue and (request.data.get("state_id") or request.data.get("estimate_point")):
entity_issue_state_activity_task.delay(
issue_cycle_data=[
{
"issue_id": str(issue.id),
"cycle_id": str(cycle_issue.cycle_id),
}
],
user_id=str(request.user.id),
slug=slug,
action="UPDATED",
)
return Response(serializer.data, status=status.HTTP_200_OK)
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
@@ -785,6 +902,16 @@ class IssueDetailAPIEndpoint(BaseAPIView):
status=status.HTTP_403_FORBIDDEN,
)
current_instance = json.dumps(IssueSerializer(issue).data, cls=DjangoJSONEncoder)
cycle_issue = CycleIssue.objects.filter(issue_id=pk).first()
if cycle_issue:
# added a entry to remove from the entity issue state activity
entity_issue_state_activity_task.delay(
issue_cycle_data=[{"issue_id": str(issue.id), "cycle_id": str(cycle_issue.cycle_id)}],
user_id=str(request.user.id),
slug=slug,
action="REMOVED",
)
# EE code end here
issue.delete()
issue_activity.delay(
type="issue.activity.deleted",
@@ -958,6 +1085,7 @@ class LabelDetailAPIEndpoint(LabelListCreateAPIEndpoint):
@label_docs(
operation_id="update_label",
summary="Update a label",
description="Partially update an existing label's properties like name, color, or description.",
parameters=[
LABEL_ID_PARAMETER,
@@ -1013,6 +1141,7 @@ class LabelDetailAPIEndpoint(LabelListCreateAPIEndpoint):
@label_docs(
operation_id="delete_label",
summary="Delete a label",
description="Permanently remove a label from the project. This action cannot be undone.",
parameters=[
LABEL_ID_PARAMETER,
@@ -1202,6 +1331,7 @@ class IssueLinkDetailAPIEndpoint(BaseAPIView):
@issue_link_docs(
operation_id="update_issue_link",
summary="Update an issue link",
description="Modify the URL, title, or metadata of an existing issue link.",
parameters=[
ISSUE_ID_PARAMETER,
@@ -1340,6 +1470,23 @@ class IssueCommentListCreateAPIEndpoint(BaseAPIView):
Retrieve all comments for a work item.
"""
external_id = request.GET.get("external_id")
external_source = request.GET.get("external_source")
if external_id and external_source:
try:
issue_comment = IssueComment.objects.get(
external_id=external_id,
external_source=external_source,
workspace__slug=slug,
project_id=project_id,
issue_id=issue_id,
)
serializer = IssueCommentSerializer(issue_comment, fields=self.fields, expand=self.expand)
return Response(serializer.data, status=status.HTTP_200_OK)
except IssueComment.DoesNotExist:
return Response({"error": "Comment not found"}, status=status.HTTP_404_NOT_FOUND)
return self.paginate(
request=request,
queryset=(self.get_queryset()),
@@ -1408,7 +1555,7 @@ class IssueCommentListCreateAPIEndpoint(BaseAPIView):
issue_comment.created_at = request.data.get("created_at", timezone.now())
issue_comment.created_by_id = request.data.get("created_by", request.user.id)
issue_comment.actor_id = request.data.get("created_by", request.user.id)
issue_comment.save(update_fields=["created_at", "created_by"])
issue_comment.save(update_fields=["created_at", "created_by", "actor"])
issue_activity.delay(
type="comment.activity.created",
@@ -1430,7 +1577,6 @@ class IssueCommentListCreateAPIEndpoint(BaseAPIView):
slug=slug,
origin=base_host(request=request, is_app=True),
)
serializer = IssueCommentSerializer(issue_comment)
return Response(serializer.data, status=status.HTTP_201_CREATED)
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
@@ -1559,6 +1705,7 @@ class IssueCommentDetailAPIEndpoint(BaseAPIView):
current_instance=current_instance,
epoch=int(timezone.now().timestamp()),
)
# Send the model activity
model_activity.delay(
model_name="issue_comment",
@@ -1569,7 +1716,6 @@ class IssueCommentDetailAPIEndpoint(BaseAPIView):
slug=slug,
origin=base_host(request=request, is_app=True),
)
issue_comment = IssueComment.objects.get(pk=serializer.instance.id)
serializer = IssueCommentSerializer(issue_comment)
return Response(serializer.data, status=status.HTTP_200_OK)
@@ -1825,7 +1971,15 @@ class IssueAttachmentListCreateAPIEndpoint(BaseAPIView):
status=status.HTTP_400_BAD_REQUEST,
)
size_limit = min(size, settings.FILE_SIZE_LIMIT)
# Check if the file size is greater than the limit
if check_workspace_feature_flag(
feature_key=FeatureFlag.FILE_SIZE_LIMIT_PRO,
slug=slug,
user_id=str(request.user.id),
):
size_limit = min(size, settings.PRO_FILE_SIZE_LIMIT)
else:
size_limit = min(size, settings.FILE_SIZE_LIMIT)
if not type or type not in settings.ATTACHMENT_MIME_TYPES:
return Response(
@@ -2134,6 +2288,183 @@ class IssueAttachmentDetailAPIEndpoint(BaseAPIView):
return Response(status=status.HTTP_204_NO_CONTENT)
class IssueAttachmentServerEndpoint(BaseAPIView):
serializer_class = IssueAttachmentSerializer
permission_classes = [ProjectEntityPermission]
model = FileAsset
use_read_replica = True
def post(self, request, slug, project_id, issue_id):
name = request.data.get("name")
type = request.data.get("type", False)
size = request.data.get("size")
external_id = request.data.get("external_id")
external_source = request.data.get("external_source")
# Check if the request is valid
if not name or not size:
return Response(
{"error": "Invalid request.", "status": False},
status=status.HTTP_400_BAD_REQUEST,
)
# Check if the file size is greater than the limit
if check_workspace_feature_flag(
feature_key=FeatureFlag.FILE_SIZE_LIMIT_PRO,
slug=slug,
user_id=str(request.user.id),
):
size_limit = min(size, settings.PRO_FILE_SIZE_LIMIT)
else:
size_limit = min(size, settings.FILE_SIZE_LIMIT)
if not type or type not in settings.ATTACHMENT_MIME_TYPES:
return Response(
{"error": "Invalid file type.", "status": False},
status=status.HTTP_400_BAD_REQUEST,
)
# Get the workspace
workspace = Workspace.objects.get(slug=slug)
# asset key
asset_key = f"{workspace.id}/{uuid.uuid4().hex}-{name}"
if (
request.data.get("external_id")
and request.data.get("external_source")
and FileAsset.objects.filter(
project_id=project_id,
workspace__slug=slug,
external_source=request.data.get("external_source"),
external_id=request.data.get("external_id"),
issue_id=issue_id,
entity_type=FileAsset.EntityTypeContext.ISSUE_ATTACHMENT,
).exists()
):
asset = FileAsset.objects.filter(
project_id=project_id,
workspace__slug=slug,
external_source=request.data.get("external_source"),
external_id=request.data.get("external_id"),
issue_id=issue_id,
entity_type=FileAsset.EntityTypeContext.ISSUE_ATTACHMENT,
).first()
return Response(
{
"error": "Issue with the same external id and external source already exists",
"id": str(asset.id),
},
status=status.HTTP_409_CONFLICT,
)
# Create a File Asset
asset = FileAsset.objects.create(
attributes={"name": name, "type": type, "size": size_limit},
asset=asset_key,
size=size_limit,
workspace_id=workspace.id,
created_by=request.user,
issue_id=issue_id,
project_id=project_id,
entity_type=FileAsset.EntityTypeContext.ISSUE_ATTACHMENT,
external_id=external_id,
external_source=external_source,
)
# Get the presigned URL
storage = S3Storage(request=request, is_server=True)
# Generate a presigned URL to share an S3 object
presigned_url = storage.generate_presigned_post(object_name=asset_key, file_type=type, file_size=size_limit)
# Return the presigned URL
return Response(
{
"upload_data": presigned_url,
"asset_id": str(asset.id),
"attachment": IssueAttachmentSerializer(asset).data,
"asset_url": asset.asset_url,
},
status=status.HTTP_200_OK,
)
def delete(self, request, slug, project_id, issue_id, pk):
issue_attachment = FileAsset.objects.get(pk=pk, workspace__slug=slug, project_id=project_id)
issue_attachment.is_deleted = True
issue_attachment.deleted_at = timezone.now()
issue_attachment.save()
issue_activity.delay(
type="attachment.activity.deleted",
requested_data=None,
actor_id=str(self.request.user.id),
issue_id=str(issue_id),
project_id=str(project_id),
current_instance=None,
epoch=int(timezone.now().timestamp()),
notification=True,
origin=request.META.get("HTTP_ORIGIN"),
)
# Get the storage metadata
if not issue_attachment.storage_metadata:
get_asset_object_metadata.delay(str(issue_attachment.id))
issue_attachment.save()
return Response(status=status.HTTP_204_NO_CONTENT)
def get(self, request, slug, project_id, issue_id, pk=None):
if pk:
# Get the asset
asset = FileAsset.objects.get(id=pk, workspace__slug=slug, project_id=project_id)
# Check if the asset is uploaded
if not asset.is_uploaded:
return Response(
{"error": "The asset is not uploaded.", "status": False},
status=status.HTTP_400_BAD_REQUEST,
)
storage = S3Storage(request=request)
presigned_url = storage.generate_presigned_url(
object_name=asset.asset.name,
disposition="attachment",
filename=asset.attributes.get("name"),
)
return HttpResponseRedirect(presigned_url)
def patch(self, request, slug, project_id, issue_id, pk):
"""Confirm attachment upload
Mark an attachment as uploaded after successful file transfer to storage.
Triggers activity logging and metadata extraction.
"""
issue_attachment = FileAsset.objects.get(pk=pk, workspace__slug=slug, project_id=project_id)
serializer = IssueAttachmentSerializer(issue_attachment)
# Send this activity only if the attachment is not uploaded before
if not issue_attachment.is_uploaded:
issue_activity.delay(
type="attachment.activity.created",
requested_data=None,
actor_id=str(self.request.user.id),
issue_id=str(self.kwargs.get("issue_id", None)),
project_id=str(self.kwargs.get("project_id", None)),
current_instance=json.dumps(serializer.data, cls=DjangoJSONEncoder),
epoch=int(timezone.now().timestamp()),
notification=True,
origin=request.META.get("HTTP_ORIGIN"),
)
# Update the attachment
issue_attachment.is_uploaded = True
issue_attachment.created_by = request.user
# Get the storage metadata
if not issue_attachment.storage_metadata:
get_asset_object_metadata.delay(str(issue_attachment.id))
issue_attachment.save()
return Response(status=status.HTTP_204_NO_CONTENT)
class IssueSearchEndpoint(BaseAPIView):
"""Endpoint to search across multiple fields in the issues"""
@@ -2209,6 +2540,302 @@ class IssueSearchEndpoint(BaseAPIView):
"project__identifier",
"project_id",
"workspace__slug",
"type_id",
)[: int(limit)]
return Response({"issues": issue_results}, status=status.HTTP_200_OK)
class IssueRelationListCreateAPIEndpoint(BaseAPIView):
"""Issue Relation List and Create Endpoint"""
serializer_class = IssueRelationSerializer
model = IssueRelation
permission_classes = [ProjectEntityPermission]
@issue_docs(
operation_id="list_work_item_relations",
summary="List work item relations",
description="Retrieve all relationships for a work item including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after relations.", # noqa E501
parameters=[
ISSUE_ID_PARAMETER,
CURSOR_PARAMETER,
PER_PAGE_PARAMETER,
ORDER_BY_PARAMETER,
FIELDS_PARAMETER,
EXPAND_PARAMETER,
],
responses={
200: OpenApiResponse(
description="Work item relations grouped by relation type",
response=IssueRelationResponseSerializer,
examples=[
OpenApiExample(
name="Work Item Relations Response",
value={
"blocking": [
"550e8400-e29b-41d4-a716-446655440000",
"550e8400-e29b-41d4-a716-446655440001",
],
"blocked_by": ["550e8400-e29b-41d4-a716-446655440002"],
"duplicate": [],
"relates_to": ["550e8400-e29b-41d4-a716-446655440003"],
"start_after": [],
"start_before": ["550e8400-e29b-41d4-a716-446655440004"],
"finish_after": [],
"finish_before": [],
},
)
],
),
400: INVALID_REQUEST_RESPONSE,
404: ISSUE_NOT_FOUND_RESPONSE,
},
)
def get(self, request, slug, project_id, issue_id):
"""List work item relations
Retrieve all relationships for a work item organized by relation type.
Returns a structured response with relations grouped by type.
"""
# Fetch all issue relations in a single query
issue_relations = list(
IssueRelation.objects.filter(Q(issue_id=issue_id) | Q(related_issue=issue_id))
.filter(workspace__slug=slug)
.select_related("project", "workspace", "issue", "related_issue")
.order_by("-created_at")
.distinct()
)
# Initialize lists for different relation types
blocking_issues = []
blocked_by_issues = []
duplicate_issues = []
relates_to_issues = []
start_after_issues = []
start_before_issues = []
finish_after_issues = []
finish_before_issues = []
# Process relations on application side to avoid N+1 queries
for relation in issue_relations:
if relation.relation_type == "blocked_by":
if relation.related_issue_id == issue_id:
# This issue is blocked by the related issue
blocking_issues.append(relation.issue_id)
elif relation.issue_id == issue_id:
# This issue blocks the related issue
blocked_by_issues.append(relation.related_issue_id)
elif relation.relation_type == "duplicate":
if relation.issue_id == issue_id:
duplicate_issues.append(relation.related_issue_id)
elif relation.related_issue_id == issue_id:
duplicate_issues.append(relation.issue_id)
elif relation.relation_type == "relates_to":
if relation.issue_id == issue_id:
relates_to_issues.append(relation.related_issue_id)
elif relation.related_issue_id == issue_id:
relates_to_issues.append(relation.issue_id)
elif relation.relation_type == "start_before":
if relation.related_issue_id == issue_id:
# The related issue starts after this issue
start_after_issues.append(relation.issue_id)
elif relation.issue_id == issue_id:
# This issue starts before the related issue
start_before_issues.append(relation.related_issue_id)
elif relation.relation_type == "finish_before":
if relation.related_issue_id == issue_id:
# The related issue finishes after this issue
finish_after_issues.append(relation.issue_id)
elif relation.issue_id == issue_id:
# This issue finishes before the related issue
finish_before_issues.append(relation.related_issue_id)
response_data = {
"blocking": blocking_issues,
"blocked_by": blocked_by_issues,
"duplicate": duplicate_issues,
"relates_to": relates_to_issues,
"start_after": start_after_issues,
"start_before": start_before_issues,
"finish_after": finish_after_issues,
"finish_before": finish_before_issues,
}
return Response(response_data, status=status.HTTP_200_OK)
@issue_docs(
operation_id="create_work_item_relation",
summary="Create work item relation",
description="Create relationships between work items. Supports various relation types including blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, and finish_after.", # noqa E501
parameters=[
ISSUE_ID_PARAMETER,
],
request=OpenApiRequest(
request=IssueRelationCreateSerializer,
examples=[
OpenApiExample(
name="Create blocking relation",
value={
"relation_type": "blocking",
"issues": [
"550e8400-e29b-41d4-a716-446655440000",
"550e8400-e29b-41d4-a716-446655440001",
],
},
)
],
),
responses={
201: OpenApiResponse(
description="Work item relations created successfully",
response=IssueRelationSerializer(many=True),
examples=[
OpenApiExample(
name="Relations created",
value=[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Fix authentication bug",
"sequence_id": 42,
"project_id": "550e8400-e29b-41d4-a716-446655440001",
"relation_type": "blocked_by",
"state_id": "550e8400-e29b-41d4-a716-446655440002",
"priority": "high",
"type_id": "550e8400-e29b-41d4-a716-446655440003",
"is_epic": False,
"created_at": "2024-01-15T10:00:00Z",
"updated_at": "2024-01-15T10:00:00Z",
"created_by": "550e8400-e29b-41d4-a716-446655440004",
"updated_by": "550e8400-e29b-41d4-a716-446655440004",
}
],
)
],
),
400: INVALID_REQUEST_RESPONSE,
404: ISSUE_NOT_FOUND_RESPONSE,
},
)
def post(self, request, slug, project_id, issue_id):
"""Create work item relation
Create relationships between work items with specified relation type.
Automatically tracks relation creation activity.
"""
# Validate request data using serializer
serializer = IssueRelationCreateSerializer(data=request.data)
if not serializer.is_valid():
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
relation_type = serializer.validated_data["relation_type"]
issues = serializer.validated_data["issues"]
project = Project.objects.get(pk=project_id)
issue_relation = IssueRelation.objects.bulk_create(
[
IssueRelation(
issue_id=(issue if relation_type in ["blocking", "start_after", "finish_after"] else issue_id),
related_issue_id=(
issue_id if relation_type in ["blocking", "start_after", "finish_after"] else issue
),
relation_type=(get_actual_relation(relation_type)),
project_id=project_id,
workspace_id=project.workspace_id,
created_by=request.user,
updated_by=request.user,
)
for issue in issues
],
batch_size=10,
ignore_conflicts=True,
)
issue_activity.delay(
type="issue_relation.activity.created",
requested_data=json.dumps(request.data, cls=DjangoJSONEncoder),
actor_id=str(request.user.id),
issue_id=str(issue_id),
project_id=str(project_id),
current_instance=None,
epoch=int(timezone.now().timestamp()),
notification=True,
origin=base_host(request=request, is_app=True),
)
if relation_type in ["blocking", "start_after", "finish_after"]:
return Response(
RelatedIssueSerializer(issue_relation, many=True).data,
status=status.HTTP_201_CREATED,
)
else:
return Response(
IssueRelationSerializer(issue_relation, many=True).data,
status=status.HTTP_201_CREATED,
)
class IssueRelationRemoveAPIEndpoint(BaseAPIView):
"""Issue Relation Remove Endpoint"""
permission_classes = [ProjectEntityPermission]
model = IssueRelation
@issue_docs(
operation_id="remove_work_item_relation",
summary="Remove work item relation",
description="Remove a relationship between work items by specifying the related work item ID.",
parameters=[
ISSUE_ID_PARAMETER,
],
request=OpenApiRequest(
request=IssueRelationRemoveSerializer,
examples=[
OpenApiExample(
name="Remove relation",
value={"related_issue": "550e8400-e29b-41d4-a716-446655440000"},
)
],
),
responses={
204: OpenApiResponse(description="Work item relation removed successfully"),
404: OpenApiResponse(description="Work item relation not found"),
},
)
def post(self, request, slug, project_id, issue_id):
"""Remove a work item relation
Remove a relationship between work items.
Records deletion activity for audit purposes.
"""
# Validate request data using serializer
serializer = IssueRelationRemoveSerializer(data=request.data)
if not serializer.is_valid():
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
related_issue = serializer.validated_data["related_issue"]
issue_relations = IssueRelation.objects.filter(
workspace__slug=slug,
).filter(
Q(issue_id=related_issue, related_issue_id=issue_id) | Q(issue_id=issue_id, related_issue_id=related_issue)
)
issue_relations = issue_relations.first()
current_instance = json.dumps(IssueRelationSerializer(issue_relations).data, cls=DjangoJSONEncoder)
issue_relations.delete()
issue_activity.delay(
type="issue_relation.activity.deleted",
requested_data=json.dumps(request.data, cls=DjangoJSONEncoder),
actor_id=str(request.user.id),
issue_id=str(issue_id),
project_id=str(project_id),
current_instance=current_instance,
epoch=int(timezone.now().timestamp()),
notification=True,
origin=base_host(request=request, is_app=True),
)
return Response(status=status.HTTP_204_NO_CONTENT)
+414
View File
@@ -0,0 +1,414 @@
# Python imports
import random
# Django imports
from django.db import transaction
from django.db.models import OuterRef, Subquery
from django.db.models.functions import Coalesce
from django.contrib.postgres.aggregates import ArrayAgg
# Third party imports
from rest_framework import status
from rest_framework.response import Response
from drf_spectacular.utils import OpenApiResponse, OpenApiRequest, OpenApiExample
# Module imports
from plane.api.views.base import BaseAPIView
from plane.app.permissions import ProjectEntityPermission
from plane.db.models import Workspace, Project, IssueType, ProjectIssueType, Issue
from plane.api.serializers import IssueTypeAPISerializer, ProjectIssueTypeAPISerializer
from plane.payment.flags.flag_decorator import check_feature_flag
from plane.payment.flags.flag import FeatureFlag
from plane.utils.helpers import get_boolean_value
from plane.utils.openapi.decorators import issue_type_docs
class IssueTypeListCreateAPIEndpoint(BaseAPIView):
"""
This viewset automatically provides `list` and `create` actions related to issue types.
"""
model = IssueType
serializer_class = IssueTypeAPISerializer
permission_classes = [ProjectEntityPermission]
webhook_event = "issue_type"
logo_icons = [
"Activity",
"AlertCircle",
"Archive",
"Bell",
"Calendar",
"Camera",
"Check",
"Clock",
"Code",
"Database",
"Download",
"Edit",
"File",
"Folder",
"Globe",
"Heart",
"Home",
"Mail",
"Search",
"User",
]
logo_backgrounds = [
"#EF5974",
"#FF7474",
"#FC964D",
"#1FA191",
"#6DBCF5",
"#748AFF",
"#4C49F8",
"#5D407A",
"#999AA0",
]
model = IssueType
serializer_class = IssueTypeAPISerializer
permission_classes = [ProjectEntityPermission]
webhook_event = "issue_type"
@property
def workspace_slug(self):
return self.kwargs.get("slug", None)
@property
def project_id(self):
return self.kwargs.get("project_id", None)
@property
def type_id(self):
return self.kwargs.get("type_id", None)
def generate_logo_prop(self):
return {
"in_use": "icon",
"icon": {
"name": self.logo_icons[random.randint(0, len(self.logo_icons) - 1)],
"background_color": self.logo_backgrounds[
random.randint(0, len(self.logo_backgrounds) - 1)
],
},
}
def get_queryset(self):
return self.model.objects.filter(
workspace__slug=self.kwargs.get("slug"),
project_issue_types__project_id=self.kwargs.get("project_id"),
is_epic=False,
)
# list issue types and get issue type by id
@check_feature_flag(FeatureFlag.ISSUE_TYPES)
@issue_type_docs(
operation_id="list_issue_types",
description="List all issue types for a project",
summary="List issue types",
responses={
200: OpenApiResponse(
description="Issue types",
response=IssueTypeAPISerializer(many=True),
),
404: OpenApiResponse(description="Issue type not found"),
},
)
def get(self, request, slug, project_id):
# list of issue types
issue_types = self.get_queryset()
serializer = self.serializer_class(issue_types, many=True)
return Response(serializer.data, status=status.HTTP_200_OK)
# create issue type
@issue_type_docs(
operation_id="create_issue_type",
description="Create a new issue type for a project",
summary="Create a new issue type",
request=OpenApiRequest(
request=IssueTypeAPISerializer,
examples=[
OpenApiExample(
"IssueTypeAPISerializer",
value={
"name": "Bug",
"description": "A bug is a problem with the software that prevents it from working as expected.",
"external_id": "1234567890",
"external_source": "github",
},
description="Example request for creating an issue type",
),
],
),
responses={
201: OpenApiResponse(
description="Issue type created", response=IssueTypeAPISerializer
),
409: OpenApiResponse(
description="Issue type with the same external id and external source already exists"
),
},
)
@check_feature_flag(FeatureFlag.ISSUE_TYPES)
def post(self, request, slug, project_id):
with transaction.atomic():
workspace = Workspace.objects.get(slug=slug)
project = Project.objects.get(pk=project_id)
# check if issue type with the same external id and external source already exists
# return the issue type id if it exists
external_id = request.data.get("external_id")
external_source = request.data.get("external_source")
external_existing_issue_type = (
self.get_queryset()
.filter(external_id=external_id, external_source=external_source)
.first()
)
if external_id and external_source and external_existing_issue_type:
return Response(
{
"error": "Work item type with the same external id and external source already exists",
"id": str(external_existing_issue_type.id),
},
status=status.HTTP_409_CONFLICT,
)
# creating issue type
issue_type_serializer = self.serializer_class(data=request.data)
issue_type_serializer.is_valid(raise_exception=True)
issue_type_serializer.save(
workspace=workspace, logo_props=self.generate_logo_prop()
)
# adding the issue type to the project
project_issue_type_serializer = ProjectIssueTypeAPISerializer(
data={"issue_type": issue_type_serializer.data["id"]}
)
project_issue_type_serializer.is_valid(raise_exception=True)
project_issue_type_serializer.save(project=project, level=0)
# getting the issue type
issue_type = self.get_queryset().get(pk=issue_type_serializer.data["id"])
serializer = self.serializer_class(issue_type)
return Response(serializer.data, status=status.HTTP_201_CREATED)
class IssueTypeDetailAPIEndpoint(BaseAPIView):
"""
This viewset automatically provides `list`, `create`, `retrieve`,
`update` and `destroy` actions related to issue types.
"""
logo_icons = [
"Activity",
"AlertCircle",
"Archive",
"Bell",
"Calendar",
"Camera",
"Check",
"Clock",
"Code",
"Database",
"Download",
"Edit",
"File",
"Folder",
"Globe",
"Heart",
"Home",
"Mail",
"Search",
"User",
]
logo_backgrounds = [
"#EF5974",
"#FF7474",
"#FC964D",
"#1FA191",
"#6DBCF5",
"#748AFF",
"#4C49F8",
"#5D407A",
"#999AA0",
]
model = IssueType
serializer_class = IssueTypeAPISerializer
permission_classes = [ProjectEntityPermission]
webhook_event = "issue_type"
@property
def workspace_slug(self):
return self.kwargs.get("slug", None)
@property
def project_id(self):
return self.kwargs.get("project_id", None)
@property
def type_id(self):
return self.kwargs.get("type_id", None)
def generate_logo_prop(self):
return {
"in_use": "icon",
"icon": {
"name": self.logo_icons[random.randint(0, len(self.logo_icons) - 1)],
"background_color": self.logo_backgrounds[
random.randint(0, len(self.logo_backgrounds) - 1)
],
},
}
def get_queryset(self):
return self.model.objects.filter(
workspace__slug=self.kwargs.get("slug"),
project_issue_types__project_id=self.kwargs.get("project_id"),
is_epic=False,
)
# list issue types and get issue type by id
@check_feature_flag(FeatureFlag.ISSUE_TYPES)
@issue_type_docs(
operation_id="retrieve_issue_type",
summary="Retrieve an issue type by id",
description="Retrieve an issue type by id",
responses={
200: OpenApiResponse(
description="Issue types", response=IssueTypeAPISerializer
),
404: OpenApiResponse(description="Issue type not found"),
},
)
def get(self, request, slug, project_id, type_id):
issue_type = self.get_queryset().get(pk=type_id)
issue_type = self.get_queryset().annotate(
project_ids=Coalesce(
Subquery(
ProjectIssueType.objects.filter(
issue_type=OuterRef("pk"), workspace__slug=slug
)
.values("issue_type")
.annotate(project_ids=ArrayAgg("project_id", distinct=True))
.values("project_ids")
),
[],
)
)
serializer = self.serializer_class(issue_type, many=True)
return Response(serializer.data, status=status.HTTP_200_OK)
# update issue type by id
@issue_type_docs(
operation_id="update_issue_type",
summary="Update an issue type",
description="Update an issue type",
request=OpenApiRequest(
request=IssueTypeAPISerializer,
examples=[
OpenApiExample(
"IssueTypeAPISerializer",
value={
"name": "Bug",
"description": "A bug is a problem with the software that prevents it from working as expected.",
"external_id": "1234567890",
"external_source": "github",
},
description="Example request for updating an issue type",
),
],
),
responses={
200: OpenApiResponse(
description="Issue type updated", response=IssueTypeAPISerializer
),
409: OpenApiResponse(
description="Issue type with the same external id and external source already exists"
),
},
)
@check_feature_flag(FeatureFlag.ISSUE_TYPES)
def patch(self, request, slug, project_id, type_id):
with transaction.atomic():
issue_type = self.get_queryset().get(pk=type_id)
data = request.data
# check if the issue type is the default issue type and if the is_active field is being updated to false
if (
issue_type.is_default
and get_boolean_value(request.data.get("is_active")) is False
):
return Response(
{
"error": "Default work item type's is_active field cannot be false"
},
status=status.HTTP_400_BAD_REQUEST,
)
issue_type_serializer = self.serializer_class(
issue_type, data=data, partial=True
)
issue_type_serializer.is_valid(raise_exception=True)
# check if issue type with the same external id and external source already exists
external_id = request.data.get("external_id")
external_source = request.data.get("external_source")
external_existing_issue_type = (
self.get_queryset()
.filter(external_id=external_id, external_source=external_source)
.first()
)
# don't allow updating the external id if it already exists in another issue type
# checking if the external id is being updated to a different issue type
if external_id and external_existing_issue_type.id != issue_type.id:
return Response(
{
"error": "Work item type with the same external id and external source already exists",
"id": str(issue_type.id),
},
status=status.HTTP_409_CONFLICT,
)
issue_type_serializer.save()
return Response(issue_type_serializer.data, status=status.HTTP_200_OK)
# delete issue type by id
@issue_type_docs(
operation_id="delete_issue_type",
summary="Delete an issue type",
description="Delete an issue type",
responses={
204: OpenApiResponse(description="Issue type deleted"),
400: OpenApiResponse(
description="Default work item type cannot be deleted"
),
},
)
@check_feature_flag(FeatureFlag.ISSUE_TYPES)
def delete(self, request, slug, project_id, type_id):
issue_type = self.get_queryset().get(pk=type_id)
# check if the issue type is the default issue type
if issue_type.is_default:
return Response(
{"error": "Default work item type cannot be deleted"},
status=status.HTTP_400_BAD_REQUEST,
)
# check if the issue type is being used in any issues
if Issue.objects.filter(project_id=project_id, type_id=type_id).exists():
return Response(
{"error": "Work item type with existing issues cannot be deleted"},
status=status.HTTP_400_BAD_REQUEST,
)
issue_type.delete()
return Response(status=status.HTTP_204_NO_CONTENT)
+102 -3
View File
@@ -1,3 +1,12 @@
# Python imports
import uuid
# Django imports
from django.core.validators import validate_email
from django.contrib.auth.hashers import make_password
from django.core.exceptions import ValidationError
# Third Party imports
from rest_framework.response import Response
from rest_framework import status
@@ -9,7 +18,7 @@ from drf_spectacular.utils import (
# Module imports
from .base import BaseAPIView
from plane.api.serializers import UserLiteSerializer
from plane.db.models import User, Workspace, WorkspaceMember, ProjectMember
from plane.db.models import User, Workspace, WorkspaceMember, ProjectMember, Project
from plane.app.permissions import ProjectMemberPermission, WorkSpaceAdminPermission
from plane.utils.openapi import (
WORKSPACE_SLUG_PARAMETER,
@@ -22,6 +31,8 @@ from plane.utils.openapi import (
PROJECT_MEMBER_EXAMPLE,
)
from plane.payment.bgtasks.member_sync_task import member_sync_task
class WorkspaceMemberAPIEndpoint(BaseAPIView):
permission_classes = [WorkSpaceAdminPermission]
@@ -100,7 +111,7 @@ class ProjectMemberAPIEndpoint(BaseAPIView):
responses={
200: OpenApiResponse(
description="List of project members with their roles",
response=UserLiteSerializer,
response=UserLiteSerializer(many=True),
examples=[PROJECT_MEMBER_EXAMPLE],
),
401: UNAUTHORIZED_RESPONSE,
@@ -121,7 +132,6 @@ class ProjectMemberAPIEndpoint(BaseAPIView):
{"error": "Provided workspace does not exist"},
status=status.HTTP_400_BAD_REQUEST,
)
# Get the workspace members that are present inside the workspace
project_members = ProjectMember.objects.filter(project_id=project_id, workspace__slug=slug).values_list(
"member_id", flat=True
@@ -131,3 +141,92 @@ class ProjectMemberAPIEndpoint(BaseAPIView):
users = UserLiteSerializer(User.objects.filter(id__in=project_members), many=True).data
return Response(users, status=status.HTTP_200_OK)
def post(self, request, slug, project_id):
# ------------------- Validation -------------------
if (
request.data.get("email") is None
or request.data.get("display_name") is None
):
return Response(
{
"error": "Expected email, display_name, workspace_slug, project_id, one or more of the fields are missing."
},
status=status.HTTP_400_BAD_REQUEST,
)
email = request.data.get("email")
try:
validate_email(email)
except ValidationError:
return Response(
{"error": "Invalid email provided"}, status=status.HTTP_400_BAD_REQUEST
)
workspace = Workspace.objects.filter(slug=slug).first()
project = Project.objects.filter(pk=project_id).first()
if not all([workspace, project]):
return Response(
{"error": "Provided workspace or project does not exist"},
status=status.HTTP_400_BAD_REQUEST,
)
user = User.objects.filter(email=email).first()
workspace_member = None
project_member = None
if user:
# Check if user is part of the workspace
workspace_member = WorkspaceMember.objects.filter(
workspace=workspace, member=user
).first()
if workspace_member:
# Check if user is part of the project
project_member = ProjectMember.objects.filter(
project=project, member=user
).first()
if project_member:
return Response(
{"error": "User is already part of the workspace and project"},
status=status.HTTP_400_BAD_REQUEST,
)
# If user does not exist, create the user
if not user:
user = User.objects.create(
email=email,
display_name=request.data.get("display_name"),
first_name=request.data.get("first_name", ""),
last_name=request.data.get("last_name", ""),
username=uuid.uuid4().hex,
password=make_password(uuid.uuid4().hex),
is_password_autoset=True,
is_active=False,
avatar_asset_id=request.data.get("avatar_asset_id", None),
)
user.save()
# Create a workspace member for the user if not already a member
if not workspace_member:
workspace_member = WorkspaceMember.objects.create(
workspace=workspace, member=user, role=request.data.get("role", 5)
)
workspace_member.save()
# Create a project member for the user if not already a member
if not project_member:
project_member = ProjectMember.objects.create(
project=project, member=user, role=request.data.get("role", 5)
)
project_member.save()
# Run the member sync task for the workspace
member_sync_task.delay(workspace.slug)
# Serialize the user and return the response
user_data = UserLiteSerializer(user).data
return Response(user_data, status=status.HTTP_201_CREATED)
+16 -1
View File
@@ -265,6 +265,21 @@ class ModuleListCreateAPIEndpoint(BaseAPIView):
Retrieve all modules in a project or get details of a specific module.
Returns paginated results with module statistics and member information.
"""
external_id = request.GET.get("external_id")
external_source = request.GET.get("external_source")
if external_id and external_source:
module = Module.objects.get(
external_id=external_id,
external_source=external_source,
workspace__slug=slug,
project_id=project_id,
)
return Response(
ModuleSerializer(module, fields=self.fields, expand=self.expand).data,
status=status.HTTP_200_OK,
)
return self.paginate(
request=request,
queryset=(self.get_queryset().filter(archived_at__isnull=True)),
@@ -650,7 +665,7 @@ class ModuleIssueListCreateAPIEndpoint(BaseAPIView):
responses={
200: OpenApiResponse(
description="Module issues added",
response=ModuleIssueSerializer,
response=ModuleIssueSerializer(many=True),
examples=[MODULE_ISSUE_EXAMPLE],
),
400: REQUIRED_FIELDS_RESPONSE,
+53
View File
@@ -156,6 +156,20 @@ class ProjectListCreateAPIEndpoint(BaseAPIView):
Retrieve all projects in a workspace or get details of a specific project.
Returns projects ordered by user's custom sort order with member information.
"""
external_id = request.GET.get("external_id")
external_source = request.GET.get("external_source")
if external_id and external_source:
project = Project.objects.get(
external_id=external_id,
external_source=external_source,
workspace__slug=slug,
)
return Response(
ProjectSerializer(project, fields=self.fields, expand=self.expand).data,
status=status.HTTP_200_OK,
)
sort_order_query = ProjectMember.objects.filter(
member=request.user,
project_id=OuterRef("pk"),
@@ -211,6 +225,27 @@ class ProjectListCreateAPIEndpoint(BaseAPIView):
workspace = Workspace.objects.get(slug=slug)
serializer = ProjectCreateSerializer(data={**request.data}, context={"workspace_id": workspace.id})
if serializer.is_valid():
if (
request.data.get("external_id")
and request.data.get("external_source")
and Project.objects.filter(
external_id=request.data.get("external_id"),
external_source=request.data.get("external_source"),
workspace__slug=slug,
).exists()
):
project = Project.objects.filter(
external_id=request.data.get("external_id"),
external_source=request.data.get("external_source"),
workspace__slug=slug,
).first()
return Response(
{
"error": "Project with the same external id and external source already exists",
"id": str(project.id),
},
status=status.HTTP_409_CONFLICT,
)
serializer.save()
# Add the user as Administrator to the project
@@ -457,6 +492,24 @@ class ProjectDetailAPIEndpoint(BaseAPIView):
)
if serializer.is_valid():
# don't allow external id and external source to be changed
# if they are already set for an existing project
if (
request.data.get("external_id")
and request.data.get("external_source")
and Project.objects.filter(
external_id=request.data.get("external_id"),
external_source=request.data.get("external_source"),
workspace__slug=slug,
).exists()
):
return Response(
{
"error": "Project with the same external id and external source already exists",
"id": str(project.id),
},
status=status.HTTP_409_CONFLICT,
)
serializer.save()
if serializer.data["intake_view"]:
intake = Intake.objects.filter(project=project, is_default=True).first()
+15
View File
@@ -148,6 +148,21 @@ class StateListCreateAPIEndpoint(BaseAPIView):
Retrieve all workflow states for a project.
Returns paginated results when listing all states.
"""
external_id = request.GET.get("external_id")
external_source = request.GET.get("external_source")
if external_id and external_source:
state = State.objects.get(
external_id=external_id,
external_source=external_source,
workspace__slug=slug,
project_id=project_id,
)
return Response(
StateSerializer(state, fields=self.fields, expand=self.expand).data,
status=status.HTTP_200_OK,
)
return self.paginate(
request=request,
queryset=(self.get_queryset()),
-1
View File
@@ -10,7 +10,6 @@ from plane.db.models import User
from plane.utils.openapi.decorators import user_docs
from plane.utils.openapi import USER_EXAMPLE
class UserEndpoint(BaseAPIView):
serializer_class = UserLiteSerializer
model = User
@@ -0,0 +1,7 @@
from rest_framework.authentication import SessionAuthentication
class BaseSessionAuthentication(SessionAuthentication):
# Disable csrf for the rest apis
def enforce_csrf(self, request):
return
+55 -19
View File
@@ -1,9 +1,16 @@
from plane.db.models import WorkspaceMember, ProjectMember
# Python imports
from enum import Enum
from functools import wraps
# Third party imports
from rest_framework.response import Response
from rest_framework import status
from enum import Enum
# Module imports
from plane.db.models import WorkspaceMember, ProjectMember
from plane.ee.models import TeamspaceProject, TeamspaceMember
from plane.payment.flags.flag_decorator import check_workspace_feature_flag
from plane.payment.flags.flag import FeatureFlag
class ROLE(Enum):
@@ -12,13 +19,19 @@ class ROLE(Enum):
GUEST = 5
def allow_permission(allowed_roles, level="PROJECT", creator=False, model=None):
def allow_permission(
allowed_roles,
level="PROJECT",
creator=False,
field="created_by",
model=None,
):
def decorator(view_func):
@wraps(view_func)
def _wrapped_view(instance, request, *args, **kwargs):
# Check for creator if required
# Check for ownership if required
if creator and model:
obj = model.objects.filter(id=kwargs["pk"], created_by=request.user).exists()
obj = model.objects.filter(id=kwargs["pk"], **{field: request.user}).exists()
if obj:
return view_func(instance, request, *args, **kwargs)
@@ -46,21 +59,44 @@ def allow_permission(allowed_roles, level="PROJECT", creator=False, model=None):
# Return if the user has the allowed role else if they are workspace admin and part of the project regardless of the role # noqa: E501
if is_user_has_allowed_role:
return view_func(instance, request, *args, **kwargs)
elif (
ProjectMember.objects.filter(
member=request.user,
workspace__slug=kwargs["slug"],
project_id=kwargs["project_id"],
is_active=True,
).exists()
and WorkspaceMember.objects.filter(
member=request.user,
workspace__slug=kwargs["slug"],
role=ROLE.ADMIN.value,
is_active=True,
).exists()
# Return if the user is workspace admin and is also part of the project or a teamspace member
if WorkspaceMember.objects.filter(
member=request.user,
workspace__slug=kwargs["slug"],
role=ROLE.ADMIN.value,
is_active=True,
).exists():
teamspace_ids = TeamspaceProject.objects.filter(
workspace__slug=kwargs["slug"], project_id=kwargs["project_id"]
).values_list("team_space_id", flat=True)
if (
ProjectMember.objects.filter(
member=request.user,
workspace__slug=kwargs["slug"],
project_id=kwargs["project_id"],
is_active=True,
).exists()
or TeamspaceMember.objects.filter(member=request.user, team_space_id__in=teamspace_ids).exists()
):
return view_func(instance, request, *args, **kwargs)
#
# Check if the user is member of the team space
# if scope is project further check if user is member of the team space
# only if member is present in allowed roles
#
if ROLE.MEMBER.value in allowed_role_values and check_workspace_feature_flag(
feature_key=FeatureFlag.TEAMSPACES,
slug=kwargs["slug"],
user_id=request.user.id,
):
return view_func(instance, request, *args, **kwargs)
teamspace_ids = TeamspaceProject.objects.filter(
workspace__slug=kwargs["slug"], project_id=kwargs["project_id"]
).values_list("team_space_id", flat=True)
if TeamspaceMember.objects.filter(member=request.user, team_space_id__in=teamspace_ids).exists():
return view_func(instance, request, *args, **kwargs)
# Return permission denied if no conditions are met
return Response(
+108 -9
View File
@@ -1,13 +1,60 @@
# Third Party imports
from rest_framework.permissions import SAFE_METHODS, BasePermission
from rest_framework.request import Request
# Module import
from plane.db.models import ProjectMember, WorkspaceMember
from plane.ee.models import TeamspaceProject, TeamspaceMember
from plane.payment.flags.flag_decorator import check_workspace_feature_flag
from plane.payment.flags.flag import FeatureFlag
from plane.db.models.project import ROLE
def check_teamspace_membership(view, request: Request) -> bool:
"""
Check if the user is a member of any teamspace associated with the project.
Args:
view: The view instance containing workspace_slug and project_id
request (Request): The incoming request object containing user information
Returns:
bool: True if user is a member of any associated teamspace, False otherwise
Note:
This function first checks if teamspaces feature is enabled for the workspace
before performing the membership check.
"""
# check the user is part of the teamspace if the project is attached to any.
if check_workspace_feature_flag(
feature_key=FeatureFlag.TEAMSPACES,
slug=view.workspace_slug,
user_id=request.user.id,
):
## Get all the teamspace ids that the project is attached to.
teamspace_ids = TeamspaceProject.objects.filter(
workspace__slug=view.workspace_slug, project_id=view.project_id
).values_list("team_space_id", flat=True)
# return True if the user is a member of any of the teamspace
return TeamspaceMember.objects.filter(
member=request.user, team_space_id__in=teamspace_ids
).exists()
return False
class ProjectBasePermission(BasePermission):
def has_permission(self, request, view):
"""
Base permission class for project-related operations.
This class implements basic permission checks for project access:
- Anonymous users are denied access
- READ operations require workspace membership
- CREATE operations require workspace admin/member role
- UPDATE operations require project admin role
"""
def has_permission(self, request, view) -> bool:
if request.user.is_anonymous:
return False
@@ -50,7 +97,15 @@ class ProjectBasePermission(BasePermission):
class ProjectMemberPermission(BasePermission):
def has_permission(self, request, view):
"""
Permission class for project member operations.
Extends the base permissions with additional checks:
- Allows teamspace members access if the project is associated with their teamspace
- Provides different permission levels for different operations
"""
def has_permission(self, request, view) -> bool:
if request.user.is_anonymous:
return False
@@ -69,7 +124,7 @@ class ProjectMemberPermission(BasePermission):
).exists()
## Only Project Admins can update project attributes
return ProjectMember.objects.filter(
is_project_member = ProjectMember.objects.filter(
workspace__slug=view.workspace_slug,
member=request.user,
role__in=[ROLE.ADMIN.value, ROLE.MEMBER.value],
@@ -77,33 +132,59 @@ class ProjectMemberPermission(BasePermission):
is_active=True,
).exists()
# If the user is already an admin or member return True
if is_project_member:
return True
# check the user is part of the teamspace if the project is attached to any.
return check_teamspace_membership(view=view, request=request)
class ProjectEntityPermission(BasePermission):
def has_permission(self, request, view):
"""
Permission class for project entity operations.
Handles permissions for project-related entities with additional features:
- Supports project identification by identifier
- Implements teamspace-based access control
- Different permission levels for read/write operations
"""
def has_permission(self, request, view) -> bool:
if request.user.is_anonymous:
return False
# Handle requests based on project__identifier
if hasattr(view, "project_identifier") and view.project_identifier:
if request.method in SAFE_METHODS:
return ProjectMember.objects.filter(
is_project_member = ProjectMember.objects.filter(
workspace__slug=view.workspace_slug,
member=request.user,
project__identifier=view.project_identifier,
is_active=True,
).exists()
if is_project_member:
return True
else:
return check_teamspace_membership(view=view, request=request)
## Safe Methods -> Handle the filtering logic in queryset
if request.method in SAFE_METHODS:
return ProjectMember.objects.filter(
is_project_member = ProjectMember.objects.filter(
workspace__slug=view.workspace_slug,
member=request.user,
project_id=view.project_id,
is_active=True,
).exists()
if is_project_member:
return True
else:
return check_teamspace_membership(view=view, request=request)
## Only project members or admins can create and edit the project attributes
return ProjectMember.objects.filter(
is_project_member = ProjectMember.objects.filter(
workspace__slug=view.workspace_slug,
member=request.user,
role__in=[ROLE.ADMIN.value, ROLE.MEMBER.value],
@@ -111,15 +192,33 @@ class ProjectEntityPermission(BasePermission):
is_active=True,
).exists()
if is_project_member:
return True
else:
return check_teamspace_membership(view=view, request=request)
class ProjectLitePermission(BasePermission):
def has_permission(self, request, view):
"""
Lightweight permission class for basic project access control.
Implements simplified permission checks:
- Verifies project membership
- Falls back to teamspace membership check
"""
def has_permission(self, request, view) -> bool:
if request.user.is_anonymous:
return False
return ProjectMember.objects.filter(
is_project_member = ProjectMember.objects.filter(
workspace__slug=view.workspace_slug,
member=request.user,
project_id=view.project_id,
is_active=True,
).exists()
if is_project_member:
return True
else:
return check_teamspace_membership(view=view, request=request)
+17 -2
View File
@@ -1,4 +1,4 @@
from .base import BaseSerializer
from .base import BaseSerializer, DynamicBaseSerializer
from .user import (
UserSerializer,
UserLiteSerializer,
@@ -23,6 +23,7 @@ from .workspace import (
WorkspaceRecentVisitSerializer,
WorkspaceHomePreferenceSerializer,
StickySerializer,
WorkspaceUserMeSerializer,
)
from .project import (
ProjectSerializer,
@@ -33,7 +34,6 @@ from .project import (
ProjectIdentifierSerializer,
ProjectLiteSerializer,
ProjectMemberLiteSerializer,
DeployBoardSerializer,
ProjectMemberAdminSerializer,
ProjectPublicMemberSerializer,
ProjectMemberRoleSerializer,
@@ -45,6 +45,7 @@ from .cycle import (
CycleIssueSerializer,
CycleWriteSerializer,
CycleUserPropertiesSerializer,
EntityProgressSerializer,
)
from .asset import FileAssetSerializer
from .issue import (
@@ -75,6 +76,7 @@ from .issue import (
IssueVersionDetailSerializer,
IssueDescriptionVersionDetailSerializer,
IssueListDetailSerializer,
IssueDuplicateSerializer,
)
from .module import (
@@ -92,10 +94,12 @@ from .importer import ImporterSerializer
from .page import (
PageSerializer,
PageLiteSerializer,
PageDetailSerializer,
PageVersionSerializer,
PageBinaryUpdateSerializer,
PageVersionDetailSerializer,
PageUserSerializer,
)
from .estimate import (
@@ -128,3 +132,14 @@ from .draft import (
DraftIssueSerializer,
DraftIssueDetailSerializer,
)
from .integration import (
IntegrationSerializer,
WorkspaceIntegrationSerializer,
GithubIssueSyncSerializer,
GithubRepositorySerializer,
GithubRepositorySyncSerializer,
GithubCommentSyncSerializer,
SlackProjectSyncSerializer,
)
from .deploy_board import DeployBoardSerializer
+1
View File
@@ -3,6 +3,7 @@ from rest_framework import serializers
class BaseSerializer(serializers.ModelSerializer):
id = serializers.PrimaryKeyRelatedField(read_only=True)
deleted_at = serializers.ReadOnlyField()
class DynamicBaseSerializer(BaseSerializer):
+15 -1
View File
@@ -3,9 +3,11 @@ from rest_framework import serializers
# Module imports
from .base import BaseSerializer
from .issue import IssueStateSerializer
from plane.db.models import Cycle, CycleIssue, CycleUserProperties
from plane.utils.timezone_converter import convert_to_utc
from plane.ee.models import EntityProgress
class CycleWriteSerializer(BaseSerializer):
@@ -36,7 +38,13 @@ class CycleWriteSerializer(BaseSerializer):
class Meta:
model = Cycle
fields = "__all__"
read_only_fields = ["workspace", "project", "owned_by", "archived_at"]
read_only_fields = [
"workspace",
"project",
"owned_by",
"archived_at",
"version",
]
class CycleSerializer(BaseSerializer):
@@ -100,3 +108,9 @@ class CycleUserPropertiesSerializer(BaseSerializer):
model = CycleUserProperties
fields = "__all__"
read_only_fields = ["workspace", "project", "cycle", "user"]
class EntityProgressSerializer(BaseSerializer):
class Meta:
model = EntityProgress
fields = "__all__"
@@ -0,0 +1,15 @@
# Module imports
from .base import BaseSerializer
from plane.app.serializers.project import ProjectLiteSerializer
from plane.app.serializers.workspace import WorkspaceLiteSerializer
from plane.db.models import DeployBoard
class DeployBoardSerializer(BaseSerializer):
project_details = ProjectLiteSerializer(read_only=True, source="project")
workspace_detail = WorkspaceLiteSerializer(read_only=True, source="workspace")
class Meta:
model = DeployBoard
fields = "__all__"
read_only_fields = ["workspace", "project", "anchor"]
+18 -1
View File
@@ -12,6 +12,7 @@ from plane.db.models import (
Label,
State,
DraftIssue,
IssueType,
DraftIssueAssignee,
DraftIssueLabel,
DraftIssueCycle,
@@ -34,6 +35,9 @@ class DraftIssueCreateSerializer(BaseSerializer):
parent_id = serializers.PrimaryKeyRelatedField(
source="parent", queryset=Issue.objects.all(), required=False, allow_null=True
)
type_id = serializers.PrimaryKeyRelatedField(
source="type", queryset=IssueType.objects.all(), required=False, allow_null=True
)
label_ids = serializers.ListField(
child=serializers.PrimaryKeyRelatedField(queryset=Label.objects.all()),
write_only=True,
@@ -145,8 +149,21 @@ class DraftIssueCreateSerializer(BaseSerializer):
workspace_id = self.context["workspace_id"]
project_id = self.context["project_id"]
issue_type = validated_data.pop("type", None)
if not issue_type:
# Get default issue type
issue_type = IssueType.objects.filter(
project_issue_types__project_id=project_id,
is_epic=False,
is_default=True,
).first()
issue_type = issue_type
# Create Issue
issue = DraftIssue.objects.create(**validated_data, workspace_id=workspace_id, project_id=project_id)
issue = DraftIssue.objects.create(
**validated_data, workspace_id=workspace_id, project_id=project_id, type=issue_type
)
# Issue Audit Users
created_by_id = issue.created_by_id
@@ -1,6 +1,7 @@
from rest_framework import serializers
from plane.db.models import UserFavorite, Cycle, Module, Issue, IssueView, Page, Project
from plane.ee.models import Dashboard
class ProjectFavoriteLiteSerializer(serializers.ModelSerializer):
@@ -39,6 +40,12 @@ class ViewFavoriteSerializer(serializers.ModelSerializer):
fields = ["id", "name", "logo_props", "project_id"]
class DashboardFavoriteLiteSerializer(serializers.ModelSerializer):
class Meta:
model = Dashboard
fields = ["id", "name"]
def get_entity_model_and_serializer(entity_type):
entity_map = {
"cycle": (Cycle, CycleFavoriteLiteSerializer),
@@ -47,6 +54,7 @@ def get_entity_model_and_serializer(entity_type):
"view": (IssueView, ViewFavoriteSerializer),
"page": (Page, PageFavoriteLiteSerializer),
"project": (Project, ProjectFavoriteLiteSerializer),
"workspace_dashboard": (Dashboard, DashboardFavoriteLiteSerializer),
"folder": (None, None),
}
return entity_map.get(entity_type, (None, None))
@@ -0,0 +1,8 @@
from .base import IntegrationSerializer, WorkspaceIntegrationSerializer
from .github import (
GithubRepositorySerializer,
GithubRepositorySyncSerializer,
GithubIssueSyncSerializer,
GithubCommentSyncSerializer,
)
from .slack import SlackProjectSyncSerializer
@@ -0,0 +1,18 @@
# Module imports
from plane.app.serializers import BaseSerializer
from plane.db.models import Integration, WorkspaceIntegration
class IntegrationSerializer(BaseSerializer):
class Meta:
model = Integration
fields = "__all__"
read_only_fields = ["verified"]
class WorkspaceIntegrationSerializer(BaseSerializer):
integration_detail = IntegrationSerializer(read_only=True, source="integration")
class Meta:
model = WorkspaceIntegration
fields = "__all__"
@@ -0,0 +1,36 @@
# Module imports
from plane.app.serializers import BaseSerializer
from plane.db.models import (
GithubIssueSync,
GithubRepository,
GithubRepositorySync,
GithubCommentSync,
)
class GithubRepositorySerializer(BaseSerializer):
class Meta:
model = GithubRepository
fields = "__all__"
class GithubRepositorySyncSerializer(BaseSerializer):
repo_detail = GithubRepositorySerializer(source="repository")
class Meta:
model = GithubRepositorySync
fields = "__all__"
class GithubIssueSyncSerializer(BaseSerializer):
class Meta:
model = GithubIssueSync
fields = "__all__"
read_only_fields = ["project", "workspace", "repository_sync"]
class GithubCommentSyncSerializer(BaseSerializer):
class Meta:
model = GithubCommentSync
fields = "__all__"
read_only_fields = ["project", "workspace", "repository_sync", "issue_sync"]
@@ -0,0 +1,10 @@
# Module imports
from plane.app.serializers import BaseSerializer
from plane.db.models import SlackProjectSync
class SlackProjectSyncSerializer(BaseSerializer):
class Meta:
model = SlackProjectSync
fields = "__all__"
read_only_fields = ["project", "workspace", "workspace_integration"]
+226 -29
View File
@@ -38,11 +38,15 @@ from plane.db.models import (
IssueDescriptionVersion,
ProjectMember,
EstimatePoint,
IssueType,
)
from plane.utils.content_validator import (
validate_html_content,
validate_binary_data,
)
from plane.ee.models import Customer, TeamspaceProject, TeamspaceMember
from plane.payment.flags.flag_decorator import check_workspace_feature_flag
from plane.payment.flags.flag import FeatureFlag
class IssueFlatSerializer(BaseSerializer):
@@ -61,6 +65,7 @@ class IssueFlatSerializer(BaseSerializer):
"sequence_id",
"sort_order",
"is_draft",
"type_id",
]
@@ -80,6 +85,9 @@ class IssueCreateSerializer(BaseSerializer):
state_id = serializers.PrimaryKeyRelatedField(
source="state", queryset=State.objects.all(), required=False, allow_null=True
)
type_id = serializers.PrimaryKeyRelatedField(
source="type", queryset=IssueType.objects.all(), required=False, allow_null=True
)
parent_id = serializers.PrimaryKeyRelatedField(
source="parent", queryset=Issue.objects.all(), required=False, allow_null=True
)
@@ -140,12 +148,45 @@ class IssueCreateSerializer(BaseSerializer):
# Validate assignees are from project
if attrs.get("assignee_ids", []):
attrs["assignee_ids"] = ProjectMember.objects.filter(
project_id=self.context["project_id"],
role__gte=15,
is_active=True,
member_id__in=attrs["assignee_ids"],
).values_list("member_id", flat=True)
assignee_ids = attrs["assignee_ids"]
if check_workspace_feature_flag(
feature_key=FeatureFlag.TEAMSPACES,
user_id=self.context["user_id"],
slug=self.context["slug"],
):
# Then get all the teamspace members for the project with project member
teamspace_ids = TeamspaceProject.objects.filter(
project_id=self.context["project_id"],
).values_list("team_space_id", flat=True)
teamspace_member_ids = list(
TeamspaceMember.objects.filter(
team_space_id__in=teamspace_ids,
member_id__in=assignee_ids,
).values_list("member_id", flat=True)
)
project_member_ids = list(
ProjectMember.objects.filter(
project_id=self.context["project_id"],
role__gte=15,
is_active=True,
member_id__in=assignee_ids,
).values_list("member_id", flat=True)
)
# Then get all the teamspace members for the project with project member
attrs["assignee_ids"] = list(
set(teamspace_member_ids + project_member_ids)
)
else:
attrs["assignee_ids"] = ProjectMember.objects.filter(
project_id=self.context["project_id"],
role__gte=15,
is_active=True,
member_id__in=assignee_ids,
).values_list("member_id", flat=True)
# Validate labels are from project
if attrs.get("label_ids"):
@@ -188,6 +229,39 @@ class IssueCreateSerializer(BaseSerializer):
return attrs
def _is_valid_assignee(self, assignee_id, project_id):
"""
Check if an assignee is valid for the project.
Returns True if the assignee is either a project member or teamspace member (if enabled).
""" # noqa: E501
# Check if assignee is a valid project member
is_project_member = ProjectMember.objects.filter(
member_id=assignee_id,
project_id=project_id,
role__gte=15,
is_active=True,
).exists()
if is_project_member:
return True
# Check teamspace membership if feature is enabled
if check_workspace_feature_flag(
feature_key=FeatureFlag.TEAMSPACES,
user_id=self.context["user_id"],
slug=self.context["slug"],
):
teamspace_ids = TeamspaceProject.objects.filter(
project_id=project_id,
).values_list("team_space_id", flat=True)
return TeamspaceMember.objects.filter(
member_id=assignee_id,
team_space_id__in=teamspace_ids,
).exists()
return False
def create(self, validated_data):
assignees = validated_data.pop("assignee_ids", None)
labels = validated_data.pop("label_ids", None)
@@ -196,8 +270,21 @@ class IssueCreateSerializer(BaseSerializer):
workspace_id = self.context["workspace_id"]
default_assignee_id = self.context["default_assignee_id"]
issue_type = validated_data.pop("type", None)
if not issue_type:
# Get default issue type
issue_type = IssueType.objects.filter(
project_issue_types__project_id=project_id,
is_epic=False,
is_default=True,
).first()
issue_type = issue_type
# Create Issue
issue = Issue.objects.create(**validated_data, project_id=project_id)
issue = Issue.objects.create(
**validated_data, project_id=project_id, type=issue_type
)
# Issue Audit Users
created_by_id = issue.created_by_id
@@ -222,15 +309,9 @@ class IssueCreateSerializer(BaseSerializer):
except IntegrityError:
pass
else:
# Then assign it to default assignee, if it is a valid assignee
if (
default_assignee_id is not None
and ProjectMember.objects.filter(
member_id=default_assignee_id,
project_id=project_id,
role__gte=15,
is_active=True,
).exists()
# Assign to default assignee if valid
if default_assignee_id is not None and self._is_valid_assignee(
default_assignee_id, project_id
):
try:
IssueAssignee.objects.create(
@@ -276,7 +357,21 @@ class IssueCreateSerializer(BaseSerializer):
updated_by_id = instance.updated_by_id
if assignees is not None:
IssueAssignee.objects.filter(issue=instance).delete()
# Here because of validate the assignee_ids are list of uuids
current_assignees = IssueAssignee.objects.filter(
issue=instance
).values_list("assignee_id", flat=True)
# Get the assignees to add and assignees to remove from both the current and the new assignees #noqa: E501
assignees_to_add = list(set(assignees) - set(current_assignees))
assignees_to_remove = list(set(current_assignees) - set(assignees))
# Delete the assignees to remove
IssueAssignee.objects.filter(
issue=instance, assignee_id__in=assignees_to_remove
).delete()
# Create the assignees to add
try:
IssueAssignee.objects.bulk_create(
[
@@ -288,7 +383,7 @@ class IssueCreateSerializer(BaseSerializer):
created_by_id=created_by_id,
updated_by_id=updated_by_id,
)
for assignee_id in assignees
for assignee_id in assignees_to_add
],
batch_size=10,
ignore_conflicts=True,
@@ -297,19 +392,37 @@ class IssueCreateSerializer(BaseSerializer):
pass
if labels is not None:
IssueLabel.objects.filter(issue=instance).delete()
# Here we get label instances as a list
current_label_ids = list(
IssueLabel.objects.filter(issue=instance).values_list(
"label_id", flat=True
)
)
requested_label_ids = labels
# Get the labels to add and labels to remove from both the current and the new labels #noqa: E501
labels_to_add = list(set(requested_label_ids) - set(current_label_ids))
labels_to_remove = list(set(current_label_ids) - set(requested_label_ids))
# Delete the labels to remove
IssueLabel.objects.filter(
issue=instance, label_id__in=labels_to_remove
).delete()
# Create the labels to add
try:
IssueLabel.objects.bulk_create(
[
IssueLabel(
label_id=label_id,
label_id=label,
issue=instance,
project_id=project_id,
workspace_id=workspace_id,
created_by_id=created_by_id,
updated_by_id=updated_by_id,
)
for label_id in labels
for label in labels_to_add
],
batch_size=10,
ignore_conflicts=True,
@@ -317,7 +430,7 @@ class IssueCreateSerializer(BaseSerializer):
except IntegrityError:
pass
# Time updation occues even when other related models are updated
# Time related updates occurs even when other related models are updated
instance.updated_at = timezone.now()
return super().update(instance, validated_data)
@@ -383,7 +496,11 @@ class IssueRelationSerializer(BaseSerializer):
project_id = serializers.PrimaryKeyRelatedField(source="related_issue.project_id", read_only=True)
sequence_id = serializers.IntegerField(source="related_issue.sequence_id", read_only=True)
name = serializers.CharField(source="related_issue.name", read_only=True)
type_id = serializers.UUIDField(source="related_issue.type.id", read_only=True)
relation_type = serializers.CharField(read_only=True)
is_epic = serializers.BooleanField(
source="related_issue.type.is_epic", read_only=True
)
state_id = serializers.UUIDField(source="related_issue.state.id", read_only=True)
priority = serializers.CharField(source="related_issue.priority", read_only=True)
assignee_ids = serializers.ListField(
@@ -400,6 +517,8 @@ class IssueRelationSerializer(BaseSerializer):
"sequence_id",
"relation_type",
"name",
"type_id",
"is_epic",
"state_id",
"priority",
"assignee_ids",
@@ -423,7 +542,9 @@ class RelatedIssueSerializer(BaseSerializer):
project_id = serializers.PrimaryKeyRelatedField(source="issue.project_id", read_only=True)
sequence_id = serializers.IntegerField(source="issue.sequence_id", read_only=True)
name = serializers.CharField(source="issue.name", read_only=True)
type_id = serializers.UUIDField(source="issue.type.id", read_only=True)
relation_type = serializers.CharField(read_only=True)
is_epic = serializers.BooleanField(source="issue.type.is_epic", read_only=True)
state_id = serializers.UUIDField(source="issue.state.id", read_only=True)
priority = serializers.CharField(source="issue.priority", read_only=True)
assignee_ids = serializers.ListField(
@@ -440,6 +561,8 @@ class RelatedIssueSerializer(BaseSerializer):
"sequence_id",
"relation_type",
"name",
"type_id",
"is_epic",
"state_id",
"priority",
"assignee_ids",
@@ -458,6 +581,19 @@ class RelatedIssueSerializer(BaseSerializer):
]
class IssueDuplicateSerializer(BaseSerializer):
sequence_id = serializers.IntegerField(
source="related_issue.sequence_id", read_only=True
)
project_identifier = serializers.CharField(
source="related_issue.project.identifier", read_only=True
)
class Meta:
model = IssueRelation
fields = ["id", "project_id", "sequence_id", "project_identifier"]
class IssueAssigneeSerializer(BaseSerializer):
assignee_details = UserLiteSerializer(read_only=True, source="assignee")
@@ -661,7 +797,15 @@ class CommentReactionSerializer(BaseSerializer):
"created_by",
"updated_by",
]
read_only_fields = ["workspace", "project", "comment", "actor", "deleted_at", "created_by", "updated_by"]
read_only_fields = [
"workspace",
"project",
"comment",
"actor",
"deleted_at",
"created_by",
"updated_by",
]
class IssueVoteSerializer(BaseSerializer):
@@ -733,10 +877,28 @@ class IssueIntakeSerializer(DynamicBaseSerializer):
"created_at",
"label_ids",
"created_by",
"type_id",
]
read_only_fields = fields
class CustomerSerializer(DynamicBaseSerializer):
class Meta:
model = Customer
fields = [
"id",
"name",
"email",
"website_url",
"domain",
"contract_status",
"stage",
"employees",
"revenue",
"created_by",
]
class IssueSerializer(DynamicBaseSerializer):
# ids
cycle_id = serializers.PrimaryKeyRelatedField(read_only=True)
@@ -779,6 +941,7 @@ class IssueSerializer(DynamicBaseSerializer):
"link_count",
"is_draft",
"archived_at",
"type_id",
]
read_only_fields = fields
@@ -806,6 +969,7 @@ class IssueListDetailSerializer(serializers.Serializer):
"id": instance.id,
"name": instance.name,
"state_id": instance.state_id,
"type_id": instance.type_id,
"sort_order": instance.sort_order,
"completed_at": instance.completed_at,
"estimate_point": instance.estimate_point_id,
@@ -821,14 +985,23 @@ class IssueListDetailSerializer(serializers.Serializer):
"updated_by": instance.updated_by_id,
"is_draft": instance.is_draft,
"archived_at": instance.archived_at,
# Computed fields
"cycle_id": instance.cycle_id,
"cycle_id": instance.cycle_id if hasattr(instance, "cycle_id") else None,
"module_ids": self.get_module_ids(instance),
"label_ids": self.get_label_ids(instance),
"assignee_ids": self.get_assignee_ids(instance),
"sub_issues_count": instance.sub_issues_count,
"attachment_count": instance.attachment_count,
"link_count": instance.link_count,
"sub_issues_count": (
instance.sub_issues_count
if hasattr(instance, "sub_issues_count")
else None
),
"attachment_count": (
instance.attachment_count
if hasattr(instance, "attachment_count")
else None
),
"link_count": (
instance.link_count if hasattr(instance, "link_count") else None
),
}
# Handle expanded fields only when requested - using direct field access
@@ -887,9 +1060,16 @@ class IssueListDetailSerializer(serializers.Serializer):
class IssueLiteSerializer(DynamicBaseSerializer):
is_epic = serializers.SerializerMethodField()
def get_is_epic(self, obj):
if hasattr(obj, "type") and obj.type:
return obj.type.is_epic
return False
class Meta:
model = Issue
fields = ["id", "sequence_id", "project_id"]
fields = ["id", "sequence_id", "project_id", "type_id", "is_epic"]
read_only_fields = fields
@@ -897,15 +1077,32 @@ class IssueDetailSerializer(IssueSerializer):
description_html = serializers.CharField()
is_subscribed = serializers.BooleanField(read_only=True)
is_intake = serializers.BooleanField(read_only=True)
is_epic = serializers.BooleanField(read_only=True)
class Meta(IssueSerializer.Meta):
fields = IssueSerializer.Meta.fields + [
"description_html",
"is_subscribed",
"is_intake",
"is_epic",
]
read_only_fields = fields
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
slug = self.context.get("slug", None)
user_id = self.context.get("user_id", None)
# Check if the user has access to the customer request count
if slug and user_id:
if check_workspace_feature_flag(
feature_key=FeatureFlag.CUSTOMERS, slug=slug, user_id=user_id
):
self.fields["customer_request_ids"] = serializers.ListField(
read_only=True
)
self.fields["initiative_ids"] = serializers.ListField(read_only=True)
class IssuePublicSerializer(BaseSerializer):
project_detail = ProjectLiteSerializer(read_only=True, source="project")
+60 -2
View File
@@ -17,6 +17,8 @@ from plane.db.models import (
PageVersion,
)
from plane.ee.models.page import PageUser
class PageSerializer(BaseSerializer):
is_favorite = serializers.BooleanField(read_only=True)
@@ -28,6 +30,13 @@ class PageSerializer(BaseSerializer):
# Many to many
label_ids = serializers.ListField(child=serializers.UUIDField(), required=False)
project_ids = serializers.ListField(child=serializers.UUIDField(), required=False)
anchor = serializers.CharField(read_only=True)
parent_id = serializers.PrimaryKeyRelatedField(
source="parent", queryset=Page.objects.all(), required=False, allow_null=True
)
shared_access = serializers.IntegerField(read_only=True)
is_shared = serializers.BooleanField(read_only=True)
sub_pages_count = serializers.IntegerField(read_only=True)
class Meta:
model = Page
@@ -38,7 +47,6 @@ class PageSerializer(BaseSerializer):
"access",
"color",
"labels",
"parent",
"is_favorite",
"is_locked",
"archived_at",
@@ -51,8 +59,16 @@ class PageSerializer(BaseSerializer):
"logo_props",
"label_ids",
"project_ids",
"anchor",
"external_id",
"external_source",
"parent_id",
"sub_pages_count",
"shared_access",
"is_shared",
"sort_order",
]
read_only_fields = ["workspace", "owned_by"]
read_only_fields = ["workspace", "owned_by", "anchor"]
def create(self, validated_data):
labels = validated_data.pop("labels", None)
@@ -124,11 +140,43 @@ class PageSerializer(BaseSerializer):
class PageDetailSerializer(PageSerializer):
description_html = serializers.CharField()
is_favorite = serializers.BooleanField(read_only=True)
parent_id = serializers.PrimaryKeyRelatedField(
source="parent", queryset=Page.objects.all(), required=False, allow_null=True
)
shared_access = serializers.IntegerField(read_only=True)
class Meta(PageSerializer.Meta):
fields = PageSerializer.Meta.fields + ["description_html"]
class PageLiteSerializer(BaseSerializer):
project_ids = serializers.ListField(child=serializers.UUIDField(), required=False)
sub_pages_count = serializers.IntegerField(read_only=True)
is_shared = serializers.BooleanField(read_only=True)
class Meta:
model = Page
fields = [
"id",
"name",
"access",
"logo_props",
"is_locked",
"archived_at",
"parent_id",
"workspace",
"project_ids",
"sub_pages_count",
"owned_by",
"deleted_at",
"is_description_empty",
"updated_at",
"moved_to_page",
"moved_to_project",
"is_shared",
"sort_order",
]
class PageVersionSerializer(BaseSerializer):
class Meta:
model = PageVersion
@@ -162,6 +210,7 @@ class PageVersionDetailSerializer(BaseSerializer):
"updated_at",
"created_by",
"updated_by",
"sub_pages_data",
]
read_only_fields = ["workspace", "page"]
@@ -219,3 +268,12 @@ class PageBinaryUpdateSerializer(serializers.Serializer):
instance.save()
return instance
class PageUserSerializer(BaseSerializer):
user_id = serializers.UUIDField(source="user.id", read_only=True)
class Meta:
model = PageUser
fields = "__all__"
read_only_fields = ["workspace", "page", "user"]
+79 -17
View File
@@ -10,17 +10,18 @@ from plane.db.models import (
ProjectMember,
ProjectMemberInvite,
ProjectIdentifier,
DeployBoard,
ProjectPublicMember,
)
from plane.utils.content_validator import (
validate_html_content,
)
from plane.ee.models.initiative import InitiativeProject
class ProjectSerializer(BaseSerializer):
workspace_detail = WorkspaceLiteSerializer(source="workspace", read_only=True)
inbox_view = serializers.BooleanField(read_only=True, source="intake_view")
initiative_ids = serializers.ListField(child=serializers.UUIDField(), required=False, write_only=True)
class Meta:
model = Project
@@ -81,6 +82,53 @@ class ProjectSerializer(BaseSerializer):
return project
def update(self, instance, validated_data):
initiative_ids = validated_data.pop("initiative_ids", None)
identifier = validated_data.get("identifier", "").strip().upper()
workspace_id = self.context["workspace_id"]
if initiative_ids is not None:
InitiativeProject.objects.filter(project_id=instance.id).delete()
InitiativeProject.objects.bulk_create(
[
InitiativeProject(
project_id=instance.id,
initiative_id=initiative_id,
workspace_id=workspace_id,
created_by_id=self.context["user_id"],
)
for initiative_id in initiative_ids
],
batch_size=10,
)
# If identifier is not passed update the project and return
if identifier == "":
project = super().update(instance, validated_data)
return project
# If no Project Identifier is found create it
project_identifier = ProjectIdentifier.objects.filter(
name=identifier, workspace_id=instance.workspace_id
).first()
if project_identifier is None:
project = super().update(instance, validated_data)
project_identifier = ProjectIdentifier.objects.filter(project=project).first()
if project_identifier is not None:
project_identifier.name = identifier
project_identifier.save()
return project
# If found check if the project_id to be updated and identifier project id is same # noqa: E501
if project_identifier.project_id == instance.id:
# If same pass update
project = super().update(instance, validated_data)
return project
# If not same fail update
raise serializers.ValidationError(detail="Project Identifier is already taken")
class ProjectLiteSerializer(BaseSerializer):
class Meta:
@@ -100,17 +148,45 @@ class ProjectLiteSerializer(BaseSerializer):
class ProjectListSerializer(DynamicBaseSerializer):
is_favorite = serializers.BooleanField(read_only=True)
sort_order = serializers.FloatField(read_only=True)
member_role = serializers.IntegerField(read_only=True)
member_role = serializers.SerializerMethodField()
anchor = serializers.CharField(read_only=True)
members = serializers.SerializerMethodField()
cover_image_url = serializers.CharField(read_only=True)
# EE: project_grouping starts
state_id = serializers.UUIDField(read_only=True)
priority = serializers.CharField(read_only=True)
start_date = serializers.DateTimeField(read_only=True)
target_date = serializers.DateTimeField(read_only=True)
initiative_ids = serializers.SerializerMethodField(read_only=True)
# EE: project_grouping ends
inbox_view = serializers.BooleanField(read_only=True, source="intake_view")
def get_members(self, obj):
project_members = getattr(obj, "members_list", None)
if project_members is not None:
# Filter members by the project ID
return [member.member_id for member in project_members if member.is_active and not member.member.is_bot]
return [
member.member_id
for member in project_members
if member.is_active and (member.member and not member.member.is_bot)
]
return []
def get_member_role(self, obj):
project_members = getattr(obj, "members_list", None)
current_user_id = self.context["request"].user.id if self.context.get("request") else None
# calculate the current member role
if project_members is not None and current_user_id:
current_member = next(
(member for member in project_members if member.member_id == current_user_id),
None,
)
return current_member.role if current_member else None
return None
def get_initiative_ids(self, obj):
if obj.initiatives.all():
return [initiative.initiative_id for initiative in obj.initiatives.all()]
return []
class Meta:
@@ -133,10 +209,6 @@ class ProjectDetailSerializer(BaseSerializer):
class ProjectMemberSerializer(BaseSerializer):
workspace = WorkspaceLiteSerializer(read_only=True)
project = ProjectLiteSerializer(read_only=True)
member = UserLiteSerializer(read_only=True)
class Meta:
model = ProjectMember
fields = "__all__"
@@ -186,16 +258,6 @@ class ProjectMemberLiteSerializer(BaseSerializer):
read_only_fields = fields
class DeployBoardSerializer(BaseSerializer):
project_details = ProjectLiteSerializer(read_only=True, source="project")
workspace_detail = WorkspaceLiteSerializer(read_only=True, source="workspace")
class Meta:
model = DeployBoard
fields = "__all__"
read_only_fields = ["workspace", "project", "anchor"]
class ProjectPublicMemberSerializer(BaseSerializer):
class Meta:
model = ProjectPublicMember
+32
View File
@@ -5,9 +5,26 @@ from rest_framework import serializers
from .base import DynamicBaseSerializer
from plane.db.models import IssueView
from plane.utils.issue_filters import issue_filters
from plane.payment.flags.flag import FeatureFlag
from plane.payment.flags.flag_decorator import check_workspace_feature_flag
class ViewIssueListSerializer(serializers.Serializer):
def __init__(self, *args, **kwargs):
super().__init__(*args, **kwargs)
slug = self.context.get("slug", None)
user_id = self.context.get("user_id", None)
# Check if the user has access to the customer request count
if slug and user_id:
if check_workspace_feature_flag(
feature_key=FeatureFlag.CUSTOMERS, slug=slug, user_id=user_id
):
self.fields["customer_request_ids"] = serializers.ListField(
read_only=True
)
self.fields["customer_ids"] = serializers.ListField(read_only=True)
def get_assignee_ids(self, instance):
return [assignee.assignee_id for assignee in instance.issue_assignee.all()]
@@ -17,6 +34,17 @@ class ViewIssueListSerializer(serializers.Serializer):
def get_module_ids(self, instance):
return [module.module_id for module in instance.issue_module.all()]
def get_customer_ids(self, instance):
return [
customer.customer_id for customer in instance.customer_request_issues.all()
]
def get_customer_request_ids(self, instance):
return [
customer_request.customer_request_id
for customer_request in instance.customer_request_issues.all()
]
def to_representation(self, instance):
data = {
"id": instance.id,
@@ -42,15 +70,19 @@ class ViewIssueListSerializer(serializers.Serializer):
"is_draft": instance.is_draft,
"archived_at": instance.archived_at,
"state__group": instance.state.group if instance.state else None,
"type_id": instance.type_id,
"assignee_ids": self.get_assignee_ids(instance),
"label_ids": self.get_label_ids(instance),
"module_ids": self.get_module_ids(instance),
"customer_ids": self.get_customer_ids(instance),
"customer_request_ids": self.get_customer_request_ids(instance),
}
return data
class IssueViewSerializer(DynamicBaseSerializer):
is_favorite = serializers.BooleanField(read_only=True)
anchor = serializers.CharField(read_only=True)
class Meta:
model = IssueView
+11
View File
@@ -3,6 +3,9 @@ import socket
import ipaddress
from urllib.parse import urlparse
# Django imports
from django.conf import settings
# Third party imports
from rest_framework import serializers
@@ -37,6 +40,10 @@ class WebhookSerializer(DynamicBaseSerializer):
if ip.is_loopback:
raise serializers.ValidationError({"url": "URL resolves to a blocked IP address."})
# if in cloud environment, private IP addresses are also not allowed
if settings.IS_MULTI_TENANT and ip.is_private:
raise serializers.ValidationError({"url": "URL resolves to a blocked IP address."})
# Additional validation for multiple request domains and their subdomains
request = self.context.get("request")
disallowed_domains = ["plane.so"] # Add your disallowed domains here
@@ -72,6 +79,10 @@ class WebhookSerializer(DynamicBaseSerializer):
if ip.is_loopback:
raise serializers.ValidationError({"url": "URL resolves to a blocked IP address."})
# if in cloud environment, private IP addresses are also not allowed
if settings.IS_MULTI_TENANT and ip.is_private:
raise serializers.ValidationError({"url": "URL resolves to a blocked IP address."})
# Additional validation for multiple request domains and their subdomains
request = self.context.get("request")
disallowed_domains = ["plane.so"] # Add your disallowed domains here
@@ -71,6 +71,31 @@ class WorkSpaceSerializer(DynamicBaseSerializer):
]
class WorkspaceUserMeSerializer(DynamicBaseSerializer):
owner = UserLiteSerializer(read_only=True)
total_members = serializers.IntegerField(read_only=True)
total_issues = serializers.IntegerField(read_only=True)
logo_url = serializers.CharField(read_only=True)
current_plan = serializers.CharField(read_only=True)
role = serializers.IntegerField(read_only=True)
is_on_trial = serializers.BooleanField(read_only=True)
class Meta:
model = Workspace
fields = "__all__"
read_only_fields = [
"id",
"created_by",
"updated_by",
"created_at",
"updated_at",
"owner",
"logo_url",
"role",
"is_on_trial",
]
class WorkspaceLiteSerializer(BaseSerializer):
class Meta:
model = Workspace
@@ -88,6 +113,7 @@ class WorkSpaceMemberSerializer(DynamicBaseSerializer):
class WorkspaceMemberMeSerializer(BaseSerializer):
draft_issue_count = serializers.IntegerField(read_only=True)
active_cycles_count = serializers.IntegerField(read_only=True)
class Meta:
model = WorkspaceMember
@@ -195,6 +221,7 @@ class WorkspaceUserLinkSerializer(BaseSerializer):
class IssueRecentVisitSerializer(serializers.ModelSerializer):
project_identifier = serializers.SerializerMethodField()
assignees = serializers.SerializerMethodField()
is_epic = serializers.SerializerMethodField()
class Meta:
model = Issue
@@ -208,6 +235,7 @@ class IssueRecentVisitSerializer(serializers.ModelSerializer):
"sequence_id",
"project_id",
"project_identifier",
"is_epic",
]
def get_project_identifier(self, obj):
@@ -217,6 +245,9 @@ class IssueRecentVisitSerializer(serializers.ModelSerializer):
def get_assignees(self, obj):
return list(obj.assignees.filter(issue_assignee__deleted_at__isnull=True).values_list("id", flat=True))
def get_is_epic(self, obj):
return obj.type.is_epic if obj.type else False
class ProjectRecentVisitSerializer(serializers.ModelSerializer):
project_members = serializers.SerializerMethodField()
@@ -233,6 +264,12 @@ class ProjectRecentVisitSerializer(serializers.ModelSerializer):
return members
class WorkspacePageRecentVisitSerializer(serializers.ModelSerializer):
class Meta:
model = Page
fields = ["id", "name", "logo_props", "owned_by"]
class PageRecentVisitSerializer(serializers.ModelSerializer):
project_id = serializers.SerializerMethodField()
project_identifier = serializers.SerializerMethodField()
@@ -262,6 +299,7 @@ def get_entity_model_and_serializer(entity_type):
"issue": (Issue, IssueRecentVisitSerializer),
"page": (Page, PageRecentVisitSerializer),
"project": (Project, ProjectRecentVisitSerializer),
"workspace_page": (Page, WorkspacePageRecentVisitSerializer),
}
return entity_map.get(entity_type, (None, None))
+12 -1
View File
@@ -18,6 +18,13 @@ from .webhook import urlpatterns as webhook_urls
from .workspace import urlpatterns as workspace_urls
from .timezone import urlpatterns as timezone_urls
# Integrations URLS
from .importer import urlpatterns as importer_urls
from .integration import urlpatterns as integration_urls
# url patterns
from plane.ee.urls.app import urlpatterns as ee_urls
urlpatterns = [
*analytic_urls,
*asset_urls,
@@ -28,7 +35,6 @@ urlpatterns = [
*issue_urls,
*module_urls,
*notification_urls,
*page_urls,
*project_urls,
*search_urls,
*state_urls,
@@ -38,4 +44,9 @@ urlpatterns = [
*api_urls,
*webhook_urls,
*timezone_urls,
# ee
*integration_urls,
*importer_urls,
*ee_urls,
*page_urls,
]
+48
View File
@@ -12,9 +12,17 @@ from plane.app.views import (
AssetRestoreEndpoint,
ProjectAssetEndpoint,
ProjectBulkAssetEndpoint,
# Unlimited Asset Endpoints
SiloAssetsEndpoint,
AssetCheckEndpoint,
WorkspaceAssetDownloadEndpoint,
ProjectAssetDownloadEndpoint,
ProxyUploadEndpoint,
ProxyDownloadEndpoint,
ProjectReuploadAssetEndpoint,
WorkspaceReuploadAssetEndpoint,
WorkspaceFileAssetServerEndpoint,
ProjectAssetServerEndpoint,
)
@@ -51,6 +59,11 @@ urlpatterns = [
WorkspaceFileAssetEndpoint.as_view(),
name="workspace-file-assets",
),
path(
"assets/v2/workspaces/<str:slug>/reupload/<uuid:asset_id>/",
WorkspaceReuploadAssetEndpoint.as_view(),
name="workspace-reupload-asset",
),
path(
"assets/v2/user-assets/",
UserAssetsV2Endpoint.as_view(),
@@ -76,6 +89,11 @@ urlpatterns = [
ProjectAssetEndpoint.as_view(),
name="bulk-asset-update",
),
path(
"assets/v2/workspaces/<str:slug>/projects/<uuid:project_id>/reupload/<uuid:asset_id>/",
ProjectReuploadAssetEndpoint.as_view(),
name="bulk-asset-reupload",
),
path(
"assets/v2/workspaces/<str:slug>/projects/<uuid:project_id>/<uuid:pk>/",
ProjectAssetEndpoint.as_view(),
@@ -101,4 +119,34 @@ urlpatterns = [
ProjectAssetDownloadEndpoint.as_view(),
name="project-asset-download",
),
path(
"assets/silo/workspaces/<str:slug>/",
SiloAssetsEndpoint.as_view(),
name="silo-assets",
),
path(
"assets/silo/workspaces/<str:slug>/<uuid:asset_id>/",
SiloAssetsEndpoint.as_view(),
name="silo-assets-detail",
),
path(
"assets/proxy-upload/<str:encoded_s3_url>/",
ProxyUploadEndpoint.as_view(),
name="proxy-upload",
),
path(
"assets/proxy-download/<str:encoded_params>/",
ProxyDownloadEndpoint.as_view(),
name="proxy-download",
),
path(
"assets/v2/workspaces/<str:slug>/<uuid:asset_id>/server/",
WorkspaceFileAssetServerEndpoint.as_view(),
name="workspace-file-asset-server",
),
path(
"assets/v2/workspaces/<str:slug>/projects/<uuid:project_id>/<uuid:asset_id>/server/",
ProjectAssetServerEndpoint.as_view(),
name="project-asset-server",
),
]
+12
View File
@@ -0,0 +1,12 @@
from django.urls import path
from plane.app.views.exporter import ExportIssuesEndpoint
urlpatterns = [
path(
"workspaces/<str:slug>/export-issues/",
ExportIssuesEndpoint.as_view(),
name="export-issues",
),
]
+43
View File
@@ -0,0 +1,43 @@
from django.urls import path
from plane.app.views import (
ServiceIssueImportSummaryEndpoint,
ImportServiceEndpoint,
UpdateServiceImportStatusEndpoint,
BulkImportIssuesEndpoint,
)
urlpatterns = [
path(
"workspaces/<str:slug>/importers/<str:service>/",
ServiceIssueImportSummaryEndpoint.as_view(),
name="importer-summary",
),
path(
"workspaces/<str:slug>/projects/importers/<str:service>/",
ImportServiceEndpoint.as_view(),
name="importer",
),
path(
"workspaces/<str:slug>/importers/",
ImportServiceEndpoint.as_view(),
name="importer",
),
path(
"workspaces/<str:slug>/importers/<str:service>/<uuid:pk>/",
ImportServiceEndpoint.as_view(),
name="importer",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/service/<str:service>/importers/<uuid:importer_id>/",
UpdateServiceImportStatusEndpoint.as_view(),
name="importer-status",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/bulk-import-issues/<str:service>/",
BulkImportIssuesEndpoint.as_view(),
name="bulk-import-issues",
),
]
+88
View File
@@ -0,0 +1,88 @@
from django.urls import path
from plane.app.views import (
IntegrationViewSet,
WorkspaceIntegrationViewSet,
GithubRepositoriesEndpoint,
GithubRepositorySyncViewSet,
GithubIssueSyncViewSet,
GithubCommentSyncViewSet,
BulkCreateGithubIssueSyncEndpoint,
SlackProjectSyncViewSet,
)
urlpatterns = [
path(
"integrations/",
IntegrationViewSet.as_view({"get": "list", "post": "create"}),
name="integrations",
),
path(
"integrations/<uuid:pk>/",
IntegrationViewSet.as_view(
{"get": "retrieve", "patch": "partial_update", "delete": "destroy"}
),
name="integrations",
),
path(
"workspaces/<str:slug>/workspace-integrations/",
WorkspaceIntegrationViewSet.as_view({"get": "list"}),
name="workspace-integrations",
),
path(
"workspaces/<str:slug>/workspace-integrations/<str:provider>/",
WorkspaceIntegrationViewSet.as_view({"post": "create"}),
name="workspace-integrations",
),
path(
"workspaces/<str:slug>/workspace-integrations/<uuid:pk>/provider/",
WorkspaceIntegrationViewSet.as_view({"get": "retrieve", "delete": "destroy"}),
name="workspace-integrations",
),
# Github Integrations
path(
"workspaces/<str:slug>/workspace-integrations/<uuid:workspace_integration_id>/github-repositories/",
GithubRepositoriesEndpoint.as_view(),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/workspace-integrations/<uuid:workspace_integration_id>/github-repository-sync/",
GithubRepositorySyncViewSet.as_view({"get": "list", "post": "create"}),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/workspace-integrations/<uuid:workspace_integration_id>/github-repository-sync/<uuid:pk>/",
GithubRepositorySyncViewSet.as_view({"get": "retrieve", "delete": "destroy"}),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/github-repository-sync/<uuid:repo_sync_id>/github-issue-sync/",
GithubIssueSyncViewSet.as_view({"post": "create", "get": "list"}),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/github-repository-sync/<uuid:repo_sync_id>/bulk-create-github-issue-sync/",
BulkCreateGithubIssueSyncEndpoint.as_view(),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/github-repository-sync/<uuid:repo_sync_id>/github-issue-sync/<uuid:pk>/",
GithubIssueSyncViewSet.as_view({"get": "retrieve", "delete": "destroy"}),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/github-repository-sync/<uuid:repo_sync_id>/github-issue-sync/<uuid:issue_sync_id>/github-comment-sync/",
GithubCommentSyncViewSet.as_view({"post": "create", "get": "list"}),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/github-repository-sync/<uuid:repo_sync_id>/github-issue-sync/<uuid:issue_sync_id>/github-comment-sync/<uuid:pk>/",
GithubCommentSyncViewSet.as_view({"get": "retrieve", "delete": "destroy"}),
),
## End Github Integrations
# Slack Integration
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/workspace-integrations/<uuid:workspace_integration_id>/project-slack-sync/",
SlackProjectSyncViewSet.as_view({"post": "create", "get": "list"}),
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/workspace-integrations/<uuid:workspace_integration_id>/project-slack-sync/<uuid:pk>/",
SlackProjectSyncViewSet.as_view({"delete": "destroy", "get": "retrieve"}),
),
## End Slack Integration
]
-13
View File
@@ -7,7 +7,6 @@ from plane.app.views import (
IssueLinkViewSet,
IssueAttachmentEndpoint,
CommentReactionViewSet,
ExportIssuesEndpoint,
IssueActivityEndpoint,
IssueArchiveViewSet,
IssueCommentViewSet,
@@ -18,7 +17,6 @@ from plane.app.views import (
IssueUserDisplayPropertyEndpoint,
IssueViewSet,
LabelViewSet,
BulkArchiveIssuesEndpoint,
DeletedIssuesListViewSet,
IssuePaginatedViewSet,
IssueDetailEndpoint,
@@ -92,11 +90,6 @@ urlpatterns = [
BulkDeleteIssuesEndpoint.as_view(),
name="project-issues-bulk",
),
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/bulk-archive-issues/",
BulkArchiveIssuesEndpoint.as_view(),
name="bulk-archive-issues",
),
##
path(
"workspaces/<str:slug>/projects/<uuid:project_id>/issues/<uuid:issue_id>/sub-issues/",
@@ -141,12 +134,6 @@ urlpatterns = [
IssueAttachmentV2Endpoint.as_view(),
name="project-issue-attachments",
),
## Export Issues
path(
"workspaces/<str:slug>/export-issues/",
ExportIssuesEndpoint.as_view(),
name="export-issues",
),
## End Issues
## Issue Activity
path(
+11 -1
View File
@@ -1,7 +1,12 @@
from django.urls import path
from plane.app.views import GlobalSearchEndpoint, IssueSearchEndpoint, SearchEndpoint
from plane.app.views import (
GlobalSearchEndpoint,
IssueSearchEndpoint,
SearchEndpoint,
WorkspaceSearchEndpoint,
)
urlpatterns = [
@@ -20,4 +25,9 @@ urlpatterns = [
SearchEndpoint.as_view(),
name="entity-search",
),
path(
"workspaces/<str:slug>/app-search/",
WorkspaceSearchEndpoint.as_view(),
name="app-search",
),
]
+2
View File
@@ -7,6 +7,7 @@ from plane.app.views import (
UpdateUserTourCompletedEndpoint,
UserActivityEndpoint,
UserActivityGraphEndpoint,
UserTokenVerificationEndpoint,
## User
UserEndpoint,
UserIssueCompletedGraphEndpoint,
@@ -49,6 +50,7 @@ urlpatterns = [
name="user-tour",
),
path("users/me/activities/", UserActivityEndpoint.as_view(), name="user-activities"),
path("users/me/verify/", UserTokenVerificationEndpoint.as_view(), name="user-verify"),
# user workspaces
path("users/me/workspaces/", UserWorkSpacesEndpoint.as_view(), name="user-workspace"),
# User Graphs
+38 -4
View File
@@ -97,7 +97,6 @@ from .cycle.base import (
)
from .cycle.issue import CycleIssueViewSet
from .cycle.archive import CycleArchiveUnarchiveEndpoint
from .asset.base import FileAssetEndpoint, UserAssetsEndpoint, FileAssetViewSet
from .asset.v2 import (
WorkspaceFileAssetEndpoint,
@@ -109,7 +108,13 @@ from .asset.v2 import (
AssetCheckEndpoint,
WorkspaceAssetDownloadEndpoint,
ProjectAssetDownloadEndpoint,
ProjectReuploadAssetEndpoint,
WorkspaceReuploadAssetEndpoint,
WorkspaceFileAssetServerEndpoint,
ProjectAssetServerEndpoint,
)
from .asset.silo import SiloAssetsEndpoint
from .issue.base import (
IssueListEndpoint,
IssueViewSet,
@@ -125,7 +130,7 @@ from .issue.base import (
from .issue.activity import IssueActivityEndpoint
from .issue.archive import IssueArchiveViewSet, BulkArchiveIssuesEndpoint
from .issue.archive import IssueArchiveViewSet
from .issue.attachment import (
IssueAttachmentEndpoint,
@@ -173,6 +178,7 @@ from .page.version import PageVersionEndpoint
from .search.base import GlobalSearchEndpoint, SearchEndpoint
from .search.issue import IssueSearchEndpoint
from .search.workspace import WorkspaceSearchEndpoint
from .external.base import (
GPTIntegrationEndpoint,
@@ -218,7 +224,6 @@ from .notification.base import (
UserNotificationPreferenceEndpoint,
)
from .exporter.base import ExportIssuesEndpoint
from .webhook.base import (
@@ -229,7 +234,36 @@ from .webhook.base import (
from .error_404 import custom_404_view
from .importer.base import (
ServiceIssueImportSummaryEndpoint,
ImportServiceEndpoint,
UpdateServiceImportStatusEndpoint,
BulkImportIssuesEndpoint,
BulkImportModulesEndpoint,
)
from .integration.base import IntegrationViewSet, WorkspaceIntegrationViewSet
from .integration.github import (
GithubRepositoriesEndpoint,
GithubRepositorySyncViewSet,
GithubIssueSyncViewSet,
GithubCommentSyncViewSet,
BulkCreateGithubIssueSyncEndpoint,
)
from .integration.slack import SlackProjectSyncViewSet
from .notification.base import MarkAllReadNotificationViewSet
from .user.base import AccountEndpoint, ProfileEndpoint, UserSessionEndpoint
from .user.base import (
AccountEndpoint,
ProfileEndpoint,
UserSessionEndpoint,
UserTokenVerificationEndpoint,
)
from .timezone.base import TimezoneEndpoint
from .asset.proxy import ProxyUploadEndpoint, ProxyDownloadEndpoint
+903 -7
View File
@@ -1,10 +1,14 @@
from rest_framework.response import Response
from rest_framework import status
from typing import Dict, List, Any
from django.db.models import QuerySet, Q, Count
from django.http import HttpRequest
from django.db.models.functions import TruncMonth
from django.utils import timezone
from django.db.models.functions import Cast
from django.db.models.fields.json import KeyTextTransform
from plane.app.views.base import BaseAPIView
from plane.app.permissions import ROLE, allow_permission
from plane.db.models import (
@@ -18,10 +22,18 @@ from plane.db.models import (
Workspace,
ProjectMember,
)
from plane.ee.models import EntityUpdates, ProjectAttribute
from plane.utils.build_chart import build_analytics_chart
from plane.utils.date_utils import (
get_analytics_filters,
)
from plane.payment.flags.flag_decorator import check_workspace_feature_flag
from plane.payment.flags.flag import FeatureFlag
from django.db.models import Max
from django.db import models
from django.db.models import Case, When, Value, F, CharField
from django.db.models.functions import Concat
from plane.payment.flags.flag_decorator import ErrorCodes
class AdvanceAnalyticsBaseView(BaseAPIView):
@@ -97,6 +109,88 @@ class AdvanceAnalyticsEndpoint(AdvanceAnalyticsBaseView):
"completed_work_items": self.get_filtered_counts(base_queryset.filter(state__group="completed")),
}
def get_users_stats(self) -> Dict[str, Dict[str, int]]:
members_query = WorkspaceMember.objects.filter(
workspace__slug=self._workspace_slug,
is_active=True,
member__is_bot=False,
)
if self.request.GET.get("project_ids", None):
project_ids = self.request.GET.get("project_ids", None)
project_ids = [str(project_id) for project_id in project_ids.split(",")]
members_query = ProjectMember.objects.filter(
project_id__in=project_ids, is_active=True, member__is_bot=False
)
return {
"total_users": self.get_filtered_counts(members_query),
"total_admins": self.get_filtered_counts(members_query.filter(role=ROLE.ADMIN.value)),
"total_members": self.get_filtered_counts(members_query.filter(role=ROLE.MEMBER.value)),
"total_guests": self.get_filtered_counts(members_query.filter(role=ROLE.GUEST.value)),
}
def get_projects_stats(self) -> Dict[str, Dict[str, int]]:
latest_updates = EntityUpdates.objects.filter(
**self.filters["base_filters"],
entity_type="PROJECT",
created_at__in=EntityUpdates.objects.filter(**self.filters["base_filters"], entity_type="PROJECT")
.values("project_id")
.annotate(latest_created_at=Max("created_at"))
.values("latest_created_at"),
).order_by("project_id", "-created_at")
return {
"total_projects": self.get_filtered_counts(
Project.objects.filter(**self.filters["project_filters"]),
),
"on_track_updates": self.get_filtered_counts(
latest_updates.filter(status="ON-TRACK"),
),
"off_track_updates": self.get_filtered_counts(
latest_updates.filter(status="OFF-TRACK"),
),
"at_risk_updates": self.get_filtered_counts(
latest_updates.filter(status="AT-RISK"),
),
}
def get_cycles_stats(self) -> Dict[str, Dict[str, int]]:
base_queryset = Cycle.objects.filter(**self.filters["base_filters"])
return {
"total_cycles": self.get_filtered_counts(base_queryset),
"current_cycles": self.get_filtered_counts(
base_queryset.filter(start_date__lte=timezone.now(), end_date__gte=timezone.now()),
),
"upcoming_cycles": self.get_filtered_counts(base_queryset.filter(start_date__gte=timezone.now())),
"completed_cycles": self.get_filtered_counts(base_queryset.filter(end_date__lte=timezone.now())),
}
def get_module_stats(self) -> Dict[str, Dict[str, int]]:
base_queryset = Module.objects.filter(**self.filters["base_filters"])
return {
"total_modules": self.get_filtered_counts(base_queryset),
"completed_modules": self.get_filtered_counts(base_queryset.filter(status="completed")),
"in_progress_modules": self.get_filtered_counts(base_queryset.filter(status="in-progress")),
"planned_modules": self.get_filtered_counts(base_queryset.filter(status="planned")),
"paused_modules": self.get_filtered_counts(base_queryset.filter(status="paused")),
}
def get_intake_stats(self) -> Dict[str, Dict[str, int]]:
base_queryset = Issue.objects.filter(**self.filters["base_filters"]).filter(
issue_intake__isnull=False,
issue_intake__status__in=["-2", "-1", "0", "1", "2"],
)
return {
"total_intake": self.get_filtered_counts(base_queryset),
"accepted_intake": self.get_filtered_counts(base_queryset.filter(issue_intake__status=1)),
"rejected_intake": self.get_filtered_counts(base_queryset.filter(issue_intake__status=-1)),
"duplicate_intake": self.get_filtered_counts(base_queryset.filter(issue_intake__status=2)),
}
@allow_permission([ROLE.ADMIN, ROLE.MEMBER], level="WORKSPACE")
def get(self, request: HttpRequest, slug: str) -> Response:
self.initialize_workspace(slug, type="analytics")
@@ -112,6 +206,51 @@ class AdvanceAnalyticsEndpoint(AdvanceAnalyticsBaseView):
self.get_work_items_stats(),
status=status.HTTP_200_OK,
)
if check_workspace_feature_flag(
feature_key=FeatureFlag.ANALYTICS_ADVANCED,
slug=slug,
user_id=str(request.user.id),
):
if tab == "users":
return Response(
self.get_users_stats(),
status=status.HTTP_200_OK,
)
elif tab == "projects":
return Response(
self.get_projects_stats(),
status=status.HTTP_200_OK,
)
elif tab == "work-items":
return Response(
self.get_work_items_stats(),
status=status.HTTP_200_OK,
)
elif tab == "cycles":
return Response(
self.get_cycles_stats(),
status=status.HTTP_200_OK,
)
elif tab == "modules":
return Response(
self.get_module_stats(),
status=status.HTTP_200_OK,
)
elif tab == "intake":
return Response(
self.get_intake_stats(),
status=status.HTTP_200_OK,
)
else:
return Response(
{
"error": "Payment required",
"error_code": ErrorCodes.PAYMENT_REQUIRED.value,
},
status=status.HTTP_402_PAYMENT_REQUIRED,
)
return Response({"message": "Invalid tab"}, status=status.HTTP_400_BAD_REQUEST)
@@ -137,7 +276,7 @@ class AdvanceAnalyticsStatsEndpoint(AdvanceAnalyticsBaseView):
.order_by("project_id")
)
def get_work_items_stats(self) -> Dict[str, Dict[str, int]]:
def get_work_items_stats(self) -> QuerySet:
base_queryset = Issue.issue_objects.filter(**self.filters["base_filters"])
return (
base_queryset.values("project_id", "project__name")
@@ -151,6 +290,328 @@ class AdvanceAnalyticsStatsEndpoint(AdvanceAnalyticsBaseView):
.order_by("project_id")
)
def get_project_stats(self) -> List[Dict[str, Any]]:
# Get all project stats in a single query using annotations
projects = (
Project.objects.filter(**self.filters["project_filters"])
.annotate(
# Issue stats
total_work_items=Count(
"project_issue",
filter=Q(
project_issue__archived_at__isnull=True,
project_issue__is_draft=False,
),
distinct=True,
),
completed_work_items=Count(
"project_issue",
filter=Q(
project_issue__archived_at__isnull=True,
project_issue__is_draft=False,
project_issue__state__group="completed",
),
distinct=True,
),
total_epics=Count(
"project_issue",
filter=Q(
project_issue__archived_at__isnull=True,
project_issue__is_draft=False,
project_issue__type__is_epic=True,
),
distinct=True,
),
total_intake=Count(
"project_issue",
filter=Q(
project_issue__archived_at__isnull=True,
project_issue__is_draft=False,
project_issue__issue_intake__isnull=False,
project_issue__issue_intake__status__in=[
"-2",
"-1",
"0",
"1",
"2",
],
),
distinct=True,
),
# Cycle stats
total_cycles=Count(
"project_cycle",
filter=Q(project_cycle__archived_at__isnull=True),
distinct=True,
),
# Module stats
total_modules=Count(
"project_module",
filter=Q(project_module__archived_at__isnull=True),
distinct=True,
),
# Member stats
total_members=Count(
"project_projectmember",
filter=Q(
project_projectmember__is_active=True,
project_projectmember__member__is_bot=False,
),
distinct=True,
),
# Page stats
total_pages=Count(
"project_pages",
filter=Q(project_pages__page__archived_at__isnull=True),
distinct=True,
),
# View stats
total_views=Count(
"project_issueview",
distinct=True,
),
)
.values(
"id",
"name",
"logo_props",
"identifier",
"total_work_items",
"completed_work_items",
"total_epics",
"total_intake",
"total_cycles",
"total_modules",
"total_members",
"total_pages",
"total_views",
)
)
return list(projects)
def get_users_stats(self) -> QuerySet:
# First get all project members
if self.request.GET.get("project_ids", None):
project_ids = [str(project_id) for project_id in self.request.GET.get("project_ids", "").split(",")]
member_ids = ProjectMember.objects.filter(
project_id__in=project_ids, is_active=True, member__is_bot=False
).values_list("member_id", flat=True)
else:
active_member_ids = WorkspaceMember.objects.filter(
workspace__slug=self._workspace_slug,
is_active=True,
member__is_bot=False,
).values_list("member_id", flat=True)
inactive_member_ids = WorkspaceMember.objects.filter(
workspace__slug=self._workspace_slug,
is_active=False,
member__is_bot=False,
).values_list("member_id", flat=True)
# Combine active and inactive ids for filtering issues
member_ids = list(active_member_ids) + list(inactive_member_ids)
# Get stats for all members in a single query
return (
Issue.issue_objects.filter(
**self.filters["base_filters"],
)
.annotate(
display_name=Case(
When(Q(created_by__in=member_ids), then=F("created_by__display_name")),
When(Q(assignees__in=member_ids), then=F("assignees__display_name")),
default=Value(None),
output_field=models.CharField(),
),
user_id=Case(
When(Q(created_by__in=member_ids), then=F("created_by")),
When(Q(assignees__in=member_ids), then=F("assignees__id")),
default=Value(None),
output_field=models.CharField(),
),
avatar=Case(
When(Q(created_by__in=member_ids), then=F("created_by__avatar")),
When(Q(assignees__in=member_ids), then=F("assignees__avatar")),
default=Value(None),
output_field=models.CharField(),
),
avatar_url=Case(
When(
Q(created_by__in=member_ids) & Q(created_by__avatar_asset__isnull=False),
then=Concat(
Value("/api/assets/v2/static/"),
"created_by__avatar_asset",
Value("/"),
),
),
When(
Q(assignees__in=member_ids) & Q(assignees__avatar_asset__isnull=False),
then=Concat(
Value("/api/assets/v2/static/"),
"assignees__avatar_asset",
Value("/"),
),
),
When(Q(created_by__in=member_ids), then=F("created_by__avatar")),
When(Q(assignees__in=member_ids), then=F("assignees__avatar")),
default=Value(None),
output_field=models.CharField(),
),
is_active=Case(
When(
Q(created_by__in=active_member_ids)
| Q(assignees__in=active_member_ids),
then=Value(True),
),
default=Value(False),
output_field=models.BooleanField(),
),
)
.values("display_name", "user_id", "avatar_url", "is_active")
.annotate(
cancelled_work_items=Count(
"id",
filter=Q(state__group="cancelled") & Q(assignees__in=member_ids),
distinct=True,
),
completed_work_items=Count(
"id",
filter=Q(state__group="completed") & Q(assignees__in=member_ids),
distinct=True,
),
backlog_work_items=Count(
"id",
filter=Q(state__group="backlog") & Q(assignees__in=member_ids),
distinct=True,
),
un_started_work_items=Count(
"id",
filter=Q(state__group="unstarted") & Q(assignees__in=member_ids),
distinct=True,
),
started_work_items=Count(
"id",
filter=Q(state__group="started") & Q(assignees__in=member_ids),
distinct=True,
),
created_work_items=Count("id", filter=Q(created_by__in=member_ids), distinct=True),
)
.order_by("-is_active", "display_name")
)
def get_cycle_stats(self, filters: Dict[str, Any]) -> QuerySet:
qs = Cycle.objects.filter(
**self.filters["base_filters"],
)
return (
qs.values(
"id",
"name",
"project__name",
"project__logo_props",
"owned_by_id",
"start_date",
"end_date",
)
.annotate(
total_issues=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__deleted_at__isnull=True,
),
)
)
.annotate(
completed_issues=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(
issue_cycle__issue__state__group="completed",
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__deleted_at__isnull=True,
),
)
)
.annotate(
status=Case(
When(
Q(start_date__lte=timezone.now()) & Q(end_date__gte=timezone.now()),
then=Value("CURRENT"),
),
When(start_date__gt=timezone.now(), then=Value("UPCOMING")),
When(end_date__lt=timezone.now(), then=Value("COMPLETED")),
When(
Q(start_date__isnull=True) & Q(end_date__isnull=True),
then=Value("DRAFT"),
),
default=Value("DRAFT"),
output_field=CharField(),
)
)
)
def get_module_stats(self, filters: Dict[str, Any]) -> QuerySet:
qs = Module.objects.filter(
**self.filters["base_filters"],
)
return (
qs.values(
"id",
"name",
"project__name",
"project__logo_props",
"start_date",
"target_date",
"lead_id",
"status",
)
.annotate(
total_issues=Count(
"issue_module__issue__id",
distinct=True,
filter=Q(
issue_module__issue__archived_at__isnull=True,
issue_module__issue__is_draft=False,
issue_module__deleted_at__isnull=True,
),
)
)
.annotate(
completed_issues=Count(
"issue_module__issue__id",
distinct=True,
filter=Q(
issue_module__issue__state__group="completed",
issue_module__issue__archived_at__isnull=True,
issue_module__issue__is_draft=False,
issue_module__deleted_at__isnull=True,
),
)
)
)
def get_intake_stats(self, filters: Dict[str, Any]) -> QuerySet:
qs = Issue.objects.filter(
**self.filters["base_filters"],
).filter(
issue_intake__isnull=False,
issue_intake__status__in=["-2", "-1", "0", "1", "2"],
)
return qs.values("project_id", "project__name", "project__logo_props").annotate(
total_work_items=Count("issue_intake__issue_id"),
accepted_intake=Count("issue_intake__issue_id", filter=Q(issue_intake__status=1)),
rejected_intake=Count("issue_intake__issue_id", filter=Q(issue_intake__status=-1)),
duplicate_intake=Count("issue_intake__issue_id", filter=Q(issue_intake__status=2)),
)
@allow_permission([ROLE.ADMIN, ROLE.MEMBER], level="WORKSPACE")
def get(self, request: HttpRequest, slug: str) -> Response:
self.initialize_workspace(slug, type="chart")
@@ -162,9 +623,49 @@ class AdvanceAnalyticsStatsEndpoint(AdvanceAnalyticsBaseView):
status=status.HTTP_200_OK,
)
if check_workspace_feature_flag(
feature_key=FeatureFlag.ANALYTICS_ADVANCED,
slug=slug,
user_id=str(request.user.id),
):
if type == "users":
return Response(
self.get_users_stats(),
status=status.HTTP_200_OK,
)
elif type == "projects":
return Response(
self.get_project_stats(),
status=status.HTTP_200_OK,
)
elif type == "cycles":
return Response(
self.get_cycle_stats(self.filters["base_filters"]),
status=status.HTTP_200_OK,
)
elif type == "modules":
return Response(
self.get_module_stats(self.filters["base_filters"]),
status=status.HTTP_200_OK,
)
elif type == "intake":
return Response(
self.get_intake_stats(self.filters["base_filters"]),
status=status.HTTP_200_OK,
)
else:
return Response(
{
"error": "Payment required",
"error_code": ErrorCodes.PAYMENT_REQUIRED.value,
},
status=status.HTTP_402_PAYMENT_REQUIRED,
)
return Response({"message": "Invalid type"}, status=status.HTTP_400_BAD_REQUEST)
# TODO : Add pagination for the charts
class AdvanceAnalyticsChartEndpoint(AdvanceAnalyticsBaseView):
def project_chart(self) -> List[Dict[str, Any]]:
# Get the base queryset with workspace and project filters
@@ -183,10 +684,16 @@ class AdvanceAnalyticsChartEndpoint(AdvanceAnalyticsBaseView):
total_cycles = Cycle.objects.filter(**self.filters["base_filters"], **date_filter).count()
total_modules = Module.objects.filter(**self.filters["base_filters"], **date_filter).count()
total_intake = Issue.objects.filter(
issue_intake__isnull=False, **self.filters["base_filters"], **date_filter
issue_intake__isnull=False,
issue_intake__status__in=["-2", "-1", "0", "1", "2"],
**self.filters["base_filters"],
**date_filter,
).count()
total_members = WorkspaceMember.objects.filter(
workspace__slug=self._workspace_slug, is_active=True, **date_filter
workspace__slug=self._workspace_slug,
is_active=True,
member__is_bot=False,
**date_filter,
).count()
total_pages = ProjectPage.objects.filter(**self.filters["base_filters"], **date_filter).count()
total_views = IssueView.objects.filter(**self.filters["base_filters"], **date_filter).count()
@@ -248,12 +755,12 @@ class AdvanceAnalyticsChartEndpoint(AdvanceAnalyticsBaseView):
# Generate monthly data (ensure months with 0 count are included)
data = []
# include the current date at the end
end_date = timezone.now().date()
last_month = end_date.replace(day=1)
current_year = timezone.now().year
start_date = timezone.datetime(current_year, 1, 1).date()
end_date = timezone.datetime(current_year, 12, 1).date()
current_month = start_date
while current_month <= last_month:
while current_month <= end_date:
date_str = current_month.strftime("%Y-%m-%d")
stats = stats_dict.get(date_str, {"created_count": 0, "completed_count": 0})
data.append(
@@ -278,6 +785,361 @@ class AdvanceAnalyticsChartEndpoint(AdvanceAnalyticsBaseView):
return {"data": data, "schema": schema}
def project_status_chart(self) -> Dict[str, Any]:
# Get the base queryset
queryset = (
ProjectAttribute.objects.filter(**self.filters["base_filters"])
.values("state__group")
.annotate(
count=Count("project", distinct=True),
states=Count("state", distinct=True),
)
.order_by("state__group")
)
# Transform data into required format
data = [
{
"key": item["state__group"],
"name": item["state__group"],
"count": item["count"],
}
for item in queryset
]
return {"data": data, "schema": {}}
def cycle_chart(self) -> Dict[str, Any]:
# Get the base queryset
queryset = (
Cycle.objects.filter(**self.filters["base_filters"])
.values("id", "name", "progress_snapshot", "start_date", "end_date")
.annotate(
total_issues=Case(
When(
Q(progress_snapshot__isnull=False) & ~Q(progress_snapshot={}),
then=Cast(
KeyTextTransform("total_issues", "progress_snapshot"),
output_field=models.IntegerField(),
),
),
default=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__issue__deleted_at__isnull=True,
),
),
output_field=models.IntegerField(),
)
)
.annotate(
completed_issues=Case(
When(
Q(progress_snapshot__isnull=False) & ~Q(progress_snapshot={}),
then=Cast(
KeyTextTransform("completed_issues", "progress_snapshot"),
output_field=models.IntegerField(),
),
),
default=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(
issue_cycle__issue__state__group="completed",
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__issue__deleted_at__isnull=True,
),
),
output_field=models.IntegerField(),
)
)
.annotate(
unstarted_issues=Case(
When(
Q(progress_snapshot__isnull=False) & ~Q(progress_snapshot={}),
then=Cast(
KeyTextTransform("unstarted_issues", "progress_snapshot"),
output_field=models.IntegerField(),
),
),
default=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(
issue_cycle__issue__state__group="unstarted",
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__issue__deleted_at__isnull=True,
),
),
output_field=models.IntegerField(),
)
)
.annotate(
started_issues=Case(
When(
Q(progress_snapshot__isnull=False) & ~Q(progress_snapshot={}),
then=Cast(
KeyTextTransform("started_issues", "progress_snapshot"),
output_field=models.IntegerField(),
),
),
default=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(issue_cycle__issue__state__group="started"),
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__issue__deleted_at__isnull=True,
),
output_field=models.IntegerField(),
)
)
.annotate(
backlog_issues=Case(
When(
Q(progress_snapshot__isnull=False) & ~Q(progress_snapshot={}),
then=Cast(
KeyTextTransform("backlog_issues", "progress_snapshot"),
output_field=models.IntegerField(),
),
),
default=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(
issue_cycle__issue__state__group="backlog",
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__issue__deleted_at__isnull=True,
),
),
output_field=models.IntegerField(),
)
)
.annotate(
cancelled_issues=Case(
When(
Q(progress_snapshot__isnull=False) & ~Q(progress_snapshot={}),
then=Cast(
KeyTextTransform("cancelled_issues", "progress_snapshot"),
output_field=models.IntegerField(),
),
),
default=Count(
"issue_cycle__issue__id",
distinct=True,
filter=Q(
issue_cycle__issue__state__group="cancelled",
issue_cycle__issue__archived_at__isnull=True,
issue_cycle__issue__is_draft=False,
issue_cycle__issue__deleted_at__isnull=True,
),
),
output_field=models.IntegerField(),
)
)
.annotate(
status=Case(
When(
Q(start_date__lte=timezone.now()) & Q(end_date__gte=timezone.now()),
then=Value("CURRENT"),
),
When(start_date__gt=timezone.now(), then=Value("UPCOMING")),
When(end_date__lt=timezone.now(), then=Value("COMPLETED")),
When(
Q(start_date__isnull=True) & Q(end_date__isnull=True),
then=Value("DRAFT"),
),
default=Value("DRAFT"),
output_field=CharField(),
)
)
)[:30]
# Calculate completion percentage for each cycle
data = []
for cycle in queryset:
total_issues = cycle.get("total_issues", 0)
completed_issues = cycle.get("completed_issues", 0)
completion_percentage = (completed_issues / total_issues * 100) if total_issues > 0 else 0
data.append(
{
"key": cycle.get("name"),
"name": cycle.get("name"),
"count": round(completion_percentage, 2),
"total_issues": total_issues,
"completed_issues": completed_issues,
"unstarted_issues": cycle.get("unstarted_issues", 0),
"started_issues": cycle.get("started_issues", 0),
"backlog_issues": cycle.get("backlog_issues", 0),
"cancelled_issues": cycle.get("cancelled_issues", 0),
"status": cycle.get("status"),
"start_date": cycle.get("start_date"),
"end_date": cycle.get("end_date"),
}
)
return {"data": data, "schema": {}}
def module_chart(self) -> Dict[str, Any]:
# Get the base queryset with module stats
queryset = (
Module.objects.filter(**self.filters["base_filters"])
.annotate(
total_issues=Count(
"issue_module__issue__id",
distinct=True,
filter=Q(
issue_module__issue__archived_at__isnull=True,
issue_module__issue__is_draft=False,
issue_module__deleted_at__isnull=True,
),
),
completed_issues=Count(
"issue_module__issue__id",
distinct=True,
filter=Q(
issue_module__issue__state__group="completed",
issue_module__issue__archived_at__isnull=True,
issue_module__issue__is_draft=False,
issue_module__deleted_at__isnull=True,
),
),
cancelled_issues=Count(
"issue_module__issue__id",
distinct=True,
filter=Q(
issue_module__issue__state__group__in=["cancelled"],
issue_module__issue__archived_at__isnull=True,
issue_module__issue__is_draft=False,
issue_module__deleted_at__isnull=True,
),
),
unstarted_issues=Count(
"issue_module__issue__id",
distinct=True,
filter=Q(
issue_module__issue__state__group__in=["unstarted"],
issue_module__issue__archived_at__isnull=True,
issue_module__issue__is_draft=False,
issue_module__deleted_at__isnull=True,
),
),
started_issues=Count(
"issue_module__issue__id",
distinct=True,
filter=Q(
issue_module__issue__state__group__in=["started"],
issue_module__issue__archived_at__isnull=True,
issue_module__issue__is_draft=False,
issue_module__deleted_at__isnull=True,
),
),
)
.values(
"id",
"name",
"project__name",
"total_issues",
"completed_issues",
"unstarted_issues",
"started_issues",
"cancelled_issues",
"status",
"start_date",
"target_date",
)
)
# Calculate completion percentage for each module
data = []
for module in queryset:
total_issues = module.get("total_issues", 0)
completed_issues = module.get("completed_issues", 0)
completion_percentage = (completed_issues / total_issues * 100) if total_issues > 0 else 0
data.append(
{
"key": module.get("name"),
"name": module.get("name"),
"count": round(completion_percentage, 2),
"total_issues": total_issues,
"completed_issues": completed_issues,
"unstarted_issues": module.get("unstarted_issues", 0),
"started_issues": module.get("started_issues", 0),
"cancelled_issues": module.get("cancelled_issues", 0),
"status": module.get("status"),
"start_date": module.get("start_date"),
"target_date": module.get("target_date"),
}
)
return {"data": data, "schema": {}}
def intake_chart(self) -> Dict[str, Any]:
# Get the base queryset
queryset = (
Issue.objects.filter(**self.filters["base_filters"])
.filter(issue_intake__isnull=False, issue_intake__status__in=[1, -1])
.select_related("workspace", "issue_intake")
)
# Annotate by month and count accepted/rejected intakes
monthly_stats = (
queryset.annotate(month=TruncMonth("created_at"))
.values("month")
.annotate(
accepted_count=Count("id", filter=Q(issue_intake__status=1)),
rejected_count=Count("id", filter=Q(issue_intake__status=-1)),
)
.order_by("month")
)
# Create dictionary of month -> counts
stats_dict = {
stat["month"].strftime("%Y-%m-%d"): {
"accepted_count": stat["accepted_count"],
"rejected_count": stat["rejected_count"],
}
for stat in monthly_stats
}
# Generate monthly data (ensure months with 0 count are included)
data = []
current_year = timezone.now().year
start_date = timezone.datetime(current_year, 1, 1).date()
end_date = timezone.datetime(current_year, 12, 1).date()
current_month = start_date
while current_month <= end_date:
date_str = current_month.strftime("%Y-%m-%d")
stats = stats_dict.get(date_str, {"accepted_count": 0, "rejected_count": 0})
data.append(
{
"key": date_str,
"name": date_str,
"count": stats["accepted_count"] + stats["rejected_count"],
"accepted_count": stats["accepted_count"],
"rejected_count": stats["rejected_count"],
}
)
# Move to next month
if current_month.month == 12:
break
current_month = current_month.replace(month=current_month.month + 1)
schema = {
"accepted_count": "accepted_count",
"rejected_count": "rejected_count",
}
return {"data": data, "schema": schema}
@allow_permission([ROLE.ADMIN, ROLE.MEMBER], level="WORKSPACE")
def get(self, request: HttpRequest, slug: str) -> Response:
self.initialize_workspace(slug, type="chart")
@@ -311,4 +1173,38 @@ class AdvanceAnalyticsChartEndpoint(AdvanceAnalyticsBaseView):
status=status.HTTP_200_OK,
)
if check_workspace_feature_flag(
feature_key=FeatureFlag.ANALYTICS_ADVANCED,
slug=slug,
user_id=str(request.user.id),
):
if type == "project-status":
return Response(
self.project_status_chart(),
status=status.HTTP_200_OK,
)
elif type == "cycles":
return Response(
self.cycle_chart(),
status=status.HTTP_200_OK,
)
elif type == "modules":
return Response(
self.module_chart(),
status=status.HTTP_200_OK,
)
elif type == "intake":
return Response(
self.intake_chart(),
status=status.HTTP_200_OK,
)
else:
return Response(
{
"error": "Payment required",
"error_code": ErrorCodes.PAYMENT_REQUIRED.value,
},
status=status.HTTP_402_PAYMENT_REQUIRED,
)
return Response({"message": "Invalid type"}, status=status.HTTP_400_BAD_REQUEST)
@@ -98,6 +98,7 @@ class AnalyticsEndpoint(BaseAPIView):
labels__id__isnull=False,
label_issue__deleted_at__isnull=True,
)
.filter(Q(type__isnull=True) | Q(type__is_epic=False))
.distinct("labels__id")
.order_by("labels__id")
.values("labels__id", "labels__color", "labels__name")
@@ -475,4 +476,5 @@ class ProjectStatsEndpoint(BaseAPIView):
)
projects = projects.annotate(**annotations).values("id", *requested_fields)
return Response(projects, status=status.HTTP_200_OK)
@@ -1,3 +1,4 @@
from datetime import timedelta
from rest_framework.response import Response
from rest_framework import status
from typing import Dict, Any
@@ -5,7 +6,9 @@ from django.db.models import QuerySet, Q, Count
from django.http import HttpRequest
from django.db.models.functions import TruncMonth
from django.utils import timezone
from datetime import timedelta
from django.db import models
from django.db.models import F, Case, When, Value
from django.db.models.functions import Concat
from plane.app.views.base import BaseAPIView
from plane.app.permissions import ROLE, allow_permission
from plane.db.models import (
@@ -16,13 +19,13 @@ from plane.db.models import (
CycleIssue,
ModuleIssue,
)
from django.db import models
from django.db.models import F, Case, When, Value
from django.db.models.functions import Concat
from plane.utils.build_chart import build_analytics_chart
from plane.utils.date_utils import (
get_analytics_filters,
)
from plane.payment.flags.flag_decorator import check_workspace_feature_flag
from plane.payment.flags.flag import FeatureFlag
class ProjectAdvanceAnalyticsBaseView(BaseAPIView):
@@ -51,7 +54,7 @@ class ProjectAdvanceAnalyticsEndpoint(ProjectAdvanceAnalyticsBaseView):
"count": get_filtered_count(),
}
def get_work_items_stats(self, project_id, cycle_id=None, module_id=None) -> Dict[str, Dict[str, int]]:
def get_work_items_stats(self, project_id, cycle_id=None, module_id=None, epic=False) -> Dict[str, Dict[str, int]]:
"""
Returns work item stats for the workspace, or filtered by cycle_id or module_id if provided.
"""
@@ -66,6 +69,10 @@ class ProjectAdvanceAnalyticsEndpoint(ProjectAdvanceAnalyticsBaseView):
"issue_id", flat=True
)
base_queryset = Issue.issue_objects.filter(id__in=module_issues)
elif epic:
base_queryset = Issue.objects.filter(**self.filters["base_filters"], project_id=project_id).filter(
Q(type__isnull=False) & Q(type__is_epic=True)
)
else:
base_queryset = Issue.issue_objects.filter(**self.filters["base_filters"], project_id=project_id)
@@ -84,8 +91,13 @@ class ProjectAdvanceAnalyticsEndpoint(ProjectAdvanceAnalyticsBaseView):
# Optionally accept cycle_id or module_id as query params
cycle_id = request.GET.get("cycle_id", None)
module_id = request.GET.get("module_id", None)
epic = request.GET.get("epic", False) and check_workspace_feature_flag(
feature_key=FeatureFlag.EPICS,
slug=slug,
user_id=request.user.id,
)
return Response(
self.get_work_items_stats(cycle_id=cycle_id, module_id=module_id, project_id=project_id),
self.get_work_items_stats(cycle_id=cycle_id, module_id=module_id, project_id=project_id, epic=epic),
status=status.HTTP_200_OK,
)
@@ -112,7 +124,7 @@ class ProjectAdvanceAnalyticsStatsEndpoint(ProjectAdvanceAnalyticsBaseView):
.order_by("project_id")
)
def get_work_items_stats(self, project_id, cycle_id=None, module_id=None) -> Dict[str, Dict[str, int]]:
def get_work_items_stats(self, project_id, cycle_id=None, module_id=None, epic=False) -> Dict[str, Dict[str, int]]:
base_queryset = None
if cycle_id is not None:
cycle_issues = CycleIssue.objects.filter(**self.filters["base_filters"], cycle_id=cycle_id).values_list(
@@ -124,6 +136,10 @@ class ProjectAdvanceAnalyticsStatsEndpoint(ProjectAdvanceAnalyticsBaseView):
"issue_id", flat=True
)
base_queryset = Issue.issue_objects.filter(id__in=module_issues)
elif epic:
base_queryset = Issue.objects.filter(**self.filters["base_filters"], project_id=project_id).filter(
Q(type__isnull=False) & Q(type__is_epic=True)
)
else:
base_queryset = Issue.issue_objects.filter(**self.filters["base_filters"], project_id=project_id)
return (
@@ -167,8 +183,18 @@ class ProjectAdvanceAnalyticsStatsEndpoint(ProjectAdvanceAnalyticsBaseView):
# Optionally accept cycle_id or module_id as query params
cycle_id = request.GET.get("cycle_id", None)
module_id = request.GET.get("module_id", None)
epic = request.GET.get("epic", False) and check_workspace_feature_flag(
feature_key=FeatureFlag.EPICS,
slug=slug,
user_id=request.user.id,
)
return Response(
self.get_work_items_stats(project_id=project_id, cycle_id=cycle_id, module_id=module_id),
self.get_work_items_stats(
project_id=project_id,
cycle_id=cycle_id,
module_id=module_id,
epic=epic,
),
status=status.HTTP_200_OK,
)
@@ -176,14 +202,8 @@ class ProjectAdvanceAnalyticsStatsEndpoint(ProjectAdvanceAnalyticsBaseView):
class ProjectAdvanceAnalyticsChartEndpoint(ProjectAdvanceAnalyticsBaseView):
def work_item_completion_chart(self, project_id, cycle_id=None, module_id=None) -> Dict[str, Any]:
# Get the base queryset
queryset = (
Issue.issue_objects.filter(**self.filters["base_filters"])
.filter(project_id=project_id)
.select_related("workspace", "state", "parent")
.prefetch_related("assignees", "labels", "issue_module__module", "issue_cycle__cycle")
)
def work_item_completion_chart(self, project_id, cycle_id=None, module_id=None, epic=False) -> Dict[str, Any]:
queryset = None
if cycle_id is not None:
cycle_issues = CycleIssue.objects.filter(**self.filters["base_filters"], cycle_id=cycle_id).values_list(
@@ -209,7 +229,26 @@ class ProjectAdvanceAnalyticsChartEndpoint(ProjectAdvanceAnalyticsBaseView):
return {"data": [], "schema": {}}
queryset = module_issues
elif epic:
queryset = Issue.objects.filter(**self.filters["base_filters"], project_id=project_id).filter(
Q(type__isnull=False) & Q(type__is_epic=True)
)
project = Project.objects.filter(id=project_id).first()
if project.created_at:
start_date = project.created_at.date().replace(day=1)
else:
return {"data": [], "schema": {}}
else:
# Get the base queryset
queryset = (
Issue.issue_objects.filter(**self.filters["base_filters"])
.filter(project_id=project_id)
.select_related("workspace", "state", "parent")
.prefetch_related("assignees", "labels", "issue_module__module", "issue_cycle__cycle")
)
project = Project.objects.filter(id=project_id).first()
if project.created_at:
start_date = project.created_at.date().replace(day=1)
@@ -318,7 +357,11 @@ class ProjectAdvanceAnalyticsChartEndpoint(ProjectAdvanceAnalyticsBaseView):
x_axis = request.GET.get("x_axis", "PRIORITY")
cycle_id = request.GET.get("cycle_id", None)
module_id = request.GET.get("module_id", None)
epic = request.GET.get("epic", False) and check_workspace_feature_flag(
feature_key=FeatureFlag.EPICS,
slug=slug,
user_id=request.user.id,
)
if type == "custom-work-items":
queryset = (
Issue.issue_objects.filter(**self.filters["base_filters"])
@@ -340,6 +383,17 @@ class ProjectAdvanceAnalyticsChartEndpoint(ProjectAdvanceAnalyticsBaseView):
).values_list("issue_id", flat=True)
queryset = queryset.filter(id__in=module_issues)
elif epic:
queryset = (
Issue.objects.filter(**self.filters["base_filters"], project_id=project_id)
.filter(Q(type__isnull=False) & Q(type__is_epic=True))
.select_related("workspace", "state", "parent")
.prefetch_related(
"assignees",
"labels",
)
)
# Apply date range filter if available
if self.filters["chart_period_range"]:
start_date, end_date = self.filters["chart_period_range"]
@@ -351,12 +405,13 @@ class ProjectAdvanceAnalyticsChartEndpoint(ProjectAdvanceAnalyticsBaseView):
)
elif type == "work-items":
# Optionally accept cycle_id or module_id as query params
cycle_id = request.GET.get("cycle_id", None)
module_id = request.GET.get("module_id", None)
return Response(
self.work_item_completion_chart(project_id=project_id, cycle_id=cycle_id, module_id=module_id),
self.work_item_completion_chart(
project_id=project_id,
cycle_id=cycle_id,
module_id=module_id,
epic=epic,
),
status=status.HTTP_200_OK,
)
+5 -1
View File
@@ -2,6 +2,8 @@
from uuid import uuid4
from typing import Optional
# Django imports
# Third party
from rest_framework.response import Response
from rest_framework.request import Request
@@ -65,7 +67,9 @@ class ServiceApiTokenEndpoint(BaseAPIView):
def post(self, request: Request, slug: str) -> Response:
workspace = Workspace.objects.get(slug=slug)
api_token = APIToken.objects.filter(workspace=workspace, is_service=True).first()
api_token = APIToken.objects.filter(
workspace=workspace, is_service=True, user=request.user, expired_at__isnull=True
).first()
if api_token:
return Response({"token": str(api_token.token)}, status=status.HTTP_200_OK)

Some files were not shown because too many files have changed in this diff Show More