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
+29 -6
View File
@@ -9,13 +9,17 @@ import (
type ProyectoTicket struct {
gorm.Model
ProyectoID uint `json:"proyecto_id" gorm:"column:proyecto_id;index"`
PortalUserID uint `json:"portal_user_id" gorm:"column:portal_user_id;index"`
ProyectoID *uint `json:"proyecto_id" gorm:"column:proyecto_id;index"`
PortalUserID *uint `json:"portal_user_id" gorm:"column:portal_user_id;index"`
AutorNombre string `json:"autor_nombre" gorm:"column:autor_nombre"`
EmailFrom string `json:"email_from" gorm:"column:email_from;size:255"`
Titulo string `json:"titulo" gorm:"column:titulo"`
Descripcion string `json:"descripcion" gorm:"column:descripcion;type:text"`
Estado string `json:"estado" gorm:"column:estado;default:'abierto'"` // abierto|en_progreso|resuelto|cerrado
Prioridad string `json:"prioridad" gorm:"column:prioridad;default:'media'"` // baja|media|alta|urgente
Origen string `json:"origen" gorm:"column:origen;default:'portal'"` // portal|email
AsignadoA *uint `json:"asignado_a" gorm:"column:asignado_a;index"`
Asignado *Users `json:"asignado" gorm:"foreignKey:AsignadoA"`
Mensajes []TicketMensaje `json:"mensajes" gorm:"foreignKey:TicketID"`
}
@@ -39,13 +43,13 @@ func (TicketMensaje) TableName() string { return "ticket_mensajes" }
func GetTicketsByProyecto(proyectoID uint) ([]ProyectoTicket, error) {
var items []ProyectoTicket
err := app.Http.Database.DB.Where("proyecto_id = ?", proyectoID).
Preload("Mensajes").Order("created_at DESC").Find(&items).Error
Preload("Mensajes").Preload("Asignado").Order("created_at DESC").Find(&items).Error
return items, err
}
func GetTicketByID(id uint) (*ProyectoTicket, error) {
var item ProyectoTicket
err := app.Http.Database.DB.Preload("Mensajes").First(&item, id).Error
err := app.Http.Database.DB.Preload("Mensajes").Preload("Asignado").First(&item, id).Error
return &item, err
}
@@ -65,13 +69,13 @@ func CreateTicketMensaje(m *TicketMensaje) error {
func GetTicketsByPortalUser(portalUserID uint) ([]ProyectoTicket, error) {
var items []ProyectoTicket
err := app.Http.Database.DB.Where("portal_user_id = ?", portalUserID).
Preload("Mensajes").Order("created_at DESC").Find(&items).Error
Preload("Mensajes").Preload("Asignado").Order("created_at DESC").Find(&items).Error
return items, err
}
func GetAllTickets(estado string) ([]ProyectoTicket, error) {
var items []ProyectoTicket
db := app.Http.Database.DB.Preload("Mensajes").Order("created_at DESC")
db := app.Http.Database.DB.Preload("Mensajes").Preload("Asignado").Order("created_at DESC")
if estado != "" && estado != "todos" {
db = db.Where("estado = ?", estado)
}
@@ -79,6 +83,25 @@ func GetAllTickets(estado string) ([]ProyectoTicket, error) {
return items, err
}
func AssignedToUser(userID uint) error {
return app.Http.Database.DB.Model(&ProyectoTicket{}).
Where("asignado_a IS NULL OR asignado_a = 0").
Update("asignado_a", userID).Error
}
func CountTicketsByEstado() map[string]int64 {
result := map[string]int64{}
type row struct{ Estado string; Count int64 }
var rows []row
app.Http.Database.DB.Model(&ProyectoTicket{}).
Select("estado, count(*) as count").
Group("estado").Find(&rows)
for _, r := range rows {
result[r.Estado] = r.Count
}
return result
}
// MarkTicketMessagesReadByPortal marca como leídos todos los mensajes de admin
// de un ticket para el portal user (cuando abre el ticket).
func MarkTicketMessagesReadByPortal(ticketID uint) error {
+91
View File
@@ -0,0 +1,91 @@
package models
import (
"testing"
)
func TestProyectoTicketTableName(t *testing.T) {
if got := (ProyectoTicket{}).TableName(); got != "proyecto_tickets" {
t.Errorf("TableName() = %q, want %q", got, "proyecto_tickets")
}
}
func TestTicketMensajeTableName(t *testing.T) {
if got := (TicketMensaje{}).TableName(); got != "ticket_mensajes" {
t.Errorf("TableName() = %q, want %q", got, "ticket_mensajes")
}
}
func TestProyectoTicketDefaults(t *testing.T) {
ticket := ProyectoTicket{
Titulo: "Test ticket",
Descripcion: "Descripción",
AutorNombre: "Cliente",
}
if ticket.Estado != "" {
t.Errorf("Estado debe ser vacío por defecto (GORM default), got %q", ticket.Estado)
}
if ticket.Prioridad != "" {
t.Errorf("Prioridad debe ser vacía por defecto (GORM default), got %q", ticket.Prioridad)
}
if ticket.Origen != "" {
t.Errorf("Origen debe ser vacío por defecto (GORM default), got %q", ticket.Origen)
}
if ticket.ProyectoID != nil {
t.Errorf("ProyectoID debe ser nil por defecto, got %v", ticket.ProyectoID)
}
if ticket.PortalUserID != nil {
t.Errorf("PortalUserID debe ser nil por defecto, got %v", ticket.PortalUserID)
}
}
func TestProyectoTicketEmailFrom(t *testing.T) {
ticket := ProyectoTicket{
EmailFrom: "cliente@ejemplo.com",
AutorNombre: "Cliente",
Titulo: "Soporte",
Origen: "email",
}
if ticket.EmailFrom != "cliente@ejemplo.com" {
t.Errorf("EmailFrom = %q, want %q", ticket.EmailFrom, "cliente@ejemplo.com")
}
if ticket.Origen != "email" {
t.Errorf("Origen = %q, want %q", ticket.Origen, "email")
}
}
func TestProyectoTicketAsignado(t *testing.T) {
uid := uint(42)
ticket := ProyectoTicket{
AsignadoA: &uid,
}
if ticket.AsignadoA == nil {
t.Fatal("AsignadoA debe ser no nil")
}
if *ticket.AsignadoA != 42 {
t.Errorf("AsignadoA = %d, want %d", *ticket.AsignadoA, 42)
}
}
func TestProyectoTicketAsignadoNil(t *testing.T) {
ticket := ProyectoTicket{}
if ticket.AsignadoA != nil {
t.Errorf("AsignadoA debe ser nil por defecto, got %v", *ticket.AsignadoA)
}
}
func TestTicketMensajeDefaults(t *testing.T) {
msg := TicketMensaje{
TicketID: 1,
Contenido: "Hola",
AutorNombre: "Admin",
}
if msg.EsAdmin {
t.Error("EsAdmin debe ser false por defecto")
}
if msg.LeidoPortal {
t.Error("LeidoPortal debe ser false por defecto")
}
}
// CountTicketsByEstado requiere DB real — probado en integration tests
+39
View File
@@ -0,0 +1,39 @@
package models
import (
"github.com/sujit-baniya/fiber-boilerplate/app"
"gorm.io/gorm"
)
type SoporteWebhookConfig struct {
gorm.Model
Activo bool `json:"activo" gorm:"column:activo;default:true"`
Nombre string `json:"nombre" gorm:"column:nombre;size:100"`
Provider string `json:"provider" gorm:"column:provider;size:50;default:'sendgrid'"` // sendgrid|mailgun|generic
ApiKey string `json:"api_key" gorm:"column:api_key;size:255"`
EmailDestino string `json:"email_destino" gorm:"column:email_destino;size:255"` // ej: soporte@u-s.app
ResponderAuto bool `json:"responder_auto" gorm:"column:responder_auto;default:true"`
MensajeAuto string `json:"mensaje_auto" gorm:"column:mensaje_auto;type:text"`
AsignarA *uint `json:"asignar_a" gorm:"column:asignar_a;index"` // auto-asignar tickets a este user
}
func (SoporteWebhookConfig) TableName() string { return "soporte_webhook_config" }
func GetSoporteWebhookActivo() (*SoporteWebhookConfig, error) {
var item SoporteWebhookConfig
err := app.Http.Database.DB.Where("activo = ?", true).First(&item).Error
return &item, err
}
func GetAllSoporteWebhookConfigs() ([]SoporteWebhookConfig, error) {
var items []SoporteWebhookConfig
err := app.Http.Database.DB.Order("created_at DESC").Find(&items).Error
return items, err
}
func SaveSoporteWebhookConfig(s *SoporteWebhookConfig) error {
if s.ID > 0 {
return app.Http.Database.DB.Model(s).Updates(s).Error
}
return app.Http.Database.DB.Create(s).Error
}
+58
View File
@@ -0,0 +1,58 @@
package models
import (
"testing"
)
func TestSoporteWebhookConfigTableName(t *testing.T) {
if got := (SoporteWebhookConfig{}).TableName(); got != "soporte_webhook_config" {
t.Errorf("TableName() = %q, want %q", got, "soporte_webhook_config")
}
}
func TestSoporteWebhookConfigDefaults(t *testing.T) {
cfg := SoporteWebhookConfig{
Nombre: "Test",
Provider: "sendgrid",
}
if cfg.Provider != "sendgrid" {
t.Errorf("Provider = %q, want %q", cfg.Provider, "sendgrid")
}
if cfg.EmailDestino != "" {
t.Errorf("EmailDestino debe ser vacío, got %q", cfg.EmailDestino)
}
}
func TestSoporteWebhookConfigAutoResponder(t *testing.T) {
cfg := SoporteWebhookConfig{
Nombre: "Soporte",
ResponderAuto: true,
MensajeAuto: "Gracias por contactarnos",
}
if !cfg.ResponderAuto {
t.Error("ResponderAuto debe ser true")
}
if cfg.MensajeAuto != "Gracias por contactarnos" {
t.Errorf("MensajeAuto = %q, want %q", cfg.MensajeAuto, "Gracias por contactarnos")
}
}
func TestSoporteWebhookConfigAsignarA(t *testing.T) {
uid := uint(5)
cfg := SoporteWebhookConfig{
AsignarA: &uid,
}
if cfg.AsignarA == nil {
t.Fatal("AsignarA debe ser no nil")
}
if *cfg.AsignarA != 5 {
t.Errorf("AsignarA = %d, want %d", *cfg.AsignarA, 5)
}
}
func TestSoporteWebhookConfigAsignarANil(t *testing.T) {
cfg := SoporteWebhookConfig{}
if cfg.AsignarA != nil {
t.Errorf("AsignarA debe ser nil por defecto, got %v", *cfg.AsignarA)
}
}