51 lines
2 KiB
Go
51 lines
2 KiB
Go
package domain
|
||
|
||
import (
|
||
"crypto/sha256"
|
||
"errors"
|
||
)
|
||
|
||
// ErrAlbumGroupReservationInvalid 表示相册分组预留缺少发送者、目标、
|
||
// random_id 或 proposed grouped_id。RPC 边界通常会更早拦截这些输入；
|
||
// domain/store 仍 fail-fast，避免坏绑定进入持久层。
|
||
var ErrAlbumGroupReservationInvalid = errors.New("album group reservation invalid")
|
||
|
||
// AlbumGroupReservationRequest 在任何相册 item 落库或上传媒体解析前，原子地把
|
||
// 一组 random_id 绑定到同一个 grouped_id。Peer 是幂等作用域的一部分：同一发送者
|
||
// 可以在不同会话中复用 random_id，而不会互相污染相册分组。
|
||
type AlbumGroupReservationRequest struct {
|
||
SenderUserID int64
|
||
Peer Peer
|
||
Items []AlbumGroupReservationItem
|
||
ProposedGroupedID int64
|
||
}
|
||
|
||
// AlbumGroupReservationItem 把 random_id 与该 item 的不可变客户端意图绑定。
|
||
// IntentHash 是在媒体解析/服务端派生字段产生前计算的 SHA-256；相同 random_id
|
||
// 若携带不同意图必须报冲突，不能借旧 album reservation 绕过发送幂等校验。
|
||
type AlbumGroupReservationItem struct {
|
||
RandomID int64
|
||
IntentHash []byte
|
||
}
|
||
|
||
// Validate 校验持久层必须依赖的最小不变量。同一批内重复 random_id 与发送幂等
|
||
// 冲突同义，必须显式失败，不能静默去重后改变客户端请求的消息条数。
|
||
func (r AlbumGroupReservationRequest) Validate() error {
|
||
if r.SenderUserID <= 0 || r.Peer.ID <= 0 || r.ProposedGroupedID == 0 || len(r.Items) == 0 {
|
||
return ErrAlbumGroupReservationInvalid
|
||
}
|
||
if r.Peer.Type != PeerTypeUser && r.Peer.Type != PeerTypeChannel {
|
||
return ErrAlbumGroupReservationInvalid
|
||
}
|
||
seen := make(map[int64]struct{}, len(r.Items))
|
||
for _, item := range r.Items {
|
||
if item.RandomID == 0 || len(item.IntentHash) != sha256.Size {
|
||
return ErrAlbumGroupReservationInvalid
|
||
}
|
||
if _, exists := seen[item.RandomID]; exists {
|
||
return ErrMessageRandomIDDuplicate
|
||
}
|
||
seen[item.RandomID] = struct{}{}
|
||
}
|
||
return nil
|
||
}
|