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