Project

General

Profile

Download (20.6 KB) Statistics
| Branch: | Tag: | Revision:

calebasse / calebasse / agenda / models.py @ 3e9b47e9

1
# -*- coding: utf-8 -*-
2

    
3
from datetime import datetime, date, timedelta
4
from copy import copy
5

    
6
from django.utils.translation import ugettext_lazy as _
7
from django.contrib.auth.models import User
8
from django.db import models
9
from django import forms
10

    
11
from calebasse.agenda import managers
12
from calebasse.utils import weeks_since_epoch, weekday_ranks
13
from interval import Interval
14

    
15
__all__ = (
16
    'EventType',
17
    'Event',
18
    'EventWithAct',
19
)
20

    
21
class EventType(models.Model):
22
    '''
23
    Simple ``Event`` classifcation.
24
    '''
25
    class Meta:
26
        verbose_name = u'Type d\'événement'
27
        verbose_name_plural = u'Types d\'événement'
28

    
29
    def __unicode__(self):
30
        return self.label
31

    
32
    label = models.CharField(_('label'), max_length=50)
33
    rank = models.IntegerField(_('Sorting Rank'), null=True, blank=True, default=0)
34

    
35
class Event(models.Model):
36
    '''
37
    Container model for general agenda events
38
    '''
39
    objects = managers.EventManager()
40

    
41
    title = models.CharField(_('Title'), max_length=60, blank=True)
42
    description = models.TextField(_('Description'), max_length=100)
43
    event_type = models.ForeignKey(EventType, verbose_name=u"Type d'événement")
44
    creator = models.ForeignKey(User, verbose_name=_(u'Créateur'), blank=True, null=True)
45
    create_date = models.DateTimeField(_(u'Date de création'), auto_now_add=True)
46

    
47
    services = models.ManyToManyField('ressources.Service',
48
            null=True, blank=True, default=None)
49
    participants = models.ManyToManyField('personnes.People',
50
            null=True, blank=True, default=None)
51
    room = models.ForeignKey('ressources.Room', blank=True, null=True,
52
            verbose_name=u'Salle')
53

    
54
    start_datetime = models.DateTimeField(_('Début'), db_index=True)
55
    end_datetime = models.DateTimeField(_('Fin'), blank=True, null=True)
56
    old_ev_id = models.CharField(max_length=8, blank=True, null=True)
57
    old_rr_id = models.CharField(max_length=8, blank=True, null=True)
58
    # only used when there is no rr id
59
    old_rs_id = models.CharField(max_length=8, blank=True, null=True)
60
    # exception to is mutually exclusive with recurrence_periodicity
61
    # an exception cannot be periodic
62
    exception_to = models.ForeignKey('self', related_name='exceptions',
63
            blank=True, null=True,
64
            verbose_name=u'Exception à')
65
    exception_date = models.DateField(blank=True, null=True,
66
            verbose_name=u'Reporté du', db_index=True)
67
    # canceled can only be used with exception to
68
    canceled = models.BooleanField(_('Annulé'), db_index=True)
69

    
70
    PERIODS = (
71
            (1, u'Toutes les semaines'),
72
            (2, u'Une semaine sur deux'),
73
            (3, u'Une semaine sur trois'),
74
            (4, 'Une semaine sur quatre'),
75
            (5, 'Une semaine sur cinq')
76
    )
77
    OFFSET = range(0,4)
78
    PERIODICITIES = (
79
            (1, u'Toutes les semaines'),
80
            (2, u'Une semaine sur deux'),
81
            (3, u'Une semaine sur trois'),
82
            (4, u'Une semaine sur quatre'),
83
            (5, u'Une semaine sur cinq'),
84
            (6, u'La première semaine du mois'),
85
            (7, u'La deuxième semaine du mois'),
86
            (8, u'La troisième semaine du mois'),
87
            (9, u'La quatrième semaine du mois'),
88
            (10, u'La dernière semaine du mois'),
89
            (11, u'Les semaines paires'),
90
            (12, u'Les semaines impaires')
91
    )
92
    WEEK_RANKS = (
93
            (0, u'La première semaine du mois'),
94
            (1, u'La deuxième semaine du mois'),
95
            (2, u'La troisième semaine du mois'),
96
            (3, u'La quatrième semaine du mois'),
97
            (4, u'La dernière semaine du mois')
98
    )
99
    PARITIES = (
100
            (0, u'Les semaines paires'),
101
            (1, u'Les semaines impaires')
102
    )
103
    recurrence_periodicity = models.PositiveIntegerField(
104
            choices=PERIODICITIES,
105
            verbose_name=u"Périodicité",
106
            default=None,
107
            blank=True,
108
            null=True,
109
            db_index=True)
110
    recurrence_week_day = models.PositiveIntegerField(default=0, db_index=True)
111
    recurrence_week_offset = models.PositiveIntegerField(
112
            choices=zip(OFFSET, OFFSET),
113
            verbose_name=u"Décalage en semaines par rapport au 1/1/1970 pour le calcul de période",
114
            default=0,
115
            db_index=True)
116
    recurrence_week_period = models.PositiveIntegerField(
117
            choices=PERIODS,
118
            verbose_name=u"Période en semaines",
119
            default=None,
120
            blank=True,
121
            null=True,
122
            db_index=True)
123
    recurrence_week_rank = models.PositiveIntegerField(
124
            verbose_name=u"Rang de la semaine dans le mois",
125
            choices=WEEK_RANKS,
126
            blank=True, null=True, db_index=True)
127
    recurrence_week_parity = models.PositiveIntegerField(
128
            choices=PARITIES,
129
            verbose_name=u"Parité des semaines",
130
            blank=True,
131
            null=True,
132
            db_index=True)
133
    recurrence_end_date = models.DateField(
134
            verbose_name=_(u'Fin de la récurrence'),
135
            blank=True, null=True,
136
            db_index=True)
137

    
138
    PERIOD_LIST_TO_FIELDS = [(1, None, None),
139
        (2, None, None),
140
        (3, None, None),
141
        (4, None, None),
142
        (5, None, None),
143
        (None, 0, None),
144
        (None, 1, None),
145
        (None, 2, None),
146
        (None, 3, None),
147
        (None, 4, None),
148
        (None, None, 0),
149
        (None, None, 1)
150
    ]
151

    
152
    class Meta:
153
        verbose_name = u'Evénement'
154
        verbose_name_plural = u'Evénements'
155
        ordering = ('start_datetime', 'end_datetime', 'title')
156
        unique_together = (('exception_to', 'exception_date'),)
157

    
158
    def __init__(self, *args, **kwargs):
159
        if kwargs.get('start_datetime') and not kwargs.has_key('recurrence_end_date'):
160
            kwargs['recurrence_end_date'] = kwargs.get('start_datetime').date()
161
        super(Event, self).__init__(*args, **kwargs)
162

    
163
    def clean(self):
164
        '''Initialize recurrence fields if they are not.'''
165
        self.sanitize()
166
        if self.recurrence_periodicity:
167
            if self.recurrence_end_date and self.start_datetime and self.recurrence_end_date < self.start_datetime.date():
168
                raise forms.ValidationError(u'La date de fin de périodicité doit être postérieure à la date de début.')
169
        if self.recurrence_week_parity is not None:
170
            if self.start_datetime:
171
                week = self.start_datetime.date().isocalendar()[1]
172
                start_week_parity = week % 2
173
                if start_week_parity != self.recurrence_week_parity:
174
                    raise forms.ValidationError(u'Le date de départ de la périodicité est en semaine {week}.'.format(week=week))
175
        if self.recurrence_week_rank is not None and self.start_datetime:
176
            start_week_ranks = weekday_ranks(self.start_datetime.date())
177
            if self.recurrence_week_rank not in start_week_ranks:
178
                raise forms.ValidationError('La date de début de périodicité doit faire partie de la bonne semaine dans le mois.')
179

    
180
    def sanitize(self):
181
        if self.recurrence_periodicity:
182
            l = self.PERIOD_LIST_TO_FIELDS[self.recurrence_periodicity-1]
183
        else:
184
            l = None, None, None
185
        self.recurrence_week_period = l[0]
186
        self.recurrence_week_rank = l[1]
187
        self.recurrence_week_parity = l[2]
188
        if self.start_datetime:
189
            if self.recurrence_periodicity:
190
                self.recurrence_week_day = self.start_datetime.weekday()
191
            if self.recurrence_week_period is not None:
192
                self.recurrence_week_offset = weeks_since_epoch(self.start_datetime) % self.recurrence_week_period
193

    
194
    def timedelta(self):
195
        '''Distance between start and end of the event'''
196
        return self.end_datetime - self.start_datetime
197

    
198
    def match_date(self, date):
199
        if self.is_recurring():
200
            # consider exceptions
201
            exception = self.get_exceptions_dict().get(date)
202
            if exception is not None:
203
                return exception if exception.match_date(date) else None
204
            if self.canceled:
205
                return None
206
            if date.weekday() != self.recurrence_week_day:
207
                return None
208
            if self.start_datetime.date() > date:
209
                return None
210
            if self.recurrence_end_date and self.recurrence_end_date < date:
211
                return None
212
            if self.recurrence_week_period is not None:
213
                if weeks_since_epoch(date) % self.recurrence_week_period != self.recurrence_week_offset:
214
                    return None
215
            elif self.recurrence_week_parity is not None:
216
                if date.isocalendar()[1] % 2 != self.recurrence_week_parity:
217
                    return None
218
            elif self.recurrence_week_rank is not None:
219
                if self.recurrence_week_rank not in weekday_ranks(date):
220
                    return None
221
            else:
222
                raise NotImplemented
223
            return self
224
        else:
225
            return self if date == self.start_datetime.date() else None
226

    
227

    
228
    def today_occurrence(self, today=None, match=False, upgrade=True):
229
        '''For a recurring event compute the today 'Event'.
230

    
231
           The computed event is the fake one that you cannot save to the database.
232
        '''
233
        today = today or date.today()
234
        if self.canceled:
235
            return None
236
        if match:
237
            exception = self.get_exceptions_dict().get(today)
238
            if exception:
239
                if exception.start_datetime.date() == today:
240
                    return exception.today_occurrence(today)
241
                else:
242
                    return None
243
        else:
244
            exception_or_self = self.match_date(today)
245
            if exception_or_self is None:
246
                return None
247
            if exception_or_self != self:
248
                return exception_or_self.today_occurrence(today)
249
        if self.event_type_id == 1 and type(self) != EventWithAct and upgrade:
250
           self = self.eventwithact
251
        if self.recurrence_periodicity is None:
252
            return self
253
        start_datetime = datetime.combine(today, self.start_datetime.timetz())
254
        end_datetime = start_datetime + self.timedelta()
255
        event = copy(self)
256
        event.exception_to = self
257
        event.exception_date = today
258
        event.start_datetime = start_datetime
259
        event.end_datetime = end_datetime
260
        event.recurrence_periodicity = None
261
        event.recurrence_week_offset = 0
262
        event.recurrence_week_period = None
263
        event.recurrence_week_parity = None
264
        event.recurrence_week_rank = None
265
        event.recurrence_end_date = None
266
        event.parent = self
267
        # the returned event is "virtual", it must not be saved
268
        old_save = event.save
269
        old_participants = list(self.participants.all())
270
        def save(*args, **kwargs): 
271
            event.id = None
272
            event.event_ptr_id = None
273
            old_save(*args, **kwargs)
274
            if hasattr(self, 'exceptions_dict'):
275
                self.exceptions_dict[event.start_datetime.date()] = event
276
            event.participants = old_participants
277
        event.save = save
278
        return event
279

    
280
    def next_occurence(self, today=None):
281
        '''Returns the next occurence after today.'''
282
        today = today or date.today()
283
        for occurence in self.all_occurences():
284
            if occurence.start_datetime.date() > today:
285
                return occurence
286

    
287
    def is_recurring(self):
288
        '''Is this event multiple ?'''
289
        return self.recurrence_periodicity is not None
290

    
291
    def get_exceptions_dict(self):
292
        if not hasattr(self, 'exceptions_dict'):
293
            self.exceptions_dict = dict()
294
            if self.exception_to_id is None:
295
                for exception in self.exceptions.all():
296
                    self.exceptions_dict[exception.exception_date] = exception
297
        return self.exceptions_dict
298

    
299
    def all_occurences(self, limit=90):
300
        '''Returns all occurences of this event as virtual Event objects
301

    
302
           limit - compute occurrences until limit days in the future
303

    
304
           Default is to limit to 90 days.
305
        '''
306
        if self.recurrence_periodicity is not None:
307
            day = self.start_datetime.date()
308
            max_end_date = max(date.today(), self.start_datetime.date()) + timedelta(days=limit)
309
            end_date = min(self.recurrence_end_date or max_end_date, max_end_date)
310
            occurrences = []
311
            if self.recurrence_week_period is not None:
312
                delta = timedelta(days=self.recurrence_week_period*7)
313
                while day <= end_date:
314
                    occurrence = self.today_occurrence(day, True)
315
                    if occurrence is not None:
316
                        occurrences.append(occurrence)
317
                    day += delta
318
            elif self.recurrence_week_parity is not None:
319
                delta = timedelta(days=7)
320
                while day <= end_date:
321
                    if day.isocalendar()[1] % 2 == self.recurrence_week_parity:
322
                        occurrence = self.today_occurrence(day, True)
323
                        if occurrence is not None:
324
                            occurrences.append(occurrence)
325
                    day += delta
326
            elif self.recurrence_week_rank is not None:
327
                delta = timedelta(days=7)
328
                while day <= end_date:
329
                    if self.recurrence_week_rank in weekday_ranks(day):
330
                        occurrence = self.today_occurrence(day, True)
331
                        if occurrence is not None:
332
                            occurrences.append(occurrence)
333
                    day += delta
334
            for exception in self.exceptions.all():
335
                if exception.exception_date != exception.start_datetime.date():
336
                    occurrences.append(exception.eventwithact if exception.event_type_id == 1 else exception)
337
            return sorted(occurrences, key=lambda o: o.start_datetime)
338
        else:
339
            return [self]
340

    
341
    def save(self, *args, **kwargs):
342
        assert self.recurrence_periodicity is None or self.exception_to is None
343
        assert self.exception_to is None or self.exception_to.recurrence_periodicity is not None
344
        assert self.start_datetime is not None
345
        self.sanitize() # init periodicity fields
346
        super(Event, self).save(*args, **kwargs)
347
        self.acts_cleaning()
348

    
349
    def delete(self, *args, **kwargs):
350
        self.canceled = True
351
        # save will clean acts
352
        self.save(*args, **kwargs)
353

    
354
    def acts_cleaning(self):
355
        # list of occurences may have changed
356
        from ..actes.models import Act
357
        if self.exception_to:
358
            # maybe a new exception, so look for parent acts with same date
359
            # as exception date
360
            acts = Act.objects.filter(models.Q(parent_event=self)
361
                    |models.Q(parent_event=self.exception_to,
362
                        date=self.exception_date))
363
        else:
364
            acts = Act.objects.filter(parent_event=self)
365
        acts = acts.prefetch_related('actvalidationstate_set')
366
        if acts:
367
            eventwithact = self.eventwithact
368
            for act in acts:
369
                if act.is_new():
370
                    if self.match_date(act.date):
371
                        if self.canceled:
372
                            act.delete()
373
                        else:
374
                            eventwithact.update_act(act)
375
                    else:
376
                        act.delete()
377

    
378
    def to_interval(self):
379
        return Interval(self.start_datetime, self.end_datetime)
380

    
381
    def is_event_absence(self):
382
        return False
383

    
384
    RECURRENCE_DESCRIPTION = [
385
            u'Tous les %s',      #(1, None, None),
386
            u'Un %s sur deux',   #(2, None, None),
387
            u'Un %s sur trois',  #(3, None, None),
388
            u'Un %s sur quatre', #(4, None, None),
389
            u'Un %s sur cinq',   #(5, None, None),
390
            u'Le premier %s du mois',   #(None, 0, None),
391
            u'Le deuxième %s du mois',  #(None, 1, None),
392
            u'Le troisième %s du mois', #(None, 2, None),
393
            u'Le quatrième %s du mois', #(None, 3, None),
394
            u'Le dernier %s du mois',   #(None, 4, None),
395
            u'Les %s les semaines paires',    #(None, None, 0),
396
            u'Les %s les semaines impaires', #(None, None, 1)
397
    ]
398

    
399
    WEEKDAY_DESRIPTION = [
400
            u'lundi',
401
            u'mardi',
402
            u'mercredi',
403
            u'jeudi',
404
            u'vendredi',
405
            u'samedi',
406
            u'dimanche'
407
    ]
408

    
409
    def recurrence_description(self):
410
        '''Self description of this recurring event'''
411
        if not self.recurrence_periodicity:
412
            return None
413
        parts = []
414
        parts.append(self.RECURRENCE_DESCRIPTION[self.recurrence_periodicity] \
415
            % self.WEEKDAY_DESRIPTION[self.recurrence_week_day])
416
        if self.recurrence_end_date:
417
            parts.append(u'du')
418
        else:
419
            parts.append(u'à partir du')
420
        parts.append(self.start_datetime.strftime('%d/%m/%Y'))
421
        if self.recurrence_end_date:
422
            parts.append(u'au')
423
            parts.append(self.recurrence_end_date.strftime('%d/%m/%Y'))
424
        return u' '.join(parts)
425

    
426

    
427

    
428

    
429

    
430
    def __unicode__(self):
431
        return self.title
432

    
433
    def __repr__(self):
434
        return '<Event: on {start_datetime} with {participants}'.format(
435
                start_datetime=self.start_datetime,
436
                participants=self.participants.all() if self.id else '<un-saved>')
437

    
438

    
439
class EventWithActManager(managers.EventManager):
440
    def create_patient_appointment(self, creator, title, patient,
441
            doctors=[], act_type=None, service=None, start_datetime=None, end_datetime=None,
442
            room=None, periodicity=1, until=False):
443
        appointment = self.create_event(creator=creator,
444
                title=title,
445
                event_type=EventType(id=1),
446
                participants=doctors,
447
                services=[service],
448
                start_datetime=start_datetime,
449
                end_datetime=end_datetime,
450
                room=room,
451
                periodicity=periodicity,
452
                until=until,
453
                act_type=act_type,
454
                patient=patient)
455
        return appointment
456

    
457

    
458
class EventWithAct(Event):
459
    '''An event corresponding to an act.'''
460
    objects = EventWithActManager()
461
    act_type = models.ForeignKey('ressources.ActType',
462
        verbose_name=u'Type d\'acte')
463
    patient = models.ForeignKey('dossiers.PatientRecord')
464
    convocation_sent = models.BooleanField(blank=True,
465
        verbose_name=u'Convoqué', db_index=True)
466

    
467

    
468
    @property
469
    def act(self):
470
        for act in self.act_set.all():
471
            if act.date == self.start_datetime.date():
472
                return act
473
        return self.build_act()
474

    
475
    def get_state(self):
476
        act = self.act
477
        if act.id:
478
            return act.get_state()
479
        return None
480

    
481
    def build_act(self):
482
        from ..actes.models import Act, ActValidationState
483
        act = Act()
484
        self.init_act(act)
485
        old_save = act.save
486
        def save(*args, **kwargs):
487
            old_save(*args, **kwargs)
488
            act.doctors = self.participants.select_subclasses()
489
            ActValidationState.objects.create(act=act, state_name='NON_VALIDE',
490
                author=self.creator, previous_state=None)
491
        act.save = save
492
        return act
493

    
494
    def update_act(self, act):
495
        '''Update an act to match details of the meeting'''
496
        self.init_act(act)
497
        act.save()
498

    
499
    def init_act(self, act):
500
        delta = self.timedelta()
501
        duration = delta.seconds // 60
502
        act._duration = duration
503
        act.act_type = self.act_type
504
        act.patient = self.patient
505
        act.parent_event = self
506
        act.date = self.start_datetime.date()
507

    
508
    def save(self, *args, **kwargs):
509
        '''Force event_type to be patient meeting.'''
510
        self.event_type = EventType(id=1)
511
        super(EventWithAct, self).save(*args, **kwargs)
512

    
513
    def is_event_absence(self):
514
        return self.act.is_absent()
515

    
516
    def __unicode__(self):
517
        kwargs = {
518
                'patient': self.patient,
519
                'start_datetime': self.start_datetime,
520
                'act_type': self.act_type
521
        }
522
        kwargs['doctors'] = ', '.join(map(unicode, self.participants.all())) if self.id else ''
523
        return u'Rdv le {start_datetime} de {patient} avec {doctors} pour ' \
524
            '{act_type} ({act_type.id})'.format(**kwargs)
525

    
526

    
527
from django.db.models.signals import m2m_changed
528
from django.dispatch import receiver
529

    
530

    
531
@receiver(m2m_changed, sender=Event.participants.through)
532
def participants_changed(sender, instance, action, **kwargs):
533
    if action.startswith('post'):
534
        workers = [ p.worker for p in instance.participants.prefetch_related('worker') ]
535
        for act in instance.act_set.all():
536
            act.doctors = workers
(7-7/10)