henriqueatila/golang-gin-best-practices / skills/golang-gin-architect
golang-gin-architect
VerifiedSoftware architect for Go Gin APIs. Use when making architecture decisions, evaluating complexity, designing systems, choosing patterns, or coordinating across gin skills.
references/messaging-rabbitmq-producer.md
View on GitHub# Messaging — Queue Declaration Helper and Producer Pattern
Companion to `messaging-rabbitmq-connection.md` (connection factory, when to use messaging).
---
## Queue Declaration Helper
```go
// pkg/messaging/topology.go
type QueueOpts struct {
Name string
Durable bool
AutoDelete bool
DLX string // dead letter exchange name (empty = no DLX)
}
func DeclareQueue(ch *amqp.Channel, opts QueueOpts) (amqp.Queue, error) {
args := amqp.Table{}
if opts.DLX != "" {
args["x-dead-letter-exchange"] = opts.DLX
}
q, err := ch.QueueDeclare(opts.Name, opts.Durable, opts.AutoDelete, false, false, args)
if err != nil {
return amqp.Queue{}, fmt.Errorf("DeclareQueue %q: %w", opts.Name, err)
}
return q, nil
}
```
Always declare queues/exchanges idempotently (same arguments on every startup). RabbitMQ errors on redeclare with different settings.
---
## Producer Pattern
Publish from the service layer, never directly from Gin handlers.
```go
// pkg/messaging/producer.go
type Producer struct {
conn *Connection
logger *slog.Logger
}
func NewProducer(conn *Connection, logger *slog.Logger) *Producer {
return &Producer{conn: conn, logger: logger}
}
func (p *Producer) Publish(ctx context.Context, exchange, routingKey string, payload any) error {
body, err := json.Marshal(payload)
if err != nil {
return fmt.Errorf("producer.Publish marshal: %w", err)
}
ch, err := p.conn.Channel()
if err != nil {
return fmt.Errorf("producer.Publish channel: %w", err)
}
defer ch.Close()
msgID := uuid.NewString()
msg := amqp.Publishing{
ContentType: "application/json",
DeliveryMode: amqp.Persistent,
MessageId: msgID,
Timestamp: time.Now().UTC(),
Body: body,
}
if err := ch.PublishWithContext(ctx, exchange, routingKey, false, false, msg); err != nil {
return fmt.Errorf("producer.Publish: %w", err)
}
p.logger.InfoContext(ctx, "message published",
"exchange", exchange, "routing_key", routingKey, "message_id", msgID)
return nil
}
```
Calling from a service:
```go
func (s *Service) SendWelcomeEmail(ctx context.Context, userID, email string) error {
payload := map[string]string{"user_id": userID, "email": email, "type": "welcome"}
return s.producer.Publish(ctx, "", "email.send", payload)
}
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |