- 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>
53 lines
1.8 KiB
Python
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"])
|