* Basic setup for drf-spectacular * Updated to only handle /api/v1 endpoints * feat: add asset and user endpoints with URL routing - Introduced new asset-related endpoints for user assets and server assets, allowing for asset uploads and management. - Added user endpoint to retrieve current user information. - Updated URL routing to include new asset and user patterns. - Enhanced issue handling with a new search endpoint for issues across multiple fields. - Expanded member management with a new endpoint for workspace members. * Group endpoints by tags * Detailed schema definitions and examples for asset endpoints * Removed unnecessary extension * Specify avatar_url field separately * chore: add project docs * chore: correct all errors * chore: added open spec in work items * feat: enhance cycle API endpoints with detailed OpenAPI specifications - Updated CycleAPIEndpoint and CycleIssueAPIEndpoint to include detailed OpenAPI schema definitions for GET, POST, PATCH, and DELETE operations. - Specified allowed HTTP methods for each endpoint in the URL routing. - Improved documentation for cycle creation, updating, and deletion, including request and response examples. * chore: added open spec in labels * chore: work item properties * feat: enhance API endpoints with OpenAPI specifications and HTTP method definitions - Added detailed OpenAPI schema definitions for various API endpoints including Intake, Module, and State. - Specified allowed HTTP methods for each endpoint in the URL routing for better clarity and documentation. - Improved request and response examples for better understanding of API usage. - Introduced unarchive functionality for cycles and modules with appropriate endpoint definitions. * chore: run formatter * Removed unnecessary settings for authentication * Refactors OpenAPI documentation structure Improves the organization and maintainability of the OpenAPI documentation by modularizing the `openapi_spec_helpers.py` file. The changes include: - Migrates common parameters, responses, examples, and authentication extensions to separate modules. - Introduces helper decorators for different endpoint types. - Updates view imports to use the new module paths. - Removes the legacy `openapi_spec_helpers.py` file. This refactoring results in a more structured and easier-to-maintain OpenAPI documentation setup. * Refactor OpenAPI endpoint specifications - Removed unnecessary parameters from the OpenAPI documentation for various endpoints in the asset, cycle, and project views. - Updated request structures to improve clarity and consistency across the API documentation. - Enhanced response formatting for better readability and maintainability. * Enhance API documentation with detailed endpoint descriptions Updated various API endpoints across the application to include comprehensive docstrings that clarify their functionality. Each endpoint now features a summary and detailed description, improving the overall understanding of their purpose and usage. This change enhances the OpenAPI specifications for better developer experience and documentation clarity. * Enhance API serializers and views with new request structures - Added new serializers for handling cycle and module issue requests, including `CycleIssueRequestSerializer`, `TransferCycleIssueRequestSerializer`, `ModuleIssueRequestSerializer`, and intake issue creation/updating serializers. - Updated existing serializers to improve clarity and maintainability, including the `UserAssetUploadSerializer` and `IssueAttachmentUploadSerializer`. - Refactored API views to utilize the new serializers, enhancing the request handling for cycle and intake issue endpoints. - Improved OpenAPI documentation by replacing inline request definitions with serializer references for better consistency and readability. * Refactor OpenAPI documentation and endpoint specifications - Replaced inline schema definitions with dedicated decorators for various endpoint types, enhancing clarity and maintainability. - Updated API views to utilize new decorators for user, cycle, intake, module, and project endpoints, improving consistency in OpenAPI documentation. - Removed unnecessary parameters and responses from endpoint specifications, streamlining the documentation for better readability. - Enhanced the organization of OpenAPI documentation by modularizing endpoint-specific decorators and parameters. * chore: correct formatting * chore: correct formatting for all api folder files * refactor: clean up serializer imports and test setup - Removed unused `StateLiteSerializer` import from the serializer module. - Updated test setup to include a noqa comment for the `django_db_setup` fixture, ensuring clarity in the code. - Added missing commas in user data dictionary for consistency. * feat: add project creation and update serializers with validation - Introduced `ProjectCreateSerializer` and `ProjectUpdateSerializer` to handle project creation and updates, respectively. - Implemented validation to ensure project leads and default assignees are members of the workspace. - Updated API views to utilize the new serializers for creating and updating projects, enhancing request handling. - Added OpenAPI documentation references for the new serializers in the project API endpoints. * feat: update serializers to include additional read-only fields * refactor: rename intake issue serializers and enhance structure - Renamed `CreateIntakeIssueRequestSerializer` to `IntakeIssueCreateSerializer` and `UpdateIntakeIssueRequestSerializer` to `IntakeIssueUpdateSerializer` for clarity. - Introduced `IssueSerializer` for nested issue data in intake requests, improving the organization of serializer logic. - Updated API views to utilize the new serializer names, ensuring consistency across the codebase. * refactor: rename issue serializer for intake and enhance API documentation - Renamed `IssueSerializer` to `IssueForIntakeSerializer` for better clarity in the context of intake issues. - Updated references in `IntakeIssueCreateSerializer` and `IntakeIssueUpdateSerializer` to use the new `IssueForIntakeSerializer`. - Added OpenAPI documentation for the `get_workspace_work_item` endpoint, detailing parameters and responses for improved clarity. * chore: modules and cycles serializers * feat: add new serializers for label and issue link management - Introduced `LabelCreateUpdateSerializer`, `IssueLinkCreateSerializer`, `IssueLinkUpdateSerializer`, and `IssueCommentCreateSerializer` to enhance the handling of label and issue link data. - Updated existing API views to utilize the new serializers for creating and updating labels, issue links, and comments, improving request handling and validation. - Added `IssueSearchSerializer` for searching issues, streamlining the search functionality in the API. * Don't consider read only fields as required * Add setting to separate request and response definitions * Fixed avatar_url warning on openapi spec generation * Made spectacular disabled by default * Moved spectacular settings into separate file and added detailed descriptions to tags * Specify methods for asset urls * Better server names * Enhance API documentation with summaries for various endpoints - Added summary descriptions for user asset, cycle, intake, issue, member, module, project, state, and user API endpoints to improve clarity and usability of the API documentation. - Updated the OpenAPI specifications to reflect these changes, ensuring better understanding for developers interacting with the API. * Add contact information to OpenAPI settings - Included contact details for Plane in the OpenAPI settings to enhance API documentation and provide developers with a direct point of contact for support. - This addition aims to improve the overall usability and accessibility of the API documentation. * Reordered tags and improved description relavancy * Enhance OpenAPI documentation for cycle and issue endpoints - Added response definitions for the `get_cycle_issues` and `delete_cycle_issue` methods in the CycleIssueAPIEndpoint to clarify expected outcomes. - Included additional response codes for the IssueSearchEndpoint to handle various error scenarios, improving the overall API documentation and usability. * Enhance serializer documentation across multiple files - Updated docstrings for various serializers including UserAssetUploadSerializer, AssetUpdateSerializer, and others to provide clearer descriptions of their functionality and usage. - Improved consistency in formatting and language across serializer classes to enhance readability and maintainability. - Added detailed explanations for new serializers related to project, module, and cycle management, ensuring comprehensive documentation for developers. * Refactor API endpoints for cycles, intake, modules, projects, and states - Replaced existing API endpoint classes with more descriptive names such as CycleListCreateAPIEndpoint, CycleDetailAPIEndpoint, IntakeIssueListCreateAPIEndpoint, and others to enhance clarity. - Updated URL patterns to reflect the new endpoint names, ensuring consistency across the API. - Improved documentation and method summaries for better understanding of endpoint functionalities. - Enhanced query handling in the new endpoint classes to streamline data retrieval and improve performance. * Refactor issue and label API endpoints for clarity and functionality - Renamed existing API endpoint classes to more descriptive names such as IssueListCreateAPIEndpoint, IssueDetailAPIEndpoint, LabelListCreateAPIEndpoint, and LabelDetailAPIEndpoint to enhance clarity. - Updated URL patterns to reflect the new endpoint names, ensuring consistency across the API. - Improved method summaries and documentation for better understanding of endpoint functionalities. - Streamlined query handling in the new endpoint classes to enhance data retrieval and performance. * Refactor asset API endpoint methods and introduce new status enums - Updated the GenericAssetEndpoint to only allow POST requests for asset creation, removing the GET method. - Modified the get method to require asset_id, ensuring that asset retrieval is always tied to a specific asset. - Added new IntakeIssueStatus and ModuleStatus enums to improve clarity and management of asset and module states. - Enhanced OpenAPI settings to include these new enums for better documentation and usability. * enforce naming convention * Added LICENSE to openapi spec * Enhance OpenAPI documentation for various API endpoints - Updated API endpoints in asset, cycle, intake, issue, module, project, and state views to include OpenApiRequest and OpenApiExample for better request documentation. - Added example requests for creating and updating resources, improving clarity for API consumers. - Ensured consistent use of OpenApi utilities across all relevant endpoints to enhance overall API documentation quality. * Enhance OpenAPI documentation for various API endpoints - Added detailed descriptions to multiple API endpoints across asset, cycle, intake, issue, module, project, state, and user views to improve clarity for API consumers. - Ensured consistent documentation practices by including descriptions that outline the purpose and functionality of each endpoint. - This update aims to enhance the overall usability and understanding of the API documentation. * Update OpenAPI examples and enhance project queryset logic - Changed example fields in OpenAPI documentation for issue comments from "content" to "comment_html" to reflect the correct structure. - Introduced a new `get_queryset` method in the ProjectDetailAPIEndpoint to filter projects based on user membership and workspace, while also annotating additional project-related data such as total members, cycles, and modules. - Updated permission checks to use the correct attribute name for project identifiers, ensuring accurate permission handling. * Enhance OpenAPI documentation and add response examples - Updated multiple API endpoints across asset, cycle, intake, issue, module, project, state, and user views to include new OpenApiResponse examples for better clarity on expected outcomes. - Introduced new parameters for project and issue identifiers to improve request handling and documentation consistency. - Enhanced existing responses with detailed examples to aid API consumers in understanding the expected data structure and error handling. - This update aims to improve the overall usability and clarity of the API documentation. * refactor: update terminology from 'issues' to 'work items' across multiple API endpoints for consistency and clarity * use common timezones from pytz for choices * Moved the openapi utils to the new folder structure * Added exception logging in GenericAssetEndpoint to improve error handling * Fixed code rabbit suggestions * Refactored IssueDetailAPIEndpoint to streamline issue retrieval and response handling, removing redundant external ID checks and custom ordering logic. --------- Co-authored-by: pablohashescobar <nikhilschacko@gmail.com> Co-authored-by: NarayanBavisetti <narayan3119@gmail.com>
278 lines
8.9 KiB
Python
278 lines
8.9 KiB
Python
# Python imports
|
|
import random
|
|
import string
|
|
import uuid
|
|
|
|
import pytz
|
|
from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin, UserManager
|
|
|
|
# Django imports
|
|
from django.db import models
|
|
from django.db.models.signals import post_save
|
|
from django.dispatch import receiver
|
|
from django.utils import timezone
|
|
|
|
# Module imports
|
|
from plane.db.models import FileAsset
|
|
from ..mixins import TimeAuditModel
|
|
|
|
|
|
def get_default_onboarding():
|
|
return {
|
|
"profile_complete": False,
|
|
"workspace_create": False,
|
|
"workspace_invite": False,
|
|
"workspace_join": False,
|
|
}
|
|
|
|
|
|
def get_mobile_default_onboarding():
|
|
return {
|
|
"profile_complete": False,
|
|
"workspace_create": False,
|
|
"workspace_join": False,
|
|
}
|
|
|
|
|
|
class User(AbstractBaseUser, PermissionsMixin):
|
|
id = models.UUIDField(
|
|
default=uuid.uuid4, unique=True, editable=False, db_index=True, primary_key=True
|
|
)
|
|
username = models.CharField(max_length=128, unique=True)
|
|
# user fields
|
|
mobile_number = models.CharField(max_length=255, blank=True, null=True)
|
|
email = models.CharField(max_length=255, null=True, blank=True, unique=True)
|
|
|
|
# identity
|
|
display_name = models.CharField(max_length=255, default="")
|
|
first_name = models.CharField(max_length=255, blank=True)
|
|
last_name = models.CharField(max_length=255, blank=True)
|
|
# avatar
|
|
avatar = models.TextField(blank=True)
|
|
avatar_asset = models.ForeignKey(
|
|
FileAsset,
|
|
on_delete=models.SET_NULL,
|
|
null=True,
|
|
blank=True,
|
|
related_name="user_avatar",
|
|
)
|
|
# cover image
|
|
cover_image = models.URLField(blank=True, null=True, max_length=800)
|
|
cover_image_asset = models.ForeignKey(
|
|
FileAsset,
|
|
on_delete=models.SET_NULL,
|
|
null=True,
|
|
blank=True,
|
|
related_name="user_cover_image",
|
|
)
|
|
|
|
# tracking metrics
|
|
date_joined = models.DateTimeField(auto_now_add=True, verbose_name="Created At")
|
|
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Created At")
|
|
updated_at = models.DateTimeField(auto_now=True, verbose_name="Last Modified At")
|
|
last_location = models.CharField(max_length=255, blank=True)
|
|
created_location = models.CharField(max_length=255, blank=True)
|
|
|
|
# the is' es
|
|
is_superuser = models.BooleanField(default=False)
|
|
is_managed = models.BooleanField(default=False)
|
|
is_password_expired = models.BooleanField(default=False)
|
|
is_active = models.BooleanField(default=True)
|
|
is_staff = models.BooleanField(default=False)
|
|
is_email_verified = models.BooleanField(default=False)
|
|
is_password_autoset = models.BooleanField(default=False)
|
|
|
|
# random token generated
|
|
token = models.CharField(max_length=64, blank=True)
|
|
|
|
last_active = models.DateTimeField(default=timezone.now, null=True)
|
|
last_login_time = models.DateTimeField(null=True)
|
|
last_logout_time = models.DateTimeField(null=True)
|
|
last_login_ip = models.CharField(max_length=255, blank=True)
|
|
last_logout_ip = models.CharField(max_length=255, blank=True)
|
|
last_login_medium = models.CharField(max_length=20, default="email")
|
|
last_login_uagent = models.TextField(blank=True)
|
|
token_updated_at = models.DateTimeField(null=True)
|
|
# my_issues_prop = models.JSONField(null=True)
|
|
|
|
is_bot = models.BooleanField(default=False)
|
|
bot_type = models.CharField(
|
|
max_length=30, verbose_name="Bot Type", blank=True, null=True
|
|
)
|
|
|
|
# timezone
|
|
USER_TIMEZONE_CHOICES = tuple(zip(pytz.common_timezones, pytz.common_timezones))
|
|
user_timezone = models.CharField(
|
|
max_length=255, default="UTC", choices=USER_TIMEZONE_CHOICES
|
|
)
|
|
|
|
# email validation
|
|
is_email_valid = models.BooleanField(default=False)
|
|
|
|
# masking
|
|
masked_at = models.DateTimeField(null=True)
|
|
|
|
USERNAME_FIELD = "email"
|
|
REQUIRED_FIELDS = ["username"]
|
|
|
|
objects = UserManager()
|
|
|
|
class Meta:
|
|
verbose_name = "User"
|
|
verbose_name_plural = "Users"
|
|
db_table = "users"
|
|
ordering = ("-created_at",)
|
|
|
|
def __str__(self):
|
|
return f"{self.username} <{self.email}>"
|
|
|
|
@property
|
|
def avatar_url(self):
|
|
# Return the logo asset url if it exists
|
|
if self.avatar_asset:
|
|
return self.avatar_asset.asset_url
|
|
|
|
# Return the logo url if it exists
|
|
if self.avatar:
|
|
return self.avatar
|
|
return None
|
|
|
|
@property
|
|
def cover_image_url(self):
|
|
# Return the logo asset url if it exists
|
|
if self.cover_image_asset:
|
|
return self.cover_image_asset.asset_url
|
|
|
|
# Return the logo url if it exists
|
|
if self.cover_image:
|
|
return self.cover_image
|
|
return None
|
|
|
|
def save(self, *args, **kwargs):
|
|
self.email = self.email.lower().strip()
|
|
self.mobile_number = self.mobile_number
|
|
|
|
if self.token_updated_at is not None:
|
|
self.token = uuid.uuid4().hex + uuid.uuid4().hex
|
|
self.token_updated_at = timezone.now()
|
|
|
|
if not self.display_name:
|
|
self.display_name = (
|
|
self.email.split("@")[0]
|
|
if len(self.email.split("@"))
|
|
else "".join(random.choice(string.ascii_letters) for _ in range(6))
|
|
)
|
|
|
|
if self.is_superuser:
|
|
self.is_staff = True
|
|
|
|
super(User, self).save(*args, **kwargs)
|
|
|
|
|
|
class Profile(TimeAuditModel):
|
|
SUNDAY = 0
|
|
MONDAY = 1
|
|
TUESDAY = 2
|
|
WEDNESDAY = 3
|
|
THURSDAY = 4
|
|
FRIDAY = 5
|
|
SATURDAY = 6
|
|
|
|
START_OF_THE_WEEK_CHOICES = (
|
|
(SUNDAY, "Sunday"),
|
|
(MONDAY, "Monday"),
|
|
(TUESDAY, "Tuesday"),
|
|
(WEDNESDAY, "Wednesday"),
|
|
(THURSDAY, "Thursday"),
|
|
(FRIDAY, "Friday"),
|
|
(SATURDAY, "Saturday"),
|
|
)
|
|
|
|
id = models.UUIDField(
|
|
default=uuid.uuid4, unique=True, editable=False, db_index=True, primary_key=True
|
|
)
|
|
# User
|
|
user = models.OneToOneField(
|
|
"db.User", on_delete=models.CASCADE, related_name="profile"
|
|
)
|
|
# General
|
|
theme = models.JSONField(default=dict)
|
|
is_app_rail_docked = models.BooleanField(default=True)
|
|
# Onboarding
|
|
is_tour_completed = models.BooleanField(default=False)
|
|
onboarding_step = models.JSONField(default=get_default_onboarding)
|
|
use_case = models.TextField(blank=True, null=True)
|
|
role = models.CharField(max_length=300, null=True, blank=True) # job role
|
|
is_onboarded = models.BooleanField(default=False)
|
|
# Last visited workspace
|
|
last_workspace_id = models.UUIDField(null=True)
|
|
# address data
|
|
billing_address_country = models.CharField(max_length=255, default="INDIA")
|
|
billing_address = models.JSONField(null=True)
|
|
has_billing_address = models.BooleanField(default=False)
|
|
company_name = models.CharField(max_length=255, blank=True)
|
|
|
|
is_smooth_cursor_enabled = models.BooleanField(default=False)
|
|
# mobile
|
|
is_mobile_onboarded = models.BooleanField(default=False)
|
|
mobile_onboarding_step = models.JSONField(default=get_mobile_default_onboarding)
|
|
mobile_timezone_auto_set = models.BooleanField(default=False)
|
|
# language
|
|
language = models.CharField(max_length=255, default="en")
|
|
start_of_the_week = models.PositiveSmallIntegerField(
|
|
choices=START_OF_THE_WEEK_CHOICES, default=SUNDAY
|
|
)
|
|
|
|
class Meta:
|
|
verbose_name = "Profile"
|
|
verbose_name_plural = "Profiles"
|
|
db_table = "profiles"
|
|
ordering = ("-created_at",)
|
|
|
|
|
|
class Account(TimeAuditModel):
|
|
PROVIDER_CHOICES = (
|
|
("google", "Google"),
|
|
("github", "Github"),
|
|
("gitlab", "GitLab"),
|
|
)
|
|
|
|
id = models.UUIDField(
|
|
default=uuid.uuid4, unique=True, editable=False, db_index=True, primary_key=True
|
|
)
|
|
user = models.ForeignKey(
|
|
"db.User", on_delete=models.CASCADE, related_name="accounts"
|
|
)
|
|
provider_account_id = models.CharField(max_length=255)
|
|
provider = models.CharField(choices=PROVIDER_CHOICES)
|
|
access_token = models.TextField()
|
|
access_token_expired_at = models.DateTimeField(null=True)
|
|
refresh_token = models.TextField(null=True, blank=True)
|
|
refresh_token_expired_at = models.DateTimeField(null=True)
|
|
last_connected_at = models.DateTimeField(default=timezone.now)
|
|
id_token = models.TextField(blank=True)
|
|
metadata = models.JSONField(default=dict)
|
|
|
|
class Meta:
|
|
unique_together = ["provider", "provider_account_id"]
|
|
verbose_name = "Account"
|
|
verbose_name_plural = "Accounts"
|
|
db_table = "accounts"
|
|
ordering = ("-created_at",)
|
|
|
|
|
|
@receiver(post_save, sender=User)
|
|
def create_user_notification(sender, instance, created, **kwargs):
|
|
# create preferences
|
|
if created and not instance.is_bot:
|
|
# Module imports
|
|
from plane.db.models import UserNotificationPreference
|
|
|
|
UserNotificationPreference.objects.create(
|
|
user=instance,
|
|
property_change=False,
|
|
state_change=False,
|
|
comment=False,
|
|
mention=False,
|
|
issue_completed=False,
|
|
)
|