letschatty 0.4.484__tar.gz → 0.4.485__tar.gz

{letschatty-0.4.484 → letschatty-0.4.485}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: letschatty
-Version: 0.4.484
+Version: 0.4.485
 Summary: Models and custom classes to work across the Chattyverse
 License: MIT
 Author: Axel

{letschatty-0.4.484 → letschatty-0.4.485}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "letschatty"
-version = "0.4.484"
+version = "0.4.485"
 description = "Models and custom classes to work across the Chattyverse"
 authors = ["Axel <axel@letschatty.com>"]
 license = "MIT"

{letschatty-0.4.484 → letschatty-0.4.485}/src/letschatty/models/company/assets/__init__.py

@@ -7,4 +7,5 @@ from .sale import *
 from .contact_point import *
 from .ai_agents_v2.chatty_ai_agent import *
 from .workflow_execution import *
-from .notification import *
+from .notification import *
+from .recordatorio import *

letschatty-0.4.485/src/letschatty/models/company/assets/recordatorio.py

@@ -0,0 +1,83 @@
+"""Un recordatorio: algo que hay que hacer en un chat, con fecha.
+
+No es un highlight —que es una nota y se queda quieta— ni un mensaje programado —que le
+habla al cliente—. Este le habla al agente: vence, se resuelve, y puede tener un
+responsable.
+
+La visibilidad NO vive acá. Se calcula al leer, contra el chat: quien puede ver el chat ve
+sus recordatorios, más el responsable y el creador, que siempre ven lo suyo. Guardar acá
+una copia del agente del chat se desincronizaría en cuanto el chat se reasigna —y en las
+empresas con APB el agente cambia con cada apertura.
+"""
+from __future__ import annotations
+
+from datetime import datetime, timezone
+from typing import Any, ClassVar, Optional
+
+from pydantic import Field, field_validator
+
+from ...base_models.chatty_asset_model import ChattyAssetPreview, CompanyAssetModel
+from ...utils.types import StrObjectId
+
+
+class RecordatorioPreview(ChattyAssetPreview):
+    titulo: str
+    remind_at: datetime
+    chat_id: StrObjectId
+    resolved_at: Optional[datetime] = Field(default=None)
+
+    @classmethod
+    def get_projection(cls) -> dict[str, Any]:
+        return super().get_projection() | {
+            "titulo": 1, "remind_at": 1, "chat_id": 1, "resolved_at": 1,
+        }
+
+    @classmethod
+    def from_asset(cls, asset: "Recordatorio") -> "RecordatorioPreview":
+        return cls(
+            _id=asset.id,
+            name=asset.titulo,
+            company_id=asset.company_id,
+            created_at=asset.created_at,
+            updated_at=asset.updated_at,
+            titulo=asset.titulo,
+            remind_at=asset.remind_at,
+            chat_id=asset.chat_id,
+            resolved_at=asset.resolved_at,
+            deleted_at=asset.deleted_at,
+        )
+
+
+class Recordatorio(CompanyAssetModel):
+    titulo: str = Field(description="Qué hay que hacer. 'Llamar a Pepe'")
+    detalle: Optional[str] = Field(default=None, description="Por qué, o qué decirle. Se lee cuando el recordatorio salta, días después")
+    remind_at: datetime = Field(description="Cuándo vence, en UTC")
+    chat_id: StrObjectId = Field(frozen=True, description="El chat del que cuelga. Obligatorio: define quién lo ve, y en v1 no existen los recordatorios sueltos")
+    assignee_id: Optional[StrObjectId] = Field(default=None, description="Responsable. Nulo significa 'sin responsable': lo atiende quien tenga el chat")
+    created_by: StrObjectId = Field(frozen=True, description="Quién lo pidió. Siempre presente, aunque no haya responsable")
+    resolved_at: Optional[datetime] = Field(default=None)
+    resolved_by: Optional[StrObjectId] = Field(default=None)
+
+    preview_class: ClassVar[type[RecordatorioPreview]] = RecordatorioPreview
+
+    @field_validator("remind_at", "resolved_at", mode="before")
+    @classmethod
+    def _a_utc(cls, v: object) -> object:
+        # Mongo devuelve datetimes naive. Sin esto, comparar con `now(UTC)` para saber si
+        # venció explota con "can't compare offset-naive and offset-aware".
+        if isinstance(v, datetime):
+            return v.replace(tzinfo=timezone.utc) if v.tzinfo is None else v.astimezone(timezone.utc)
+        return v
+
+    @property
+    def resuelto(self) -> bool:
+        return self.resolved_at is not None
+
+    @property
+    def vencido(self) -> bool:
+        """Se calcula, no se guarda.
+
+        Un estado guardado necesitaría a alguien que lo escriba al vencer —el schedule que
+        el diseño descarta— y se desincronizaría en cuanto alguien reprograma.
+        """
+        return not self.resuelto and self.remind_at <= datetime.now(timezone.utc)