A R R R Associates
77 lines
4.9 KiB
Python
77 lines
4.9 KiB
Python
from __future__ import annotations
|
|
|
|
from datetime import date, datetime, timezone
|
|
|
|
from sqlalchemy import Boolean, Date, DateTime, ForeignKey, Integer, String, Text
|
|
from sqlalchemy.orm import Mapped, mapped_column, relationship
|
|
|
|
from app.core.db.common import CommonBase
|
|
|
|
|
|
class UserAlert(CommonBase):
|
|
"""Common role-aware alert table for all dashboards and portals.
|
|
|
|
Phase 7H foundation only stores and displays alerts. Later phases can call
|
|
app.modules.alerts.service.create_alert() from task, document, attendance,
|
|
client and consultant workflows without changing this schema.
|
|
"""
|
|
|
|
__tablename__ = "user_alerts"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
tenant_id: Mapped[int | None] = mapped_column(ForeignKey("tenants.id", ondelete="CASCADE"), nullable=True, index=True)
|
|
branch_id: Mapped[int | None] = mapped_column(ForeignKey("branches.id", ondelete="SET NULL"), nullable=True, index=True)
|
|
user_id: Mapped[int] = mapped_column(ForeignKey("users.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
|
|
role_context: Mapped[str | None] = mapped_column(String(50), nullable=True, index=True)
|
|
alert_type: Mapped[str] = mapped_column(String(80), nullable=False, default="general", index=True)
|
|
priority: Mapped[str] = mapped_column(String(20), nullable=False, default="normal", index=True)
|
|
title: Mapped[str] = mapped_column(String(255), nullable=False)
|
|
message: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
target_url: Mapped[str | None] = mapped_column(String(500), nullable=True)
|
|
|
|
is_read: Mapped[bool] = mapped_column(Boolean, nullable=False, default=False, index=True)
|
|
read_at_utc: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
|
|
created_at_utc: Mapped[datetime] = mapped_column(
|
|
DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False, index=True
|
|
)
|
|
created_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id", ondelete="SET NULL"), nullable=True)
|
|
|
|
user = relationship("User", foreign_keys=[user_id])
|
|
created_by = relationship("User", foreign_keys=[created_by_user_id])
|
|
|
|
|
|
class WorkflowEscalation(CommonBase):
|
|
"""Durable engagement escalation register used by staff, managers and partners."""
|
|
|
|
__tablename__ = "workflow_escalations"
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, autoincrement=True)
|
|
tenant_id: Mapped[int] = mapped_column(ForeignKey("tenants.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
branch_id: Mapped[int | None] = mapped_column(ForeignKey("branches.id", ondelete="SET NULL"), nullable=True, index=True)
|
|
subscription_id: Mapped[int] = mapped_column(ForeignKey("client_service_subscriptions.id", ondelete="CASCADE"), nullable=False, index=True)
|
|
task_id: Mapped[int | None] = mapped_column(ForeignKey("client_service_task_instances.id", ondelete="SET NULL"), nullable=True, index=True)
|
|
raised_by_user_id: Mapped[int] = mapped_column(ForeignKey("users.id", ondelete="RESTRICT"), nullable=False, index=True)
|
|
assigned_to_user_id: Mapped[int] = mapped_column(ForeignKey("users.id", ondelete="RESTRICT"), nullable=False, index=True)
|
|
escalation_level: Mapped[str] = mapped_column(String(30), nullable=False, index=True)
|
|
category: Mapped[str] = mapped_column(String(50), nullable=False, default="workflow_dependency", index=True)
|
|
priority: Mapped[str] = mapped_column(String(20), nullable=False, default="high", index=True)
|
|
status: Mapped[str] = mapped_column(String(20), nullable=False, default="open", index=True)
|
|
message: Mapped[str] = mapped_column(Text, nullable=False)
|
|
follow_up_date: Mapped[date | None] = mapped_column(Date, nullable=True, index=True)
|
|
acknowledged_at_utc: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
|
|
acknowledged_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id", ondelete="SET NULL"), nullable=True)
|
|
resolved_at_utc: Mapped[datetime | None] = mapped_column(DateTime(timezone=True), nullable=True)
|
|
resolved_by_user_id: Mapped[int | None] = mapped_column(ForeignKey("users.id", ondelete="SET NULL"), nullable=True)
|
|
resolution_note: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
created_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), nullable=False, index=True)
|
|
updated_at_utc: Mapped[datetime] = mapped_column(DateTime(timezone=True), default=lambda: datetime.now(timezone.utc), onupdate=lambda: datetime.now(timezone.utc), nullable=False)
|
|
|
|
subscription = relationship("ClientServiceSubscription")
|
|
task = relationship("ClientServiceTaskInstance")
|
|
raised_by = relationship("User", foreign_keys=[raised_by_user_id])
|
|
assigned_to = relationship("User", foreign_keys=[assigned_to_user_id])
|
|
acknowledged_by = relationship("User", foreign_keys=[acknowledged_by_user_id])
|
|
resolved_by = relationship("User", foreign_keys=[resolved_by_user_id])
|
|
|