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',
   8     'egCoreMod', 'egUiMod', 'egGridMod', 'egUserMod'])
   9
  10 .config(function($routeProvider, $locationProvider, $compileProvider) {
  11     $locationProvider.html5Mode(true);
  12     $compileProvider.aHrefSanitizationWhitelist(/^\s*(https?|blob):/); // grid export
  13
  14     // data loaded at startup which only requires an authtoken goes
  15     // here. this allows the requests to be run in parallel instead of
  16     // waiting until startup has completed.
  17     var resolver = {delay : ['egCore','egUser', function(egCore , egUser) {
  18
  19         // fetch the org settings we care about during egStartup
  20         // and toss them into egCore.env as egCore.env.aous[name] = value.
  21         // note: only load settings here needed by all tabs; load tab-
  22         // specific settings from within their respective controllers
  23         egCore.env.classLoaders.aous = function() {
  24             return egCore.org.settings([
  25                 'circ.do_not_tally_claims_returned',
  26                 'circ.tally_lost',
  27                 'circ.obscure_dob',
  28                 'ui.circ.show_billing_tab_on_bills',
  29                 'circ.patron_expires_soon_warning',
  30                 'ui.circ.items_out.lost',
  31                 'ui.circ.items_out.longoverdue',
  32                 'ui.circ.items_out.claimsreturned'
  33             ]).then(function(settings) {
  34                 // local settings are cached within egOrg.  Caching them
  35                 // again in egEnv just simplifies the syntax for access.
  36                 egCore.env.aous = settings;
  37             });
  38         }
  39
  40         egCore.env.loadClasses.push('aous');
  41
  42         // app-globally modify the default flesh fields for
  43         // fleshed user retrieval.
  44         if (egUser.defaultFleshFields.indexOf('profile') == -1) {
  45             egUser.defaultFleshFields = egUser.defaultFleshFields.concat([
  46                 'profile',
  47                 'net_access_level',
  48                 'ident_type',
  49                 'ident_type2',
  50                 'cards',
  51                 'groups'
  52             ]);
  53         }
  54
  55         return egCore.startup.go().then(function() {
  56
  57             // This call requires orgs to be loaded, because it
  58             // calls egCore.org.ancestors(), so call it after startup
  59             return egCore.pcrud.search('actsc',
  60                 {owner : egCore.org.ancestors(
  61                     egCore.auth.user().ws_ou(), true)},
  62                 {}, {atomic : true}
  63             ).then(function(cats) {
  64                 egCore.env.absorbList(cats, 'actsc');
  65             });
  66         });
  67     }]};
  68
  69     $routeProvider.when('/circ/patron/search', {
  70         templateUrl: './circ/patron/t_search',
  71         controller: 'PatronSearchCtrl',
  72         resolve : resolver
  73     });
  74
  75     $routeProvider.when('/circ/patron/bcsearch', {
  76         templateUrl: './circ/patron/t_bcsearch',
  77         controller: 'PatronBarcodeSearchCtrl',
  78         resolve : resolver
  79     });
  80
  81     $routeProvider.when('/circ/patron/credentials', {
  82         templateUrl: './circ/patron/t_credentials',
  83         controller: 'PatronVerifyCredentialsCtrl',
  84         resolve : resolver
  85     });
  86
  87     $routeProvider.when('/circ/patron/last', {
  88         templateUrl: './circ/patron/t_last_patron',
  89         controller: 'PatronFetchLastCtrl',
  90         resolve : resolver
  91     });
  92
  93     // the following require a patron ID
  94
  95     $routeProvider.when('/circ/patron/:id/alerts', {
  96         templateUrl: './circ/patron/t_alerts',
  97         controller: 'PatronAlertsCtrl',
  98         resolve : resolver
  99     });
 100
 101     $routeProvider.when('/circ/patron/:id/checkout', {
 102         templateUrl: './circ/patron/t_checkout',
 103         controller: 'PatronCheckoutCtrl',
 104         resolve : resolver
 105     });
 106
 107     $routeProvider.when('/circ/patron/:id/items_out', {
 108         templateUrl: './circ/patron/t_items_out',
 109         controller: 'PatronItemsOutCtrl',
 110         resolve : resolver
 111     });
 112
 113     $routeProvider.when('/circ/patron/:id/holds', {
 114         templateUrl: './circ/patron/t_holds',
 115         controller: 'PatronHoldsCtrl',
 116         resolve : resolver
 117     });
 118
 119     $routeProvider.when('/circ/patron/:id/holds/create', {
 120         templateUrl: './circ/patron/t_holds_create',
 121         controller: 'PatronHoldsCreateCtrl',
 122         resolve : resolver
 123     });
 124
 125     $routeProvider.when('/circ/patron/:id/holds/:hold_id', {
 126         templateUrl: './circ/patron/t_holds',
 127         controller: 'PatronHoldsCtrl',
 128         resolve : resolver
 129     });
 130
 131     $routeProvider.when('/circ/patron/:id/hold/:hold_id', {
 132         templateUrl: './circ/patron/t_hold_details',
 133         controller: 'PatronHoldDetailsCtrl',
 134         resolve : resolver
 135     });
 136
 137     $routeProvider.when('/circ/patron/:id/bills', {
 138         templateUrl: './circ/patron/t_bills',
 139         controller: 'PatronBillsCtrl',
 140         resolve : resolver
 141     });
 142
 143     $routeProvider.when('/circ/patron/:id/bill/:xact_id', {
 144         templateUrl: './circ/patron/t_xact_details',
 145         controller: 'XactDetailsCtrl',
 146         resolve : resolver
 147     });
 148
 149     $routeProvider.when('/circ/patron/:id/bill_history/:history_tab', {
 150         templateUrl: './circ/patron/t_bill_history',
 151         controller: 'BillHistoryCtrl',
 152         resolve : resolver
 153     });
 154
 155     $routeProvider.when('/circ/patron/:id/messages', {
 156         templateUrl: './circ/patron/t_messages',
 157         controller: 'PatronMessagesCtrl',
 158         resolve : resolver
 159     });
 160
 161     $routeProvider.when('/circ/patron/:id/edit', {
 162         templateUrl: './circ/patron/t_edit',
 163         controller: 'PatronRegCtrl',
 164         resolve : resolver
 165     });
 166
 167     $routeProvider.when('/circ/patron/:id/credentials', {
 168         templateUrl: './circ/patron/t_credentials',
 169         controller: 'PatronVerifyCredentialsCtrl',
 170         resolve : resolver
 171     });
 172
 173     $routeProvider.when('/circ/patron/:id/notes', {
 174         templateUrl: './circ/patron/t_notes',
 175         controller: 'PatronNotesCtrl',
 176         resolve : resolver
 177     });
 178
 179     $routeProvider.when('/circ/patron/:id/triggered_events', {
 180         templateUrl: './circ/patron/t_triggered_events',
 181         controller: 'PatronTriggeredEventsCtrl',
 182         resolve : resolver
 183     });
 184
 185     $routeProvider.when('/circ/patron/:id/edit_perms', {
 186         templateUrl: './circ/patron/t_edit_perms',
 187         controller: 'PatronPermsCtrl',
 188         resolve : resolver
 189     });
 190
 191     $routeProvider.when('/circ/patron/:id/group', {
 192         templateUrl: './circ/patron/t_group',
 193         controller: 'PatronGroupCtrl',
 194         resolve : resolver
 195     });
 196
 197     $routeProvider.when('/circ/patron/:id/stat_cats', {
 198         templateUrl: './circ/patron/t_stat_cats',
 199         controller: 'PatronStatCatsCtrl',
 200         resolve : resolver
 201     });
 202
 203     $routeProvider.otherwise({redirectTo : '/circ/patron/search'});
 204 })
 205
 206 /**
 207  * Patron service
 208  */
 209 .factory('patronSvc',
 210        ['$q','$timeout','$location','egCore','egUser','$locale',
 211 function($q , $timeout , $location , egCore,  egUser , $locale) {
 212
 213     var service = {
 214         // cached patron search results
 215         patrons : [],
 216
 217         // currently selected patron object
 218         current : null,
 219
 220         // patron circ stats (overdues, fines, holds)
 221         patron_stats : null,
 222
 223         // event types manually overridden, which should always be
 224         // overridden for checkouts to this patron for this instance of
 225         // the interface.
 226         checkout_overrides : {},
 227     };
 228
 229     // when we change the default patron, we need to clear out any
 230     // data collected on that patron
 231     service.resetPatronLists = function() {
 232         service.checkouts = [];
 233         service.items_out = []
 234         service.items_out_ids = [];
 235         service.holds = [];
 236         service.hold_ids = [];
 237         service.checkout_overrides = {};
 238         service.patron_stats = null;
 239         service.noncat_ids = [];
 240         service.hasAlerts = false;
 241         service.alertsShown = false;
 242         service.patronExpired = false;
 243         service.patronExpiresSoon = false;
 244         service.retrievedWithInactive = false;
 245         service.invalidAddresses = false;
 246     }
 247     service.resetPatronLists();  // initialize
 248
 249     // shortcut to force-reload the current primary
 250     service.refreshPrimary = function() {
 251         if (!service.current) return $q.when();
 252         return service.setPrimary(service.current.id(), null, true);
 253     }
 254
 255     // clear the currently focused user
 256     service.clearPrimary = function() {
 257         // reset with no patron
 258         service.resetPatronLists();
 259         service.current = null;
 260         service.patron_stats = null;
 261         return $q.when();
 262     }
 263
 264     // sets the primary display user, fetching data as necessary.
 265     service.setPrimary = function(id, user, force) {
 266         var user_id = id ? id : (user ? user.id() : null);
 267
 268         console.debug('setting primary user to: ' + user_id);
 269
 270         if (!user_id) return $q.reject();
 271
 272         // when loading a new patron, update the last patron setting
 273         if (!service.current || service.current.id() != user_id)
 274             egCore.hatch.setLocalItem('eg.circ.last_patron', user_id);
 275
 276         // avoid running multiple retrievals for the same patron, which
 277         // can happen during dbl-click by maintaining a single running
 278         // data retrieval promise
 279         if (service.primaryUserPromise) {
 280             if (service.primaryUserId == user_id) {
 281                 return service.primaryUserPromise.promise;
 282             } else {
 283                 service.primaryUserPromise = null;
 284             }
 285         }
 286
 287         service.primaryUserPromise = $q.defer();
 288         service.primaryUserId = user_id;
 289
 290         service.getPrimary(id, user, force)
 291         .then(function() {
 292             var p = service.primaryUserPromise;
 293             service.primaryUserId = null;
 294             // clear before resolution just to be safe.
 295             service.primaryUserPromise = null;
 296             p.resolve();
 297         });
 298
 299         return service.primaryUserPromise.promise;
 300     }
 301
 302     service.getPrimary = function(id, user, force) {
 303
 304         if (user) {
 305             if (!force && service.current &&
 306                 service.current.id() == user.id()) {
 307                 if (service.patron_stats) {
 308                     return $q.when();
 309                 } else {
 310                     return service.fetchUserStats();
 311                 }
 312             }
 313
 314             service.resetPatronLists();
 315             service.current = user;
 316             service.localFlesh(user);
 317             return service.fetchUserStats();
 318
 319         } else if (id) {
 320             if (!force && service.current && service.current.id() == id) {
 321                 if (service.patron_stats) {
 322                     return $q.when();
 323                 } else {
 324                     return service.fetchUserStats();
 325                 }
 326             }
 327
 328             service.resetPatronLists();
 329
 330             return egUser.get(id).then(
 331                 function(user) {
 332                     service.current = user;
 333                     service.localFlesh(user);
 334                     return service.fetchUserStats();
 335                 },
 336                 function(err) {
 337                     console.error(
 338                         "unable to fetch user "+id+': '+js2JSON(err))
 339                 }
 340             );
 341         } else {
 342
 343             // fetching a null user clears the primary user.
 344             // NOTE: this should probably reject() and log an error,
 345             // but calling clear for backwards compat for now.
 346             return service.clearPrimary();
 347         }
 348     }
 349
 350     // flesh some additional user fields locally
 351     service.localFlesh = function(user) {
 352         if (!angular.isObject(typeof user.home_ou()))
 353             user.home_ou(egCore.org.get(user.home_ou()));
 354
 355         angular.forEach(
 356             user.standing_penalties(),
 357             function(penalty) {
 358                 if (!angular.isObject(penalty.org_unit()))
 359                     penalty.org_unit(egCore.org.get(penalty.org_unit()));
 360             }
 361         );
 362
 363         // stat_cat_entries == stat_cat_entry_user_map
 364         angular.forEach(user.stat_cat_entries(), function(map) {
 365             if (angular.isObject(map.stat_cat())) return;
 366             // At page load, we only retrieve org-visible stat cats.
 367             // For the common case, ignore entries for remote stat cats.
 368             var cat = egCore.env.actsc.map[map.stat_cat()];
 369             if (cat) {
 370                 map.stat_cat(cat);
 371                 cat.owner(egCore.org.get(cat.owner()));
 372             }
 373         });
 374     }
 375
 376     // resolves to true if the patron account has expired or will
 377     // expire soon, based on YAOUS circ.patron_expires_soon_warning
 378     // note: returning a promise is no longer strictly necessary
 379     // (no more async activity) if the calling function is changed too.
 380     service.testExpire = function() {
 381
 382         var expire = Date.parse(service.current.expire_date());
 383         if (expire < new Date()) {
 384             return $q.when(service.patronExpired = true);
 385         }
 386
 387         var soon = egCore.env.aous['circ.patron_expires_soon_warning'];
 388         if (Number(soon)) {
 389             var preExpire = new Date();
 390             preExpire.setDate(preExpire.getDate() + Number(soon));
 391             if (expire < preExpire)
 392                 return $q.when(service.patronExpiresSoon = true);
 393         }
 394
 395         return $q.when(false);
 396     }
 397
 398     // resolves to true if the patron account has any invalid addresses.
 399     service.testInvalidAddrs = function() {
 400
 401         if (service.invalidAddresses)
 402             return $q.when(true);
 403
 404         var fail = false;
 405
 406         angular.forEach(
 407             service.current.addresses(),
 408             function(addr) { if (addr.valid() == 'f') fail = true }
 409         );
 410
 411         return $q.when(fail);
 412     }
 413
 414     // resolves to true if there is any aspect of the patron account
 415     // which should produce a message in the alerts panel
 416     service.checkAlerts = function() {
 417
 418         if (service.hasAlerts) // already checked
 419             return $q.when(true);
 420
 421         var deferred = $q.defer();
 422         var p = service.current;
 423
 424         if (service.alert_penalties.length ||
 425             p.alert_message() ||
 426             p.active() == 'f' ||
 427             p.barred() == 't' ||
 428             service.patron_stats.holds.ready) {
 429
 430             service.hasAlerts = true;
 431         }
 432
 433         // see if the user was retrieved with an inactive card
 434         if (bc = $location.search().card) {
 435             var card = p.cards().filter(
 436                 function(c) { return c.barcode() == bc })[0];
 437
 438             if (card && card.active() == 'f') {
 439                 service.hasAlerts = true;
 440                 service.retrievedWithInactive = true;
 441             }
 442         }
 443
 444         // regardless of whether we know of alerts, we still need
 445         // to test/fetch the expire data for display
 446         service.testExpire().then(function(bool) {
 447             if (bool) service.hasAlerts = true;
 448             deferred.resolve(service.hasAlerts);
 449         });
 450
 451         service.testInvalidAddrs().then(function(bool) {
 452             if (bool) service.invalidAddresses = true;
 453             deferred.resolve(service.invalidAddresses);
 454         });
 455
 456         return deferred.promise;
 457     }
 458
 459     service.fetchGroupFines = function() {
 460         return egCore.net.request(
 461             'open-ils.actor',
 462             'open-ils.actor.usergroup.members.balance_owed',
 463             egCore.auth.token(), service.current.usrgroup()
 464         ).then(function(list) {
 465             var total = 0;
 466             angular.forEach(list, function(u) {
 467                 total += 100 * Number(u.balance_owed)
 468             });
 469             service.patron_stats.fines.group_balance_owed = total / 100;
 470         });
 471     }
 472
 473     service.getUserStats = function(id) {
 474         return egCore.net.request(
 475             'open-ils.actor',
 476             'open-ils.actor.user.opac.vital_stats.authoritative',
 477             egCore.auth.token(), id
 478         ).then(
 479             function(stats) {
 480                 // force numeric to ensure correct boolean handling in templates
 481                 stats.fines.balance_owed = Number(stats.fines.balance_owed);
 482                 stats.checkouts.overdue = Number(stats.checkouts.overdue);
 483                 stats.checkouts.claims_returned =
 484                     Number(stats.checkouts.claims_returned);
 485                 stats.checkouts.lost = Number(stats.checkouts.lost);
 486                 stats.checkouts.out = Number(stats.checkouts.out);
 487                 stats.checkouts.total_out =
 488                     stats.checkouts.out + stats.checkouts.overdue;
 489
 490                 if (!egCore.env.aous['circ.do_not_tally_claims_returned'])
 491                     stats.checkouts.total_out += stats.checkouts.claims_returned;
 492
 493                 if (egCore.env.aous['circ.tally_lost'])
 494                     stats.checkouts.total_out += stats.checkouts.lost
 495
 496                 return stats;
 497             }
 498         );
 499     }
 500
 501     // Fetches the IDs of any active non-cat checkouts for the current
 502     // user.  Also sets the patron_stats non_cat count value to match.
 503     service.getUserNonCats = function(id) {
 504         return egCore.net.request(
 505             'open-ils.circ',
 506             'open-ils.circ.open_non_cataloged_circulation.user.authoritative',
 507             egCore.auth.token(), id
 508         ).then(function(noncat_ids) {
 509             service.noncat_ids = noncat_ids;
 510             service.patron_stats.checkouts.noncat = noncat_ids.length;
 511         });
 512     }
 513
 514     // grab additional circ info
 515     service.fetchUserStats = function() {
 516         return service.getUserStats(service.current.id())
 517         .then(function(stats) {
 518             service.patron_stats = stats
 519             service.alert_penalties = service.current.standing_penalties()
 520                 .filter(function(pen) {
 521                 return pen.standing_penalty().staff_alert() == 't'
 522             });
 523
 524             service.summary_stat_cats = [];
 525             angular.forEach(service.current.stat_cat_entries(),
 526                 function(map) {
 527                     if (angular.isObject(map.stat_cat()) &&
 528                         map.stat_cat().usr_summary() == 't') {
 529                         service.summary_stat_cats.push(map);
 530                     }
 531                 }
 532             );
 533
 534             // run these two in parallel
 535             var p1 = service.getUserNonCats(service.current.id());
 536             var p2 = service.fetchGroupFines();
 537             return $q.all([p1, p2]);
 538         });
 539     }
 540
 541     // Avoid using parens [e.g. (1.23)] to indicate negative numbers,
 542     // which is the Angular default.
 543     // http://stackoverflow.com/questions/17441254/why-angularjs-currency-filter-formats-negative-numbers-with-parenthesis
 544     // FIXME: This change needs to be moved into a project-wide collection
 545     // of locale overrides.
 546     $locale.NUMBER_FORMATS.PATTERNS[1].negPre = '-';
 547     $locale.NUMBER_FORMATS.PATTERNS[1].negSuf = '';
 548
 549     return service;
 550 }])
 551
 552 /**
 553  * Manages tabbed patron view.
 554  * This is the parent scope of all patron tab scopes.
 555  *
 556  * */
 557 .controller('PatronCtrl',
 558        ['$scope','$q','$location','$filter','egCore','egUser','patronSvc',
 559 function($scope,  $q,  $location , $filter,  egCore,  egUser,  patronSvc) {
 560
 561     $scope.is_patron_edit = function() {
 562         return Boolean($location.path().match(/patron\/\d+\/edit$/));
 563     }
 564
 565     // To support the fixed position patron edit actions bar,
 566     // its markup has to live outside the scope of the patron
 567     // edit controller.  Insert a scope blob here that can be
 568     // modifed from within the patron edit controller.
 569     $scope.edit_passthru = {};
 570
 571     // returns true if a redirect occurs
 572     function redirectToAlertPanel() {
 573
 574         $scope.alert_penalties =
 575             function() {return patronSvc.alert_penalties}
 576
 577         if (patronSvc.alertsShown) return false;
 578         patronSvc.alertsShown = true;
 579
 580         // if the patron has any unshown alerts, show them now
 581         if (patronSvc.hasAlerts &&
 582             !$location.path().match(/alerts$/)) {
 583
 584             $location
 585                 .path('/circ/patron/' + patronSvc.current.id() + '/alerts')
 586                 .search('card', null);
 587             return true;
 588         }
 589
 590         // no alert required.  If the patron has fines and the show-bills
 591         // OUS is applied, direct to the bills page.
 592         if ($scope.patron_stats().fines.balance_owed > 0 // TODO: != 0 ?
 593             && egCore.env.aous['ui.circ.show_billing_tab_on_bills']
 594             && !$location.path().match(/bills$/)) {
 595
 596             $scope.tab = 'bills';
 597             $location
 598                 .path('/circ/patron/' + patronSvc.current.id() + '/bills')
 599                 .search('card', null);
 600
 601             return true;
 602         }
 603
 604         return false;
 605     }
 606
 607     // called after each route-specified controller is instantiated.
 608     // this doubles as a way to inform the top-level controller that
 609     // egStartup.go() has completed, which means we are clear to
 610     // fetch the patron, etc.
 611     $scope.initTab = function(tab, patron_id) {
 612         console.log('init tab ' + tab);
 613         $scope.tab = tab;
 614         $scope.aous = egCore.env.aous;
 615
 616         if (patron_id) {
 617             $scope.patron_id = patron_id;
 618             return patronSvc.setPrimary($scope.patron_id)
 619             .then(function() {return patronSvc.checkAlerts()})
 620             .then(redirectToAlertPanel);
 621         }
 622         return $q.when();
 623     }
 624
 625     $scope._show_dob = {};
 626     $scope.show_dob = function (val) {
 627         if ($scope.patron()) {
 628             if (typeof val != 'undefined') $scope._show_dob[$scope.patron().id()] = val;
 629             return $scope._show_dob[$scope.patron().id()];
 630         }
 631         return !egCore.env.aous['circ.obscure_dob'];
 632     }
 633
 634     $scope.obscure_dob = function() {
 635         return egCore.env.aous && egCore.env.aous['circ.obscure_dob'];
 636     }
 637     $scope.now_show_dob = function() {
 638         return egCore.env.aous && egCore.env.aous['circ.obscure_dob'] ?
 639             $scope.show_dob() : true;
 640     }
 641
 642     $scope.patron = function() { return patronSvc.current }
 643     $scope.patron_stats = function() { return patronSvc.patron_stats }
 644     $scope.summary_stat_cats = function() { return patronSvc.summary_stat_cats }
 645
 646     $scope.print_address = function(addr) {
 647         egCore.print.print({
 648             context : 'default',
 649             template : 'patron_address',
 650             scope : {
 651                 patron : egCore.idl.toHash(patronSvc.current),
 652                 address : egCore.idl.toHash(addr)
 653             }
 654         });
 655     }
 656
 657     $scope.toggle_expand_summary = function() {
 658         if ($scope.collapsePatronSummary) {
 659             $scope.collapsePatronSummary = false;
 660             egCore.hatch.removeItem('eg.circ.patron.summary.collapse');
 661         } else {
 662             $scope.collapsePatronSummary = true;
 663             egCore.hatch.setItem('eg.circ.patron.summary.collapse', true);
 664         }
 665     }
 666
 667     // always expand the patron summary in the search UI, regardless
 668     // of stored preference.
 669     $scope.collapse_summary = function() {
 670         return $scope.tab != 'search' && $scope.collapsePatronSummary;
 671     }
 672
 673     egCore.hatch.getItem('eg.circ.patron.summary.collapse')
 674     .then(function(val) {$scope.collapsePatronSummary = Boolean(val)});
 675 }])
 676
 677 .controller('PatronBarcodeSearchCtrl',
 678        ['$scope','$location','egCore','egConfirmDialog','egUser','patronSvc',
 679 function($scope , $location , egCore , egConfirmDialog , egUser , patronSvc) {
 680     $scope.selectMe = true; // focus text input
 681     patronSvc.clearPrimary(); // clear the default user
 682
 683     // jump to the patron checkout UI
 684     function loadPatron(user_id) {
 685         $location
 686         .path('/circ/patron/' + user_id + '/checkout')
 687         .search('card', $scope.args.barcode);
 688     }
 689
 690     // create an opt-in=yes response for the loaded user
 691     function createOptIn(user_id) {
 692         egCore.net.request(
 693             'open-ils.actor',
 694             'open-ils.actor.user.org_unit_opt_in.create',
 695             egCore.auth.token(), user_id).then(function(resp) {
 696                 if (evt = egCore.evt.parse(resp)) return alert(evt);
 697                 loadPatron(user_id);
 698             }
 699         );
 700     }
 701
 702     $scope.submitBarcode = function(args) {
 703         $scope.bcNotFound = null;
 704         $scope.optInRestricted = false;
 705         if (!args.barcode) return;
 706
 707         // blur so next time it's set to true it will re-apply select()
 708         $scope.selectMe = false;
 709
 710         var user_id;
 711
 712         // lookup barcode
 713         egCore.net.request(
 714             'open-ils.actor',
 715             'open-ils.actor.get_barcodes',
 716             egCore.auth.token(), egCore.auth.user().ws_ou(),
 717             'actor', args.barcode)
 718
 719         .then(function(resp) { // get_barcodes
 720
 721             if (evt = egCore.evt.parse(resp)) {
 722                 alert(evt); // FIXME
 723                 return;
 724             }
 725
 726             if (!resp || !resp[0]) {
 727                 $scope.bcNotFound = args.barcode;
 728                 $scope.selectMe = true;
 729                 return;
 730             }
 731
 732             // see if an opt-in request is needed
 733             user_id = resp[0].id;
 734             return egCore.net.request(
 735                 'open-ils.actor',
 736                 'open-ils.actor.user.org_unit_opt_in.check',
 737                 egCore.auth.token(), user_id);
 738
 739         }).then(function(optInResp) { // opt_in_check
 740
 741             if (evt = egCore.evt.parse(optInResp)) {
 742                 alert(evt); // FIXME
 743                 return;
 744             }
 745
 746             if (optInResp == 2) {
 747                 // opt-in disallowed at this location by patron's home library
 748                 $scope.optInRestricted = true;
 749                 $scope.selectMe = true;
 750                 return;
 751             }
 752
 753             if (optInResp == 1) {
 754                 // opt-in handled or not needed
 755                 return loadPatron(user_id);
 756             }
 757
 758             // opt-in needed, show the opt-in dialog
 759             egUser.get(user_id, {useFields : []})
 760
 761             .then(function(user) { // retrieve user
 762                 egConfirmDialog.open(
 763                     egCore.strings.OPT_IN_DIALOG, '',
 764                     {   org : egCore.org.get(user.home_ou()),
 765                         user : user,
 766                         ok : function() { createOptIn(user.id()) },
 767                         cancel : function() {}
 768                     }
 769                 );
 770             })
 771         });
 772     }
 773 }])
 774
 775
 776 /**
 777  * Manages patron search
 778  */
 779 .controller('PatronSearchCtrl',
 780        ['$scope','$q','$routeParams','$timeout','$window','$location','egCore',
 781        '$filter','egUser', 'patronSvc','egGridDataProvider','$document',
 782 function($scope,  $q,  $routeParams,  $timeout,  $window,  $location,  egCore,
 783         $filter,  egUser,  patronSvc , egGridDataProvider , $document) {
 784
 785     $scope.initTab('search');
 786     $scope.focusMe = true;
 787     $scope.searchArgs = {
 788         // default to searching globally
 789         home_ou : egCore.org.tree()
 790     };
 791
 792     // last used patron search form element
 793     var lastFormElement;
 794
 795     $scope.gridControls = {
 796         activateItem : function(item) {
 797             $location.path('/circ/patron/' + item.id() + '/checkout');
 798         },
 799         selectedItems : function() {return []}
 800     }
 801
 802     // Handle URL-encoded searches
 803     if ($location.search().search) {
 804         console.log('URL search = ' + $location.search().search);
 805         patronSvc.urlSearch = {search : JSON2js($location.search().search)};
 806
 807         // why the double-JSON encoded sort?
 808         if (patronSvc.urlSearch.search.search_sort) {
 809             patronSvc.urlSearch.sort =
 810                 JSON2js(patronSvc.urlSearch.search.search_sort);
 811         } else {
 812             patronSvc.urlSearch.sort = [];
 813         }
 814         delete patronSvc.urlSearch.search.search_sort;
 815
 816         // include inactive patrons if "inactive" param
 817         if ($location.search().inactive) {
 818             patronSvc.urlSearch.inactive = $location.search().inactive;
 819         }
 820     }
 821
 822     var propagate;
 823     var propagate_inactive;
 824     if (patronSvc.lastSearch) {
 825         propagate = patronSvc.lastSearch.search;
 826     } else if (patronSvc.urlSearch) {
 827         propagate = patronSvc.urlSearch.search;
 828         if (patronSvc.urlSearch.inactive) {
 829             propagate_inactive = patronSvc.urlSearch.inactive;
 830         }
 831     }
 832
 833     if (egCore.env.pgt) {
 834         $scope.profiles = egCore.env.pgt.list;
 835     } else {
 836         egCore.pcrud.search('pgt', {parent : null},
 837             {flesh : -1, flesh_fields : {pgt : ['children']}}
 838         ).then(
 839             function(tree) {
 840                 egCore.env.absorbTree(tree, 'pgt')
 841                 $scope.profiles = egCore.env.pgt.list;
 842             }
 843         );
 844     }
 845
 846     if (propagate) {
 847         // populate the search form with our cached / preexisting search info
 848         angular.forEach(propagate, function(val, key) {
 849             if (key == 'profile')
 850                 val.value = $scope.profiles.filter(function(p) { p.id() == val.value })[0];
 851             if (key == 'home_ou')
 852                 val.value = egCore.org.get(val.value);
 853             $scope.searchArgs[key] = val.value;
 854         });
 855         if (propagate_inactive) {
 856             $scope.searchArgs[inactive] = propagate_inactive;
 857         }
 858     }
 859
 860     var provider = egGridDataProvider.instance({});
 861
 862     $scope.$watch(
 863         function() {return $scope.gridControls.selectedItems()},
 864         function(list) {
 865             if (list[0])
 866                 patronSvc.setPrimary(null, list[0]);
 867         },
 868         true
 869     );
 870
 871     provider.get = function(offset, count) {
 872         var deferred = $q.defer();
 873
 874         var fullSearch;
 875         if (patronSvc.urlSearch) {
 876             fullSearch = patronSvc.urlSearch;
 877             // enusre the urlSearch only runs once.
 878             delete patronSvc.urlSearch;
 879
 880         } else {
 881
 882             var search = compileSearch($scope.searchArgs);
 883             if (Object.keys(search) == 0) return $q.when();
 884
 885             var home_ou = search.home_ou;
 886             delete search.home_ou;
 887             var inactive = search.inactive;
 888             delete search.inactive;
 889
 890             fullSearch = {
 891                 search : search,
 892                 sort : compileSort(),
 893                 inactive : inactive,
 894                 home_ou : home_ou,
 895             };
 896         }
 897
 898         fullSearch.count = count;
 899         fullSearch.offset = offset;
 900
 901         if (patronSvc.lastSearch) {
 902             // search repeated, return the cached results
 903             if (angular.equals(fullSearch, patronSvc.lastSearch)) {
 904                 console.log('patron search returning ' +
 905                     patronSvc.patrons.length + ' cached results');
 906
 907                 // notify has to happen after returning the promise
 908                 $timeout(
 909                     function() {
 910                         angular.forEach(patronSvc.patrons, function(user) {
 911                             deferred.notify(user);
 912                         });
 913                         deferred.resolve();
 914                     }
 915                 );
 916                 return deferred.promise;
 917             }
 918         }
 919
 920         patronSvc.lastSearch = fullSearch;
 921
 922         if (fullSearch.search.id) {
 923             // search by user id performs a direct ID lookup
 924             var userId = fullSearch.search.id.value;
 925             $timeout(
 926                 function() {
 927                     egUser.get(userId).then(function(user) {
 928                         patronSvc.localFlesh(user);
 929                         patronSvc.patrons = [user];
 930                         deferred.notify(user);
 931                         deferred.resolve();
 932                     });
 933                 }
 934             );
 935             return deferred.promise;
 936         }
 937
 938         // Dispay the search progress bar to indicate a search is in progress
 939         $scope.show_search_progress = true;
 940
 941         patronSvc.patrons = [];
 942         egCore.net.request(
 943             'open-ils.actor',
 944             'open-ils.actor.patron.search.advanced.fleshed',
 945             egCore.auth.token(),
 946             fullSearch.search,
 947             fullSearch.count,
 948             fullSearch.sort,
 949             fullSearch.inactive,
 950             fullSearch.home_ou,
 951             egUser.defaultFleshFields,
 952             fullSearch.offset
 953
 954         ).then(
 955             function() {
 956                 // hide progress bar on 0-hits searches
 957                 $scope.show_search_progress = false;
 958                 deferred.resolve();
 959             },
 960             null, // onerror
 961             function(user) {
 962                 // hide progress bar as soon as the first result appears.
 963                 $scope.show_search_progress = false;
 964                 patronSvc.localFlesh(user); // inline
 965                 patronSvc.patrons.push(user);
 966                 deferred.notify(user);
 967             }
 968         );
 969
 970         return deferred.promise;
 971     };
 972
 973     $scope.patronSearchGridProvider = provider;
 974
 975     // determine the tree depth of the profile group
 976     $scope.pgt_depth = function(grp) {
 977         var d = 0;
 978         while (grp = egCore.env.pgt.map[grp.parent()]) d++;
 979         return d;
 980     }
 981
 982     $scope.clearForm = function () {
 983         $scope.searchArgs={};
 984         if (lastFormElement) lastFormElement.focus();
 985     }
 986
 987     $scope.applyShowExtras = function($event, bool) {
 988         if (bool) {
 989             $scope.showExtras = true;
 990             egCore.hatch.setItem('eg.circ.patron.search.show_extras', true);
 991         } else {
 992             $scope.showExtras = false;
 993             egCore.hatch.removeItem('eg.circ.patron.search.show_extras');
 994         }
 995         if (lastFormElement) lastFormElement.focus();
 996         $event.preventDefault();
 997     }
 998
 999     egCore.hatch.getItem('eg.circ.patron.search.show_extras')
1000     .then(function(val) {$scope.showExtras = val});
1001
1002     // map form arguments into search params
1003     function compileSearch(args) {
1004         var search = {};
1005         angular.forEach(args, function(val, key) {
1006             if (!val) return;
1007             if (key == 'profile' && args.profile) {
1008                 search.profile = {value : args.profile.id(), group : 0};
1009             } else if (key == 'home_ou' && args.home_ou) {
1010                 search.home_ou = args.home_ou.id(); // passed separately
1011             } else if (key == 'inactive') {
1012                 search.inactive = val;
1013             } else {
1014                 search[key] = {value : val, group : 0};
1015             }
1016             if (key.match(/phone|ident/)) {
1017                 search[key].group = 2;
1018             } else {
1019                 if (key.match(/street|city|state|post_code/)) {
1020                     search[key].group = 1;
1021                 } else if (key == 'card') {
1022                     search[key].group = 3
1023                 }
1024             }
1025         });
1026
1027         return search;
1028     }
1029
1030     function compileSort() {
1031
1032         if (!provider.sort.length) {
1033             return [ // default
1034                 "family_name ASC",
1035                 "first_given_name ASC",
1036                 "second_given_name ASC",
1037                 "dob DESC"
1038             ];
1039         }
1040
1041         var sort = [];
1042         angular.forEach(
1043             provider.sort,
1044             function(sortdef) {
1045                 if (angular.isObject(sortdef)) {
1046                     var name = Object.keys(sortdef)[0];
1047                     var dir = sortdef[name];
1048                     sort.push(name + ' ' + dir);
1049                 } else {
1050                     sort.push(sortdef);
1051                 }
1052             }
1053         );
1054
1055         return sort;
1056     }
1057
1058     $scope.setLastFormElement = function() {
1059         lastFormElement = $document[0].activeElement;
1060     }
1061
1062     // search form submit action; tells the results grid to
1063     // refresh itself.
1064     $scope.search = function(args) { // args === $scope.searchArgs
1065         if (args && Object.keys(args).length)
1066             $scope.gridControls.refresh();
1067         if (lastFormElement) lastFormElement.focus();
1068     }
1069
1070     // TODO: move this into the (forthcoming) grid row activate action
1071     $scope.onPatronDblClick = function($event, user) {
1072         $location.path('/circ/patron/' + user.id() + '/checkout');
1073     }
1074
1075     if (patronSvc.urlSearch) {
1076         // force the grid to load the url-based search on page load
1077         provider.refresh();
1078     }
1079
1080 }])
1081
1082 /**
1083  * Manages messages
1084  */
1085 .controller('PatronMessagesCtrl',
1086        ['$scope','$q','$routeParams','egCore','$modal','patronSvc','egCirc',
1087 function($scope , $q , $routeParams,  egCore , $modal , patronSvc , egCirc) {
1088     $scope.initTab('messages', $routeParams.id);
1089     var usr_id = $routeParams.id;
1090
1091     // setup date filters
1092     var start = new Date(); // now - 1 year
1093     start.setFullYear(start.getFullYear() - 1),
1094     $scope.dates = {
1095         start_date : start,
1096         end_date : new Date()
1097     }
1098
1099     function date_range() {
1100         var start = $scope.dates.start_date.toISOString().replace(/T.*/,'');
1101         var end = $scope.dates.end_date.toISOString().replace(/T.*/,'');
1102         var today = new Date().toISOString().replace(/T.*/,'');
1103         if (end == today) end = 'now';
1104         return [start, end];
1105     }
1106
1107     // grid queries
1108
1109     var activeGrid = $scope.activeGridControls = {
1110         setSort : function() {
1111             return ['set_date'];
1112         },
1113         setQuery : function() {
1114             return {
1115                 usr : usr_id,
1116                 '-or' : [
1117                     {stop_date : null},
1118                     {stop_date : {'>' : 'now'}}
1119                 ]
1120             }
1121         }
1122     }
1123
1124     var archiveGrid = $scope.archiveGridControls = {
1125         setSort : function() {
1126             return ['set_date'];
1127         },
1128         setQuery : function() {
1129             return {
1130                 usr : usr_id,
1131                 stop_date : {'<=' : 'now'},
1132                 set_date : {between : date_range()}
1133             };
1134         }
1135     };
1136
1137     $scope.removePenalty = function(selected) {
1138         // the grid stores flattened penalties.  Fetch penalty objects first
1139
1140         var ids = selected.map(function(s){ return s.id });
1141         egCore.pcrud.search('ausp',
1142             {id : ids}, {},
1143             {atomic : true, authoritative : true}
1144
1145         // then delete them
1146         ).then(function(penalties) {
1147             return egCore.pcrud.remove(penalties);
1148
1149         // then refresh the grid
1150         }).then(function() {
1151             activeGrid.refresh();
1152         });
1153     }
1154
1155     $scope.archivePenalty = function(selected) {
1156         // the grid stores flattened penalties.  Fetch penalty objects first
1157
1158         var ids = selected.map(function(s){ return s.id });
1159         egCore.pcrud.search('ausp',
1160             {id : ids}, {},
1161             {atomic : true, authoritative : true}
1162
1163         // then delete them
1164         ).then(function(penalties) {
1165             angular.forEach(penalties, function(p){ p.stop_date('now') });
1166             return egCore.pcrud.update(penalties);
1167
1168         // then refresh the grid
1169         }).then(function() {
1170             activeGrid.refresh();
1171             archiveGrid.refresh();
1172         });
1173     }
1174
1175     // leverage egEnv for caching
1176     function fetchPenaltyTypes() {
1177         if (egCore.env.csp)
1178             return $q.when(egCore.env.csp.list);
1179         return egCore.pcrud.search(
1180             // id <= 100 are reserved for system use
1181             'csp', {id : {'>': 100}}, {}, {atomic : true})
1182         .then(function(penalties) {
1183             egCore.env.absorbList(penalties, 'csp');
1184             return penalties;
1185         });
1186     }
1187
1188     $scope.createPenalty = function() {
1189         egCirc.create_penalty(usr_id).then(function() {
1190             activeGrid.refresh();
1191             // force a refresh of the user, since they may now
1192             // have blocking penalties, etc.
1193             patronSvc.setPrimary(patronSvc.current.id(), null, true);
1194         });
1195     }
1196
1197     $scope.editPenalty = function(selected) {
1198         if (selected.length == 0) return;
1199
1200         // grab the penalty from the user object
1201         var penalty = patronSvc.current.standing_penalties().filter(
1202             function(p) {return p.id() == selected[0].id})[0];
1203
1204         egCirc.edit_penalty(penalty).then(function() {
1205             activeGrid.refresh();
1206             // force a refresh of the user, since they may now
1207             // have blocking penalties, etc.
1208             patronSvc.setPrimary(patronSvc.current.id(), null, true);
1209         });
1210     }
1211 }])
1212
1213
1214 /**
1215  * Credentials tester
1216  */
1217 .controller('PatronVerifyCredentialsCtrl',
1218        ['$scope','$routeParams','$location','egCore',
1219 function($scope,  $routeParams , $location , egCore) {
1220     $scope.verified = null;
1221     $scope.focusMe = true;
1222
1223     // called with a patron, pre-populate the form args
1224     $scope.initTab('other', $routeParams.id).then(
1225         function() {
1226             if ($routeParams.id && $scope.patron()) {
1227                 $scope.prepop = true;
1228                 $scope.username = $scope.patron().usrname();
1229                 $scope.barcode = $scope.patron().card().barcode();
1230             } else {
1231                 $scope.username = '';
1232                 $scope.barcode = '';
1233                 $scope.password = '';
1234             }
1235         }
1236     );
1237
1238     // verify login credentials
1239     $scope.verify = function() {
1240         $scope.verified = null;
1241         $scope.notFound = false;
1242
1243         egCore.net.request(
1244             'open-ils.actor',
1245             'open-ils.actor.verify_user_password',
1246             egCore.auth.token(), $scope.barcode,
1247             $scope.username, hex_md5($scope.password || '')
1248
1249         ).then(function(resp) {
1250             $scope.focusMe = true;
1251             if (evt = egCore.evt.parse(resp)) {
1252                 alert(evt);
1253             } else if (resp == 1) {
1254                 $scope.verified = true;
1255             } else {
1256                 $scope.verified = false;
1257             }
1258         });
1259     }
1260
1261     // load the main patron UI for the provided username or barcode
1262     $scope.load = function($event) {
1263         $scope.notFound = false;
1264         $scope.verified = null;
1265
1266         egCore.net.request(
1267             'open-ils.actor',
1268             'open-ils.actor.user.retrieve_id_by_barcode_or_username',
1269             egCore.auth.token(), $scope.barcode, $scope.username
1270
1271         ).then(function(resp) {
1272
1273             if (Number(resp)) {
1274                 $location.path('/circ/patron/' + resp + '/checkout');
1275                 return;
1276             }
1277
1278             // something went wrong...
1279             $scope.focusMe = true;
1280             if (evt = egCore.evt.parse(resp)) {
1281                 if (evt.textcode == 'ACTOR_USR_NOT_FOUND') {
1282                     $scope.notFound = true;
1283                     return;
1284                 }
1285                 return alert(evt);
1286             } else {
1287                 alert(resp);
1288             }
1289         });
1290
1291         // load() button sits within the verify form.
1292         // avoid submitting the verify() form action on load()
1293         $event.preventDefault();
1294     }
1295 }])
1296
1297 .controller('PatronAlertsCtrl',
1298        ['$scope','$routeParams','$location','egCore','patronSvc',
1299 function($scope,  $routeParams , $location , egCore , patronSvc) {
1300
1301     $scope.initTab('other', $routeParams.id)
1302     .then(function() {
1303         $scope.patronExpired = patronSvc.patronExpired;
1304         $scope.patronExpiresSoon = patronSvc.patronExpiresSoon;
1305         $scope.retrievedWithInactive = patronSvc.retrievedWithInactive;
1306         $scope.invalidAddresses = patronSvc.invalidAddresses;
1307     });
1308
1309 }])
1310
1311 .controller('PatronNotesCtrl',
1312        ['$scope','$routeParams','$location','egCore','patronSvc','$modal',
1313 function($scope,  $routeParams , $location , egCore , patronSvc , $modal) {
1314     $scope.initTab('other', $routeParams.id);
1315     var usr_id = $routeParams.id;
1316
1317     // fetch the notes
1318     function refreshPage() {
1319         $scope.notes = [];
1320         egCore.pcrud.search('aun',
1321             {usr : usr_id},
1322             {flesh : 1, flesh_fields : {aun : ['creator']}},
1323             {authoritative : true})
1324         .then(null, null, function(note) {
1325             $scope.notes.push(note);
1326         });
1327     }
1328
1329     // open the new-note dialog and create the note
1330     $scope.newNote = function() {
1331         $modal.open({
1332             templateUrl: './circ/patron/t_new_note_dialog',
1333             controller:
1334                 ['$scope', '$modalInstance',
1335             function($scope, $modalInstance) {
1336                 $scope.focusNote = true;
1337                 $scope.args = {};
1338                 $scope.ok = function(count) { $modalInstance.close($scope.args) }
1339                 $scope.cancel = function () { $modalInstance.dismiss() }
1340             }],
1341         }).result.then(
1342             function(args) {
1343                 if (!args.value) return;
1344                 var note = new egCore.idl.aun();
1345                 note.usr(usr_id);
1346                 note.title(args.title);
1347                 note.value(args.value);
1348                 note.pub(args.pub ? 't' : 'f');
1349                 note.creator(egCore.auth.user().id());
1350                 egCore.pcrud.create(note).then(function() {refreshPage()});
1351             }
1352         );
1353     }
1354
1355     // delete the selected note
1356     $scope.deleteNote = function(note) {
1357         egCore.pcrud.remove(note).then(function() {refreshPage()});
1358     }
1359
1360     // print the selected note
1361     $scope.printNote = function(note) {
1362         var hash = egCore.idl.toHash(note);
1363         hash.usr = egCore.idl.toHash($scope.patron());
1364         egCore.print.print({
1365             context : 'default',
1366             template : 'patron_note',
1367             scope : {note : hash}
1368         });
1369     }
1370
1371     // perform the initial note fetch
1372     refreshPage();
1373 }])
1374
1375 .controller('PatronGroupCtrl',
1376        ['$scope','$routeParams','$q','$window','$timeout','$location','egCore',
1377         'patronSvc','$modal','egPromptDialog','egConfirmDialog',
1378 function($scope,  $routeParams , $q , $window , $timeout,  $location , egCore ,
1379          patronSvc , $modal , egPromptDialog , egConfirmDialog) {
1380
1381     var usr_id = $routeParams.id;
1382
1383     $scope.totals = {owed : 0, total_out : 0, overdue : 0}
1384
1385     var grid = $scope.gridControls = {
1386         activateItem : function(item) {
1387             $location.path('/circ/patron/' + item.id + '/checkout');
1388         },
1389         itemRetrieved : function(item) {
1390
1391             if (item.id == patronSvc.current.id()) {
1392                 item.stats = patronSvc.patron_stats;
1393
1394             } else {
1395                 // flesh stats for other group members
1396                 patronSvc.getUserStats(item.id).then(function(stats) {
1397                     item.stats = stats;
1398                     $scope.totals.total_out += stats.checkouts.total_out;
1399                     $scope.totals.overdue += stats.checkouts.overdue;
1400                 });
1401             }
1402         },
1403         setSort : function() {
1404             return ['create_date'];
1405         }
1406     }
1407
1408     $scope.initTab('other', $routeParams.id)
1409     .then(function(redirect) {
1410         // if we are redirecting to the alerts page, avoid updating the
1411         // grid query.
1412         if (redirect) return;
1413         // let initTab() fetch the user first so we can know the usrgroup
1414
1415         grid.setQuery({
1416             usrgroup : patronSvc.current.usrgroup(),
1417             deleted : 'f'
1418         });
1419         $scope.totals.owed = patronSvc.patron_stats.fines.group_balance_owed;
1420     });
1421
1422     $scope.removeFromGroup = function(selected) {
1423         var promises = [];
1424         angular.forEach(selected, function(user) {
1425             console.debug('removing user ' + user.id + ' from group');
1426
1427             promises.push(
1428                 egCore.net.request(
1429                     'open-ils.actor',
1430                     'open-ils.actor.usergroup.new',
1431                     egCore.auth.token(), user.id, true
1432                 )
1433             );
1434         });
1435
1436         $q.all(promises).then(function() {grid.refresh()});
1437     }
1438
1439     function addUserToGroup(user) {
1440         user.usrgroup(patronSvc.current.usrgroup());
1441         user.ischanged(true);
1442         egCore.net.request(
1443             'open-ils.actor',
1444             'open-ils.actor.patron.update',
1445             egCore.auth.token(), user
1446
1447         ).then(function() {grid.refresh()});
1448     }
1449
1450     // fetch each user ("selected" has flattened users)
1451     // update the usrgroup, then update the user object
1452     // After all updates are complete, refresh the grid.
1453     function moveUsersToGroup(target_user, selected) {
1454         var promises = [];
1455
1456         angular.forEach(selected, function(user) {
1457             promises.push(
1458                 egCore.pcrud.retrieve('au', user.id)
1459                 .then(function(u) {
1460                     u.usrgroup(target_user.usrgroup());
1461                     u.ischanged(true);
1462                     return egCore.net.request(
1463                         'open-ils.actor',
1464                         'open-ils.actor.patron.update',
1465                         egCore.auth.token(), u
1466                     );
1467                 })
1468             );
1469         });
1470
1471         $q.all(promises).then(function() {grid.refresh()});
1472     }
1473
1474     function showMoveToGroupConfirm(barcode, selected, outbound) {
1475
1476         // find the user
1477         egCore.pcrud.search('ac', {barcode : barcode})
1478
1479         // fetch the fleshed user
1480         .then(function(card) {
1481
1482             if (!card) return; // TODO: warn user
1483
1484             egCore.pcrud.retrieve('au', card.usr())
1485             .then(function(user) {
1486                 user.card(card);
1487                 $modal.open({
1488                     templateUrl: './circ/patron/t_move_to_group_dialog',
1489                     controller: [
1490                                 '$scope','$modalInstance',
1491                         function($scope , $modalInstance) {
1492                             $scope.user = user;
1493                             $scope.selected = selected;
1494                             $scope.outbound = outbound;
1495                             $scope.ok =
1496                                 function(count) { $modalInstance.close() }
1497                             $scope.cancel =
1498                                 function () { $modalInstance.dismiss() }
1499                         }
1500                     ]
1501                 }).result.then(function() {
1502                     if (outbound) {
1503                         moveUsersToGroup(user, selected);
1504                     } else {
1505                         addUserToGroup(user);
1506                     }
1507                 });
1508             });
1509         });
1510     }
1511
1512     // selected == move selected patrons to another patron's group
1513     // !selected == patron from a different group moves into our group
1514     function moveToGroup(selected, outbound) {
1515         egPromptDialog.open(
1516             egCore.strings.GROUP_ADD_USER, '',
1517             {ok : function(value) {
1518                 if (value)
1519                     showMoveToGroupConfirm(value, selected, outbound);
1520             }}
1521         );
1522     }
1523
1524     $scope.moveToGroup = function() { moveToGroup([], false) };
1525     $scope.moveToAnotherGroup = function(selected) { moveToGroup(selected, true) };
1526
1527     $scope.cloneUser = function(selected) {
1528         if (!selected.length) return;
1529         var url = $location.absUrl().replace(
1530             /\/patron\/.*/,
1531             '/patron/register/clone/' + selected[0].id);
1532         $window.open(url, '_blank').focus();
1533     }
1534
1535     $scope.retrieveSelected = function(selected) {
1536         if (!selected.length) return;
1537         angular.forEach(selected, function(usr) {
1538             $timeout(function() {
1539                 var url = $location.absUrl().replace(
1540                     /\/patron\/.*/,
1541                     '/patron/' + usr.id + '/checkout');
1542                 $window.open(url, '_blank')
1543             });
1544         });
1545     }
1546
1547 }])
1548
1549 .controller('PatronStatCatsCtrl',
1550        ['$scope','$routeParams','$q','egCore','patronSvc',
1551 function($scope,  $routeParams , $q , egCore , patronSvc) {
1552     $scope.initTab('other', $routeParams.id)
1553     .then(function(redirect) {
1554         // Entries for org-visible stat cats are fleshed.  Any others
1555         // have to be fleshed within.
1556
1557         var to_flesh = {};
1558         angular.forEach(patronSvc.current.stat_cat_entries(),
1559             function(entry) {
1560                 if (!angular.isObject(entry.stat_cat())) {
1561                     to_flesh[entry.stat_cat()] = entry;
1562                 }
1563             }
1564         );
1565
1566         if (!Object.keys(to_flesh).length) return;
1567
1568         egCore.pcrud.search('actsc', {id : Object.keys(to_flesh)})
1569         .then(null, null, function(cat) { // stream
1570             cat.owner(egCore.org.get(cat.owner())); // owner flesh
1571             to_flesh[cat.id()].stat_cat(cat);
1572         });
1573     });
1574 }])
1575
1576 .controller('PatronFetchLastCtrl',
1577        ['$scope','$location','egCore',
1578 function($scope , $location , egCore) {
1579
1580     var id = egCore.hatch.getLocalItem('eg.circ.last_patron');
1581     if (id) return $location.path('/circ/patron/' + id + '/checkout');
1582
1583     $scope.no_last = true;
1584 }])
1585
1586 .controller('PatronTriggeredEventsCtrl',
1587        ['$scope','$routeParams','$location','egCore','patronSvc',
1588 function($scope,  $routeParams,  $location , egCore , patronSvc) {
1589     $scope.initTab('other', $routeParams.id);
1590
1591     var url = $location.absUrl().replace(/\/staff.*/, '/actor/user/event_log');
1592     url += '?patron_id=' + encodeURIComponent($routeParams.id);
1593
1594     $scope.triggered_events_url = url;
1595     $scope.funcs = {};
1596 }])
1597
1598 .controller('PatronPermsCtrl',
1599        ['$scope','$routeParams','$window','$location','egCore',
1600 function($scope , $routeParams , $window , $location , egCore) {
1601     $scope.initTab('other', $routeParams.id);
1602
1603     var url = $location.absUrl().replace(
1604         /\/eg\/staff.*/, '/xul/server/patron/user_edit.xhtml');
1605
1606     url += '?usr=' + encodeURIComponent($routeParams.id);
1607
1608     // user_edit does not load the session via cookie.  It uses URL
1609     // params or xulG instead.  Pass via xulG.
1610     $scope.funcs = {
1611         ses : egCore.auth.token(),
1612         on_patron_save : function() {
1613             $scope.funcs.reload();
1614         }
1615     }
1616
1617     $scope.user_perms_url = url;
1618 }])
1619