]> git.evergreen-ils.org Git - Evergreen.git/blob - Open-ILS/web/js/ui/default/staff/circ/patron/app.js
LP1896285 Patron search add to bucket serialize
[Evergreen.git] / 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     $scope.doesPatronExpireSoon = function() { return patronSvc.patronExpiresSoon }
331
332     $scope.print_address = function(addr) {
333         egCore.print.print({
334             context : 'default', 
335             template : 'patron_address', 
336             scope : {
337                 patron : egCore.idl.toHash(patronSvc.current),
338                 address : egCore.idl.toHash(addr)
339             }
340         });
341     }
342
343     $scope.copy_address = function(addr) {
344         // Alas, navigator.clipboard is not yet supported in FF and others.
345         var lNode = document.querySelector('#patron-address-copy-' + addr.id());
346
347         // Un-hide the textarea just long enough to copy its data.
348         // Using node.style instead of ng-show/ng-hide in hopes it 
349         // will be quicker, so the user never sees the textarea.
350         lNode.style.visibility = 'visible';
351         lNode.focus();
352         lNode.select();
353
354         if (!document.execCommand('copy')) {
355             console.error('Copy command failed');
356         }
357
358         lNode.style.visibility = 'hidden';
359     }
360
361     $scope.toggle_expand_summary = function() {
362         if ($scope.collapsePatronSummary) {
363             $scope.collapsePatronSummary = false;
364             egCore.hatch.removeItem('eg.circ.patron.summary.collapse');
365         } else {
366             $scope.collapsePatronSummary = true;
367             egCore.hatch.setItem('eg.circ.patron.summary.collapse', true);
368         }
369     }
370     
371     // always expand the patron summary in the search UI, regardless
372     // of stored preference.
373     $scope.collapse_summary = function() {
374         return $scope.tab != 'search' && $scope.collapsePatronSummary;
375     }
376
377     function _purge_account(dest_usr,override) {
378         egNet.request(
379             'open-ils.actor',
380             'open-ils.actor.user.delete' + (override ? '.override' : ''),
381             egCore.auth.token(),
382             $scope.patron().id(),
383             dest_usr
384         ).then(function(resp){
385             if (evt = egCore.evt.parse(resp)) {
386                 if (evt.code == '2004' /* ACTOR_USER_DELETE_OPEN_XACTS */) {
387                     egConfirmDialog.open(
388                         egCore.strings.PATRON_PURGE_CONFIRM_TITLE, egCore.strings.PATRON_PURGE_OVERRIDE_PROMPT,
389                         {ok : function() {
390                             _purge_account(dest_usr,true);
391                         }}
392                     );
393                 } else {
394                     alert(js2JSON(evt));
395                 }
396             } else {
397                 location.href = egCore.env.basePath + '/circ/patron/search';
398             }
399         });
400     }
401
402     function _purge_account_with_destination(dest_barcode) {
403         egCore.pcrud.search('ac', {barcode : dest_barcode})
404         .then(function(card) {
405             if (!card) {
406                 egAlertDialog.open(egCore.strings.PATRON_PURGE_STAFF_BAD_BARCODE);
407             } else {
408                 _purge_account(card.usr());
409             }
410         });
411     }
412
413     $scope.purge_account = function() {
414         egConfirmDialog.open(
415             egCore.strings.PATRON_PURGE_CONFIRM_TITLE, egCore.strings.PATRON_PURGE_CONFIRM,
416             {ok : function() {
417                 egConfirmDialog.open(
418                     egCore.strings.PATRON_PURGE_CONFIRM_TITLE, egCore.strings.PATRON_PURGE_LAST_CHANCE,
419                     {ok : function() {
420                         egNet.request(
421                             'open-ils.actor',
422                             'open-ils.actor.user.has_work_perm_at',
423                             egCore.auth.token(), 'STAFF_LOGIN', $scope.patron().id()
424                         ).then(function(resp) {
425                             var is_staff = resp.length > 0;
426                             if (is_staff) {
427                                 egPromptDialog.open(
428                                     egCore.strings.PATRON_PURGE_STAFF_PROMPT,
429                                     null, // TODO: this would be cool if it worked: egCore.auth.user().card().barcode(),
430                                     {ok : function(barcode) {_purge_account_with_destination(barcode)}}
431                                 );
432                             } else {
433                                 _purge_account();
434                             }
435                         });
436                     }
437                 });
438             }
439         });
440     }
441
442     egCore.hatch.getItem('eg.circ.patron.summary.collapse')
443     .then(function(val) {$scope.collapsePatronSummary = Boolean(val)});
444 }])
445
446 .controller('PatronBarcodeSearchCtrl',
447        ['$scope','$location','egCore','egConfirmDialog','egUser','patronSvc','$uibModal','$q',
448 function($scope , $location , egCore , egConfirmDialog , egUser , patronSvc , $uibModal , $q) {
449     $scope.selectMe = true; // focus text input
450     patronSvc.clearPrimary(); // clear the default user
451
452     // jump to the patron checkout UI
453     function loadPatron(user_id) {
454         egCore.audio.play('success.patron.by_barcode');
455         $location
456         .path('/circ/patron/' + user_id + '/checkout')
457         .search('card', $scope.args.barcode);
458         patronSvc.search_barcode = $scope.args.barcode;
459     }
460
461     // create an opt-in=yes response for the loaded user
462     function createOptIn(user_id) {
463         egCore.net.request(
464             'open-ils.actor',
465             'open-ils.actor.user.org_unit_opt_in.create',
466             egCore.auth.token(), user_id).then(function(resp) {
467                 if (evt = egCore.evt.parse(resp)) return alert(evt);
468                 loadPatron(user_id);
469             }
470         );
471     }
472
473     $scope.submitBarcode = function(args) {
474         $scope.bcNotFound = null;
475         $scope.optInRestricted = false;
476         if (!args.barcode) return;
477         args.barcode = args.barcode.replace(/^\s/g,'');
478         args.barcode = args.barcode.replace(/\s$/g,'');
479         // blur so next time it's set to true it will re-apply select()
480         $scope.selectMe = false;
481
482         var user_id;
483
484         // given a scanned barcode, this function finds any matching users
485         // and handles multiple matches due to barcode completion
486         function handleBarcodeCompletion(scanned_barcode) {
487             var deferred = $q.defer();
488
489             egCore.net.request(
490                 'open-ils.actor',
491                 'open-ils.actor.get_barcodes',
492                 egCore.auth.token(), egCore.auth.user().ws_ou(), 
493                 'actor', scanned_barcode)
494
495             .then(function(resp) { // get_barcodes
496
497                 if (evt = egCore.evt.parse(resp)) {
498                     alert(evt); // FIXME
499                     deferred.reject();
500                     return;
501                 }
502
503                 if (!resp || !resp[0]) {
504                     $scope.bcNotFound = args.barcode;
505                     $scope.selectMe = true;
506                     egCore.audio.play('warning.patron.not_found');
507                     deferred.reject();
508                     return;
509                 }
510
511                 if (resp.length == 1) {
512                     // exactly one matching barcode: return it
513                     deferred.resolve();
514                     user_id = resp[0].id;
515                 } else {
516                     // multiple matching barcodes: let the user pick one 
517                     var barcode_map = {};
518                     var matches = [];
519                     var promises = [];
520                     var selected_barcode;
521                     angular.forEach(resp, function(match) {
522                         promises.push(
523                             egUser.get(match.id, {useFields : ['home_ou']}).then(function(user) {
524                                 barcode_map[match.barcode] = user.id();
525                                 matches.push( {
526                                     barcode: match.barcode,
527                                     title: user.first_given_name() + ' ' + user.family_name(),
528                                     org_name: user.home_ou().name(),
529                                     org_shortname: user.home_ou().shortname()
530                                 });
531                             })
532                         );
533                     });
534                     return $q.all(promises)
535                     .then(function() {
536                         $uibModal.open({
537                             templateUrl: './circ/share/t_barcode_choice_dialog',
538                             controller:
539                                 ['$scope', '$uibModalInstance',
540                                 function($scope, $uibModalInstance) {
541                                 $scope.matches = matches;
542                                 $scope.ok = function(barcode) {
543                                     $uibModalInstance.close();
544                                     selected_barcode = barcode;
545                                 }
546                                 $scope.cancel = function() {$uibModalInstance.dismiss()}
547                             }],
548                         }).result.then(function() {
549                             deferred.resolve();
550                             user_id = barcode_map[selected_barcode];
551                         });
552                     });
553                 }
554             });
555             return deferred.promise;
556         }
557
558         // call our function to lookup matching users for the scanned barcode
559         handleBarcodeCompletion(args.barcode).then(function() {
560
561             // see if an opt-in request is needed
562             return egCore.net.request(
563                 'open-ils.actor',
564                 'open-ils.actor.user.org_unit_opt_in.check',
565                 egCore.auth.token(), user_id
566             ).then(function(optInResp) { // opt_in_check
567
568                 if (evt = egCore.evt.parse(optInResp)) {
569                     alert(evt); // FIXME
570                     return;
571                 }
572
573                 if (optInResp == 2) {
574                     // opt-in disallowed at this location by patron's home library
575                     $scope.optInRestricted = true;
576                     $scope.selectMe = true;
577                     egCore.audio.play('warning.patron.opt_in_restricted');
578                     return;
579                 }
580             
581                 if (optInResp == 1) {
582                     // opt-in handled or not needed
583                     return loadPatron(user_id);
584                 }
585
586                 // opt-in needed, show the opt-in dialog
587                 egUser.get(user_id, {useFields : []})
588
589                 .then(function(user) { // retrieve user
590                     var org = egCore.org.get(user.home_ou());
591                     egConfirmDialog.open(
592                         egCore.strings.OPT_IN_DIALOG_TITLE,
593                         egCore.strings.OPT_IN_DIALOG,
594                         {   family_name : user.family_name(),
595                             first_given_name : user.first_given_name(),
596                             org_name : org.name(),
597                             org_shortname : org.shortname(),
598                             ok : function() { createOptIn(user.id()) },
599                             cancel : function() {}
600                         }
601                     );
602                 })
603             })
604         })
605     }
606 }])
607
608
609 /**
610  * Manages patron search
611  */
612 .controller('PatronSearchCtrl',
613        ['$scope','$q','$routeParams','$timeout','$window','$location','egCore','ngToast',
614        '$filter','egUser', 'patronSvc','egGridDataProvider','$document','bucketSvc',
615        'egPatronMerge','egProgressDialog','$controller','$interpolate','$uibModal',
616 function($scope,  $q,  $routeParams,  $timeout,  $window,  $location,  egCore , ngToast,
617          $filter,  egUser,  patronSvc , egGridDataProvider , $document , bucketSvc,
618         egPatronMerge , egProgressDialog , $controller , $interpolate , $uibModal) {
619
620     angular.extend(this, $controller('BasePatronSearchCtrl', {$scope : $scope}));
621     $scope.initTab('search');
622
623     $scope.gridControls = {
624         activateItem : function(item) {
625             $location.path('/circ/patron/' + item.id() + '/checkout');
626         },
627         selectedItems : function() { return [] }
628     }
629
630     $scope.bucketSvc = bucketSvc;
631     $scope.bucketSvc.fetchUserBuckets();
632     $scope.addToBucket = function(item, data, recs) {
633         if (recs.length == 0) return;
634         var added_count = 0;
635         var failed_count = 0;
636         var promise = $q.when();
637         angular.forEach(recs,
638             function(rec) {
639                 var item = new egCore.idl.cubi();
640                 item.bucket(data.id());
641                 item.target_user(rec.id());
642                 promise = promise.then(function() {
643                     return egCore.net.request(
644                         'open-ils.actor',
645                         'open-ils.actor.container.item.create',
646                         egCore.auth.token(), 'user', item
647                     );
648                 }).then(
649                     function(){ added_count++ },
650                     function(){ failed_count++ }
651                 );
652             }
653         );
654
655         promise.then( function () {
656             if (added_count) ngToast.create($interpolate(egCore.strings.BUCKET_ADD_SUCCESS)({ count: ''+added_count, name: data.name()} ));
657             if (failed_count) ngToast.warning($interpolate(egCore.strings.BUCKET_ADD_FAIL)({ count: ''+failed_count, name: data.name() } ));
658         });
659     }
660
661     var temp_scope = $scope;
662     $scope.openCreateBucketDialog = function() {
663         $uibModal.open({
664             templateUrl: './circ/patron/bucket/t_bucket_create',
665             backdrop: 'static',
666             controller:
667                 ['$scope', '$uibModalInstance', function($scope, $uibModalInstance) {
668                 $scope.focusMe = true;
669                 $scope.ok = function(args) { $uibModalInstance.close(args) }
670                 $scope.cancel = function () { $uibModalInstance.dismiss() }
671             }]
672         }).result.then(function (args) {
673             if (!args || !args.name) return;
674             bucketSvc.createBucket(args.name, args.desc).then(
675                 function(id) {
676                     if (id) {
677                         $scope.bucketSvc.fetchBucket(id).then(function (b) {
678                             $scope.addToBucket(
679                                 null,
680                                 b,
681                                 $scope.gridControls.selectedItems()
682                             );
683                             $scope.bucketSvc.fetchUserBuckets(true);
684                         });
685                     }
686                 }
687             );
688         });
689     }
690
691     $scope.$watch(
692         function() {return $scope.gridControls.selectedItems()},
693         function(list) {
694             if (list[0]) 
695                 patronSvc.setPrimary(null, list[0]);
696         },
697         true
698     );
699
700     $scope.need_one_selected = function() {
701         var items = $scope.gridControls.selectedItems();
702         return (items.length > 0) ? false : true;
703     }
704     $scope.need_two_selected = function() {
705         var items = $scope.gridControls.selectedItems();
706         return (items.length == 2) ? false : true;
707     }
708     $scope.merge_patrons = function() {
709         var items = $scope.gridControls.selectedItems();
710         if (items.length != 2) return false;
711
712         var patron_ids = [];
713         angular.forEach(items, function(i) {
714             patron_ids.push(i.id());
715         });
716         egPatronMerge.do_merge(patron_ids).then(
717             function() {
718                 // ensure that we're not drawing from cached
719                 // resuts, as a successful merge just deleted a
720                 // record
721                 delete patronSvc.lastSearch;
722                 $scope.gridControls.refresh();
723             },
724             function(evt) {
725                 if (evt && evt.textcode == 'MERGE_SELF_NOT_ALLOWED') {
726                     ngToast.warning(egCore.strings.MERGE_SELF_NOT_ALLOWED);
727                 }
728             }
729         );
730     }
731    
732 }])
733
734 /**
735  * Manages messages
736  */
737 .controller('PatronMessagesCtrl',
738        ['$scope','$q','$routeParams','egCore','$uibModal','patronSvc','egCirc',
739 function($scope , $q , $routeParams,  egCore , $uibModal , patronSvc , egCirc) {
740     $scope.initTab('messages', $routeParams.id);
741     var usr_id = $routeParams.id;
742     var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
743
744     // setup date filters
745     var start = new Date(); // now - 1 year
746     start.setFullYear(start.getFullYear() - 1),
747     $scope.dates = {
748         start_date : start,
749         end_date : new Date()
750     }
751
752     function date_range() {
753         var start = $scope.dates.start_date.toISOString().replace(/T.*/,'');
754         var end = $scope.dates.end_date.toISOString().replace(/T.*/,'');
755         var today = new Date().toISOString().replace(/T.*/,'');
756         if (end == today) end = 'now';
757         return [start, end];
758     }
759
760     // grid queries
761    
762     var activeGrid = $scope.activeGridControls = {
763         setSort : function() {
764             return ['set_date'];
765         },
766         setQuery : function() {
767             return {
768                 usr : usr_id,
769                 org_unit : org_ids,
770                 '-or' : [
771                     {stop_date : null},
772                     {stop_date : {'>' : 'now'}}
773                 ]
774             }
775         }
776     }
777
778     var archiveGrid = $scope.archiveGridControls = {
779         setSort : function() {
780             return ['set_date'];
781         },
782         watchQuery : function() {
783             return {
784                 usr : usr_id, 
785                 org_unit : org_ids,
786                 stop_date : {'<=' : 'now'},
787                 set_date : {between : date_range()}
788             };
789         }
790     };
791
792     $scope.removePenalty = function(selected) {
793         // the grid stores flattened penalties.  Fetch penalty objects first
794
795         var ids = selected.map(function(s){ return s.id });
796         egCore.pcrud.search('ausp', 
797             {id : ids}, {}, 
798             {atomic : true, authoritative : true}
799
800         // then delete them
801         ).then(function(penalties) {
802             return egCore.pcrud.remove(penalties);
803
804         // then refresh the grid
805         }).then(function() {
806             activeGrid.refresh();
807         });
808     }
809
810     $scope.archivePenalty = function(selected) {
811         // the grid stores flattened penalties.  Fetch penalty objects first
812
813         var ids = selected.map(function(s){ return s.id });
814         egCore.pcrud.search('ausp', 
815             {id : ids}, {}, 
816             {atomic : true, authoritative : true}
817
818         // then delete them
819         ).then(function(penalties) {
820             angular.forEach(penalties, function(p){ p.stop_date('now') });
821             return egCore.pcrud.update(penalties);
822
823         // then refresh the grid
824         }).then(function() {
825             activeGrid.refresh();
826             archiveGrid.refresh();
827         });
828     }
829
830     // leverage egEnv for caching
831     function fetchPenaltyTypes() {
832         if (egCore.env.csp) 
833             return $q.when(egCore.env.csp.list);
834         return egCore.pcrud.search(
835             // id <= 100 are reserved for system use
836             'csp', {id : {'>': 100}}, {}, {atomic : true})
837         .then(function(penalties) {
838             egCore.env.absorbList(penalties, 'csp');
839             return penalties;
840         });
841     }
842
843     $scope.createPenalty = function() {
844         egCirc.create_penalty(usr_id).then(function() {
845             activeGrid.refresh();
846             // force a refresh of the user, since they may now
847             // have blocking penalties, etc.
848             patronSvc.setPrimary(patronSvc.current.id(), null, true);
849         });
850     }
851
852     $scope.editPenalty = function(selected) {
853         if (selected.length == 0) return;
854
855         // grab the penalty from the user object
856         var penalty = patronSvc.current.standing_penalties().filter(
857             function(p) {return p.id() == selected[0].id})[0];
858
859         egCirc.edit_penalty(penalty).then(function() {
860             activeGrid.refresh();
861             // force a refresh of the user, since they may now
862             // have blocking penalties, etc.
863             patronSvc.setPrimary(patronSvc.current.id(), null, true);
864         });
865     }
866 }])
867
868
869 /**
870  * Credentials tester
871  */
872 .controller('PatronVerifyCredentialsCtrl',
873        ['$scope','$routeParams','$location','egCore',
874 function($scope,  $routeParams , $location , egCore) {
875     $scope.verified = null;
876     $scope.focusMe = true;
877
878     // called with a patron, pre-populate the form args
879     $scope.initTab('other', $routeParams.id).then(
880         function() {
881             if ($routeParams.id && $scope.patron()) {
882                 $scope.prepop = true;
883                 $scope.username = $scope.patron().usrname();
884                 $scope.barcode = $scope.patron().card().barcode();
885             } else {
886                 $scope.username = '';
887                 $scope.barcode = '';
888                 $scope.password = '';
889             }
890         }
891     );
892
893     // verify login credentials
894     $scope.verify = function() {
895         $scope.verified = null;
896         $scope.notFound = false;
897
898         egCore.net.request(
899             'open-ils.actor',
900             'open-ils.actor.verify_user_password',
901             egCore.auth.token(), $scope.barcode,
902             $scope.username, hex_md5($scope.password || '')
903
904         ).then(function(resp) {
905             $scope.focusMe = true;
906             if (evt = egCore.evt.parse(resp)) {
907                 alert(evt);
908             } else if (resp == 1) {
909                 $scope.verified = true;
910             } else {
911                 $scope.verified = false;
912             }
913         });
914     }
915
916     // load the main patron UI for the provided username or barcode
917     $scope.load = function($event) {
918         $scope.notFound = false;
919         $scope.verified = null;
920
921         egCore.net.request(
922             'open-ils.actor',
923             'open-ils.actor.user.retrieve_id_by_barcode_or_username',
924             egCore.auth.token(), $scope.barcode, $scope.username
925
926         ).then(function(resp) {
927
928             if (Number(resp)) {
929                 $location.path('/circ/patron/' + resp + '/checkout');
930                 return;
931             }
932
933             // something went wrong...
934             $scope.focusMe = true;
935             if (evt = egCore.evt.parse(resp)) {
936                 if (evt.textcode == 'ACTOR_USR_NOT_FOUND') {
937                     $scope.notFound = true;
938                     return;
939                 }
940                 return alert(evt);
941             } else {
942                 alert(resp);
943             }
944         });
945
946         // load() button sits within the verify form.  
947         // avoid submitting the verify() form action on load()
948         $event.preventDefault();
949     }
950 }])
951
952 .controller('PatronAlertsCtrl',
953        ['$scope','$routeParams','$location','egCore','patronSvc',
954 function($scope,  $routeParams , $location , egCore , patronSvc) {
955
956     $scope.initTab('other', $routeParams.id)
957     .then(function() {
958         $scope.patronExpired = patronSvc.patronExpired;
959         $scope.patronExpiresSoon = patronSvc.patronExpiresSoon;
960         $scope.retrievedWithInactive = patronSvc.fetchedWithInactiveCard();
961         $scope.invalidAddresses = patronSvc.invalidAddresses;
962     });
963
964 }])
965
966 .controller('PatronNotesCtrl',
967        ['$scope','$filter','$routeParams','$location','egCore','patronSvc','$uibModal',
968         'egConfirmDialog',
969 function($scope,  $filter , $routeParams , $location , egCore , patronSvc , $uibModal,
970          egConfirmDialog) {
971     $scope.initTab('other', $routeParams.id);
972     var usr_id = $routeParams.id;
973
974     // fetch the notes
975     function refreshPage() {
976         $scope.notes = [];
977         egCore.pcrud.search('aun', 
978             {usr : usr_id}, 
979             {flesh : 1, flesh_fields : {aun : ['creator']}}, 
980             {authoritative : true})
981         .then(null, null, function(note) {
982             $scope.notes.push(note);
983         });
984     }
985
986     // open the new-note dialog and create the note
987     $scope.newNote = function() {
988         $uibModal.open({
989             templateUrl: './circ/patron/t_new_note_dialog',
990             backdrop: 'static',
991             controller: 
992                 ['$scope', '$uibModalInstance',
993             function($scope, $uibModalInstance) {
994                 $scope.focusNote = true;
995                 $scope.args = {};
996                 $scope.require_initials = egCore.env.aous['ui.staff.require_initials.patron_info_notes'];
997                 $scope.ok = function(count) { $uibModalInstance.close($scope.args) }
998                 $scope.cancel = function () { $uibModalInstance.dismiss() }
999             }],
1000         }).result.then(
1001             function(args) {
1002                 if (!args.value) return;
1003                 var note = new egCore.idl.aun();
1004                 note.usr(usr_id);
1005                 note.title(args.title);
1006                 note.value(args.value);
1007                 note.pub(args.pub ? 't' : 'f');
1008                 note.creator(egCore.auth.user().id());
1009                 if (args.initials) 
1010                     note.value(note.value() + ' [' + args.initials + ']');
1011                 egCore.pcrud.create(note).then(function() {refreshPage()});
1012             }
1013         );
1014     }
1015
1016     // delete the selected note
1017     $scope.deleteNote = function(note) {
1018         egConfirmDialog.open(
1019             egCore.strings.PATRON_NOTE_DELETE_CONFIRM_TITLE, egCore.strings.PATRON_NOTE_DELETE_CONFIRM,
1020             {ok : function() {
1021                 egCore.pcrud.remove(note).then(function() {refreshPage()});
1022             },
1023             note_title : note.title(),
1024             create_date : note.create_date()
1025         });
1026     }
1027
1028     // print the selected note
1029     $scope.printNote = function(note) {
1030         var hash = egCore.idl.toHash(note);
1031         hash.usr = egCore.idl.toHash($scope.patron());
1032         egCore.print.print({
1033             context : 'default', 
1034             template : 'patron_note', 
1035             scope : {note : hash}
1036         });
1037     }
1038
1039     // perform the initial note fetch
1040     refreshPage();
1041 }])
1042
1043 .controller('PatronGroupCtrl',
1044        ['$scope','$routeParams','$q','$window','$timeout','$location','egCore',
1045         'patronSvc','$uibModal','egPromptDialog','egConfirmDialog',
1046 function($scope,  $routeParams , $q , $window , $timeout,  $location , egCore ,
1047          patronSvc , $uibModal , egPromptDialog , egConfirmDialog) {
1048
1049     var usr_id = $routeParams.id;
1050
1051     $scope.totals = {owed : 0, total_out : 0, overdue : 0}
1052
1053     var grid = $scope.gridControls = {
1054         activateItem : function(item) {
1055             $location.path('/circ/patron/' + item.id + '/checkout');
1056         },
1057         itemRetrieved : function(item) {
1058
1059             if (item.id == patronSvc.current.id()) {
1060                 item.stats = patronSvc.patron_stats;
1061
1062             } else {
1063                 // flesh stats for other group members
1064                 patronSvc.getUserStats(item.id).then(function(stats) {
1065                     item.stats = stats;
1066                     $scope.totals.total_out += stats.checkouts.total_out; 
1067                     $scope.totals.overdue += stats.checkouts.overdue; 
1068                 });
1069             }
1070         },
1071         setSort : function() {
1072             return ['create_date'];
1073         },
1074         watchQuery: function() {
1075             if (patronSvc.current) {
1076                 return {
1077                     usrgroup : patronSvc.current.usrgroup(),
1078                     deleted : 'f'
1079                 };
1080             }
1081             return null;
1082         }
1083     }
1084
1085     $scope.initTab('other', $routeParams.id)
1086     .then(function(redirect) {
1087         // if we are redirecting to the alerts page, avoid updating the
1088         // grid query.
1089         if (redirect) return;
1090         // let initTab() fetch the user first so we can know the usrgroup
1091         $scope.totals.owed = patronSvc.patron_stats.fines.group_balance_owed;
1092     });
1093
1094     $scope.removeFromGroup = function(selected) {
1095         var promises = [];
1096         angular.forEach(selected, function(user) {
1097             console.debug('removing user ' + user.id + ' from group');
1098
1099             promises.push(
1100                 egCore.net.request(
1101                     'open-ils.actor',
1102                     'open-ils.actor.usergroup.new',
1103                     egCore.auth.token(), user.id, true
1104                 )
1105             );
1106         });
1107
1108         $q.all(promises).then(function() {grid.refresh()});
1109     }
1110
1111     function addUserToGroup(user) {
1112         user.usrgroup(patronSvc.current.usrgroup());
1113         user.ischanged(true);
1114         egCore.net.request(
1115             'open-ils.actor',
1116             'open-ils.actor.patron.update',
1117             egCore.auth.token(), user
1118
1119         ).then(function() {grid.refresh()});
1120     }
1121
1122     // fetch each user ("selected" has flattened users)
1123     // update the usrgroup, then update the user object
1124     // After all updates are complete, refresh the grid.
1125     function moveUsersToGroup(target_user, selected) {
1126         var promises = [];
1127
1128         angular.forEach(selected, function(user) {
1129             promises.push(
1130                 egCore.pcrud.retrieve('au', user.id)
1131                 .then(function(u) {
1132                     u.usrgroup(target_user.usrgroup());
1133                     u.ischanged(true);
1134                     return egCore.net.request(
1135                         'open-ils.actor',
1136                         'open-ils.actor.patron.update',
1137                         egCore.auth.token(), u
1138                     );
1139                 })
1140             );
1141         });
1142
1143         $q.all(promises).then(function() {grid.refresh()});
1144     }
1145
1146     function showMoveToGroupConfirm(barcode, selected, outbound) {
1147
1148         // find the user
1149         egCore.pcrud.search('ac', {barcode : barcode})
1150
1151         // fetch the fleshed user
1152         .then(function(card) {
1153
1154             if (!card) return; // TODO: warn user
1155
1156             egCore.pcrud.retrieve('au', card.usr())
1157             .then(function(user) {
1158                 user.card(card);
1159                 $uibModal.open({
1160                     templateUrl: './circ/patron/t_move_to_group_dialog',
1161                     backdrop: 'static',
1162                     controller: [
1163                                 '$scope','$uibModalInstance',
1164                         function($scope , $uibModalInstance) {
1165                             $scope.user = user;
1166                             $scope.selected = selected;
1167                             $scope.outbound = outbound;
1168                             $scope.ok = 
1169                                 function(count) { $uibModalInstance.close() }
1170                             $scope.cancel = 
1171                                 function () { $uibModalInstance.dismiss() }
1172                         }
1173                     ]
1174                 }).result.then(function() {
1175                     if (outbound) {
1176                         moveUsersToGroup(user, selected);
1177                     } else {
1178                         addUserToGroup(user);
1179                     }
1180                 });
1181             });
1182         });
1183     }
1184
1185     // selected == move selected patrons to another patron's group
1186     // !selected == patron from a different group moves into our group
1187     function moveToGroup(selected, outbound) {
1188         egPromptDialog.open(
1189             egCore.strings.GROUP_ADD_USER, '',
1190             {ok : function(value) {
1191                 if (value) 
1192                     showMoveToGroupConfirm(value, selected, outbound);
1193             }}
1194         );
1195     }
1196
1197     $scope.moveToGroup = function() { moveToGroup([], false) };
1198     $scope.moveToAnotherGroup = function(selected) { moveToGroup(selected, true) };
1199
1200     $scope.cloneUser = function(selected) {
1201         if (!selected.length) return;
1202         var url = $location.absUrl().replace(
1203             /\/patron\/.*/, 
1204             '/patron/register/clone/' + selected[0].id);
1205         $window.open(url, '_blank').focus();
1206     }
1207
1208     $scope.retrieveSelected = function(selected) {
1209         if (!selected.length) return;
1210         angular.forEach(selected, function(usr) {
1211             $timeout(function() {
1212                 var url = $location.absUrl().replace(
1213                     /\/patron\/.*/,
1214                     '/patron/' + usr.id + '/checkout');
1215                 $window.open(url, '_blank')
1216             });
1217         });
1218     }
1219
1220 }])
1221
1222 .controller('PatronStatCatsCtrl',
1223        ['$scope','$routeParams','$q','egCore','patronSvc',
1224 function($scope,  $routeParams , $q , egCore , patronSvc) {
1225     $scope.initTab('other', $routeParams.id)
1226     .then(function(redirect) {
1227         // Entries for org-visible stat cats are fleshed.  Any others
1228         // have to be fleshed within.
1229
1230         var to_flesh = {};
1231         angular.forEach(patronSvc.current.stat_cat_entries(), 
1232             function(entry) {
1233                 if (!angular.isObject(entry.stat_cat())) {
1234                     to_flesh[entry.stat_cat()] = entry;
1235                 }
1236             }
1237         );
1238
1239         if (!Object.keys(to_flesh).length) return;
1240
1241         egCore.pcrud.search('actsc', {id : Object.keys(to_flesh)})
1242         .then(null, null, function(cat) { // stream
1243             cat.owner(egCore.org.get(cat.owner())); // owner flesh
1244             to_flesh[cat.id()].stat_cat(cat);
1245         });
1246     });
1247 }])
1248
1249 .controller('PatronSurveyCtrl',
1250        ['$scope','$routeParams','$location','egCore','patronSvc',
1251 function($scope,  $routeParams , $location , egCore , patronSvc) {
1252     $scope.initTab('other', $routeParams.id);
1253     var usr_id = $routeParams.id;
1254     var org_ids = egCore.org.fullPath(egCore.auth.user().ws_ou(), true);
1255
1256     $scope.surveys = [];
1257     var svr_responses = {};
1258
1259     // fetch all survey responses for this user.
1260     egCore.pcrud.search('asvr',
1261         {usr : usr_id},
1262         {flesh : 2, flesh_fields : {asvr : ['survey','question','answer']}}
1263     ).then(
1264         function() {
1265             // All responses collected and deduplicated.
1266             // Create one collection of responses per survey.
1267
1268             angular.forEach(svr_responses, function(questions, survey_id) {
1269                 var collection = {responses : []};
1270                 angular.forEach(questions, function(response) {
1271                     collection.survey = response.survey(); // same for one.
1272                     collection.responses.push(response);
1273                 });
1274                 $scope.surveys.push(collection);
1275             });
1276         },
1277         null, 
1278         function(response) {
1279
1280             // Discard responses for out-of-scope surveys.
1281             if (org_ids.indexOf(response.survey().owner()) < 0) 
1282                 return;
1283
1284             // survey_id => question_id => response
1285             var svr_id = response.survey().id();
1286             var qst_id = response.question().id();
1287
1288             if (!svr_responses[svr_id]) 
1289                 svr_responses[svr_id] = [];
1290
1291             if (!svr_responses[svr_id][qst_id]) {
1292                 svr_responses[svr_id][qst_id] = response;
1293
1294             } else {
1295                 // We have multiple responses for the same question.
1296                 // For this UI we only care about the most recent response.
1297                 if (response.effective_date() > 
1298                     svr_responses[svr_id][qst_id].effective_date())
1299                     svr_responses[svr_id][qst_id] = response;
1300             }
1301         }
1302     );
1303 }])
1304
1305 .controller('PatronFetchLastCtrl',
1306        ['$scope','$location','egCore',
1307 function($scope , $location , egCore) {
1308
1309     var ids = egCore.hatch.getLoginSessionItem('eg.circ.recent_patrons') || [];
1310     if (ids.length) 
1311         return $location.path('/circ/patron/' + ids[0] + '/checkout');
1312
1313     $scope.no_last = true;
1314 }])
1315
1316 .controller('PatronTriggeredEventsCtrl',
1317        ['$scope','$routeParams','$location','egCore','patronSvc',
1318 function($scope,  $routeParams,  $location , egCore , patronSvc) {
1319     $scope.initTab('other', $routeParams.id);
1320
1321     var url = $location.absUrl().replace(/\/staff.*/, '/actor/user/event_log');
1322     url += '?patron_id=' + encodeURIComponent($routeParams.id);
1323
1324     $scope.triggered_events_url = url;
1325     $scope.funcs = {};
1326 }])
1327
1328 .controller('PatronMessageCenterCtrl',
1329        ['$scope','$routeParams','$location','egCore','patronSvc',
1330 function($scope,  $routeParams,  $location , egCore , patronSvc) {
1331     $scope.initTab('other', $routeParams.id);
1332
1333     var url = $location.protocol() + '://' + $location.host()
1334         + egCore.env.basePath.replace(/\/staff.*/,  '/actor/user/message');
1335     url += '/' + encodeURIComponent($routeParams.id);
1336
1337     $scope.message_center_url = url;
1338     $scope.funcs = {};
1339 }])
1340
1341 .controller('PatronPermsCtrl',
1342        ['$scope','$routeParams','$window','$location','egCore',
1343 function($scope , $routeParams , $window , $location , egCore) {
1344     $scope.initTab('other', $routeParams.id);
1345
1346     var url = $location.absUrl().replace(
1347         /\/eg\/staff.*/, '/xul/server/patron/user_edit.xhtml');
1348
1349     url += '?usr=' + encodeURIComponent($routeParams.id);
1350
1351     // user_edit does not load the session via cookie.  It uses URL 
1352     // params or xulG instead.  Pass via xulG.
1353     $scope.funcs = {
1354         ses : egCore.auth.token(),
1355         on_patron_save : function() {
1356             $scope.funcs.reload();
1357         }
1358     }
1359
1360     $scope.user_perms_url = url;
1361 }])
1362