feat(src/projects): add Project and ProjectMember models with API serializers and views
Implement project management infrastructure to support ticket workflows and dashboard statistics
This commit is contained in:
5 files changed
+313
-16
No files matched your search
+28
-3
@@ -1,5 +1,30 @@
|
||||
"""generated with djinit"""
|
||||
|
||||
from django.contrib import admin
|
||||
|
||||
# Register your models here.
|
||||
from src.projects.models import Project, ProjectMember
|
||||
|
||||
|
||||
class ProjectMemberInline(admin.TabularInline):
|
||||
model = ProjectMember
|
||||
extra = 1
|
||||
|
||||
|
||||
@admin.register(Project)
|
||||
class ProjectAdmin(admin.ModelAdmin):
|
||||
list_display = (
|
||||
"id",
|
||||
"name",
|
||||
"ticket_prefix",
|
||||
"color",
|
||||
"start_date",
|
||||
"end_date",
|
||||
"pinned_date",
|
||||
)
|
||||
search_fields = ("name", "ticket_prefix")
|
||||
inlines = (ProjectMemberInline,)
|
||||
|
||||
|
||||
@admin.register(ProjectMember)
|
||||
class ProjectMemberAdmin(admin.ModelAdmin):
|
||||
list_display = ("id", "project", "user")
|
||||
search_fields = ("project__name", "user__email")
|
||||
|
||||
+59
-3
@@ -1,5 +1,61 @@
|
||||
"""generated with djinit"""
|
||||
|
||||
from django.conf import settings
|
||||
from django.db import models
|
||||
|
||||
# Create your models here.
|
||||
|
||||
class Project(models.Model):
|
||||
name = models.CharField(max_length=255)
|
||||
description = models.TextField(blank=True, null=True)
|
||||
ticket_prefix = models.CharField(max_length=255)
|
||||
color = models.CharField(
|
||||
max_length=7, blank=True, null=True, help_text="Hex color e.g. #3B82F6"
|
||||
)
|
||||
start_date = models.DateField(blank=True, null=True)
|
||||
end_date = models.DateField(blank=True, null=True)
|
||||
pinned_date = models.DateTimeField(blank=True, null=True)
|
||||
created_at = models.DateTimeField(auto_now_add=True)
|
||||
updated_at = models.DateTimeField(auto_now=True)
|
||||
|
||||
members = models.ManyToManyField(
|
||||
settings.AUTH_USER_MODEL,
|
||||
through="ProjectMember",
|
||||
related_name="projects",
|
||||
)
|
||||
|
||||
class Meta:
|
||||
db_table = "projects"
|
||||
verbose_name = "Project"
|
||||
verbose_name_plural = "Projects"
|
||||
indexes = [
|
||||
models.Index(fields=["pinned_date"]),
|
||||
models.Index(fields=["start_date", "end_date"]),
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return self.name
|
||||
|
||||
|
||||
class ProjectMember(models.Model):
|
||||
project = models.ForeignKey(
|
||||
Project, on_delete=models.CASCADE, related_name="project_members"
|
||||
)
|
||||
user = models.ForeignKey(
|
||||
settings.AUTH_USER_MODEL,
|
||||
on_delete=models.CASCADE,
|
||||
related_name="project_memberships",
|
||||
)
|
||||
created_at = models.DateTimeField(auto_now_add=True)
|
||||
updated_at = models.DateTimeField(auto_now=True)
|
||||
|
||||
class Meta:
|
||||
db_table = "project_members"
|
||||
verbose_name = "Project Member"
|
||||
verbose_name_plural = "Project Members"
|
||||
constraints = [
|
||||
models.UniqueConstraint(
|
||||
fields=["project", "user"], name="unique_project_member"
|
||||
)
|
||||
]
|
||||
|
||||
def __str__(self):
|
||||
return f"{self.user} -> {self.project}"
|
||||
|
||||
@@ -1,5 +1,67 @@
|
||||
"""generated with djinit"""
|
||||
|
||||
from apps.accounts.serializers import UserSerializer
|
||||
from rest_framework import serializers
|
||||
|
||||
# Create your serializers here.
|
||||
from src.projects.models import Project, ProjectMember
|
||||
|
||||
|
||||
class ProjectMemberSerializer(serializers.ModelSerializer):
|
||||
user = UserSerializer(read_only=True)
|
||||
user_id = serializers.IntegerField(write_only=True)
|
||||
|
||||
class Meta:
|
||||
model = ProjectMember
|
||||
fields = ("id", "user", "user_id", "created_at")
|
||||
read_only_fields = ("id", "created_at")
|
||||
|
||||
|
||||
class ProjectListSerializer(serializers.ModelSerializer):
|
||||
member_count = serializers.SerializerMethodField()
|
||||
ticket_count = serializers.SerializerMethodField()
|
||||
|
||||
class Meta:
|
||||
model = Project
|
||||
fields = (
|
||||
"id",
|
||||
"name",
|
||||
"description",
|
||||
"ticket_prefix",
|
||||
"color",
|
||||
"start_date",
|
||||
"end_date",
|
||||
"pinned_date",
|
||||
"member_count",
|
||||
"ticket_count",
|
||||
"created_at",
|
||||
"updated_at",
|
||||
)
|
||||
read_only_fields = ("id", "created_at", "updated_at")
|
||||
|
||||
def get_member_count(self, obj):
|
||||
return obj.members.count()
|
||||
|
||||
def get_ticket_count(self, obj):
|
||||
return obj.tickets.count()
|
||||
|
||||
|
||||
class ProjectDetailSerializer(serializers.ModelSerializer):
|
||||
members = ProjectMemberSerializer(
|
||||
source="project_members", many=True, read_only=True
|
||||
)
|
||||
|
||||
class Meta:
|
||||
model = Project
|
||||
fields = (
|
||||
"id",
|
||||
"name",
|
||||
"description",
|
||||
"ticket_prefix",
|
||||
"color",
|
||||
"start_date",
|
||||
"end_date",
|
||||
"pinned_date",
|
||||
"members",
|
||||
"created_at",
|
||||
"updated_at",
|
||||
)
|
||||
read_only_fields = ("id", "created_at", "updated_at")
|
||||
|
||||
+23
-4
@@ -1,7 +1,26 @@
|
||||
"""generated with djinit"""
|
||||
|
||||
from django.urls import path
|
||||
|
||||
from src.projects import views
|
||||
|
||||
urlpatterns = [
|
||||
# Add your URL patterns here
|
||||
]
|
||||
path("", views.ProjectListCreateView.as_view(), name="project-list"),
|
||||
path("dashboard/", views.dashboard_stats_view, name="project-dashboard"),
|
||||
path("<int:pk>/", views.ProjectDetailView.as_view(), name="project-detail"),
|
||||
path(
|
||||
"<int:project_pk>/members/",
|
||||
views.ProjectMemberListCreateView.as_view(),
|
||||
name="project-member-list",
|
||||
),
|
||||
path(
|
||||
"<int:project_pk>/members/<int:user_id>/",
|
||||
views.ProjectMemberDestroyView.as_view(),
|
||||
name="project-member-destroy",
|
||||
),
|
||||
path(
|
||||
"<int:project_pk>/statuses/",
|
||||
views.project_statuses_view,
|
||||
name="project-statuses",
|
||||
),
|
||||
path("<int:project_pk>/stats/", views.project_stats_view, name="project-stats"),
|
||||
]
|
||||
|
||||
+138
-3
@@ -1,5 +1,140 @@
|
||||
"""generated with djinit"""
|
||||
from apps.tickets.models import Ticket, TicketStatus
|
||||
from django.db import models
|
||||
from django.utils import timezone
|
||||
from rest_framework import generics, permissions
|
||||
from rest_framework.decorators import api_view, permission_classes
|
||||
from rest_framework.response import Response
|
||||
|
||||
from rest_framework import viewsets
|
||||
from src.projects.models import Project, ProjectMember
|
||||
from src.projects.serializers import (
|
||||
ProjectDetailSerializer,
|
||||
ProjectListSerializer,
|
||||
ProjectMemberSerializer,
|
||||
)
|
||||
|
||||
|
||||
class ProjectListCreateView(generics.ListCreateAPIView):
|
||||
serializer_class = ProjectListSerializer
|
||||
permission_classes = (permissions.IsAuthenticated,)
|
||||
|
||||
def get_queryset(self):
|
||||
user = self.request.user
|
||||
if user.is_superuser:
|
||||
return Project.objects.all()
|
||||
return Project.objects.filter(members=user).distinct()
|
||||
|
||||
def perform_create(self, serializer):
|
||||
project = serializer.save()
|
||||
ProjectMember.objects.get_or_create(project=project, user=self.request.user)
|
||||
|
||||
|
||||
class ProjectDetailView(generics.RetrieveUpdateDestroyAPIView):
|
||||
serializer_class = ProjectDetailSerializer
|
||||
permission_classes = (permissions.IsAuthenticated,)
|
||||
|
||||
def get_queryset(self):
|
||||
user = self.request.user
|
||||
if user.is_superuser:
|
||||
return Project.objects.all()
|
||||
return Project.objects.filter(members=user).distinct()
|
||||
|
||||
|
||||
class ProjectMemberListCreateView(generics.ListCreateAPIView):
|
||||
serializer_class = ProjectMemberSerializer
|
||||
permission_classes = (permissions.IsAuthenticated,)
|
||||
|
||||
def get_queryset(self):
|
||||
return ProjectMember.objects.filter(project_id=self.kwargs["project_pk"])
|
||||
|
||||
def perform_create(self, serializer):
|
||||
serializer.save(project_id=self.kwargs["project_pk"])
|
||||
|
||||
|
||||
class ProjectMemberDestroyView(generics.DestroyAPIView):
|
||||
permission_classes = (permissions.IsAuthenticated,)
|
||||
|
||||
def get_queryset(self):
|
||||
return ProjectMember.objects.filter(project_id=self.kwargs["project_pk"])
|
||||
|
||||
def get_object(self):
|
||||
return self.get_queryset().get(user_id=self.kwargs["user_id"])
|
||||
|
||||
|
||||
@api_view(["GET"])
|
||||
@permission_classes([permissions.IsAuthenticated])
|
||||
def project_statuses_view(request, project_pk):
|
||||
statuses = TicketStatus.objects.filter(project_id=project_pk).order_by("sort_order")
|
||||
from apps.tickets.serializers import TicketStatusSerializer
|
||||
|
||||
serializer = TicketStatusSerializer(statuses, many=True)
|
||||
return Response(serializer.data)
|
||||
|
||||
|
||||
@api_view(["GET"])
|
||||
@permission_classes([permissions.IsAuthenticated])
|
||||
def project_stats_view(request, project_pk):
|
||||
project = generics.get_object_or_404(
|
||||
Project.objects.filter(members=request.user)
|
||||
if not request.user.is_superuser
|
||||
else Project.objects.all(),
|
||||
pk=project_pk,
|
||||
)
|
||||
tickets = project.tickets.all()
|
||||
stats = {
|
||||
"total_tickets": tickets.count(),
|
||||
"open_tickets": tickets.exclude(status__is_completed=True).count(),
|
||||
"completed_tickets": tickets.filter(status__is_completed=True).count(),
|
||||
"total_members": project.members.count(),
|
||||
"total_epics": project.epics.count(),
|
||||
}
|
||||
return Response(stats)
|
||||
|
||||
|
||||
@api_view(["GET"])
|
||||
@permission_classes([permissions.IsAuthenticated])
|
||||
def dashboard_stats_view(request):
|
||||
user = request.user
|
||||
if user.is_superuser:
|
||||
total_projects = Project.objects.count()
|
||||
total_tickets = Ticket.objects.count()
|
||||
total_members = user.__class__.objects.count()
|
||||
else:
|
||||
total_projects = Project.objects.filter(members=user).count()
|
||||
total_tickets = (
|
||||
Ticket.objects.filter(
|
||||
models.Q(project__members=user) | models.Q(assignees=user)
|
||||
)
|
||||
.distinct()
|
||||
.count()
|
||||
)
|
||||
total_members = (
|
||||
user.__class__.objects.filter(project_memberships__project__members=user)
|
||||
.distinct()
|
||||
.count()
|
||||
)
|
||||
|
||||
my_assigned = Ticket.objects.filter(assignees=user).count()
|
||||
my_overdue = Ticket.objects.filter(
|
||||
assignees=user, due_date__lt=timezone.now().date(), status__is_completed=False
|
||||
).count()
|
||||
completed_this_week = (
|
||||
Ticket.objects.filter(
|
||||
models.Q(assignees=user) | models.Q(created_by=user),
|
||||
histories__created_at__week=timezone.now().isocalendar()[1],
|
||||
histories__status__is_completed=True,
|
||||
)
|
||||
.distinct()
|
||||
.count()
|
||||
)
|
||||
|
||||
return Response(
|
||||
{
|
||||
"total_projects": total_projects,
|
||||
"total_tickets": total_tickets,
|
||||
"total_members": total_members,
|
||||
"my_assigned": my_assigned,
|
||||
"my_overdue": my_overdue,
|
||||
"completed_this_week": completed_this_week,
|
||||
}
|
||||
)
|
||||
|
||||
# Create your views here.
|
||||
Reference in new issue
Block a user