Реализация rule-engine-service: RabbitMQ → правила из PostgreSQL → gRPC

Слушает telemetry.new_reading (ручной ack/nack, реквизишн только при
транспортных ошибках gRPC), кэширует активные automation_rules в памяти
с периодическим обновлением из PostgreSQL (JOIN с devices — резолвит
внутренние ID в external_id, которым оперируют MQTT/Redis/gRPC). Условия
правил (>,<,>=,<=,=,!=) оцениваются обобщённо, без привязки к конкретным
типам устройств. При срабатывании вызывает device-control-service по gRPC
и публикует automation.rule_triggered в RabbitMQ.

Проверено сквозным тестом через docker compose на полном пайплайне:
mosquitto_pub → ingest-service (ClickHouse + telemetry.new_reading) →
rule-engine-service (совпадение правила) → device-control-service (gRPC →
Redis desired_state + MQTT-команда) → automation.rule_triggered. Показание
ниже порога проверено отдельно — правило корректно не срабатывает.
This commit is contained in:
2026-07-26 21:18:59 +05:00
parent 3eb84aae6c
commit abc83faf05
20 changed files with 1334 additions and 10 deletions
@@ -0,0 +1,62 @@
// Package rabbitmq consumes ingest-service's "new reading" events and
// publishes rule-trigger events for notification-service. One connection is
// shared, with separate channels for consuming and publishing, since that's
// the amqp best practice (a channel is not meant to be used concurrently for
// unrelated flows).
package rabbitmq
import (
"fmt"
amqp "github.com/rabbitmq/amqp091-go"
)
const (
NewReadingQueue = "telemetry.new_reading" // declared by ingest-service; declared here too, idempotently
RuleTriggeredQueue = "automation.rule_triggered"
)
type Client struct {
conn *amqp.Connection
consumeCh *amqp.Channel
publishCh *amqp.Channel
}
func Connect(url string) (*Client, error) {
conn, err := amqp.Dial(url)
if err != nil {
return nil, fmt.Errorf("dial rabbitmq: %w", err)
}
consumeCh, err := conn.Channel()
if err != nil {
conn.Close()
return nil, fmt.Errorf("open consume channel: %w", err)
}
// Process one reading at a time: simple, demonstrable backpressure —
// the next delivery isn't sent until the current one is acked/nacked.
if err := consumeCh.Qos(1, 0, false); err != nil {
conn.Close()
return nil, fmt.Errorf("set qos: %w", err)
}
if _, err := consumeCh.QueueDeclare(NewReadingQueue, true, false, false, false, nil); err != nil {
conn.Close()
return nil, fmt.Errorf("declare queue %s: %w", NewReadingQueue, err)
}
publishCh, err := conn.Channel()
if err != nil {
conn.Close()
return nil, fmt.Errorf("open publish channel: %w", err)
}
if _, err := publishCh.QueueDeclare(RuleTriggeredQueue, true, false, false, false, nil); err != nil {
conn.Close()
return nil, fmt.Errorf("declare queue %s: %w", RuleTriggeredQueue, err)
}
return &Client{conn: conn, consumeCh: consumeCh, publishCh: publishCh}, nil
}
func (c *Client) Close() error {
return c.conn.Close()
}
@@ -0,0 +1,65 @@
package rabbitmq
import (
"context"
"encoding/json"
"fmt"
"time"
)
// ReadingEvent mirrors ingest-service's newReadingEvent wire format.
type ReadingEvent struct {
DeviceID string `json:"device_id"`
ZoneID string `json:"zone_id"`
SensorType string `json:"sensor_type"`
Value float64 `json:"value"`
RecordedAt time.Time `json:"recorded_at"`
}
// HandleResult tells ConsumeReadings how to settle a delivery.
type HandleResult int
const (
Ack HandleResult = iota // processed successfully
NackRequeue // transient failure (e.g. gRPC unreachable) — try again later
NackDiscard // permanent failure (e.g. bad data) — retrying won't help
)
// Handler processes one reading event and decides how it should be settled.
type Handler func(ctx context.Context, event ReadingEvent) HandleResult
// ConsumeReadings blocks, delivering messages to handler, until ctx is
// cancelled or the delivery channel closes (e.g. connection lost).
func (c *Client) ConsumeReadings(ctx context.Context, handler Handler) error {
deliveries, err := c.consumeCh.ConsumeWithContext(ctx, NewReadingQueue, "", false, false, false, false, nil)
if err != nil {
return fmt.Errorf("consume %s: %w", NewReadingQueue, err)
}
for {
select {
case <-ctx.Done():
return nil
case d, ok := <-deliveries:
if !ok {
return fmt.Errorf("delivery channel for %s closed", NewReadingQueue)
}
var event ReadingEvent
if err := json.Unmarshal(d.Body, &event); err != nil {
// Poison message: no amount of retrying fixes malformed JSON.
_ = d.Nack(false, false)
continue
}
switch handler(ctx, event) {
case Ack:
_ = d.Ack(false)
case NackRequeue:
_ = d.Nack(false, true)
case NackDiscard:
_ = d.Nack(false, false)
}
}
}
}
@@ -0,0 +1,48 @@
package rabbitmq
import (
"context"
"encoding/json"
"fmt"
"time"
amqp "github.com/rabbitmq/amqp091-go"
)
type ruleTriggeredEvent struct {
RuleID int64 `json:"rule_id"`
ZoneID int64 `json:"zone_id"`
DeviceID string `json:"device_id"`
ActionType string `json:"action_type"`
Success bool `json:"success"`
Error string `json:"error,omitempty"`
At time.Time `json:"at"`
}
// PublishRuleTriggered emits one event per rule match+dispatch attempt, so
// notification-service can (eventually) alert on it.
func (c *Client) PublishRuleTriggered(ctx context.Context, ruleID, zoneID int64, deviceID, actionType string, success bool, errMsg string) error {
body, err := json.Marshal(ruleTriggeredEvent{
RuleID: ruleID,
ZoneID: zoneID,
DeviceID: deviceID,
ActionType: actionType,
Success: success,
Error: errMsg,
At: time.Now(),
})
if err != nil {
return fmt.Errorf("marshal event: %w", err)
}
err = c.publishCh.PublishWithContext(ctx, "", RuleTriggeredQueue, false, false, amqp.Publishing{
ContentType: "application/json",
DeliveryMode: amqp.Persistent,
Timestamp: time.Now(),
Body: body,
})
if err != nil {
return fmt.Errorf("publish rule triggered event for rule %d: %w", ruleID, err)
}
return nil
}