feat(report) debtor summary report

client/src/i18n/en/report.json

@@ -83,6 +83,11 @@
       "SHOW_UNVERIFIED_TRANSACTIONS": "Include Unverified Transactions",
       "SHOW_UNVERIFIED_TRANSACTIONS_HELP": "Enable to include records from the Journal which have not been audited by the accountant as well as records from the General Ledger the accountant has verified.  This view must be treated as a projection until the accountant has approved the Journal transactions and moved them to the General Ledger."
     },
+
+    "DEBTOR_SUMMARY" : {
+      "TITLE": "Debtors summary report",
+      "DESCRIPTION": "This report shows the amount to paid for each debtor of a given debtor group in each service during a period"
+    },
     "OPENING_BALANCE": "Opening Balance",
     "ORDER": {
       "LAST_TRANSACTION": "Date of Last Transaction",

client/src/i18n/fr/report.json

@@ -77,6 +77,10 @@
       "SHOW_UNVERIFIED_TRANSACTIONS" : "Inclure les transactions non vérifiées",
       "SHOW_UNVERIFIED_TRANSACTIONS_HELP" : "L'activation de cette option inclut les données du Journal (données non verifiées) et celles du Grand Livre (données vérifiées). Ce rapport doit être consideré comme une simple projection jusqu'à ce que les données du journal soient postées."
     },
+    "DEBTOR_SUMMARY" : {
+      "TITLE": "Rapport sommaire des débiteurs",
+      "DESCRIPTION": "Ce rapport montre le montant à payer pour chaque débiteurs d'un group donné dans chaque service durant une période"
+    },
     "OPENING_BALANCE": "Balance d'ouverture",
     "ORDER": {
       "LAST_TRANSACTION": "Date de la dernière transaction",

client/src/modules/reports/generate/debtorSummary/debtorSummary.config.js

@@ -0,0 +1,65 @@
+angular.module('bhima.controllers')
+  .controller('debtorSummaryController', DebtorSummaryController);
+
+DebtorSummaryController.$inject = [
+  '$sce', 'NotifyService', 'BaseReportService',
+  'AppCache', 'reportData', '$state',
+];
+
+function DebtorSummaryController($sce, Notify, SavedReports, AppCache, reportData, $state) {
+  const vm = this;
+  const cache = new AppCache('debtorSummary');
+  const reportUrl = 'reports/finance/debtorSummary';
+
+  vm.previewGenerated = false;
+  vm.reportDetails = {};
+
+  vm.clearPreview = function clearPreview() {
+    vm.previewGenerated = false;
+    vm.previewResult = null;
+  };
+
+  vm.onSelectDebtor = (debtorGroup) => {
+    vm.reportDetails.group_uuid = debtorGroup.uuid;
+  };
+
+  vm.preview = function preview(form) {
+    if (form.$invalid) {
+      Notify.danger('FORM.ERRORS.RECORD_ERROR');
+      return 0;
+    }
+
+
+    // update cached configuration
+    cache.reportDetails = angular.copy(vm.reportDetails);
+
+    return SavedReports.requestPreview(reportUrl, reportData.id, angular.copy(vm.reportDetails))
+      .then(result => {
+        vm.previewGenerated = true;
+        vm.previewResult = $sce.trustAsHtml(result);
+      })
+      .catch(Notify.handleError);
+  };
+
+  vm.requestSaveAs = function requestSaveAs() {
+    const options = {
+      url : reportUrl,
+      report : reportData,
+      reportOptions : angular.copy(vm.reportDetails),
+    };
+
+    return SavedReports.saveAsModal(options)
+      .then(() => {
+        $state.go('reportsBase.reportsArchive', { key : options.report.report_key });
+      })
+      .catch(Notify.handleError);
+  };
+
+  checkCachedConfiguration();
+
+  function checkCachedConfiguration() {
+    if (cache.reportDetails) {
+      vm.reportDetails = angular.copy(cache.reportDetails);
+    }
+  }
+}

client/src/modules/reports/generate/debtorSummary/debtorSummary.html

@@ -0,0 +1,49 @@
+<bh-report-preview
+  ng-if="ReportConfigCtrl.previewGenerated"
+  source-document="ReportConfigCtrl.previewResult"
+  on-clear-callback="ReportConfigCtrl.clearPreview()"
+  on-save-callback="ReportConfigCtrl.requestSaveAs()">
+</bh-report-preview>
+
+<div ng-show="!ReportConfigCtrl.previewGenerated">
+  <div class="row">
+    <div class="col-md-12">
+      <h3 class="text-capitalize" translate>REPORT.DEBTOR_SUMMARY.TITLE</h3>
+      <p class="text-info" translate>REPORT.DEBTOR_SUMMARY.DESCRIPTION</p>
+    </div>
+  </div>
+
+  <div class="row" style="margin-top : 10px">
+    <div class="col-md-6">
+      <div class="panel panel-default">
+        <div class="panel-heading">
+          <span translate>REPORT.UTIL.OPTIONS</span>
+        </div>
+        <div class="panel-body">
+          <form name="ConfigForm" bh-submit="ReportConfigCtrl.preview(ConfigForm)" novalidate>
+
+                 <!-- debtor group -->
+            <bh-debtor-group-select
+              required="true"
+              debtor-group-uuid = "ReportConfigCtrl.reportDetails.group_uuid"
+              on-select-callback = "ReportConfigCtrl.onSelectDebtor(debtorGroup)">
+            </bh-debtor-group-select>
+
+
+            <!-- Date interval  -->
+            <bh-date-interval
+              date-from="ReportConfigCtrl.reportDetails.dateFrom"
+              date-to="ReportConfigCtrl.reportDetails.dateTo"
+              required="true"
+              limit-min-fiscal>
+            </bh-date-interval>
+
+            <bh-loading-button loading-state="ConfigForm.$loading">
+              <span translate>REPORT.UTIL.PREVIEW</span>
+            </bh-loading-button>
+          </form>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>

client/src/modules/reports/reports.routes.js

@@ -35,6 +35,7 @@ angular.module('bhima.routes')
       'indicatorsReport',
       'visit_report',
       'monthlyBalance',
+      'debtorSummary',
     ];
 
     $stateProvider

server/config/routes.js

@@ -125,6 +125,7 @@ const accountReferenceType = require('../controllers/finance/accounts/accountRef
 const indicators = require('../controllers/finance/indicator');
 const breakEvenReference = require('../controllers/finance/breakEvenReference');
 
+const debotrSummaryReport = require('../controllers/finance/reports/debtors/summaryReport');
 // periods
 const period = require('../controllers/finance/period');
 
@@ -416,7 +417,7 @@ exports.configure = function configure(app) {
   app.get('/reports/finance/break_even', financeReports.breakEven.report);
   app.get('/reports/finance/break_even_fee_center', financeReports.breakEvenFeeCenter.report);
   app.get('/reports/finance/operating', financeReports.operating.document);
-
+  app.get('/reports/finance/debtorSummary', debotrSummaryReport.summaryReport);
   // visits reports
   app.get('/reports/visits', medicalReports.visitsReports.document);
 

server/controllers/finance/reports/debtors/summaryReport.handlebars

@@ -0,0 +1,63 @@
+{{> head title="REPORT.CLIENTS.TITLE"}}
+
+<body>
+  <main class="container">
+    {{> header }}
+
+    <h3 class="text-center text-capitalize">
+      <strong>{{translate "REPORT.DEBTOR_SUMMARY.TITLE"}}</strong>
+    </h3>
+
+    <h4 class="text-center text-capitalize">
+      {{ debtorGroup.name }}
+    </h4>
+     <h5 class="text-center">
+        <strong class="text-capitalize">{{date dateFrom "MMMM YYYY"}}</strong>
+           -
+        <strong class="text-capitalize">{{date dateTo "MMMM YYYY"}}</strong>
+    </h4>
+
+    <section>
+      <table style="font-size:11px !important" class="table table-condensed table-report  table-header-rotated table-bordered">
+        <thead>
+          <tr class="text-capitalize text-center" style="background: #ddd">
+            <th>{{translate "FORM.LABELS.NO"}}</th>
+            <th>{{translate "TABLE.COLUMNS.REFERENCE"}}</th>
+            <th>{{translate "TABLE.COLUMNS.NAME"}}</th>
+            {{#each ./services as | s |}}
+             <th class="rotate-45" >
+                 <div><span style="padding-left:2px;">{{ s.name }}</span></div></th>
+
+            {{/each}} 
+             <th class="rotate-45"><div><span style="padding-left:2px;">{{translate "FORM.LABELS.TOTAL"}}</span></div></th>
+
+          </tr>
+        </thead>
+        <tbody>
+         {{#each ./debtorMap as |debtor| }}
+            <tr>
+              <td>{{ add @index 1}}</td>
+              <td>{{ debtor.ref}}</td>
+              <td>{{ debtor.name}}</td>
+
+            {{#each debtor.services as | amount |}}
+                <th class="text-right">{{amount}}</th>
+            {{/each}}
+             <th class="text-right">{{currency debtor.total ../metadata.enterprise.currency_id}}</th>
+            </tr>
+
+          {{/each}}
+
+        </tbody>
+
+        <tfoot>
+             <td colspan="3" class="text-right">{{ translate 'FORM.LABELS.TOTAL'}}</td>
+             {{#each services as | s |}}
+                <td class="text-right">{{ currency s.total ../metadata.enterprise.currency_id}}</td>
+            {{/each}}
+            <td>{{currency gobalSum ../metadata.enterprise.currency_id}}</td>
+        </tfoot>
+      </table>
+    </section>
+  </main>
+</body>

server/controllers/finance/reports/debtors/summaryReport.js

@@ -0,0 +1,100 @@
+/**
+ * @overview ./finance/reports/debtors/summaryReport.js
+ *
+*/
+
+const _ = require('lodash');
+const ReportManager = require('../../../../lib/ReportManager');
+const db = require('../../../../lib/db');
+const util = require('../../../../lib/util');
+
+module.exports.summaryReport = summaryReport;
+
+// path to the template to render
+const TEMPLATE = './server/controllers/finance/reports/debtors/summaryReport.handlebars';
+
+const DEFAULT_OPTIONS = {
+  csvKey : 'debtors',
+  orientation : 'landscape',
+  footerRight : '[page] / [toPage]',
+  footerFontSize : '7',
+};
+
+/**
+ * @method summaryReport
+ *
+ * @description
+ * The HTTP interface which actually creates the report.
+ */
+async function summaryReport(req, res, next) {
+  try {
+    const qs = _.extend(req.query, DEFAULT_OPTIONS);
+    const { dateFrom, dateTo } = req.query;
+    const groupUuid = req.query.group_uuid;
+    const metadata = _.clone(req.session);
+    const report = new ReportManager(TEMPLATE, metadata, qs);
+    const serviceMap = {};
+    const debtorMap = {};
+    const emptyArray = [];
+    const serviceIndexMap = {};
+    let gobalSum = 0;
+
+    const serviceSql = ` SELECT id, name FROM service `;
+    const invoiceSql = ` 
+      SELECT  ent.text as ref, d.text, SUM(i.cost) as amount, BUID(i.debtor_uuid) as debtor_uuid, i.service_id
+      FROM invoice i
+      JOIN service s on s.id= i.service_id
+      JOIN debtor d ON d.uuid = i.debtor_uuid
+      JOIN debtor_group dg on dg.uuid = d.groupUuid
+      JOIN entity_map ent ON ent.uuid = d.uuid
+      WHERE dg.uuid = ? AND (i.date BETWEEN ? AND ?) AND i.reversed=0
+      GROUP BY i.debtor_uuid, i.service_id
+    `;
+
+    const debtorGroup = await db.one('SELECT name FROM debtor_group WHERE uuid=?', db.bid(groupUuid));
+    const services = await db.exec(serviceSql);
+
+    // initilisation
+    services.forEach((s, index) => {
+      serviceMap[s.id] = s;
+      serviceMap[s.id].total = 0;
+      emptyArray.push(null);
+      serviceIndexMap[s.id] = index;
+    });
+
+    // let get the list of invoices for this group
+    const invoices = await db.exec(invoiceSql, [db.bid(groupUuid), dateFrom, dateTo]);
+    // let attribute each invoice to it service for each debtor
+    invoices.forEach(iv => {
+      if (!debtorMap[iv.debtor_uuid]) {
+        debtorMap[iv.debtor_uuid] = {
+          name : iv.text, ref : iv.ref, total : 0, services : _.clone(emptyArray),
+        };
+      }
+      debtorMap[iv.debtor_uuid].services[serviceIndexMap[iv.service_id]] += iv.amount;
+      debtorMap[iv.debtor_uuid].total += iv.amount;
+      serviceMap[iv.service_id].total += iv.amount;
+    });
+    // rounding decimals
+    Object.keys(debtorMap).forEach(dbt => {
+      debtorMap[dbt].services.forEach((s, index) => {
+        if (s) {
+          debtorMap[dbt].services[index] = util.roundDecimal(s, 4);
+        }
+      });
+    });
+
+    // the global amount to paid for this debtor group
+    services.forEach(s => {
+      gobalSum += s.total;
+    });
+
+    // then let render the report
+    const result = await report.render({
+      debtorGroup, services, debtorMap, dateFrom, dateTo, gobalSum : util.roundDecimal(gobalSum, 2),
+    });
+    res.set(result.headers).send(result.report);
+  } catch (ex) {
+    next(ex);
+  }
+}

server/models/bhima.sql

@@ -128,7 +128,8 @@ INSERT INTO unit VALUES
   (241, 'Entity Folder', 'ENTITY.MANAGEMENT', 'Entity Folder', 0, '/modules/entities', '/ENTITY_FOLDER'),
   (242, 'Entity Management','ENTITY.MANAGEMENT','',241,'/modules/entities','/entities'),
   (243, 'Entity Group', 'ENTITY.GROUP.TITLE', 'Entity Group', 241, '/modules/entity_group', '/entity_group'),
-  (244, 'Monthly Balance', 'TREE.MONTHLY_BALANCE', 'Monthly Balance', 144, '/modules/reports/monthlyBalance', '/reports/monthlyBalance');
+  (244, 'Monthly Balance', 'TREE.MONTHLY_BALANCE', 'Monthly Balance', 144, '/modules/reports/monthlyBalance', '/reports/monthlyBalance'),
+  (245, 'Debtor summary report', 'REPORT.DEBTOR_SUMMARY.TITLE', 'Debtor summary report', 144, '/modules/reports/debtorSummary', '/reports/debtorSummary');
 
 -- Reserved system account type
 INSERT INTO `account_category` VALUES
@@ -180,7 +181,8 @@ INSERT INTO `report` (`id`, `report_key`, `title_key`) VALUES
   (31, 'indicatorsReport', 'TREE.INDICATORS_REPORT'),
   (32, 'visit_report', 'PATIENT_RECORDS.REPORT.VISITS'),
   (33, 'stock_entry', 'REPORT.STOCK.ENTRY_REPORT'),
-  (34, 'monthlyBalance', 'REPORT.MONTHLY_BALANCE.TITLE');
+  (34, 'monthlyBalance', 'REPORT.MONTHLY_BALANCE.TITLE'),
+  (35, 'debtorSummary', 'REPORT.DEBTOR_SUMMARY.TITLE');
 
 -- Supported Languages
 INSERT INTO `language` VALUES

server/models/migrations/next/migrations.sql

@@ -348,3 +348,15 @@ INSERT INTO unit VALUES
 INSERT INTO `report` (`id`, `report_key`, `title_key`) VALUES
   (34, 'monthlyBalance', 'REPORT.MONTHLY_BALANCE.TITLE');
 
+/*
+  @author:jeremielodi
+  @date: 2019-08-04
+  @title : Debtors summary report,
+  @description: TThis report shows the amount to paid for each debtor of a given debtor group in each service during a period
+*/
+
+INSERT INTO `report` (`id`, `report_key`, `title_key`) VALUES
+(35, 'debtorSummary', 'REPORT.DEBTOR_SUMMARY.TITLE');
+
+INSERT INTO unit VALUES
+(245, 'Debtor summary report', 'REPORT.DEBTOR_SUMMARY.TITLE', 'Debtor summary report', 144, '/modules/reports/debtorSummary', '/reports/debtorSummary');