Files
training-software/attendance/models.py
Paperclip CTO 72e319767f
Some checks failed
CI / lint (push) Failing after 46s
CI / test (push) Failing after 11s
CI / build-container (push) Has been skipped
feat(TRA-368): add attendance app with check-in/check-out core
- AttendanceSession model with open/closed status, org_id, timestamps
- POST /api/v1/attendance/check-in/ – creates session, rejects duplicate open check-ins (409)
- POST /api/v1/attendance/check-out/ – closes open session, validates checkout > checkin
- GET /api/v1/attendance/status/ – current open session for requesting user
- GET /api/v1/attendance/history/ – paginated session history per user
- GET /api/v1/attendance/admin/sessions/ – admin view for managers/admins with filters
- Initial migration with composite indexes on (user, status) and (user, checked_in_at)
- 18 test cases covering core flows and edge cases

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-05-18 12:11:16 +02:00

53 lines
1.8 KiB
Python

import uuid
from datetime import timedelta
from django.conf import settings
from django.db import models
from django.utils import timezone
class AttendanceSession(models.Model):
STATUS_OPEN = "open"
STATUS_CLOSED = "closed"
STATUS_CHOICES = [
(STATUS_OPEN, "Open"),
(STATUS_CLOSED, "Closed"),
]
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
user = models.ForeignKey(
settings.AUTH_USER_MODEL,
on_delete=models.CASCADE,
related_name="attendance_sessions",
)
org_id = models.UUIDField(null=True, blank=True, db_index=True)
checked_in_at = models.DateTimeField(db_index=True)
checked_out_at = models.DateTimeField(null=True, blank=True)
status = models.CharField(max_length=10, choices=STATUS_CHOICES, default=STATUS_OPEN, db_index=True)
notes = models.TextField(blank=True, default="")
created_at = models.DateTimeField(auto_now_add=True)
updated_at = models.DateTimeField(auto_now=True)
class Meta:
db_table = "attendance_session"
ordering = ["-checked_in_at"]
indexes = [
models.Index(fields=["user", "status"], name="attendance_user_status_idx"),
models.Index(fields=["user", "checked_in_at"], name="attendance_user_checkin_idx"),
]
def __str__(self):
return f"{self.user_id} checked in at {self.checked_in_at}"
@property
def duration_seconds(self):
if self.checked_out_at is None:
return None
delta = self.checked_out_at - self.checked_in_at
return int(delta.total_seconds())
def close(self, checked_out_at=None):
self.checked_out_at = checked_out_at or timezone.now()
self.status = self.STATUS_CLOSED
self.save(update_fields=["checked_out_at", "status", "updated_at"])