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:
sankalp committed 2026-06-25 23:09:28 +05:45
1 parent 0851411be7
commit 03bda8889b
5 files changed
+313 -16

No files matched your search

+28 -3
View File
@@ -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
View File
@@ -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}"
+65 -3
View File
@@ -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
View File
@@ -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
View File
@@ -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.