feat: área de soporte con webhook de correo y asignación de tickets

This commit is contained in:
Lizandro Guarnizo
2026-07-28 23:39:03 -05:00
parent 772a4a5656
commit 28affb5a55
16 changed files with 957 additions and 34 deletions
+8 -6
View File
@@ -322,8 +322,8 @@ func PortalCrearTicket(c *fiber.Ctx) error {
}
t := &models.ProyectoTicket{
ProyectoID: proy.ID,
PortalUserID: u.ID,
ProyectoID: &proy.ID,
PortalUserID: &u.ID,
AutorNombre: u.Nombre,
Titulo: req.Titulo,
Descripcion: req.Descripcion,
@@ -361,7 +361,7 @@ func PortalResponderTicket(c *fiber.Ctx) error {
if err != nil {
return c.Status(404).JSON(fiber.Map{"error": "Ticket no encontrado"})
}
if ticket.PortalUserID != u.ID {
if ticket.PortalUserID == nil || *ticket.PortalUserID != u.ID {
return c.Status(403).JSON(fiber.Map{"error": "Sin acceso"})
}
msg := &models.TicketMensaje{
@@ -375,8 +375,10 @@ func PortalResponderTicket(c *fiber.Ctx) error {
}
go func() {
proyNombre := ""
if proy, err := models.GetProyectoByID(ticket.ProyectoID); err == nil {
proyNombre = proy.Nombre
if ticket.ProyectoID != nil {
if proy, err := models.GetProyectoByID(*ticket.ProyectoID); err == nil {
proyNombre = proy.Nombre
}
}
services.DispatchTicketRespuestaCliente(ticket, req.Contenido, proyNombre)
}()
@@ -548,7 +550,7 @@ func PortalMarcarTicketLeido(c *fiber.Ctx) error {
if err != nil || ticket == nil {
return c.Status(404).JSON(fiber.Map{"error": "ticket no encontrado"})
}
if ticket.PortalUserID != u.ID {
if ticket.PortalUserID == nil || *ticket.PortalUserID != u.ID {
return c.Status(403).JSON(fiber.Map{"error": "sin permiso"})
}
_ = models.MarkTicketMessagesReadByPortal(uint(ticketID))
+4 -2
View File
@@ -578,8 +578,10 @@ func AdminResponderTicket(c *fiber.Ctx) error {
return
}
proyNombre := ""
if proy, err := models.GetProyectoByID(ticket.ProyectoID); err == nil {
proyNombre = proy.Nombre
if ticket.ProyectoID != nil {
if proy, err := models.GetProyectoByID(*ticket.ProyectoID); err == nil {
proyNombre = proy.Nombre
}
}
services.DispatchTicketRespuestaAdmin(ticket, req.Contenido, proyNombre)
}()
+261
View File
@@ -0,0 +1,261 @@
package controllers
import (
"log"
"strconv"
"strings"
"github.com/gofiber/fiber/v2"
"github.com/sujit-baniya/fiber-boilerplate/app"
"github.com/sujit-baniya/fiber-boilerplate/pkg/models"
"github.com/sujit-baniya/fiber-boilerplate/pkg/services"
)
// ─── Webhook de correo entrante ───────────────────────────────────────────────
// Recibe notificaciones de SendGrid, Mailgun, etc.
// POST /webhooks/soporte/:provider
// provider: sendgrid, mailgun, generic
func SoporteWebhook(c *fiber.Ctx) error {
provider := c.Params("provider", "generic")
cfg, err := models.GetSoporteWebhookActivo()
if err != nil {
log.Printf("[SoporteWebhook] Sin config activa: %v", err)
return c.Status(200).JSON(fiber.Map{"ok": false, "error": "sin config"})
}
var emails []struct {
From string `json:"from" form:"from"`
Subject string `json:"subject" form:"subject"`
Text string `json:"text" form:"text"`
Html string `json:"html" form:"html"`
Sender string `json:"sender" form:"sender"`
FromName string `json:"from_name" form:"from_name"`
}
switch provider {
case "sendgrid":
var sg struct {
From string `json:"from"`
Subject string `json:"subject"`
Text string `json:"text"`
Html string `json:"html"`
Sender string `json:"sender"`
FromName string `json:"from_name"`
}
if err := c.BodyParser(&sg); err != nil {
return c.Status(200).JSON(fiber.Map{"ok": false, "error": "body inválido"})
}
emails = append(emails, struct {
From string `json:"from" form:"from"`
Subject string `json:"subject" form:"subject"`
Text string `json:"text" form:"text"`
Html string `json:"html" form:"html"`
Sender string `json:"sender" form:"sender"`
FromName string `json:"from_name" form:"from_name"`
}{From: sg.From, Subject: sg.Subject, Text: sg.Text, Html: sg.Html, Sender: sg.Sender, FromName: sg.FromName})
case "mailgun":
var mg struct {
From string `form:"from"`
Subject string `form:"subject"`
Text string `form:"body-plain"`
Html string `form:"body-html"`
Sender string `form:"sender"`
FromName string `form:"from_name"`
}
if err := c.BodyParser(&mg); err != nil {
return c.Status(200).JSON(fiber.Map{"ok": false})
}
emails = append(emails, struct {
From string `json:"from" form:"from"`
Subject string `json:"subject" form:"subject"`
Text string `json:"text" form:"text"`
Html string `json:"html" form:"html"`
Sender string `json:"sender" form:"sender"`
FromName string `json:"from_name" form:"from_name"`
}{
From: mg.From, Subject: mg.Subject, Text: mg.Text,
Html: mg.Html, Sender: mg.Sender, FromName: mg.FromName,
})
default:
var generic struct {
From string `json:"from"`
Subject string `json:"subject"`
Text string `json:"text"`
Html string `json:"html"`
}
if err := c.BodyParser(&generic); err != nil {
return c.Status(200).JSON(fiber.Map{"ok": false})
}
emails = append(emails, struct {
From string `json:"from" form:"from"`
Subject string `json:"subject" form:"subject"`
Text string `json:"text" form:"text"`
Html string `json:"html" form:"html"`
Sender string `json:"sender" form:"sender"`
FromName string `json:"from_name" form:"from_name"`
}{
From: generic.From, Subject: generic.Subject, Text: generic.Text, Html: generic.Html,
})
}
for _, e := range emails {
if e.From == "" || e.Subject == "" {
continue
}
fromEmail := extractEmail(e.From)
fromName := e.FromName
if fromName == "" {
fromName = extractName(e.From)
}
if fromName == "" {
fromName = fromEmail
}
contenido := e.Text
if contenido == "" {
contenido = e.Html
}
contenido = strings.TrimSpace(contenido)
if len(contenido) > 5000 {
contenido = contenido[:5000]
}
ticket := &models.ProyectoTicket{
AutorNombre: fromName,
EmailFrom: fromEmail,
Titulo: e.Subject,
Descripcion: contenido,
Estado: "abierto",
Origen: "email",
}
if cfg.AsignarA != nil {
ticket.AsignadoA = cfg.AsignarA
}
if err := models.CreateProyectoTicket(ticket); err != nil {
log.Printf("[SoporteWebhook] Error creando ticket: %v", err)
continue
}
log.Printf("[SoporteWebhook] Ticket #%d creado desde email (%s): %s", ticket.ID, fromEmail, e.Subject)
// Notificar admin
services.SendSoporteNotifAdmin(ticket)
// Auto-responder
if cfg.ResponderAuto {
services.SendSoporteAutoRespuesta(ticket)
}
}
return c.Status(200).JSON(fiber.Map{"ok": true})
}
// ─── Asignar ticket a usuario ─────────────────────────────────────────────────
// PUT /app/tickets/:ticketID/asignar
func AsignarTicket(c *fiber.Ctx) error {
ticketID, _ := strconv.ParseUint(c.Params("ticketID"), 10, 32)
type Req struct{ AsignadoID uint `json:"asignado_id"` }
var req Req
if err := c.BodyParser(&req); err != nil {
return c.Status(400).JSON(fiber.Map{"error": "body inválido"})
}
if err := app.Http.Database.DB.Model(&models.ProyectoTicket{}).
Where("id = ?", ticketID).
Update("asignado_a", req.AsignadoID).Error; err != nil {
return c.Status(500).JSON(fiber.Map{"error": err.Error()})
}
return c.JSON(fiber.Map{"ok": true})
}
// ─── Listar admins para asignación ────────────────────────────────────────────
// GET /app/tickets/admins
func GetSoporteAdmins(c *fiber.Ctx) error {
var admins []models.Users
app.Http.Database.DB.Where("is_admin = ?", true).
Or("role_id IN (SELECT id FROM roles WHERE name = 'soporte' OR name = 'admin')").
Find(&admins)
type item struct {
ID uint `json:"id"`
Name string `json:"name"`
}
result := make([]item, 0)
for _, a := range admins {
result = append(result, item{ID: a.ID, Name: a.Name})
}
return c.JSON(result)
}
// ─── Configuración del webhook ────────────────────────────────────────────────
func SoporteWebhookConfigPage(c *fiber.Ctx) error {
cfg, _ := models.GetSoporteWebhookActivo()
return c.Render("soporte_webhook", fiber.Map{
"user": c.Locals("user"),
"modules": c.Locals("userModules"),
"cfg": cfg,
}, "layouts/main")
}
func GetSoporteWebhookConfig(c *fiber.Ctx) error {
cfg, err := models.GetSoporteWebhookActivo()
if err != nil {
return c.JSON(fiber.Map{"data": nil})
}
return c.JSON(fiber.Map{"data": cfg})
}
func SaveSoporteWebhookConfig(c *fiber.Ctx) error {
type body struct {
ID uint `json:"id"`
Nombre string `json:"nombre"`
Provider string `json:"provider"`
ApiKey string `json:"api_key"`
EmailDestino string `json:"email_destino"`
ResponderAuto bool `json:"responder_auto"`
MensajeAuto string `json:"mensaje_auto"`
AsignarA *uint `json:"asignar_a"`
}
var b body
if err := c.BodyParser(&b); err != nil {
return c.Status(400).JSON(fiber.Map{"error": "body inválido"})
}
cfg := &models.SoporteWebhookConfig{
Nombre: b.Nombre,
Provider: b.Provider,
ApiKey: b.ApiKey,
EmailDestino: b.EmailDestino,
ResponderAuto: b.ResponderAuto,
MensajeAuto: b.MensajeAuto,
AsignarA: b.AsignarA,
Activo: true,
}
cfg.ID = b.ID
if err := models.SaveSoporteWebhookConfig(cfg); err != nil {
return c.Status(500).JSON(fiber.Map{"error": err.Error()})
}
return c.JSON(fiber.Map{"ok": true})
}
// ─── helpers ──────────────────────────────────────────────────────────────────
func extractEmail(s string) string {
s = strings.TrimSpace(s)
if idx := strings.LastIndex(s, "<"); idx >= 0 {
s = s[idx+1:]
}
if idx := strings.LastIndex(s, ">"); idx >= 0 {
s = s[:idx]
}
return strings.TrimSpace(s)
}
func extractName(s string) string {
s = strings.TrimSpace(s)
if idx := strings.Index(s, "<"); idx >= 0 {
return strings.TrimSpace(s[:idx])
}
return ""
}
@@ -0,0 +1,80 @@
package controllers
import (
"testing"
)
func TestExtractEmailSimple(t *testing.T) {
tests := []struct {
input string
want string
}{
{"user@example.com", "user@example.com"},
{"<user@example.com>", "user@example.com"},
{"John Doe <john@example.com>", "john@example.com"},
{"\"John Doe\" <john@example.com>", "john@example.com"},
{" spaced@example.com ", "spaced@example.com"},
{"", ""},
{"<onlybrackets>", "onlybrackets"},
}
for _, tt := range tests {
got := extractEmail(tt.input)
if got != tt.want {
t.Errorf("extractEmail(%q) = %q, want %q", tt.input, got, tt.want)
}
}
}
func TestExtractNameSimple(t *testing.T) {
tests := []struct {
input string
want string
}{
{"John Doe <john@example.com>", "John Doe"},
{"<user@example.com>", ""},
{"user@example.com", ""},
{" Spaces Here <spaces@example.com>", "Spaces Here"},
{"\"Quoted Name\" <q@example.com>", "\"Quoted Name\""},
{"", ""},
}
for _, tt := range tests {
got := extractName(tt.input)
if got != tt.want {
t.Errorf("extractName(%q) = %q, want %q", tt.input, got, tt.want)
}
}
}
func TestExtractEmailRealWorld(t *testing.T) {
inputs := []struct {
full string
mail string
name string
}{
{"María López <maria@example.com>", "maria@example.com", "María López"},
{"soporte@u-s.app", "soporte@u-s.app", ""},
{"Cliente Final <cliente+tag@dominio.co>", "cliente+tag@dominio.co", "Cliente Final"},
{"", "", ""},
}
for _, tt := range inputs {
gotMail := extractEmail(tt.full)
gotName := extractName(tt.full)
if gotMail != tt.mail {
t.Errorf("extractEmail(%q) = %q, want %q", tt.full, gotMail, tt.mail)
}
if gotName != tt.name {
t.Errorf("extractName(%q) = %q, want %q", tt.full, gotName, tt.name)
}
}
}
func TestExtractEmailEdgeCases(t *testing.T) {
// Formato RFC 5322 con nombre y ángulos
if got := extractEmail("a<b@c.com>"); got != "b@c.com" {
t.Errorf("extractEmail('a<b@c.com>') = %q, want 'b@c.com'", got)
}
// Múltiples brackets — usa el último par
if got := extractEmail("<a><b@c.com>"); got != "b@c.com" {
t.Errorf("extractEmail('<a><b@c.com>') = %q, want 'b@c.com'", got)
}
}