feat: git#636-Need details of billing account for the project for the purpose of invoicing

Author: Vikas Agarwal

src/constants.js

@@ -276,6 +276,7 @@ export const M2M_SCOPES = {
     WRITE: 'write:projects',
     READ_USER_BILLING_ACCOUNTS: 'read:user-billing-accounts',
     WRITE_PROJECTS_BILLING_ACCOUNTS: 'write:projects-billing-accounts',
+    READ_PROJECT_BILLING_ACCOUNT_DETAILS: 'read:project-billing-account-details',
   },
   PROJECT_MEMBERS: {
     ALL: 'all:project-members',

src/permissions/constants.js

@@ -96,7 +96,14 @@ const SCOPES_PROJECTS_WRITE = [
  */
 const SCOPES_PROJECTS_READ_AVL_BILLING_ACCOUNTS = [
   M2M_SCOPES.CONNECT_PROJECT_ADMIN,
-  M2M_SCOPES.READ_USER_BILLING_ACCOUNTS,
+  M2M_SCOPES.PROJECTS.READ_USER_BILLING_ACCOUNTS,
+];
+
+/**
+ * M2M scopes to "read" available Billing Accounts for the project
+ */
+const SCOPES_PROJECTS_READ_BILLING_ACCOUNT_DETAILS = [
+  M2M_SCOPES.PROJECTS.READ_PROJECT_BILLING_ACCOUNT_DETAILS,
 ];
 
 /**
@@ -277,6 +284,18 @@ export const PERMISSION = { // eslint-disable-line import/prefer-default-export
     scopes: SCOPES_PROJECTS_READ_AVL_BILLING_ACCOUNTS,
   },
 
+  /*
+   * Project Invite
+   */
+  READ_PROJECT_BILLING_ACCOUNT_DETAILS: {
+    meta: {
+      title: 'Read details of billing accounts - only allowed to m2m calls',
+      group: 'Project Billing Accounts',
+      description: 'Who can view the details of the Billing Account attached to the project',
+    },
+    scopes: SCOPES_PROJECTS_READ_BILLING_ACCOUNT_DETAILS,
+  },
+
   /*
    * Project Member
    */

src/permissions/index.js

@@ -24,6 +24,10 @@ module.exports = () => {
     PERMISSION.READ_AVL_PROJECT_BILLING_ACCOUNTS,
   ]));
 
+  Authorizer.setPolicy('projectBillingAccount.view', generalPermission([
+    PERMISSION.READ_PROJECT_BILLING_ACCOUNT_DETAILS,
+  ]));
+
   Authorizer.setPolicy('projectMember.create', generalPermission([
     PERMISSION.CREATE_PROJECT_MEMBER_OWN,
     PERMISSION.CREATE_PROJECT_MEMBER_NOT_OWN,

src/routes/billingAccounts/get.js

@@ -0,0 +1,49 @@
+import _ from 'lodash';
+import validate from 'express-validation';
+import Joi from 'joi';
+import { middleware as tcMiddleware } from 'tc-core-library-js';
+import SalesforceService from '../../services/salesforceService';
+import models from '../../models';
+
+/**
+ * API to get project attachments.
+ *
+ */
+
+const permissions = tcMiddleware.permissions;
+
+const schema = {
+  params: {
+    projectId: Joi.number().integer().positive().required(),
+  },
+};
+
+module.exports = [
+  validate(schema),
+  permissions('projectBillingAccount.view'),
+  async (req, res, next) => {
+    const projectId = _.parseInt(req.params.projectId);
+    try {
+      const project = await models.Project.findOne({
+        where: { id: projectId },
+        attributes: ['id', 'billingAccountId'],
+        raw: true,
+      });
+      const billingAccountId = project.billingAccountId;
+      if (!billingAccountId) {
+        const err = new Error('Billing Account not found');
+        err.status = 404;
+        throw err;
+      }
+      const { accessToken, instanceUrl } = await SalesforceService.authenticate();
+      // eslint-disable-next-line
+      const sql = `SELECT  TopCoder_Billing_Account_Id__c, Mark_Up__c from Topcoder_Billing_Account__c tba where TopCoder_Billing_Account_Id__c='${billingAccountId}'`;
+      req.log.debug(sql);
+      const billingAccount = await SalesforceService.queryBillingAccount(sql, accessToken, instanceUrl, req.log);
+      res.json(billingAccount);
+    } catch (error) {
+      req.log.error(error);
+      next(error);
+    }
+  },
+];

src/routes/billingAccounts/list.js

@@ -29,7 +29,7 @@ module.exports = [
       const sql = `SELECT  Topcoder_Billing_Account__r.id, Topcoder_Billing_Account__r.TopCoder_Billing_Account_Id__c, Topcoder_Billing_Account__r.Billing_Account_Name__c, Topcoder_Billing_Account__r.Start_Date__c, Topcoder_Billing_Account__r.End_Date__c from Topcoder_Billing_Account_Resource__c tbar where UserID__c='${userId}'`;
       // and Topcoder_Billing_Account__r.TC_Connect_Project_ID__c='${projectId}'
       req.log.debug(sql);
-      const billingAccounts = await SalesforceService.query(sql, accessToken, instanceUrl, req.log);
+      const billingAccounts = await SalesforceService.queryUserBillingAccounts(sql, accessToken, instanceUrl, req.log);
       res.json(billingAccounts);
     } catch (error) {
       req.log.error(error);

src/routes/billingAccounts/list.spec.js

@@ -71,7 +71,7 @@ describe('Project Billing Accounts list', () => {
             accessToken: 'mock',
             instanceUrl: 'mock_url',
           }));
-          salesforceQuery = sinon.stub(SalesforceService, 'query', () => Promise.resolve(billingAccountsData));
+          salesforceQuery = sinon.stub(SalesforceService, 'queryUserBillingAccounts', () => Promise.resolve(billingAccountsData));
           done();
         });
       });

src/routes/index.js

@@ -123,6 +123,8 @@ router.route('/v5/projects/:projectId(\\d+)/scopeChangeRequests/:requestId(\\d+)
 
 router.route('/v5/projects/:projectId(\\d+)/billingAccounts')
   .get(require('./billingAccounts/list'));
+router.route('/v5/projects/:projectId(\\d+)/billingAccount')
+  .get(require('./billingAccounts/get'));
 
 router.route('/v5/projects/:projectId(\\d+)/members')
   .get(require('./projectMembers/list'))

src/services/salesforceService.js

@@ -54,7 +54,7 @@ class SalesforceService {
    * @param {Object} logger logger to be used for logging
    * @returns {{totalSize: Number, done: Boolean, records: Array}} the result
    */
-  static query(sql, accessToken, instanceUrl, logger) {
+  static queryUserBillingAccounts(sql, accessToken, instanceUrl, logger) {
     return axios({
       url: `${instanceUrl}/services/data/v37.0/query?q=${sql}`,
       method: 'get',
@@ -77,6 +77,31 @@ class SalesforceService {
       return billingAccounts;
     });
   }
+
+  /**
+   * Run the query statement
+   * @param {String} sql the Saleforce sql statement
+   * @param {String} accessToken the access token
+   * @param {String} instanceUrl the salesforce instance url
+   * @param {Object} logger logger to be used for logging
+   * @returns {{totalSize: Number, done: Boolean, records: Array}} the result
+   */
+  static queryBillingAccount(sql, accessToken, instanceUrl, logger) {
+    return axios({
+      url: `${instanceUrl}/services/data/v37.0/query?q=${sql}`,
+      method: 'get',
+      headers: { authorization: `Bearer ${accessToken}` },
+    }).then((res) => {
+      if (logger) {
+        logger.debug(_.get(res, 'data.records', []));
+      }
+      const billingAccounts = _.get(res, 'data.records', []).map(o => ({
+        tcBillingAccountId: _.get(o, 'TopCoder_Billing_Account_Id__c'),
+        markup: _.get(o, 'Mark_Up__c'),
+      }));
+      return billingAccounts.length > 0 ? billingAccounts[0] : {};
+    });
+  }
 }
 
 export default SalesforceService;