494 lines
18 KiB
Python
494 lines
18 KiB
Python
# -*- coding: utf-8 -*-
|
|
|
|
import re
|
|
|
|
from django.conf import settings
|
|
from django.db import models
|
|
|
|
from django.utils import timezone
|
|
from django.contrib.contenttypes.models import ContentType
|
|
from django.contrib.contenttypes import generic
|
|
from django.contrib.auth.models import User
|
|
|
|
from greenmine.base.utils.slug import slugify_uniquely, ref_uniquely
|
|
from greenmine.base.fields import DictField
|
|
from greenmine.base.utils import iter_points
|
|
from greenmine.taggit.managers import TaggableManager
|
|
|
|
from greenmine.scrum.choices import *
|
|
from greenmine.scrum.utils import SCRUM_STATES
|
|
|
|
|
|
class ProjectManager(models.Manager):
|
|
def get_by_natural_key(self, slug):
|
|
return self.get(slug=slug)
|
|
|
|
|
|
class Project(models.Model):
|
|
uuid = models.CharField(max_length=40, unique=True, blank=True)
|
|
name = models.CharField(max_length=250, unique=True)
|
|
slug = models.SlugField(max_length=250, unique=True, blank=True)
|
|
description = models.TextField(blank=False)
|
|
|
|
created_date = models.DateTimeField(auto_now_add=True)
|
|
modified_date = models.DateTimeField(auto_now_add=True)
|
|
|
|
owner = models.ForeignKey("auth.User", related_name="projects")
|
|
public = models.BooleanField(default=True)
|
|
markup = models.CharField(max_length=10, choices=MARKUP_TYPE, default='md')
|
|
|
|
last_us_ref = models.BigIntegerField(null=True, default=0)
|
|
last_task_ref = models.BigIntegerField(null=True, default=0)
|
|
|
|
task_parser_re = models.CharField(max_length=1000, blank=True, null=True, default=None)
|
|
sprints = models.IntegerField(default=1, blank=True, null=True)
|
|
show_burndown = models.BooleanField(default=False, blank=True)
|
|
show_burnup = models.BooleanField(default=False, blank=True)
|
|
show_sprint_burndown = models.BooleanField(default=False, blank=True)
|
|
total_story_points = models.FloatField(default=None, null=True)
|
|
|
|
objects = ProjectManager()
|
|
|
|
class Meta:
|
|
permissions = (
|
|
# global permissions
|
|
('list_projects', 'Can list projects'),
|
|
('list_my_projects', 'Can list my projects'),
|
|
|
|
# per project permissions
|
|
('view_projects', 'Can view projects'),
|
|
|
|
('create_tasks', 'Can create tasks'),
|
|
('comment_tasks', 'Can comment tasks'),
|
|
('modify_tasks', 'Can modify tasks'),
|
|
('delete_task', 'Can delete tasks'),
|
|
('modify_owned_tasks', 'Can modify owned tasks'),
|
|
('modify_assigned_tasks', 'Can modify assigned tasks'),
|
|
('assign_tasks_to_others', 'Can assign tasks to others'),
|
|
('assign_tasks_to_myself', 'Can assign tasks to myself'),
|
|
('change_tasks_state', 'Can change the task state'),
|
|
('add_tasks_to_us', 'Can add tasks to a user story'),
|
|
|
|
('create_us', 'Can create user stories'),
|
|
('comment_us', 'Can comment user stories'),
|
|
('modify_us', 'Can modify user stories'),
|
|
('delete_us', 'Can delete user stories'),
|
|
('modify_owned_us', 'Can modify owned user stories'),
|
|
('add_us_to_milestones', 'Can add user stories to milestones'),
|
|
|
|
('create_questions', 'Can create questions'),
|
|
('reply_questions', 'Can reply questions'),
|
|
('modify_questions', 'Can modify questions'),
|
|
('delete_questions', 'Can delete questions'),
|
|
('modify_owned_questions', 'Can modify owned questions'),
|
|
|
|
('create_wiki_page', 'Can create wiki pages'),
|
|
('modify_wiki_page', 'Can modify wiki pages'),
|
|
('delete_wiki_page', 'Can delete wiki pages'),
|
|
('modify_owned_wiki_page', 'Can modify owned wiki pages'),
|
|
|
|
('create_documents', 'Can create documents'),
|
|
('modify_documents', 'Can modify documents'),
|
|
('delete_documents', 'Can delete documents'),
|
|
('modify_owned_documents', 'Can modify owned documents'),
|
|
|
|
('create_milestone', 'Can create milestones'),
|
|
('modify_milestone', 'Can modify milestones'),
|
|
|
|
('manage_users', 'Can manage users'),
|
|
)
|
|
|
|
def __unicode__(self):
|
|
return self.name
|
|
|
|
def natural_key(self):
|
|
return (self.slug,)
|
|
|
|
@property
|
|
def unasociated_user_stories(self):
|
|
return self.user_stories.filter(milestone__isnull=True)
|
|
|
|
@property
|
|
def all_participants(self):
|
|
return User.objects.filter(group__in=self.groups)
|
|
|
|
@property
|
|
def default_milestone(self):
|
|
return self.milestones.order_by('-created_date')[0]
|
|
|
|
def __repr__(self):
|
|
return u"<Project %s>" % (self.slug)
|
|
|
|
def save(self, *args, **kwargs):
|
|
if not self.slug:
|
|
self.slug = slugify_uniquely(self.name, self.__class__)
|
|
else:
|
|
self.modified_date = timezone.now()
|
|
|
|
super(Project, self).save(*args, **kwargs)
|
|
|
|
|
|
class MilestoneManager(models.Manager):
|
|
def get_by_natural_key(self, name, project):
|
|
return self.get(name=name, project__slug=project)
|
|
|
|
|
|
class Milestone(models.Model):
|
|
uuid = models.CharField(max_length=40, unique=True, blank=True)
|
|
name = models.CharField(max_length=200, db_index=True)
|
|
owner = models.ForeignKey('auth.User', related_name="milestones")
|
|
project = models.ForeignKey('Project', related_name="milestones")
|
|
|
|
estimated_start = models.DateField(null=True, default=None)
|
|
estimated_finish = models.DateField(null=True, default=None)
|
|
|
|
created_date = models.DateTimeField(auto_now_add=True)
|
|
modified_date = models.DateTimeField(auto_now_add=True)
|
|
closed = models.BooleanField(default=False)
|
|
|
|
disponibility = models.FloatField(null=True, default=0.0)
|
|
objects = MilestoneManager()
|
|
|
|
class Meta:
|
|
ordering = ['-created_date']
|
|
unique_together = ('name', 'project')
|
|
|
|
@property
|
|
def total_points(self):
|
|
"""
|
|
Get total story points for this milestone.
|
|
"""
|
|
|
|
total = sum(iter_points(self.user_stories.all()))
|
|
return "{0:.1f}".format(total)
|
|
|
|
def get_points_done_at_date(self, date):
|
|
"""
|
|
Get completed story points for this milestone before the date.
|
|
"""
|
|
total = 0.0
|
|
|
|
for item in self.user_stories.filter(status__in=SCRUM_STATES.get_finished_us_states()):
|
|
if item.tasks.filter(finished_date__lt=date).count() > 0:
|
|
if item.points == -1:
|
|
continue
|
|
|
|
if item.points == -2:
|
|
total += 0.5
|
|
continue
|
|
|
|
total += item.points
|
|
|
|
return "{0:.1f}".format(total)
|
|
|
|
@property
|
|
def completed_points(self):
|
|
"""
|
|
Get a total of completed points.
|
|
"""
|
|
|
|
queryset = self.user_stories.filter(status__in=SCRUM_STATES.get_finished_us_states())
|
|
total = sum(iter_points(queryset))
|
|
return "{0:.1f}".format(total)
|
|
|
|
@property
|
|
def percentage_completed(self):
|
|
return "{0:.1f}".format(
|
|
(float(self.completed_points) * 100) / float(self.total_points)
|
|
)
|
|
|
|
def natural_key(self):
|
|
return (self.name,) + self.project.natural_key()
|
|
|
|
natural_key.dependencies = ['greenmine.Project']
|
|
|
|
def __unicode__(self):
|
|
return self.name
|
|
|
|
def __repr__(self):
|
|
return u"<Milestone %s>" % (self.id)
|
|
|
|
def save(self, *args, **kwargs):
|
|
if self.id:
|
|
self.modified_date = timezone.now()
|
|
|
|
super(Milestone, self).save(*args, **kwargs)
|
|
|
|
|
|
class UserStory(models.Model):
|
|
uuid = models.CharField(max_length=40, unique=True, blank=True)
|
|
ref = models.CharField(max_length=200, db_index=True, null=True, default=None)
|
|
milestone = models.ForeignKey("Milestone", blank=True,
|
|
related_name="user_stories", null=True,
|
|
default=None)
|
|
project = models.ForeignKey("Project", related_name="user_stories")
|
|
owner = models.ForeignKey("auth.User", null=True, default=None,
|
|
related_name="user_stories")
|
|
priority = models.IntegerField(default=1)
|
|
points = models.IntegerField(choices=POINTS_CHOICES, default=-1)
|
|
status = models.CharField(max_length=50,
|
|
choices=SCRUM_STATES.get_us_choices(),
|
|
db_index=True, default="open")
|
|
|
|
tags = TaggableManager()
|
|
|
|
created_date = models.DateTimeField(auto_now_add=True)
|
|
modified_date = models.DateTimeField(auto_now_add=True)
|
|
tested = models.BooleanField(default=False)
|
|
|
|
subject = models.CharField(max_length=500)
|
|
description = models.TextField()
|
|
finish_date = models.DateTimeField(null=True, blank=True)
|
|
|
|
watchers = models.ManyToManyField('auth.User', related_name='us_watch',
|
|
null=True)
|
|
|
|
client_requirement = models.BooleanField(default=False)
|
|
team_requirement = models.BooleanField(default=False)
|
|
order = models.PositiveSmallIntegerField("Order")
|
|
|
|
class Meta:
|
|
ordering = ['order']
|
|
unique_together = ('ref', 'project')
|
|
|
|
def __repr__(self):
|
|
return u"<UserStory %s>" % (self.id)
|
|
|
|
def __unicode__(self):
|
|
return u"{0} ({1})".format(self.subject, self.ref)
|
|
|
|
def save(self, *args, **kwargs):
|
|
if self.id:
|
|
self.modified_date = timezone.now()
|
|
if not self.ref:
|
|
self.ref = ref_uniquely(self.project, self.__class__)
|
|
|
|
super(UserStory, self).save(*args, **kwargs)
|
|
|
|
""" Propertys """
|
|
def update_status(self):
|
|
tasks = self.tasks.all()
|
|
used_states = []
|
|
|
|
for task in tasks:
|
|
used_states.append(task.fake_status)
|
|
used_states = set(used_states)
|
|
|
|
for state in SCRUM_STATES.ordered_us_states():
|
|
for task_state in used_states:
|
|
if task_state == state:
|
|
self.status = state
|
|
self.save()
|
|
return None
|
|
return None
|
|
|
|
@property
|
|
def tasks_new(self):
|
|
return self.tasks.filter(status__in=SCRUM_STATES.get_task_states_for_us_state('open'))
|
|
|
|
@property
|
|
def tasks_progress(self):
|
|
return self.tasks.filter(status__in=SCRUM_STATES.get_task_states_for_us_state('progress'))
|
|
|
|
@property
|
|
def tasks_completed(self):
|
|
return self.tasks.filter(status__in=SCRUM_STATES.get_task_states_for_us_state('completed'))
|
|
|
|
@property
|
|
def tasks_closed(self):
|
|
return self.tasks.filter(status__in=SCRUM_STATES.get_task_states_for_us_state('closed'))
|
|
|
|
|
|
class Change(models.Model):
|
|
change_type = models.IntegerField(choices=TASK_CHANGE_CHOICES)
|
|
owner = models.ForeignKey('auth.User', related_name='changes')
|
|
created_date = models.DateTimeField(auto_now_add=True)
|
|
|
|
project = models.ForeignKey("Project", related_name="changes")
|
|
|
|
content_type = models.ForeignKey(ContentType)
|
|
object_id = models.PositiveIntegerField()
|
|
content_object = generic.GenericForeignKey('content_type', 'object_id')
|
|
|
|
data = DictField()
|
|
|
|
|
|
class ChangeAttachment(models.Model):
|
|
change = models.ForeignKey("Change", related_name="attachments")
|
|
owner = models.ForeignKey("auth.User", related_name="change_attachments")
|
|
|
|
created_date = models.DateTimeField(auto_now_add=True)
|
|
attached_file = models.FileField(upload_to="files/msg", max_length=500,
|
|
null=True, blank=True)
|
|
|
|
|
|
class TaskQuerySet(models.query.QuerySet):
|
|
def _add_categories(self, section_dict, category_id, category_element, selected):
|
|
section_dict[category_id] = section_dict.get(category_id, {
|
|
'element': unicode(category_element),
|
|
'count': 0,
|
|
'id': category_id,
|
|
'selected': selected,
|
|
})
|
|
section_dict[category_id]['count'] += 1
|
|
|
|
def _get_category(self, section_dict, order_by='element', reverse=False):
|
|
values = section_dict.values()
|
|
values = sorted(values, key=lambda entry: unicode(entry[order_by]))
|
|
if reverse:
|
|
values.reverse()
|
|
return values
|
|
|
|
def _get_filter_and_build_filter_dict(self, queryset, milestone_id, status_id, tags_ids, assigned_to_id, severity_id):
|
|
task_list = list(queryset)
|
|
milestones = {}
|
|
status = {}
|
|
tags = {}
|
|
assigned_to = {}
|
|
severity = {}
|
|
|
|
for task in task_list:
|
|
if task.milestone:
|
|
selected = milestone_id and task.milestone.id == milestone_id
|
|
self._add_categories(milestones, task.milestone.id, task.milestone.name, selected)
|
|
|
|
selected = status_id and task.status == status_id
|
|
self._add_categories(status, task.status, task.get_status_display(), selected)
|
|
|
|
for tag in task.tags.all():
|
|
selected = tags_ids and tag.id in tags_ids
|
|
self._add_categories(tags, tag.id, tag.name, selected)
|
|
|
|
if task.assigned_to:
|
|
selected = assigned_to_id and task.assigned_to.id == assigned_to_id
|
|
self._add_categories(assigned_to, task.assigned_to.id, task.assigned_to.first_name, selected)
|
|
|
|
selected = severity_id and task.severity == int(severity_id)
|
|
self._add_categories(severity, task.severity, task.get_severity_display(), selected)
|
|
|
|
return{
|
|
'list': task_list,
|
|
'filters': {
|
|
'milestones': self._get_category(milestones),
|
|
'status': self._get_category(status),
|
|
'tags': self._get_category(tags),
|
|
'assigned_to': self._get_category(assigned_to),
|
|
'severity': self._get_category(severity),
|
|
}
|
|
}
|
|
|
|
def filter_and_build_filter_dict(self, milestone=None, status=None, tags=None, assigned_to=None, severity=None):
|
|
|
|
queryset = self
|
|
if milestone:
|
|
queryset = queryset.filter(milestone=milestone)
|
|
|
|
if status:
|
|
queryset = queryset.filter(status=status)
|
|
|
|
if tags:
|
|
for tag in tags:
|
|
queryset = queryset.filter(tags__in=[tag])
|
|
|
|
if assigned_to:
|
|
queryset = queryset.filter(assigned_to=assigned_to)
|
|
|
|
if severity:
|
|
queryset = queryset.filter(severity=severity)
|
|
|
|
milestone_id = milestone and milestone.id
|
|
status_id = status
|
|
tags_ids = tags and tags.values_list('id', flat=True)
|
|
assigned_to_id = assigned_to and assigned_to.id
|
|
severity_id = severity
|
|
|
|
return self._get_filter_and_build_filter_dict(queryset, milestone_id, status_id, tags_ids, assigned_to_id, severity_id)
|
|
|
|
|
|
class TaskManager(models.Manager):
|
|
def get_query_set(self):
|
|
return TaskQuerySet(self.model)
|
|
|
|
|
|
class Task(models.Model):
|
|
uuid = models.CharField(max_length=40, unique=True, blank=True)
|
|
user_story = models.ForeignKey('UserStory', related_name='tasks', null=True, blank=True)
|
|
last_user_story = models.ForeignKey('UserStory', null=True, blank=True)
|
|
ref = models.CharField(max_length=200, db_index=True, null=True, default=None)
|
|
status = models.CharField(max_length=50, choices=TASK_STATUS_CHOICES,
|
|
default='open')
|
|
owner = models.ForeignKey("auth.User", null=True, default=None,
|
|
related_name="tasks")
|
|
|
|
severity = models.IntegerField(choices=TASK_SEVERITY_CHOICES, default=3)
|
|
priority = models.IntegerField(choices=TASK_PRIORITY_CHOICES, default=3)
|
|
milestone = models.ForeignKey('Milestone', related_name='tasks', null=True,
|
|
default=None, blank=True)
|
|
|
|
project = models.ForeignKey('Project', related_name='tasks')
|
|
type = models.CharField(max_length=10, choices=TASK_TYPE_CHOICES,
|
|
default='task')
|
|
|
|
created_date = models.DateTimeField(auto_now_add=True)
|
|
modified_date = models.DateTimeField(auto_now_add=True)
|
|
finished_date = models.DateTimeField(null=True, blank=True)
|
|
last_status = models.CharField(max_length=50, choices=TASK_STATUS_CHOICES,
|
|
null=True, blank=True)
|
|
|
|
subject = models.CharField(max_length=500)
|
|
description = models.TextField(blank=True)
|
|
assigned_to = models.ForeignKey('auth.User',
|
|
related_name='user_storys_assigned_to_me',
|
|
blank=True, null=True, default=None)
|
|
|
|
watchers = models.ManyToManyField('auth.User', related_name='task_watch',
|
|
null=True)
|
|
|
|
changes = generic.GenericRelation(Change)
|
|
|
|
tags = TaggableManager()
|
|
|
|
objects = TaskManager()
|
|
|
|
class Meta:
|
|
unique_together = ('ref', 'project')
|
|
|
|
def __unicode__(self):
|
|
return self.subject
|
|
|
|
@property
|
|
def fake_status(self):
|
|
return SCRUM_STATES.get_us_state_for_task_state(self.status)
|
|
|
|
def save(self, *args, **kwargs):
|
|
last_user_story = None
|
|
if self.last_user_story != self.user_story:
|
|
last_user_story = self.last_user_story
|
|
self.last_user_story = self.user_story
|
|
|
|
if self.id:
|
|
self.modified_date = timezone.now()
|
|
# Store information about close date of a task
|
|
if self.last_status != self.status:
|
|
if self.last_status in SCRUM_STATES.get_finished_task_states():
|
|
if self.status in SCRUM_STATES.get_unfinished_task_states():
|
|
self.finished_date = None
|
|
elif self.last_status in SCRUM_STATES.get_unfinished_task_states():
|
|
if self.status in SCRUM_STATES.get_finished_task_states():
|
|
self.finished_date = timezone.now()
|
|
self.last_status = self.status
|
|
|
|
if not self.ref:
|
|
self.ref = ref_uniquely(self.project, self.__class__)
|
|
|
|
super(Task, self).save(*args, **kwargs)
|
|
|
|
if last_user_story:
|
|
last_user_story.update_status()
|
|
|
|
if self.user_story:
|
|
self.user_story.update_status()
|
|
|
|
|
|
from . import sigdispatch
|