Open-ILS/web/js/ui/default/staff/circ/patron/app.js

   1 /**
   2  * Patron App
   3  *
   4  * Search, checkout, items out, holds, bills, edit, etc.
   5  */
   6
   7 angular.module('egPatronApp', ['ngRoute', 'ui.bootstrap', 'egUserBucketMod',
   8     'egCoreMod', 'egUiMod', 'egGridMod', 'egUserMod', 'ngToast',
   9     'egPatronSearchMod'])
  10
  11 .config(['ngToastProvider', function(ngToastProvider) {
  12     ngToastProvider.configure({
  13         verticalPosition: 'bottom',
  14         animation: 'fade'
  15     });
  16 }])
  17
  18 .config(function($routeProvider, $locationProvider, $compileProvider) {
  19     $locationProvider.html5Mode(true);
  20     $compileProvider.aHrefSanitizationWhitelist(/^\s*(https?|mailto|blob):/); // grid export
  21
  22     // data loaded at startup which only requires an authtoken goes
  23     // here. this allows the requests to be run in parallel instead of
  24     // waiting until startup has completed.
  25     var resolver = {delay : ['egCore','egUser', function(egCore , egUser) {
  26
  27         // fetch the org settings we care about during egStartup
  28         // and toss them into egCore.env as egCore.env.aous[name] = value.
  29         // note: only load settings here needed by all tabs; load tab-
  30         // specific settings from within their respective controllers
  31         egCore.env.classLoaders.aous = function() {
  32             return egCore.org.settings([
  33                 'ui.staff.require_initials.patron_info_notes',
  34                 'circ.do_not_tally_claims_returned',
  35                 'circ.tally_lost',
  36                 'circ.obscure_dob',
  37                 'ui.circ.show_billing_tab_on_bills',
  38                 'circ.patron_expires_soon_warning',
  39                 'ui.circ.items_out.lost',
  40                 'ui.circ.items_out.longoverdue',
  41                 'ui.circ.items_out.claimsreturned'
  42             ]).then(function(settings) {
  43                 // local settings are cached within egOrg.  Caching them
  44                 // again in egEnv just simplifies the syntax for access.
  45                 egCore.env.aous = settings;
  46             });
  47         }
  48
  49         egCore.env.loadClasses.push('aous');
  50
  51         // app-globally modify the default flesh fields for
  52         // fleshed user retrieval.
  53         if (egUser.defaultFleshFields.indexOf('profile') == -1) {
  54             egUser.defaultFleshFields = egUser.defaultFleshFields.concat([
  55                 'profile',
  56                 'net_access_level',
  57                 'ident_type',
  58                 'ident_type2',
  59                 'cards',
  60                 'groups'
  61             ]);
  62         }
  63
  64         return egCore.startup.go();
  65     }]};
  66
  67     $routeProvider.when('/circ/patron/search', {
  68         templateUrl: './circ/patron/t_search',
  69         controller: 'PatronSearchCtrl',
  70         resolve : resolver
  71     });
  72
  73     $routeProvider.when('/circ/patron/bcsearch', {
  74         templateUrl: './circ/patron/t_bcsearch',
  75         controller: 'PatronBarcodeSearchCtrl',
  76         resolve : resolver
  77     });
  78
  79     $routeProvider.when('/circ/patron/credentials', {
  80         templateUrl: './circ/patron/t_credentials',
  81         controller: 'PatronVerifyCredentialsCtrl',
  82         resolve : resolver
  83     });
  84
  85     $routeProvider.when('/circ/patron/last', {
  86         templateUrl: './circ/patron/t_last_patron',
  87         controller: 'PatronFetchLastCtrl',
  88         resolve : resolver
  89     });
  90
  91     // the following require a patron ID
  92
  93     $routeProvider.when('/circ/patron/:id/alerts', {
  94         templateUrl: './circ/patron/t_alerts',
  95         controller: 'PatronAlertsCtrl',
  96         resolve : resolver
  97     });
  98
  99     $routeProvider.when('/circ/patron/:id/checkout', {
 100         templateUrl: './circ/patron/t_checkout',
 101         controller: 'PatronCheckoutCtrl',
 102         resolve : resolver
 103     });
 104
 105     $routeProvider.when('/circ/patron/:id/items_out', {
 106         templateUrl: './circ/patron/t_items_out',
 107         controller: 'PatronItemsOutCtrl',
 108         resolve : resolver
 109     });
 110
 111     $routeProvider.when('/circ/patron/:id/holds', {
 112         templateUrl: './circ/patron/t_holds',
 113         controller: 'PatronHoldsCtrl',
 114         resolve : resolver
 115     });
 116
 117     $routeProvider.when('/circ/patron/:id/holds/create', {
 118         templateUrl: './circ/patron/t_holds_create',
 119         controller: 'PatronHoldsCreateCtrl',
 120         resolve : resolver
 121     });
 122
 123     $routeProvider.when('/circ/patron/:id/holds/:hold_id', {
 124         templateUrl: './circ/patron/t_holds',
 125         controller: 'PatronHoldsCtrl',
 126         resolve : resolver
 127     });
 128
 129     $routeProvider.when('/circ/patron/:id/hold/:hold_id', {
 130         templateUrl: './circ/patron/t_hold_details',
 131         controller: 'PatronHoldDetailsCtrl',
 132         resolve : resolver
 133     });
 134
 135     $routeProvider.when('/circ/patron/:id/bills', {
 136         templateUrl: './circ/patron/t_bills',
 137         controller: 'PatronBillsCtrl',
 138         resolve : resolver
 139     });
 140
 141     $routeProvider.when('/circ/patron/:id/bill/:xact_id/:xact_tab', {
 142         templateUrl: './circ/patron/t_xact_details',
 143         controller: 'XactDetailsCtrl',
 144         resolve : resolver
 145     });
 146
 147     $routeProvider.when('/circ/patron/:id/bill_history/:history_tab', {
 148         templateUrl: './circ/patron/t_bill_history',
 149         controller: 'BillHistoryCtrl',
 150         resolve : resolver
 151     });
 152
 153     $routeProvider.when('/circ/patron/:id/messages', {
 154         templateUrl: './circ/patron/t_messages',
 155         controller: 'PatronMessagesCtrl',
 156         resolve : resolver
 157     });
 158
 159     $routeProvider.when('/circ/patron/:id/edit', {
 160         templateUrl: './circ/patron/t_edit',
 161         controller: 'PatronRegCtrl',
 162         resolve : resolver
 163     });
 164
 165     $routeProvider.when('/circ/patron/:id/credentials', {
 166         templateUrl: './circ/patron/t_credentials',
 167         controller: 'PatronVerifyCredentialsCtrl',
 168         resolve : resolver
 169     });
 170
 171     $routeProvider.when('/circ/patron/:id/notes', {
 172         templateUrl: './circ/patron/t_notes',
 173         controller: 'PatronNotesCtrl',
 174         resolve : resolver
 175     });
 176
 177     $routeProvider.when('/circ/patron/:id/triggered_events', {
 178         templateUrl: './circ/patron/t_triggered_events',
 179         controller: 'PatronTriggeredEventsCtrl',
 180         resolve : resolver
 181     });
 182
 183     $routeProvider.when('/circ/patron/:id/message_center', {
 184         templateUrl: './circ/patron/t_message_center',
 185         controller: 'PatronMessageCenterCtrl',
 186         resolve : resolver
 187     });
 188
 189     $routeProvider.when('/circ/patron/:id/edit_perms', {
 190         templateUrl: './circ/patron/t_edit_perms',
 191         controller: 'PatronPermsCtrl',
 192         resolve : resolver
 193     });
 194
 195     $routeProvider.when('/circ/patron/:id/group', {
 196         templateUrl: './circ/patron/t_group',
 197         controller: 'PatronGroupCtrl',
 198         resolve : resolver
 199     });
 200
 201     $routeProvider.when('/circ/patron/:id/stat_cats', {
 202         templateUrl: './circ/patron/t_stat_cats',
 203         controller: 'PatronStatCatsCtrl',
 204         resolve : resolver
 205     });
 206
 207     $routeProvider.when('/circ/patron/:id/surveys', {
 208         templateUrl: './circ/patron/t_surveys',
 209         controller: 'PatronSurveyCtrl',
 210         resolve : resolver
 211     });
 212
 213     $routeProvider.otherwise({redirectTo : '/circ/patron/search'});
 214 })
 215
 216 /**
 217  * Manages tabbed patron view.
 218  * This is the parent scope of all patron tab scopes.
 219  *
 220  * */
 221 .controller('PatronCtrl',
 222        ['$scope','$q','$location','$filter','egCore','egNet','egUser','egAlertDialog','egConfirmDialog','egPromptDialog','patronSvc',
 223 function($scope,  $q , $location , $filter , egCore , egNet , egUser , egAlertDialog , egConfirmDialog , egPromptDialog , patronSvc) {
 224
 225     $scope.is_patron_edit = function() {
 226         return Boolean($location.path().match(/patron\/\d+\/edit$/));
 227     }
 228
 229     // To support the fixed position patron edit actions bar,
 230     // its markup has to live outside the scope of the patron
 231     // edit controller.  Insert a scope blob here that can be
 232     // modifed from within the patron edit controller.
 233     $scope.edit_passthru = {};
 234
 235     // returns true if a redirect occurs
 236     function redirectToAlertPanel() {
 237
 238         $scope.alert_penalties =
 239             function() {return patronSvc.alert_penalties}
 240
 241         if (patronSvc.alertsShown()) return false;
 242
 243         // if the patron has any unshown alerts, show them now
 244         if (patronSvc.hasAlerts &&
 245             !$location.path().match(/alerts$/)) {
 246
 247             $location
 248                 .path('/circ/patron/' + patronSvc.current.id() + '/alerts')
 249                 .search('card', null);
 250             return true;
 251         }
 252
 253         // no alert required.  If the patron has fines and the show-bills
 254         // OUS is applied, direct to the bills page.
 255         if ($scope.patron_stats().fines.balance_owed > 0 // TODO: != 0 ?
 256             && egCore.env.aous['ui.circ.show_billing_tab_on_bills']
 257             && !$location.path().match(/bills$/)) {
 258
 259             $scope.tab = 'bills';
 260             $location
 261                 .path('/circ/patron/' + patronSvc.current.id() + '/bills')
 262                 .search('card', null);
 263
 264             return true;
 265         }
 266
 267         return false;
 268     }
 269
 270     // called after each route-specified controller is instantiated.
 271     // this doubles as a way to inform the top-level controller that
 272     // egStartup.go() has completed, which means we are clear to
 273     // fetch the patron, etc.
 274     $scope.initTab = function(tab, patron_id) {
 275         console.log('init tab ' + tab);
 276         $scope.tab = tab;
 277         $scope.aous = egCore.env.aous;
 278         $scope.auth_user_id = egCore.auth.user().id();
 279
 280         if (patron_id) {
 281             $scope.patron_id = patron_id;
 282             return patronSvc.setPrimary($scope.patron_id)
 283             .then(function() {
 284                 // the page title context label comes from the tab.
 285                 egCore.strings.setPageTitle(
 286                     egCore.strings.PAGE_TITLE_PATRON_NAME,
 287                     egCore.strings['PAGE_TITLE_PATRON_' + tab.toUpperCase()],
 288                     {   lname : patronSvc.current.family_name(),
 289                         fname : patronSvc.current.first_given_name(),
 290                         mname : patronSvc.current.second_given_name()
 291                     }
 292                 );
 293             })
 294             .then(function() {return patronSvc.checkAlerts()})
 295             .then(redirectToAlertPanel)
 296             .then(function(){
 297                 $scope.ident_type_name = $scope.patron().ident_type().name()
 298                 $scope.hasIdentTypeName = $scope.ident_type_name.length > 0;
 299             });
 300         } else {
 301             // No patron, use the tab name as the page title.
 302             egCore.strings.setPageTitle(
 303                 egCore.strings['PAGE_TITLE_PATRON_' + tab.toUpperCase()]);
 304         }
 305         return $q.when();
 306     }
 307
 308     $scope._show_dob = {};
 309     $scope.show_dob = function (val) {
 310         if ($scope.patron()) {
 311             if (typeof val != 'undefined') $scope._show_dob[$scope.patron().id()] = val;
 312             return $scope._show_dob[$scope.patron().id()];
 313         }
 314         return !egCore.env.aous['circ.obscure_dob'];
 315     }
 316
 317     $scope.obscure_dob = function() {
 318         return egCore.env.aous && egCore.env.aous['circ.obscure_dob'];
 319     }
 320     $scope.now_show_dob = function() {
 321         return egCore.env.aous && egCore.env.aous['circ.obscure_dob'] ?
 322             $scope.show_dob() : true;
 323     }
 324
 325     $scope.patron = function() { return patronSvc.current }
 326     $scope.patron_stats = function() { return patronSvc.patron_stats }
 327     $scope.summary_stat_cats = function() { return patronSvc.summary_stat_cats }
 328     $scope.hasAlerts = function() { return patronSvc.hasAlerts }
 329     $scope.isPatronExpired = function() { return patronSvc.patronExpired }
 330
 331     $scope.print_address = function(addr) {
 332         egCore.print.print({
 333             context : 'default',
 334             template : 'patron_address',
 335             scope : {
 336                 patron : egCore.idl.toHash(patronSvc.current),
 337                 address : egCore.idl.toHash(addr)
 338             }
 339         });
 340     }
 341
 342     $scope.toggle_expand_summary = function() {
 343         if ($scope.collapsePatronSummary) {
 344             $scope.collapsePatronSummary = false;
 345             egCore.hatch.removeItem('eg.circ.patron.summary.collapse');
 346         } else {
 347             $scope.collapsePatronSummary = true;
 348             egCore.hatch.setItem('eg.circ.patron.summary.collapse', true);
 349         }
 350     }
 351
 352     // always expand the patron summary in the search UI, regardless
 353     // of stored preference.
 354     $scope.collapse_summary = function() {
 355         return $scope.tab != 'search' && $scope.collapsePatronSummary;
 356     }
 357
 358     function _purge_account(dest_usr,override) {
 359         egNet.request(
 360             'open-ils.actor',
 361             'open-ils.actor.user.delete' + (override ? '.override' : ''),
 362             egCore.auth.token(),
 363             $scope.patron().id(),
 364             dest_usr
 365         ).then(function(resp){
 366             if (evt = egCore.evt.parse(resp)) {
 367                 if (evt.code == '2004' /* ACTOR_USER_DELETE_OPEN_XACTS */) {
 368                     egConfirmDialog.open(
 369                         egCore.strings.PATRON_PURGE_CONFIRM_TITLE, egCore.strings.PATRON_PURGE_OVERRIDE_PROMPT,
 370                         {ok : function() {
 371                             _purge_account(dest_usr,true);
 372                         }}
 373                     );
 374                 } else {
 375                     alert(js2JSON(evt));
 376                 }
 377             } else {
 378                 location.href = egCore.env.basePath + '/circ/patron/search';
 379             }
 380         });
 381     }
 382
 383     function _purge_account_with_destination(dest_barcode) {
 384         egCore.pcrud.search('ac', {barcode : dest_barcode})
 385         .then(function(card) {
 386             if (!card) {
 387                 egAlertDialog.open(egCore.strings.PATRON_PURGE_STAFF_BAD_BARCODE);
 388             } else {
 389                 _purge_account(card.usr());
 390             }
 391         });
 392     }
 393
 394     $scope.purge_account = function() {
 395         egConfirmDialog.open(
 396             egCore.strings.PATRON_PURGE_CONFIRM_TITLE, egCore.strings.PATRON_PURGE_CONFIRM,
 397             {ok : function() {
 398                 egConfirmDialog.open(
 399                     egCore.strings.PATRON_PURGE_CONFIRM_TITLE, egCore.strings.PATRON_PURGE_LAST_CHANCE,
 400                     {ok : function() {
 401                         egNet.request(
 402                             'open-ils.actor',
 403                             'open-ils.actor.user.has_work_perm_at',
 404                             egCore.auth.token(), 'STAFF_LOGIN', $scope.patron().id()
 405                         ).then(function(resp) {
 406                             var is_staff = resp.length > 0;
 407                             if (is_staff) {
 408                                 egPromptDialog.open(
 409                                     egCore.strings.PATRON_PURGE_STAFF_PROMPT,
 410                                     null, // TODO: this would be cool if it worked: egCore.auth.user().card().barcode(),
 411                                     {ok : function(barcode) {_purge_account_with_destination(barcode)}}
 412                                 );
 413                             } else {
 414                                 _purge_account();
 415                             }
 416                         });
 417                     }
 418                 });
 419             }
 420         });
 421     }
 422
 423     egCore.hatch.getItem('eg.circ.patron.summary.collapse')
 424     .then(function(val) {$scope.collapsePatronSummary = Boolean(val)});
 425 }])
 426
 427 .controller('PatronBarcodeSearchCtrl',
 428        ['$scope','$location','egCore','egConfirmDialog','egUser','patronSvc','$uibModal','$q',
 429 function($scope , $location , egCore , egConfirmDialog , egUser , patronSvc , $uibModal , $q) {
 430     $scope.selectMe = true; // focus text input
 431     patronSvc.clearPrimary(); // clear the default user
 432
 433     // jump to the patron checkout UI
 434     function loadPatron(user_id) {
 435         egCore.audio.play('success.patron.by_barcode');
 436         $location
 437         .path('/circ/patron/' + user_id + '/checkout')
 438         .search('card', $scope.args.barcode);
 439         patronSvc.search_barcode = $scope.args.barcode;
 440     }
 441
 442     // create an opt-in=yes response for the loaded user
 443     function createOptIn(user_id) {
 444         egCore.net.request(
 445             'open-ils.actor',
 446             'open-ils.actor.user.org_unit_opt_in.create',
 447             egCore.auth.token(), user_id).then(function(resp) {
 448                 if (evt = egCore.evt.parse(resp)) return alert(evt);
 449                 loadPatron(user_id);
 450             }
 451         );
 452     }
 453
 454     $scope.submitBarcode = function(args) {
 455         $scope.bcNotFound = null;
 456         $scope.optInRestricted = false;
 457         if (!args.barcode) return;
 458         args.barcode = args.barcode.replace(/\s/g,'');
 459         // blur so next time it's set to true it will re-apply select()
 460         $scope.selectMe = false;
 461
 462         var user_id;
 463
 464         // given a scanned barcode, this function finds any matching users
 465         // and handles multiple matches due to barcode completion
 466         function handleBarcodeCompletion(scanned_barcode) {
 467             var deferred = $q.defer();
 468
 469             egCore.net.request(
 470                 'open-ils.actor',
 471                 'open-ils.actor.get_barcodes',
 472                 egCore.auth.token(), egCore.auth.user().ws_ou(),
 473                 'actor', scanned_barcode)
 474
 475             .then(function(resp) { // get_barcodes
 476
 477                 if (evt = egCore.evt.parse(resp)) {
 478                     alert(evt); // FIXME
 479                     deferred.reject();
 480                     return;
 481                 }
 482
 483                 if (!resp || !resp[0]) {
 484                     $scope.bcNotFound = args.barcode;
 485                     $scope.selectMe = true;
 486                     egCore.audio.play('warning.patron.not_found');
 487                     deferred.reject();
 488                     return;
 489                 }
 490
 491                 if (resp.length == 1) {
 492                     // exactly one matching barcode: return it
 493                     deferred.resolve();
 494                     user_id = resp[0].id;
 495                 } else {
 496                     // multiple matching barcodes: let the user pick one
 497                     var barcode_map = {};
 498                     var matches = [];
 499                     var promises = [];
 500                     var selected_barcode;
 501                     angular.forEach(resp, function(match) {
 502                         promises.push(
 503                             egUser.get(match.id, {useFields : ['home_ou']}).then(function(user) {
 504                                 barcode_map[match.barcode] = user.id();
 505                                 matches.push( {
 506                                     barcode: match.barcode,
 507                                     title: user.first_given_name() + ' ' + user.family_name(),
 508                                     org_name: user.home_ou().name(),
 509                                     org_shortname: user.home_ou().shortname()
 510                                 });
 511                             })
 512                         );
 513                     });
 514                     return $q.all(promises)
 515                     .then(function() {
 516                         $uibModal.open({
 517                             templateUrl: './circ/share/t_barcode_choice_dialog',
 518                             controller:
 519                                 ['$scope', '$uibModalInstance',
 520                                 function($scope, $uibModalInstance) {
 521                                 $scope.matches = matches;
 522                                 $scope.ok = function(barcode) {
 523                                     $uibModalInstance.close();
 524                                     selected_barcode = barcode;
 525                                 }
 526                                 $scope.cancel = function() {$uibModalInstance.dismiss()}
 527                             }],
 528                         }).result.then(function() {
 529                             deferred.resolve();
 530                             user_id = barcode_map[selected_barcode];
 531                         });
 532                     });
 533                 }
 534             });
 535             return deferred.promise;
 536         }
 537
 538         // call our function to lookup matching users for the scanned barcode
 539         handleBarcodeCompletion(args.barcode).then(function() {
 540
 541             // see if an opt-in request is needed
 542             return egCore.net.request(
 543                 'open-ils.actor',
 544                 'open-ils.actor.user.org_unit_opt_in.check',
 545                 egCore.auth.token(), user_id
 546             ).then(function(optInResp) { // opt_in_check
 547
 548                 if (evt = egCore.evt.parse(optInResp)) {
 549                     alert(evt); // FIXME
 550                     return;
 551                 }
 552
 553                 if (optInResp == 2) {
 554                     // opt-in disallowed at this location by patron's home library
 555                     $scope.optInRestricted = true;
 556                     $scope.selectMe = true;
 557                     egCore.audio.play('warning.patron.opt_in_restricted');
 558                     return;
 559                 }
 560
 561                 if (optInResp == 1) {
 562                     // opt-in handled or not needed
 563                     return loadPatron(user_id);
 564                 }
 565
 566                 // opt-in needed, show the opt-in dialog
 567                 egUser.get(user_id, {useFields : []})
 568
 569                 .then(function(user) { // retrieve user
 570                     var org = egCore.org.get(user.home_ou());
 571                     egConfirmDialog.open(
 572                         egCore.strings.OPT_IN_DIALOG_TITLE,
 573                         egCore.strings.OPT_IN_DIALOG,
 574                         {   family_name : user.family_name(),
 575                             first_given_name : user.first_given_name(),
 576                             org_name : org.name(),
 577                             org_shortname : org.shortname(),
 578                             ok : function() { createOptIn(user.id()) },
 579                             cancel : function() {}
 580                         }
 581                     );
 582                 })
 583             })
 584         })
 585     }
 586 }])
 587
 588
 589 /**
 590  * Manages patron search
 591  */
 592 .controller('PatronSearchCtrl',
 593        ['$scope','$q','$routeParams','$timeout','$window','$location','egCore','ngToast',
 594        '$filter','egUser', 'patronSvc','egGridDataProvider','$document','bucketSvc',
 595        'egPatronMerge','egProgressDialog','$controller','$interpolate','$uibModal',
 596 function($scope,  $q,  $routeParams,  $timeout,  $window,  $location,  egCore , ngToast,
 597          $filter,  egUser,  patronSvc , egGridDataProvider , $document , bucketSvc,
 598         egPatronMerge , egProgressDialog , $controller , $interpolate , $uibModal) {
 599
 600     angular.extend(this, $controller('BasePatronSearchCtrl', {$scope : $scope}));
 601     $scope.initTab('search');
 602
 603     $scope.gridControls = {
 604         activateItem : function(item) {
 605             $location.path('/circ/patron/' + item.id() + '/checkout');
 606         },
 607         selectedItems : function() { return [] }
 608     }
 609
 610     $scope.bucketSvc = bucketSvc;
 611     $scope.bucketSvc.fetchUserBuckets();
 612     $scope.addToBucket = function(item, data, recs) {
 613         if (recs.length == 0) return;
 614         var added_count = 0;
 615         var failed_count = 0;
 616         var p = [];
 617         angular.forEach(recs,
 618             function(rec) {
 619                 var item = new egCore.idl.cubi();
 620                 item.bucket(data.id());
 621                 item.target_user(rec.id());
 622                 p.push(egCore.net.request(
 623                     'open-ils.actor',
 624                     'open-ils.actor.container.item.create',
 625                     egCore.auth.token(), 'user', item
 626                 ).then(
 627                     function(){ added_count++ },
 628                     function(){ failed_count++ }
 629                 ));
 630             }
 631         );
 632
 633         $q.all(p).then( function () {
 634             if (added_count) ngToast.create($interpolate(egCore.strings.BUCKET_ADD_SUCCESS)({ count: ''+added_count, name: data.name()} ));
 635             if (failed_count) ngToast.warning($interpolate(egCore.strings.BUCKET_ADD_FAIL)({ count: ''+failed_count, name: data.name() } ));
 636         });
 637     }
 638
 639     var temp_scope = $scope;
 640     $scope.openCreateBucketDialog = function() {
 641         $uibModal.open({
 642             templateUrl: './circ/patron/bucket/t_bucket_create',
 643             backdrop: 'static',
 644             controller:
 645                 ['$scope', '$uibModalInstance', function($scope, $uibModalInstance) {
 646                 $scope.focusMe = true;
 647                 $scope.ok = function(args) { $uibModalInstance.close(args) }
 648                 $scope.cancel = function () { $uibModalInstance.dismiss() }
 649             }]
 650         }).result.then(function (args) {
 651             if (!args || !args.name) return;
 652             bucketSvc.createBucket(args.name, args.desc).then(
 653                 function(id) {
 654                     if (id) {
 655                         $scope.bucketSvc.fetchBucket(id).then(function (b) {
 656                             $scope.addToBucket(
 657                                 null,
 658                                 b,
 659                                 $scope.gridControls.selectedItems()
 660                             );
 661                             $scope.bucketSvc.fetchUserBuckets(true);
 662                         });
 663                     }
 664                 }
 665             );
 666         });
 667     }
 668
 669     $scope.$watch(
 670         function() {return $scope.gridControls.selectedItems()},
 671         function(list) {
 672             if (list[0])
 673                 patronSvc.setPrimary(null, list[0]);
 674         },
 675         true
 676     );
 677
 678     $scope.need_one_selected = function() {
 679         var items = $scope.gridControls.selectedItems();
 680         return (items.length > 0) ? false : true;
 681     }
 682     $scope.need_two_selected = function() {
 683         var items = $scope.gridControls.selectedItems();
 684         return (items.length == 2) ? false : true;
 685     }
 686     $scope.merge_patrons = function() {
 687         var items = $scope.gridControls.selectedItems();
 688         if (items.length != 2) return false;
 689
 690         var patron_ids = [];
 691         angular.forEach(items, function(i) {
 692             patron_ids.push(i.id());
 693         });
 694         egPatronMerge.do_merge(patron_ids).then(function() {
 695             // ensure that we're not drawing from cached
 696             // resuts, as a successful merge just deleted a
 697             // record
 698             delete patronSvc.lastSearch;
 699             $scope.gridControls.refresh();
 700         });
 701     }
 702
 703 }])
 704
 705 /**
 706  * Manages messages
 707  */
 708 .controller('PatronMessagesCtrl',
 709        ['$scope','$q','$routeParams','egCore','$uibModal','patronSvc','egCirc',
 710 function($scope , $q , $routeParams,  egCore , $uibModal , patronSvc , egCirc) {
 711     $scope.initTab('messages', $routeParams.id);
 712     var usr_id = $routeParams.id;
 713     var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
 714
 715     // setup date filters
 716     var start = new Date(); // now - 1 year
 717     start.setFullYear(start.getFullYear() - 1),
 718     $scope.dates = {
 719         start_date : start,
 720         end_date : new Date()
 721     }
 722
 723     function date_range() {
 724         var start = $scope.dates.start_date.toISOString().replace(/T.*/,'');
 725         var end = $scope.dates.end_date.toISOString().replace(/T.*/,'');
 726         var today = new Date().toISOString().replace(/T.*/,'');
 727         if (end == today) end = 'now';
 728         return [start, end];
 729     }
 730
 731     // grid queries
 732
 733     var activeGrid = $scope.activeGridControls = {
 734         setSort : function() {
 735             return ['set_date'];
 736         },
 737         setQuery : function() {
 738             return {
 739                 usr : usr_id,
 740                 org_unit : org_ids,
 741                 '-or' : [
 742                     {stop_date : null},
 743                     {stop_date : {'>' : 'now'}}
 744                 ]
 745             }
 746         }
 747     }
 748
 749     var archiveGrid = $scope.archiveGridControls = {
 750         setSort : function() {
 751             return ['set_date'];
 752         },
 753         setQuery : function() {
 754             return {
 755                 usr : usr_id,
 756                 org_unit : org_ids,
 757                 stop_date : {'<=' : 'now'},
 758                 set_date : {between : date_range()}
 759             };
 760         }
 761     };
 762
 763     $scope.removePenalty = function(selected) {
 764         // the grid stores flattened penalties.  Fetch penalty objects first
 765
 766         var ids = selected.map(function(s){ return s.id });
 767         egCore.pcrud.search('ausp',
 768             {id : ids}, {},
 769             {atomic : true, authoritative : true}
 770
 771         // then delete them
 772         ).then(function(penalties) {
 773             return egCore.pcrud.remove(penalties);
 774
 775         // then refresh the grid
 776         }).then(function() {
 777             activeGrid.refresh();
 778         });
 779     }
 780
 781     $scope.archivePenalty = function(selected) {
 782         // the grid stores flattened penalties.  Fetch penalty objects first
 783
 784         var ids = selected.map(function(s){ return s.id });
 785         egCore.pcrud.search('ausp',
 786             {id : ids}, {},
 787             {atomic : true, authoritative : true}
 788
 789         // then delete them
 790         ).then(function(penalties) {
 791             angular.forEach(penalties, function(p){ p.stop_date('now') });
 792             return egCore.pcrud.update(penalties);
 793
 794         // then refresh the grid
 795         }).then(function() {
 796             activeGrid.refresh();
 797             archiveGrid.refresh();
 798         });
 799     }
 800
 801     // leverage egEnv for caching
 802     function fetchPenaltyTypes() {
 803         if (egCore.env.csp)
 804             return $q.when(egCore.env.csp.list);
 805         return egCore.pcrud.search(
 806             // id <= 100 are reserved for system use
 807             'csp', {id : {'>': 100}}, {}, {atomic : true})
 808         .then(function(penalties) {
 809             egCore.env.absorbList(penalties, 'csp');
 810             return penalties;
 811         });
 812     }
 813
 814     $scope.createPenalty = function() {
 815         egCirc.create_penalty(usr_id).then(function() {
 816             activeGrid.refresh();
 817             // force a refresh of the user, since they may now
 818             // have blocking penalties, etc.
 819             patronSvc.setPrimary(patronSvc.current.id(), null, true);
 820         });
 821     }
 822
 823     $scope.editPenalty = function(selected) {
 824         if (selected.length == 0) return;
 825
 826         // grab the penalty from the user object
 827         var penalty = patronSvc.current.standing_penalties().filter(
 828             function(p) {return p.id() == selected[0].id})[0];
 829
 830         egCirc.edit_penalty(penalty).then(function() {
 831             activeGrid.refresh();
 832             // force a refresh of the user, since they may now
 833             // have blocking penalties, etc.
 834             patronSvc.setPrimary(patronSvc.current.id(), null, true);
 835         });
 836     }
 837 }])
 838
 839
 840 /**
 841  * Credentials tester
 842  */
 843 .controller('PatronVerifyCredentialsCtrl',
 844        ['$scope','$routeParams','$location','egCore',
 845 function($scope,  $routeParams , $location , egCore) {
 846     $scope.verified = null;
 847     $scope.focusMe = true;
 848
 849     // called with a patron, pre-populate the form args
 850     $scope.initTab('other', $routeParams.id).then(
 851         function() {
 852             if ($routeParams.id && $scope.patron()) {
 853                 $scope.prepop = true;
 854                 $scope.username = $scope.patron().usrname();
 855                 $scope.barcode = $scope.patron().card().barcode();
 856             } else {
 857                 $scope.username = '';
 858                 $scope.barcode = '';
 859                 $scope.password = '';
 860             }
 861         }
 862     );
 863
 864     // verify login credentials
 865     $scope.verify = function() {
 866         $scope.verified = null;
 867         $scope.notFound = false;
 868
 869         egCore.net.request(
 870             'open-ils.actor',
 871             'open-ils.actor.verify_user_password',
 872             egCore.auth.token(), $scope.barcode,
 873             $scope.username, hex_md5($scope.password || '')
 874
 875         ).then(function(resp) {
 876             $scope.focusMe = true;
 877             if (evt = egCore.evt.parse(resp)) {
 878                 alert(evt);
 879             } else if (resp == 1) {
 880                 $scope.verified = true;
 881             } else {
 882                 $scope.verified = false;
 883             }
 884         });
 885     }
 886
 887     // load the main patron UI for the provided username or barcode
 888     $scope.load = function($event) {
 889         $scope.notFound = false;
 890         $scope.verified = null;
 891
 892         egCore.net.request(
 893             'open-ils.actor',
 894             'open-ils.actor.user.retrieve_id_by_barcode_or_username',
 895             egCore.auth.token(), $scope.barcode, $scope.username
 896
 897         ).then(function(resp) {
 898
 899             if (Number(resp)) {
 900                 $location.path('/circ/patron/' + resp + '/checkout');
 901                 return;
 902             }
 903
 904             // something went wrong...
 905             $scope.focusMe = true;
 906             if (evt = egCore.evt.parse(resp)) {
 907                 if (evt.textcode == 'ACTOR_USR_NOT_FOUND') {
 908                     $scope.notFound = true;
 909                     return;
 910                 }
 911                 return alert(evt);
 912             } else {
 913                 alert(resp);
 914             }
 915         });
 916
 917         // load() button sits within the verify form.
 918         // avoid submitting the verify() form action on load()
 919         $event.preventDefault();
 920     }
 921 }])
 922
 923 .controller('PatronAlertsCtrl',
 924        ['$scope','$routeParams','$location','egCore','patronSvc',
 925 function($scope,  $routeParams , $location , egCore , patronSvc) {
 926
 927     $scope.initTab('other', $routeParams.id)
 928     .then(function() {
 929         $scope.patronExpired = patronSvc.patronExpired;
 930         $scope.patronExpiresSoon = patronSvc.patronExpiresSoon;
 931         $scope.retrievedWithInactive = patronSvc.fetchedWithInactiveCard();
 932         $scope.invalidAddresses = patronSvc.invalidAddresses;
 933     });
 934
 935 }])
 936
 937 .controller('PatronNotesCtrl',
 938        ['$scope','$filter','$routeParams','$location','egCore','patronSvc','$uibModal',
 939         'egConfirmDialog',
 940 function($scope,  $filter , $routeParams , $location , egCore , patronSvc , $uibModal,
 941          egConfirmDialog) {
 942     $scope.initTab('other', $routeParams.id);
 943     var usr_id = $routeParams.id;
 944
 945     // fetch the notes
 946     function refreshPage() {
 947         $scope.notes = [];
 948         egCore.pcrud.search('aun',
 949             {usr : usr_id},
 950             {flesh : 1, flesh_fields : {aun : ['creator']}},
 951             {authoritative : true})
 952         .then(null, null, function(note) {
 953             $scope.notes.push(note);
 954         });
 955     }
 956
 957     // open the new-note dialog and create the note
 958     $scope.newNote = function() {
 959         $uibModal.open({
 960             templateUrl: './circ/patron/t_new_note_dialog',
 961             backdrop: 'static',
 962             controller:
 963                 ['$scope', '$uibModalInstance',
 964             function($scope, $uibModalInstance) {
 965                 $scope.focusNote = true;
 966                 $scope.args = {};
 967                 $scope.require_initials = egCore.env.aous['ui.staff.require_initials.patron_info_notes'];
 968                 $scope.ok = function(count) { $uibModalInstance.close($scope.args) }
 969                 $scope.cancel = function () { $uibModalInstance.dismiss() }
 970             }],
 971         }).result.then(
 972             function(args) {
 973                 if (!args.value) return;
 974                 var note = new egCore.idl.aun();
 975                 note.usr(usr_id);
 976                 note.title(args.title);
 977                 note.value(args.value);
 978                 note.pub(args.pub ? 't' : 'f');
 979                 note.creator(egCore.auth.user().id());
 980                 if (args.initials)
 981                     note.value(note.value() + ' [' + args.initials + ']');
 982                 egCore.pcrud.create(note).then(function() {refreshPage()});
 983             }
 984         );
 985     }
 986
 987     // delete the selected note
 988     $scope.deleteNote = function(note) {
 989         egConfirmDialog.open(
 990             egCore.strings.PATRON_NOTE_DELETE_CONFIRM_TITLE, egCore.strings.PATRON_NOTE_DELETE_CONFIRM,
 991             {ok : function() {
 992                 egCore.pcrud.remove(note).then(function() {refreshPage()});
 993             },
 994             note_title : note.title(),
 995             create_date : note.create_date()
 996         });
 997     }
 998
 999     // print the selected note
1000     $scope.printNote = function(note) {
1001         var hash = egCore.idl.toHash(note);
1002         hash.usr = egCore.idl.toHash($scope.patron());
1003         egCore.print.print({
1004             context : 'default',
1005             template : 'patron_note',
1006             scope : {note : hash}
1007         });
1008     }
1009
1010     // perform the initial note fetch
1011     refreshPage();
1012 }])
1013
1014 .controller('PatronGroupCtrl',
1015        ['$scope','$routeParams','$q','$window','$timeout','$location','egCore',
1016         'patronSvc','$uibModal','egPromptDialog','egConfirmDialog',
1017 function($scope,  $routeParams , $q , $window , $timeout,  $location , egCore ,
1018          patronSvc , $uibModal , egPromptDialog , egConfirmDialog) {
1019
1020     var usr_id = $routeParams.id;
1021
1022     $scope.totals = {owed : 0, total_out : 0, overdue : 0}
1023
1024     var grid = $scope.gridControls = {
1025         activateItem : function(item) {
1026             $location.path('/circ/patron/' + item.id + '/checkout');
1027         },
1028         itemRetrieved : function(item) {
1029
1030             if (item.id == patronSvc.current.id()) {
1031                 item.stats = patronSvc.patron_stats;
1032
1033             } else {
1034                 // flesh stats for other group members
1035                 patronSvc.getUserStats(item.id).then(function(stats) {
1036                     item.stats = stats;
1037                     $scope.totals.total_out += stats.checkouts.total_out;
1038                     $scope.totals.overdue += stats.checkouts.overdue;
1039                 });
1040             }
1041         },
1042         setSort : function() {
1043             return ['create_date'];
1044         }
1045     }
1046
1047     $scope.initTab('other', $routeParams.id)
1048     .then(function(redirect) {
1049         // if we are redirecting to the alerts page, avoid updating the
1050         // grid query.
1051         if (redirect) return;
1052         // let initTab() fetch the user first so we can know the usrgroup
1053
1054         grid.setQuery({
1055             usrgroup : patronSvc.current.usrgroup(),
1056             deleted : 'f'
1057         });
1058         $scope.totals.owed = patronSvc.patron_stats.fines.group_balance_owed;
1059     });
1060
1061     $scope.removeFromGroup = function(selected) {
1062         var promises = [];
1063         angular.forEach(selected, function(user) {
1064             console.debug('removing user ' + user.id + ' from group');
1065
1066             promises.push(
1067                 egCore.net.request(
1068                     'open-ils.actor',
1069                     'open-ils.actor.usergroup.new',
1070                     egCore.auth.token(), user.id, true
1071                 )
1072             );
1073         });
1074
1075         $q.all(promises).then(function() {grid.refresh()});
1076     }
1077
1078     function addUserToGroup(user) {
1079         user.usrgroup(patronSvc.current.usrgroup());
1080         user.ischanged(true);
1081         egCore.net.request(
1082             'open-ils.actor',
1083             'open-ils.actor.patron.update',
1084             egCore.auth.token(), user
1085
1086         ).then(function() {grid.refresh()});
1087     }
1088
1089     // fetch each user ("selected" has flattened users)
1090     // update the usrgroup, then update the user object
1091     // After all updates are complete, refresh the grid.
1092     function moveUsersToGroup(target_user, selected) {
1093         var promises = [];
1094
1095         angular.forEach(selected, function(user) {
1096             promises.push(
1097                 egCore.pcrud.retrieve('au', user.id)
1098                 .then(function(u) {
1099                     u.usrgroup(target_user.usrgroup());
1100                     u.ischanged(true);
1101                     return egCore.net.request(
1102                         'open-ils.actor',
1103                         'open-ils.actor.patron.update',
1104                         egCore.auth.token(), u
1105                     );
1106                 })
1107             );
1108         });
1109
1110         $q.all(promises).then(function() {grid.refresh()});
1111     }
1112
1113     function showMoveToGroupConfirm(barcode, selected, outbound) {
1114
1115         // find the user
1116         egCore.pcrud.search('ac', {barcode : barcode})
1117
1118         // fetch the fleshed user
1119         .then(function(card) {
1120
1121             if (!card) return; // TODO: warn user
1122
1123             egCore.pcrud.retrieve('au', card.usr())
1124             .then(function(user) {
1125                 user.card(card);
1126                 $uibModal.open({
1127                     templateUrl: './circ/patron/t_move_to_group_dialog',
1128                     backdrop: 'static',
1129                     controller: [
1130                                 '$scope','$uibModalInstance',
1131                         function($scope , $uibModalInstance) {
1132                             $scope.user = user;
1133                             $scope.selected = selected;
1134                             $scope.outbound = outbound;
1135                             $scope.ok =
1136                                 function(count) { $uibModalInstance.close() }
1137                             $scope.cancel =
1138                                 function () { $uibModalInstance.dismiss() }
1139                         }
1140                     ]
1141                 }).result.then(function() {
1142                     if (outbound) {
1143                         moveUsersToGroup(user, selected);
1144                     } else {
1145                         addUserToGroup(user);
1146                     }
1147                 });
1148             });
1149         });
1150     }
1151
1152     // selected == move selected patrons to another patron's group
1153     // !selected == patron from a different group moves into our group
1154     function moveToGroup(selected, outbound) {
1155         egPromptDialog.open(
1156             egCore.strings.GROUP_ADD_USER, '',
1157             {ok : function(value) {
1158                 if (value)
1159                     showMoveToGroupConfirm(value, selected, outbound);
1160             }}
1161         );
1162     }
1163
1164     $scope.moveToGroup = function() { moveToGroup([], false) };
1165     $scope.moveToAnotherGroup = function(selected) { moveToGroup(selected, true) };
1166
1167     $scope.cloneUser = function(selected) {
1168         if (!selected.length) return;
1169         var url = $location.absUrl().replace(
1170             /\/patron\/.*/,
1171             '/patron/register/clone/' + selected[0].id);
1172         $window.open(url, '_blank').focus();
1173     }
1174
1175     $scope.retrieveSelected = function(selected) {
1176         if (!selected.length) return;
1177         angular.forEach(selected, function(usr) {
1178             $timeout(function() {
1179                 var url = $location.absUrl().replace(
1180                     /\/patron\/.*/,
1181                     '/patron/' + usr.id + '/checkout');
1182                 $window.open(url, '_blank')
1183             });
1184         });
1185     }
1186
1187 }])
1188
1189 .controller('PatronStatCatsCtrl',
1190        ['$scope','$routeParams','$q','egCore','patronSvc',
1191 function($scope,  $routeParams , $q , egCore , patronSvc) {
1192     $scope.initTab('other', $routeParams.id)
1193     .then(function(redirect) {
1194         // Entries for org-visible stat cats are fleshed.  Any others
1195         // have to be fleshed within.
1196
1197         var to_flesh = {};
1198         angular.forEach(patronSvc.current.stat_cat_entries(),
1199             function(entry) {
1200                 if (!angular.isObject(entry.stat_cat())) {
1201                     to_flesh[entry.stat_cat()] = entry;
1202                 }
1203             }
1204         );
1205
1206         if (!Object.keys(to_flesh).length) return;
1207
1208         egCore.pcrud.search('actsc', {id : Object.keys(to_flesh)})
1209         .then(null, null, function(cat) { // stream
1210             cat.owner(egCore.org.get(cat.owner())); // owner flesh
1211             to_flesh[cat.id()].stat_cat(cat);
1212         });
1213     });
1214 }])
1215
1216 .controller('PatronSurveyCtrl',
1217        ['$scope','$routeParams','$location','egCore','patronSvc',
1218 function($scope,  $routeParams , $location , egCore , patronSvc) {
1219     $scope.initTab('other', $routeParams.id);
1220     var usr_id = $routeParams.id;
1221     var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
1222
1223     $scope.surveys = [];
1224     var svr_responses = {};
1225
1226     // fetch all survey responses for this user.
1227     egCore.pcrud.search('asvr',
1228         {usr : usr_id},
1229         {flesh : 2, flesh_fields : {asvr : ['survey','question','answer']}}
1230     ).then(
1231         function() {
1232             // All responses collected and deduplicated.
1233             // Create one collection of responses per survey.
1234
1235             angular.forEach(svr_responses, function(questions, survey_id) {
1236                 var collection = {responses : []};
1237                 angular.forEach(questions, function(response) {
1238                     collection.survey = response.survey(); // same for one.
1239                     collection.responses.push(response);
1240                 });
1241                 $scope.surveys.push(collection);
1242             });
1243         },
1244         null,
1245         function(response) {
1246
1247             // Discard responses for out-of-scope surveys.
1248             if (org_ids.indexOf(response.survey().owner()) < 0)
1249                 return;
1250
1251             // survey_id => question_id => response
1252             var svr_id = response.survey().id();
1253             var qst_id = response.question().id();
1254
1255             if (!svr_responses[svr_id])
1256                 svr_responses[svr_id] = [];
1257
1258             if (!svr_responses[svr_id][qst_id]) {
1259                 svr_responses[svr_id][qst_id] = response;
1260
1261             } else {
1262                 // We have multiple responses for the same question.
1263                 // For this UI we only care about the most recent response.
1264                 if (response.effective_date() >
1265                     svr_responses[svr_id][qst_id].effective_date())
1266                     svr_responses[svr_id][qst_id] = response;
1267             }
1268         }
1269     );
1270 }])
1271
1272 .controller('PatronFetchLastCtrl',
1273        ['$scope','$location','egCore',
1274 function($scope , $location , egCore) {
1275
1276     var ids = egCore.hatch.getLoginSessionItem('eg.circ.recent_patrons') || [];
1277     if (ids.length)
1278         return $location.path('/circ/patron/' + ids[0] + '/checkout');
1279
1280     $scope.no_last = true;
1281 }])
1282
1283 .controller('PatronTriggeredEventsCtrl',
1284        ['$scope','$routeParams','$location','egCore','patronSvc',
1285 function($scope,  $routeParams,  $location , egCore , patronSvc) {
1286     $scope.initTab('other', $routeParams.id);
1287
1288     var url = $location.absUrl().replace(/\/staff.*/, '/actor/user/event_log');
1289     url += '?patron_id=' + encodeURIComponent($routeParams.id);
1290
1291     $scope.triggered_events_url = url;
1292     $scope.funcs = {};
1293 }])
1294
1295 .controller('PatronMessageCenterCtrl',
1296        ['$scope','$routeParams','$location','egCore','patronSvc',
1297 function($scope,  $routeParams,  $location , egCore , patronSvc) {
1298     $scope.initTab('other', $routeParams.id);
1299
1300     var url = $location.protocol() + '://' + $location.host()
1301         + egCore.env.basePath.replace(/\/staff.*/,  '/actor/user/message');
1302     url += '/' + encodeURIComponent($routeParams.id);
1303
1304     $scope.message_center_url = url;
1305     $scope.funcs = {};
1306 }])
1307
1308 .controller('PatronPermsCtrl',
1309        ['$scope','$routeParams','$window','$location','egCore',
1310 function($scope , $routeParams , $window , $location , egCore) {
1311     $scope.initTab('other', $routeParams.id);
1312
1313     var url = $location.absUrl().replace(
1314         /\/eg\/staff.*/, '/xul/server/patron/user_edit.xhtml');
1315
1316     url += '?usr=' + encodeURIComponent($routeParams.id);
1317
1318     // user_edit does not load the session via cookie.  It uses URL
1319     // params or xulG instead.  Pass via xulG.
1320     $scope.funcs = {
1321         ses : egCore.auth.token(),
1322         on_patron_save : function() {
1323             $scope.funcs.reload();
1324         }
1325     }
1326
1327     $scope.user_perms_url = url;
1328 }])
1329