"""Stunden-Auszahlung: HR/Admin weist Überstunden-Stunden zur Lohn-Auszahlung an.""" import enum import uuid from datetime import datetime from decimal import Decimal from typing import TYPE_CHECKING from sqlalchemy import DateTime, ForeignKey, Integer, Numeric, String, Text, func from sqlalchemy.dialects.postgresql import UUID from sqlalchemy.orm import Mapped, mapped_column, relationship from app.core.database import Base if TYPE_CHECKING: from app.models.user import User from app.models.company import Company class PayoutStatus(str, enum.Enum): REQUESTED = "requested" # Mitarbeiter hat beantragt, wartet auf HR APPROVED = "approved" # genehmigt / HR-Direktbuchung – Saldo abgezogen REJECTED = "rejected" # HR hat abgelehnt CANCELLED = "cancelled" # Antragsteller hat zurückgezogen (nur requested) class HoursPayout(Base): """Ein Auszahlungsvorgang für Überstunden-Stunden.""" __tablename__ = "hours_payouts" id: Mapped[uuid.UUID] = mapped_column(UUID(as_uuid=True), primary_key=True, default=uuid.uuid4) company_id: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("companies.id", ondelete="CASCADE"), nullable=False, index=True ) user_id: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("users.id", ondelete="CASCADE"), nullable=False, index=True ) hours: Mapped[Decimal] = mapped_column(Numeric(6, 2), nullable=False) # ausgezahlte Stunden period_year: Mapped[int | None] = mapped_column(Integer) # Abrechnungsmonat Jahr period_month: Mapped[int | None] = mapped_column(Integer) # Abrechnungsmonat Monat note: Mapped[str | None] = mapped_column(Text) # Notiz für Buchhaltung status: Mapped[str] = mapped_column(String(12), nullable=False, default=PayoutStatus.APPROVED.value) rejection_reason: Mapped[str | None] = mapped_column(Text) created_by: Mapped[uuid.UUID] = mapped_column( UUID(as_uuid=True), ForeignKey("users.id", ondelete="SET NULL"), nullable=False ) decided_by: Mapped[uuid.UUID | None] = mapped_column( UUID(as_uuid=True), ForeignKey("users.id", ondelete="SET NULL") ) decided_at: Mapped[datetime | None] = mapped_column(DateTime(timezone=True)) created_at: Mapped[datetime] = mapped_column( DateTime(timezone=True), server_default=func.now(), index=True ) user: Mapped["User"] = relationship("User", foreign_keys=[user_id], lazy="noload") creator: Mapped["User"] = relationship("User", foreign_keys=[created_by], lazy="noload") decider: Mapped["User"] = relationship("User", foreign_keys=[decided_by], lazy="noload") company: Mapped["Company"] = relationship("Company", lazy="noload")