feat(umind): el agente programa recordatorios, y solo para su dueño

"Avisame el 15 de marzo que vence la póliza de Acme, y todos los años" queda
programado desde la conversación, visible y cancelable en el panel. Tres tools:
programar, listar, cancelar.

El aviso vuelve por donde se pidió — Telegram a ese chat, correo a esa casilla
— o al dueño del espacio por correo y campanita. Nunca a una dirección que
dicte la conversación: eso sería un cañón de spam con destinatario libre.

Y las tools de aviso solo se le OFRECEN al modelo cuando la sesión es interna:
el chat de prueba del panel (que corre autenticado) o un canal marcado como
línea privada del dueño. En el widget público escribe cualquiera, y cualquiera
no puede programarle recordatorios ni gastarle el plan a otro. El gate está en
dos capas: la tool no se declara, y si igual la pide, el ejecutor la rechaza.

Tres detalles que se pagan una sola vez:
- El cron corre en memoria del proceso, sin lock distribuido: con dos
  instancias cada aviso saldría dos veces. El reclamo es un UPDATE condicional
  — la base ya es el árbitro, no hace falta traer otro.
- Si el servidor estuvo caído, una repetición diaria se saltea los ciclos
  perdidos en vez de disparar diez avisos viejos de golpe.
- Un fallo de SMTP devuelve el aviso a pendiente: una caída de correo no puede
  perder un vencimiento de póliza.

Una fecha sin hora se entrega a las 9, no a medianoche, que es cuando nadie
mira el teléfono.

De paso: los archivos de los espacios uMind nunca se sirven por el estático de
/uploads. El guard genérico solo sabe si hay sesión de panel, no de quién es el
archivo — salen por su endpoint, que sí valida propiedad. Cerrado por
construcción y no por acordarse.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Lizandro Guarnizo
2026-08-24 21:32:48 -05:00
co-authored by Claude Opus 5
parent 9da2a057f2
commit b2e2e83fe8
30 changed files with 757 additions and 144 deletions
+54
View File
@@ -0,0 +1,54 @@
package services
import (
"testing"
"github.com/sujit-baniya/fiber-boilerplate/pkg/models"
"time"
)
func TestParsearFechaAviso(t *testing.T) {
casos := []struct {
entrada string
hora int
ok bool
}{
{"2026-03-15 09:00", 9, true},
{"2026-03-15T09:00", 9, true},
{"2026-03-15T09:00:00Z", 9, true},
// Fecha sola: se entrega a las 9, no a medianoche — a medianoche
// nadie mira el teléfono y el recordatorio se pierde.
{"2026-03-15", 9, true},
{"el 15 de marzo", 0, false},
{"", 0, false},
}
for _, c := range casos {
got, err := ParsearFechaAviso(c.entrada)
if c.ok != (err == nil) {
t.Errorf("ParsearFechaAviso(%q): err=%v, esperaba ok=%v", c.entrada, err, c.ok)
continue
}
if c.ok && got.Hour() != c.hora {
t.Errorf("ParsearFechaAviso(%q) dio hora %d, esperaba %d", c.entrada, got.Hour(), c.hora)
}
}
}
// La repetición corre la fecha hacia adelante y, si el servidor estuvo caído,
// se saltea los ciclos perdidos en vez de disparar una ráfaga de avisos viejos.
func TestSiguienteFechaSalteaCiclosPerdidos(t *testing.T) {
viejo := time.Now().AddDate(0, 0, -10)
proximo := models.SiguienteFechaAviso(viejo, "diario")
for !proximo.After(time.Now()) {
proximo = models.SiguienteFechaAviso(proximo, "diario")
}
if !proximo.After(time.Now()) {
t.Fatal("la fecha reprogramada quedó en el pasado")
}
if proximo.After(time.Now().AddDate(0, 0, 2)) {
t.Errorf("saltó demasiado lejos: %v", proximo)
}
if !models.SiguienteFechaAviso(viejo, "").IsZero() {
t.Error("sin repetición no debería haber próxima fecha")
}
}