source: main/waeup.aaue/trunk/src/waeup/aaue/students/utils.py @ 13719

Last change on this file since 13719 was 13689, checked in by Henrik Bettermann, 9 years ago

Do not allow to pay only additional fees if clearance fee is 0.
  • Property svn:keywords set to Id
File size: 14.1 KB
Line 
1## $Id: utils.py 13689 2016-02-12 10:31:21Z henrik $
2##
3## Copyright (C) 2011 Uli Fouquet & Henrik Bettermann
4## This program is free software; you can redistribute it and/or modify
5## it under the terms of the GNU General Public License as published by
6## the Free Software Foundation; either version 2 of the License, or
7## (at your option) any later version.
8##
9## This program is distributed in the hope that it will be useful,
10## but WITHOUT ANY WARRANTY; without even the implied warranty of
11## MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12## GNU General Public License for more details.
13##
14## You should have received a copy of the GNU General Public License
15## along with this program; if not, write to the Free Software
16## Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17##
18import grok
19from time import time
20from zope.component import createObject
21from waeup.kofa.interfaces import (
22    ADMITTED, CLEARANCE, REQUESTED, CLEARED, RETURNING, PAID,
23    academic_sessions_vocab)
24from kofacustom.nigeria.students.utils import NigeriaStudentsUtils
25from waeup.kofa.accesscodes import create_accesscode
26from waeup.kofa.students.utils import trans
27from waeup.aaue.interswitch.browser import gateway_net_amt
28from waeup.aaue.interfaces import MessageFactory as _
29
30class CustomStudentsUtils(NigeriaStudentsUtils):
31    """A collection of customized methods.
32
33    """
34
35    PORTRAIT_CHANGE_STATES = (ADMITTED, RETURNING)
36
37    gpa_boundaries = ((1, 'FRNS'),
38                      (1.5, 'Pass'),
39                      (2.4, '3rd Class Honours'),
40                      (3.5, '2nd Class Honours Lower Division'),
41                      (4.5, '2nd Class Honours Upper Division'),
42                      (5, '1st Class Honours'))
43
44    def increaseMatricInteger(self, student):
45        """Increase counter for matric numbers.
46        This counter can be a centrally stored attribute or an attribute of
47        faculties, departments or certificates. In the base package the counter
48        is as an attribute of the site configuration container.
49        """
50        if student.current_mode in ('ug_pt', 'de_pt'):
51            grok.getSite()['configuration'].next_matric_integer += 1
52            return
53        elif student.is_postgrad:
54            grok.getSite()['configuration'].next_matric_integer_3 += 1
55            return
56        grok.getSite()['configuration'].next_matric_integer_2 += 1
57        return
58
59    def constructMatricNumber(self, student):
60        faccode = student.faccode
61        depcode = student.depcode
62        certcode = student.certcode
63        degree = getattr(
64            getattr(student.get('studycourse', None), 'certificate', None),
65                'degree', None)
66        year = unicode(student.entry_session)[2:]
67        if not student.state in (PAID, ) or not student.is_fresh or \
68            student.current_mode == 'found':
69            return _('Matriculation number cannot be set.'), None
70        if student.is_postgrad:
71            next_integer = grok.getSite()['configuration'].next_matric_integer_3
72            if not degree or next_integer == 0:
73                return _('Matriculation number cannot be set.'), None
74            return None, "AAU/SPS/%s/%s/%s/%s/%05d" % (
75                faccode, depcode, year, degree, next_integer)
76        if student.current_mode in ('ug_pt', 'de_pt'):
77            next_integer = grok.getSite()['configuration'].next_matric_integer
78            if next_integer == 0:
79                return _('Matriculation number cannot be set.'), None
80            return None, "PTP/%s/%s/%s/%05d" % (
81                faccode, depcode, year, next_integer)
82        next_integer = grok.getSite()['configuration'].next_matric_integer_2
83        if next_integer == 0:
84            return _('Matriculation number cannot be set.'), None
85        if student.faccode in ('FBM', 'FCS'):
86            return None, "CMS/%s/%s/%s/%05d" % (
87                faccode, depcode, year, next_integer)
88        return None, "%s/%s/%s/%05d" % (faccode, depcode, year, next_integer)
89
90    def getReturningData(self, student):
91        """ This method defines what happens after school fee payment
92        of returning students depending on the student's senate verdict.
93        """
94        prev_level = student['studycourse'].current_level
95        cur_verdict = student['studycourse'].current_verdict
96        if cur_verdict in ('A','B','L','M','N','Z',):
97            # Successful student
98            new_level = divmod(int(prev_level),100)[0]*100 + 100
99        elif cur_verdict == 'C':
100            # Student on probation
101            new_level = int(prev_level) + 10
102        else:
103            # Student is somehow in an undefined state.
104            # Level has to be set manually.
105            new_level = prev_level
106        new_session = student['studycourse'].current_session + 1
107        return new_session, new_level
108
109    def _isPaymentDisabled(self, p_session, category, student):
110        academic_session = self._getSessionConfiguration(p_session)
111        if category == 'schoolfee' and \
112            'sf_all' in academic_session.payment_disabled:
113            return True
114        if category == 'hostel_maintenance' and \
115            'maint_all' in academic_session.payment_disabled:
116            return True
117        return False
118
119    def setPaymentDetails(self, category, student,
120            previous_session=None, previous_level=None):
121        """Create Payment object and set the payment data of a student for
122        the payment category specified.
123
124        """
125        details = {}
126        p_item = u''
127        amount = 0.0
128        error = u''
129        if previous_session:
130            return _('Previous session payment not yet implemented.'), None
131        p_session = student['studycourse'].current_session
132        p_level = student['studycourse'].current_level
133        p_current = True
134        academic_session = self._getSessionConfiguration(p_session)
135        if academic_session == None:
136            return _(u'Session configuration object is not available.'), None
137        # Determine fee.
138        if category == 'transfer':
139            amount = academic_session.transfer_fee
140        elif category == 'transcript':
141            amount = academic_session.transcript_fee
142        elif category == 'bed_allocation':
143            amount = academic_session.booking_fee
144        elif category == 'hostel_maintenance':
145            amount = 0.0
146            bedticket = student['accommodation'].get(
147                str(student.current_session), None)
148            if bedticket is not None and bedticket.bed is not None:
149                p_item = bedticket.display_coordinates
150                if bedticket.bed.__parent__.maint_fee > 0:
151                    amount = bedticket.bed.__parent__.maint_fee
152                else:
153                    # fallback
154                    amount = academic_session.maint_fee
155            else:
156                return _(u'No bed allocated.'), None
157        elif category == 'welfare':
158            amount = academic_session.welfare_fee
159        elif category == 'union':
160            amount = academic_session.union_fee
161        elif category == 'lapel':
162            amount = academic_session.lapel_fee
163        elif category == 'matric_gown':
164            amount = academic_session.matric_gown_fee
165        elif category == 'concessional':
166            amount = academic_session.concessional_fee
167        elif student.current_mode == 'found' and category not in (
168            'schoolfee', 'clearance', 'late_registration'):
169            return _('Not allowed.'), None
170        elif category.startswith('clearance'):
171            if student.state not in (ADMITTED, CLEARANCE, REQUESTED, CLEARED):
172                return _(u'Acceptance Fee payments not allowed.'), None
173            if student.faccode == 'FP':
174                amount = academic_session.clearance_fee_fp
175            elif student.current_mode.endswith('_pt'):
176                if student.is_postgrad:
177                    amount = academic_session.clearance_fee_pg_pt
178                else:
179                    amount = academic_session.clearance_fee_ug_pt
180            elif student.faccode == 'FCS':
181                # Students in clinical medical sciences pay the medical
182                # acceptance fee
183                amount = academic_session.clearance_fee_med
184            elif student.is_postgrad:  # and not part-time
185                amount = academic_session.clearance_fee_pg
186            else:
187                amount = academic_session.clearance_fee
188            p_item = student['studycourse'].certificate.code
189            if amount in (0.0, None):
190                return _(u'Amount could not be determined.'), None
191            # Add Matric Gown Fee and Lapel Fee
192            if category == 'clearance_incl':
193                amount += gateway_net_amt(academic_session.matric_gown_fee) + \
194                    gateway_net_amt(academic_session.lapel_fee)
195        elif category == 'late_registration':
196            amount = academic_session.late_registration_fee
197        elif category.startswith('schoolfee'):
198            try:
199                certificate = student['studycourse'].certificate
200                p_item = certificate.code
201            except (AttributeError, TypeError):
202                return _('Study course data are incomplete.'), None
203            if student.state == CLEARED or category == 'schoolfee_2':
204                if student.is_foreigner:
205                    amount = getattr(certificate, 'school_fee_3', 0.0)
206                else:
207                    amount = getattr(certificate, 'school_fee_1', 0.0)
208                # Cut school fee by 50%
209                if category in ('schoolfee_1', 'schoolfee_2'):
210                    amount = amount / 2
211            elif category == 'schoolfee_1':
212                return _("Wrong state. Only students in state 'cleared' "
213                         "are allowed to pay by instalments."), None
214            elif student.state == RETURNING:
215                if student.is_postgrad and category == 'schoolfee_incl':
216                    return _("No additional fees required."), None
217                if not student.father_name:
218                    return _("Personal data form is not properly filled."), None
219                # In case of returning school fee payment the payment session
220                # and level contain the values of the session the student
221                # has paid for.
222                p_session, p_level = self.getReturningData(student)
223                try:
224                    academic_session = grok.getSite()[
225                        'configuration'][str(p_session)]
226                except KeyError:
227                    return _(u'Session configuration object is not available.'), None
228                if student.is_foreigner:
229                    amount = getattr(certificate, 'school_fee_4', 0.0)
230                else:
231                    amount = getattr(certificate, 'school_fee_2', 0.0)
232            else:
233                return _('Wrong state.'), None
234            if amount in (0.0, None):
235                return _(u'Amount could not be determined.'), None
236            # Add Student Union Fee and Welfare Assurance
237            if category in ('schoolfee_incl', 'schoolfee_1'):
238                amount += gateway_net_amt(academic_session.welfare_fee) + \
239                    gateway_net_amt(academic_session.union_fee)
240            # Add non-indigenous fee and session specific penalty fees
241            if student.is_postgrad:
242                amount += academic_session.penalty_pg
243                if not student.lga.startswith('edo'):
244                    amount += 20000.0
245            else:
246                amount += academic_session.penalty_ug
247        if amount in (0.0, None):
248            return _(u'Amount could not be determined.'), None
249
250        # Create ticket.
251        for key in student['payments'].keys():
252            ticket = student['payments'][key]
253            if ticket.p_state == 'paid' and\
254               ticket.p_category == category and \
255               ticket.p_item == p_item and \
256               ticket.p_session == p_session:
257                  return _('This type of payment has already been made.'), None
258        if self._isPaymentDisabled(p_session, category, student):
259            return _('Payment temporarily disabled.'), None
260        payment = createObject(u'waeup.StudentOnlinePayment')
261        timestamp = ("%d" % int(time()*10000))[1:]
262        payment.p_id = "p%s" % timestamp
263        payment.p_category = category
264        payment.p_item = p_item
265        payment.p_session = p_session
266        payment.p_level = p_level
267        payment.p_current = p_current
268        payment.amount_auth = amount
269        return None, payment
270
271    def _admissionText(self, student, portal_language):
272        inst_name = grok.getSite()['configuration'].name
273        entry_session = student['studycourse'].entry_session
274        entry_session = academic_sessions_vocab.getTerm(entry_session).title
275        text = trans(_(
276            'This is to inform you that you have been offered provisional'
277            ' admission into ${a} for the ${b} academic session as follows:',
278            mapping = {'a': inst_name, 'b': entry_session}),
279            portal_language)
280        return text
281
282    def maxCredits(self, studylevel):
283        """Return maximum credits.
284
285        """
286        return 48
287
288    def getBedCoordinates(self, bedticket):
289        """Return descriptive bed coordinates.
290        This method can be used to customize the `display_coordinates`
291        property method in order to  display a
292        customary description of the bed space.
293        """
294        bc = bedticket.bed_coordinates.split(',')
295        if len(bc) == 4:
296            return bc[0]
297        return bedticket.bed_coordinates
298
299    def getAccommodationDetails(self, student):
300        """Determine the accommodation data of a student.
301        """
302        d = {}
303        d['error'] = u''
304        hostels = grok.getSite()['hostels']
305        d['booking_session'] = hostels.accommodation_session
306        d['allowed_states'] = hostels.accommodation_states
307        d['startdate'] = hostels.startdate
308        d['enddate'] = hostels.enddate
309        d['expired'] = hostels.expired
310        # Determine bed type
311        bt = 'all'
312        if student.sex == 'f':
313            sex = 'female'
314        else:
315            sex = 'male'
316        special_handling = 'regular'
317        d['bt'] = u'%s_%s_%s' % (special_handling,sex,bt)
318        return d
319
320    # AAUE prefix
321    STUDENT_ID_PREFIX = u'E'
Note: See TracBrowser for help on using the repository browser.