From fff087a2ff9d315d7cd810c4254dbb188b593b90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?David=20Barrag=C3=A1n=20Merino?=
 <david.barragan@kaleidos.net>
Date: Tue, 14 Oct 2014 19:43:42 +0200
Subject: [PATCH] Refactor tg-us-status directive: Create directives
 tg-us-status-display and tg-us-tasks-progress-display

---
 app/coffee/modules/userstories/detail.coffee | 111 +++++++++++++++++++
 app/partials/us-detail.jade                  |   9 +-
 2 files changed, 118 insertions(+), 2 deletions(-)

diff --git a/app/coffee/modules/userstories/detail.coffee b/app/coffee/modules/userstories/detail.coffee
index 78bbfa7f..4d0a9b35 100644
--- a/app/coffee/modules/userstories/detail.coffee
+++ b/app/coffee/modules/userstories/detail.coffee
@@ -65,6 +65,10 @@ class UserStoryDetailController extends mixOf(taiga.Controller, taiga.PageMixin)
         promise.then null, @.onInitialDataError.bind(@)
 
     initializeEventHandlers: ->
+        @scope.$on "related-tasks:update", =>
+            @.loadUs()
+            @scope.tasks = _.clone(@scope.tasks, false)
+
         @scope.$on "attachment:create", =>
             @analytics.trackEvent("attachment", "create", "create attachment on userstory", 1)
             @rootscope.$broadcast("history:reload")
@@ -135,6 +139,7 @@ class UserStoryDetailController extends mixOf(taiga.Controller, taiga.PageMixin)
 
 module.controller("UserStoryDetailController", UserStoryDetailController)
 
+
 #############################################################################
 ## User story Main Directive
 #############################################################################
@@ -175,6 +180,7 @@ UsDirective = ($tgrepo, $log, $location, $confirm, $navUrls, $loading) ->
 module.directive("tgUsDetail", ["$tgRepo", "$log", "$tgLocation", "$tgConfirm",
                                 "$tgNavUrls", "$tgLoading", UsDirective])
 
+
 #############################################################################
 ## User story status directive
 #############################################################################
@@ -356,6 +362,100 @@ UsStatusDetailDirective = () ->
 
 module.directive("tgUsStatusDetail", UsStatusDetailDirective)
 
+
+
+#############################################################################
+## User story status display directive
+#############################################################################
+
+UsStatusDisplayDirective = ->
+    # Display if a US is open or closed and its kanban status.
+    #
+    # Example:
+    #     h1(tg-us-status-display, ng-model="us")
+    #
+    # Requirements:
+    #   - US object
+    #   - scope.statusById object
+
+    template = _.template("""
+    <span>
+        <% if (is_closed) { %>
+            Closed
+        <% } else { %>
+            Open
+        <% } %>
+    </span>
+    <span class="us-detail-status" style="color:<%= status.color %>">
+        <%= status.name %>
+    </span>
+    """) # TODO: i18n
+
+    link = ($scope, $el, $attrs) ->
+        render = (us) ->
+            html = template({
+                is_closed: us.is_closed
+                status: $scope.statusById[us.status]
+            })
+            $el.html(html)
+
+        $scope.$watch $attrs.ngModel, (us) ->
+            render(us) if us?
+
+        $scope.$on "$destroy", ->
+            $el.off()
+
+    return {link:link, require:"ngModel"}
+
+module.directive("tgUsStatusDisplay", UsStatusDisplayDirective)
+
+
+#############################################################################
+## User story related tasts progress splay Directive
+#############################################################################
+
+UsTasksProgressDisplayDirective = ->
+    # Display a progress bar with the stats of completed tasks.
+    #
+    # Example:
+    #     div.us-detail-progress-bar(tg-us-tasks-progress-display, ng-model="tasks")
+    #
+    # Requirements:
+    #   - Task object list
+    #   - scope.taskStatusById object
+
+    template = _.template("""
+    <div class="current-progress" style="width:<%- progress %>%" />
+    <span clasS="tasks-completed">
+        <%- totalClosedTasks %>/<%- totalTasks %> tasks completed
+    </span>
+    """) # TODO: i18n
+
+    link = ($scope, $el, $attrs) ->
+        render = (tasks) ->
+            totalTasks = tasks.length
+            totalClosedTasks = _.filter(tasks, (task) => $scope.taskStatusById[task.status].is_closed).length
+
+            progress = if totalTasks > 0 then 100 * totalClosedTasks / totalTasks else 0
+
+            html = template({
+                totalTasks: totalTasks
+                totalClosedTasks: totalClosedTasks
+                progress: progress
+            })
+            $el.html(html)
+
+        $scope.$watch $attrs.ngModel, (tasks) ->
+            render(tasks) if tasks?
+
+        $scope.$on "$destroy", ->
+            $el.off()
+
+    return {link:link, require:"ngModel"}
+
+module.directive("tgUsTasksProgressDisplay", UsTasksProgressDisplayDirective)
+
+
 #############################################################################
 ## User story estimation directive
 #############################################################################
@@ -482,6 +582,11 @@ UsEstimationDirective = ($log) ->
 
 module.directive("tgUsEstimation", UsEstimationDirective)
 
+
+#############################################################################
+## User story team requirements button directive
+#############################################################################
+
 UsTeamRequirementButtonDirective = ($rootscope, $tgrepo) ->
     template = _.template("""
       <label for="team-requirement" class="button button-gray team-requirement">Team requirement</label>
@@ -518,8 +623,14 @@ UsTeamRequirementButtonDirective = ($rootscope, $tgrepo) ->
         restrict: "EA"
         require: "ngModel"
     }
+
 module.directive("tgUsTeamRequirementButton", ["$rootScope", "$tgRepo", UsTeamRequirementButtonDirective])
 
+
+#############################################################################
+## User story client requirements button directive
+#############################################################################
+
 UsClientRequirementButtonDirective = ($rootscope, $tgrepo) ->
     template = _.template("""
       <label for="client-requirement" class="button button-gray client-requirement">Client requirement</label>
diff --git a/app/partials/us-detail.jade b/app/partials/us-detail.jade
index 36678047..ae9c24e7 100644
--- a/app/partials/us-detail.jade
+++ b/app/partials/us-detail.jade
@@ -37,7 +37,7 @@ block content
                         span.block-description(tg-bind-html="us.blocked_note || 'This user story is blocked'")
                     div.issue-nav
                         a.icon.icon-arrow-left(ng-show="previousUrl",href="{{ previousUrl }}",
-                                                title="previous user story")
+                                               title="previous user story")
                         a.icon.icon-arrow-right(ng-show="nextUrl", href="{{ nextUrl }}", title="next user story")
 
                 div(tg-tag-line, ng-model="us.tags", ng-show="us.tags")
@@ -50,10 +50,15 @@ block content
             tg-history(ng-model="us", type="us")
 
         sidebar.menu-secondary.sidebar
-            section.us-status(tg-us-status-detail, ng-model="us")
+            section.us-status
+                h1(tg-us-status-display, ng-model="us")
+                div.us-detail-progress-bar(tg-us-tasks-progress-display, ng-model="tasks")
+
             section.us-assigned-to(tg-assigned-to, ng-model="us")
             section.us-created-by(tg-created-by, ng-model="us")
+
             section.watchers(tg-watchers, ng-model="us")
+
             section.us-detail-settings
                 fieldset(tg-us-team-requirement-button, ng-model="us")
                 fieldset(tg-us-client-requirement-button, ng-model="us")