trello_api_burndown_parse/src/board.js

Get info about your team and boards using some KeyWorks Trello list structure

/**
 * Board Entity
 * @author Elihu A. Cruz
 * @version 0.0.1
 */

// libs
const axios = require('axios')

// Models & setup
const List = require('../src/list')
const Task = require('../src/task')
const User = require('../src/user')
const auth = {
  apiKey: process.env.TRELLO_KEY,
  token: process.env.TRELLO_TOKEN,
}

class Board {
  /**
   * Set default
   */
  constructor (id = 0, name = '', desc = '', dateLastActivity = '0000-00-00') {
    this.id = id
    this.name = name
    this.desc = desc
    this.dateLastActivity = dateLastActivity
    this.lists = []
    this.users = []
    this.allCards = []
    this.totalEPoints = 0
  }

  /**
   * Fill Board info
   */
  async fill () {
    // List
    await this.getLists()
    // Cards
    await this.getAllCards()
    // users
    await this.getUsers()
  }

  /**
   * Fetch list from database
   * @returns {Array}
   */
  async getLists () {
    // fetch list
    try {
      const URL = `https://api.trello.com/1/boards/${this.id}/lists`
      const params = { token: auth.token, key: auth.apiKey }

      let response = await axios.get(URL, { params })
      if (response.status === 200) {
        this.lists = response.data.map(list => {
          return new List(list.id, list.name)
        }) 
        return this.lists.slice()
      }
    } catch (error) {
      console.log(error)
    }
  }

  /**
   * Fetch all cards
   * @returns {Array}
   */
  async getAllCards () {
    // get cards
    // restart count E Points
    this.totalEPoints = 0
    // fetch list
    try {
      const URL = `https://api.trello.com/1/boards/${this.id}/cards`
      const params = { token: auth.token, key: auth.apiKey }

      let response = await axios.get(URL, { params })
      if (response.status === 200) {
        this.allCards = response.data.map(task => {
          let currTask = new Task(task.name, task.dateLastActivity, task.idMembers.pop())
          // parse fields
          currTask.parseTask()
          this.totalEPoints += currTask.estimationPoints
          return currTask
        }) 
        return this.allCards.slice()
      }
    } catch (error) {
      console.log(error)
    }
  }

  /**
   * Get users
   * @returns {Array}
   */
  async getUsers () {
    // users
    try {
      const URL = `https://api.trello.com/1/boards/${this.id}/members`
      const params = { token: auth.token, key: auth.apiKey }

      let response = await axios.get(URL, { params })
      if (response.status === 200) {
        this.users = response.data.map(user => {
          return new User(user.id, user.fullName)
        }) 
        return this.users.slice()
      }
    } catch (error) {
      console.log(error)
    }
  }

  /**
   * Burndown char plotable info
   */
  async boardBurnDownData () {
    if (this.allCards.length <= 0) {
      await this.getAllCards()
    }

    let finalPoint = this.lists.filter(list => list.name.toUpperCase() === 'DONE')
    
    if (finalPoint.length !== 0) {
      let last = finalPoint.pop()
      let grouped = await last.getTasksGroupedBy()
      
      let burndown = []
      let pointsBurn = this.totalEPoints
      // get burndown points
      for (const keyDate in grouped) {
        if (grouped.hasOwnProperty(keyDate)) {
          const group = grouped[keyDate]
          var column = {};
          pointsBurn -= this.sum(group, 'estimationPoints')
          column[keyDate] = pointsBurn
          burndown.push(column)
        }
      }
      return burndown.slice()
    } else {
      return []
    }
  }

  /**
   * Get sum of value inside object
   * @param {Array} arr
   * @param {String} prop
   */
  sum (arr = [], prop = '') {
    let total = 0
    for (let i = 0, _len = arr.length; i < _len; i++) {
        total += arr[i][prop]
    }
    return total
  }

  /**
   * Global resume
   */
  async resume () {
    // get all cards
    if (this.allCards.length <= 0) {
      await this.getAllCards()
    }

    return {
      tasks: this.allCards.length,
      estimationPoints: this.sum(this.allCards, 'estimationPoints'),
      realPoints: this.sum(this.allCards, 'realPoints'),
      wished: 120
    }
  }

  /**
   * Resume by user
   * @param {User} user
   */
  async resumeByUser() {
    // get all cards
    if (this.allCards.length <= 0) {
      await this.getAllCards()
    }
    
    return this.users.map(user => {
      let curr = this.allCards.filter(card => card.userID === user.id)
      let response = {}
      response[user.fullName] = {
        tasks: curr.length,
        estimationPoints: this.sum(curr, 'estimationPoints'),
        realPoints: this.sum(curr, 'realPoints'),
        wished: 40
      }
      return response
    })
  }
}

module.exports = Board