refactored notificatoin / tgsettle responsibility boundaries

api/proto/object_updated.proto

@@ -2,7 +2,11 @@ syntax = "proto3";
 
 option go_package = "github.com/tech/sendico/pkg/generated/gmessaging";
 
+// ObjectUpdatedEvent is a generic event published when any domain object is
+// modified, carrying the object reference and the acting user.
 message ObjectUpdatedEvent {
+    // object_ref is the unique reference of the updated object.
     string object_ref = 1;
+    // actor_account_ref identifies the account that performed the update.
     string actor_account_ref = 2;
 }