293 lines
12 KiB
Python
293 lines
12 KiB
Python
from django.shortcuts import get_object_or_404
|
|
|
|
from rest_framework import status
|
|
from rest_framework.viewsets import ModelViewSet
|
|
from rest_framework.response import Response
|
|
from rest_framework.permissions import IsAuthenticated
|
|
from rest_framework.decorators import action
|
|
from rest_framework.filters import SearchFilter, OrderingFilter
|
|
from django_filters.rest_framework import DjangoFilterBackend
|
|
|
|
from core.paginations.limit_offset import CustomLimitOffsetPagination
|
|
|
|
from apps.workspaces.models import Workspace
|
|
from apps.clients.models import Client
|
|
from apps.projects.models import Project
|
|
from apps.projects.api.serializers import (
|
|
ProjectSerializer, ProjectCreateSerializer, ProjectUpdateSerializer,
|
|
ProjectAccessMutationSerializer, ProjectAccessQuerySerializer,
|
|
ProjectAccessRateMutationSerializer,
|
|
)
|
|
from apps.projects.api.permissions import IsProjectMember, IsProjectManager
|
|
from apps.projects.services.access import (
|
|
build_project_access_item,
|
|
build_project_access_items,
|
|
ensure_workspace_project_access,
|
|
filter_projects_for_user,
|
|
get_project_access_target_membership,
|
|
grant_project_accesses,
|
|
revoke_project_accesses,
|
|
user_has_project_access,
|
|
)
|
|
from apps.projects.services.rates import get_current_project_user_rate, remove_project_user_rate, upsert_project_user_rate
|
|
from apps.projects.services.projects import (
|
|
create_project,
|
|
update_project,
|
|
toggle_project_archive
|
|
)
|
|
from apps.workspaces.services import (
|
|
PROJECTS_ARCHIVE,
|
|
PROJECTS_CREATE,
|
|
PROJECTS_DELETE,
|
|
PROJECTS_EDIT,
|
|
can_delete_workspace_object,
|
|
has_workspace_capability,
|
|
)
|
|
|
|
|
|
class ProjectViewSet(ModelViewSet):
|
|
"""
|
|
API endpoints for managing projects.
|
|
"""
|
|
pagination_class = CustomLimitOffsetPagination
|
|
|
|
filter_backends = [DjangoFilterBackend, SearchFilter, OrderingFilter]
|
|
filterset_fields = ["workspace", "client", "is_archived"]
|
|
search_fields = ["name", "description"]
|
|
ordering_fields = ["name", "created_at", "updated_at"]
|
|
ordering = ["-updated_at", "-created_at"]
|
|
|
|
def get_permissions(self):
|
|
"""
|
|
Instantiates and returns the list of permissions that this view requires.
|
|
- Workspace-authorized users can update, delete, or archive.
|
|
- Workspace members can retrieve/view.
|
|
- Any authenticated user can list their workspace projects or attempt to create.
|
|
"""
|
|
if self.action in ["update", "partial_update", "destroy", "archive"]:
|
|
permission_classes = [IsAuthenticated, IsProjectManager]
|
|
elif self.action in ["retrieve"]:
|
|
permission_classes = [IsAuthenticated, IsProjectMember]
|
|
else:
|
|
permission_classes = [IsAuthenticated]
|
|
|
|
return [permission() for permission in permission_classes]
|
|
|
|
def get_queryset(self):
|
|
"""
|
|
Returns active projects in workspaces where the current user is an active member.
|
|
"""
|
|
if getattr(self, "swagger_fake_view", False) or not self.request.user.is_authenticated:
|
|
return Project.objects.none()
|
|
|
|
queryset = filter_projects_for_user(
|
|
self.request.user,
|
|
Project.objects.filter(is_deleted=False),
|
|
)
|
|
|
|
client_ids = [client_id for client_id in self.request.query_params.getlist("clients") if client_id]
|
|
if client_ids:
|
|
queryset = queryset.filter(client_id__in=client_ids)
|
|
|
|
if "is_archived" not in self.request.query_params:
|
|
queryset = queryset.filter(is_archived=False)
|
|
|
|
return queryset
|
|
|
|
def get_serializer_class(self):
|
|
"""
|
|
Selects the appropriate serializer based on the request action.
|
|
"""
|
|
if self.action == "create":
|
|
return ProjectCreateSerializer
|
|
elif self.action in ["update", "partial_update"]:
|
|
return ProjectUpdateSerializer
|
|
return ProjectSerializer
|
|
|
|
def create(self, request, *args, **kwargs):
|
|
"""
|
|
Creates a new project using the project service layer.
|
|
"""
|
|
serializer = self.get_serializer(data=request.data)
|
|
serializer.is_valid(raise_exception=True)
|
|
|
|
workspace = get_object_or_404(Workspace, id=serializer.validated_data["workspace"], is_deleted=False)
|
|
if not has_workspace_capability(request.user, workspace, PROJECTS_CREATE):
|
|
return Response(
|
|
{"detail": "You do not have permission to create projects in this workspace."},
|
|
status=status.HTTP_403_FORBIDDEN,
|
|
)
|
|
client_id = serializer.validated_data.get("client")
|
|
client = get_object_or_404(Client, id=client_id, is_deleted=False) if client_id else None
|
|
|
|
project = create_project(
|
|
user=request.user,
|
|
workspace=workspace,
|
|
name=serializer.validated_data["name"],
|
|
client=client,
|
|
description=serializer.validated_data.get("description", ""),
|
|
color=serializer.validated_data.get("color", ""),
|
|
thumbnail=serializer.validated_data.get("thumbnail"),
|
|
)
|
|
|
|
output_serializer = ProjectSerializer(project, context={"request": request})
|
|
return Response(output_serializer.data, status=status.HTTP_201_CREATED)
|
|
|
|
def update(self, request, *args, **kwargs):
|
|
"""
|
|
Updates an existing project using the project service layer.
|
|
"""
|
|
partial = kwargs.pop("partial", False)
|
|
project = self.get_object()
|
|
|
|
serializer = self.get_serializer(data=request.data, partial=partial)
|
|
serializer.is_valid(raise_exception=True)
|
|
|
|
updated_project = update_project(
|
|
project=project,
|
|
**serializer.validated_data
|
|
)
|
|
|
|
output_serializer = ProjectSerializer(updated_project, context={"request": request})
|
|
return Response(output_serializer.data, status=status.HTTP_200_OK)
|
|
|
|
def destroy(self, request, *args, **kwargs):
|
|
"""
|
|
Soft deletes a project.
|
|
"""
|
|
project = self.get_object()
|
|
if not can_delete_workspace_object(request.user, project, PROJECTS_DELETE):
|
|
return Response(
|
|
{"detail": "You do not have permission to delete this project."},
|
|
status=status.HTTP_403_FORBIDDEN,
|
|
)
|
|
project.is_deleted = True
|
|
project.save(update_fields=["is_deleted", "updated_at"])
|
|
return Response(status=status.HTTP_204_NO_CONTENT)
|
|
|
|
@action(detail=True, methods=["post"])
|
|
def archive(self, request, pk=None):
|
|
"""
|
|
Custom endpoint to toggle the archive status of a project.
|
|
"""
|
|
project = self.get_object()
|
|
updated_project = toggle_project_archive(project)
|
|
|
|
output_serializer = ProjectSerializer(updated_project, context={"request": request})
|
|
return Response(output_serializer.data, status=status.HTTP_200_OK)
|
|
|
|
@action(detail=False, methods=["get"], url_path="access")
|
|
def access(self, request):
|
|
serializer = ProjectAccessQuerySerializer(data=request.query_params)
|
|
serializer.is_valid(raise_exception=True)
|
|
|
|
workspace = get_object_or_404(
|
|
Workspace,
|
|
id=serializer.validated_data["workspace"],
|
|
is_deleted=False,
|
|
)
|
|
ensure_workspace_project_access(request.user, workspace)
|
|
membership = get_project_access_target_membership(workspace, str(serializer.validated_data["user"]))
|
|
|
|
return Response(
|
|
{
|
|
"workspace": {"id": str(workspace.id), "name": workspace.name},
|
|
"user": {
|
|
"id": str(membership.user_id),
|
|
"name": membership.user.full_name or membership.user.mobile,
|
|
"mobile": membership.user.mobile,
|
|
"role": membership.role,
|
|
},
|
|
"items": build_project_access_items(workspace=workspace, target_user=membership.user),
|
|
}
|
|
)
|
|
|
|
@action(detail=False, methods=["post"], url_path="access/grant")
|
|
def grant_access(self, request):
|
|
serializer = ProjectAccessMutationSerializer(data=request.data)
|
|
serializer.is_valid(raise_exception=True)
|
|
|
|
workspace = get_object_or_404(
|
|
Workspace,
|
|
id=serializer.validated_data["workspace"],
|
|
is_deleted=False,
|
|
)
|
|
membership = get_project_access_target_membership(workspace, str(serializer.validated_data["user"]))
|
|
changed = grant_project_accesses(
|
|
actor=request.user,
|
|
workspace=workspace,
|
|
target_user=membership.user,
|
|
project_ids=[str(project_id) for project_id in serializer.validated_data["project_ids"]],
|
|
)
|
|
return Response({"changed": changed}, status=status.HTTP_200_OK)
|
|
|
|
@action(detail=False, methods=["post"], url_path="access/revoke")
|
|
def revoke_access(self, request):
|
|
serializer = ProjectAccessMutationSerializer(data=request.data)
|
|
serializer.is_valid(raise_exception=True)
|
|
|
|
workspace = get_object_or_404(
|
|
Workspace,
|
|
id=serializer.validated_data["workspace"],
|
|
is_deleted=False,
|
|
)
|
|
membership = get_project_access_target_membership(workspace, str(serializer.validated_data["user"]))
|
|
changed = revoke_project_accesses(
|
|
actor=request.user,
|
|
workspace=workspace,
|
|
target_user=membership.user,
|
|
project_ids=[str(project_id) for project_id in serializer.validated_data["project_ids"]],
|
|
)
|
|
return Response({"changed": changed}, status=status.HTTP_200_OK)
|
|
|
|
@action(detail=False, methods=["post"], url_path="access/rate")
|
|
def set_access_rate(self, request):
|
|
serializer = ProjectAccessRateMutationSerializer(data=request.data)
|
|
serializer.is_valid(raise_exception=True)
|
|
|
|
workspace = get_object_or_404(
|
|
Workspace,
|
|
id=serializer.validated_data["workspace"],
|
|
is_deleted=False,
|
|
)
|
|
ensure_workspace_project_access(request.user, workspace)
|
|
membership = get_project_access_target_membership(workspace, str(serializer.validated_data["user"]))
|
|
project = get_object_or_404(
|
|
Project,
|
|
id=serializer.validated_data["project"],
|
|
workspace=workspace,
|
|
is_deleted=False,
|
|
)
|
|
|
|
has_access = user_has_project_access(membership.user, project)
|
|
if not has_access:
|
|
return Response(
|
|
{"detail": "Grant project access before setting a project-specific rate."},
|
|
status=status.HTTP_400_BAD_REQUEST,
|
|
)
|
|
|
|
removed = serializer.validated_data.get("hourly_rate") is None
|
|
if removed:
|
|
remove_project_user_rate(project=project, user=membership.user)
|
|
else:
|
|
upsert_project_user_rate(
|
|
project=project,
|
|
user=membership.user,
|
|
hourly_rate=serializer.validated_data["hourly_rate"],
|
|
currency=serializer.validated_data.get("currency", "USD"),
|
|
)
|
|
|
|
workspace_rate = (
|
|
workspace.user_rates.filter(user=membership.user, is_deleted=False)
|
|
.order_by("-effective_from", "-updated_at")
|
|
.first()
|
|
)
|
|
project_rate = get_current_project_user_rate(project=project, user=membership.user)
|
|
item = build_project_access_item(
|
|
project=project,
|
|
has_access=True,
|
|
workspace_rate=workspace_rate,
|
|
project_rate=project_rate,
|
|
)
|
|
return Response({"removed": removed, "item": item}, status=status.HTTP_200_OK)
|