Documentation
¶
Overview ¶
Package proposedchanges stores field-level proposed edits to a record (a volume today, other record types later - see design.md's "generic proposed-change shape" decision) separately from the live record until an editor/admin reviews them. See platform's volume-proposed-changes spec (openspec/changes/volume-edit-with-approval-workflow in sweetrpg/platform).
Index ¶
Constants ¶
const ( StatusPending = "pending" StatusAccepted = "accepted" StatusRejected = "rejected" StatusPartiallyAccepted = "partially_accepted" )
Field-level and overall proposal statuses.
const CollectionName = "proposed_changes"
Variables ¶
This section is empty.
Functions ¶
func Add ¶
func Add(ctx context.Context, p *ProposedChange) (string, error)
Add stores a new pending proposed change, stamping SubmittedAt, and returns its ID.
func EnsureIndexes ¶
EnsureIndexes creates the compound index this package's queries rely on (record_type + record_id + status, for the per-record pending-list lookup). Safe to call on every startup - CreateOne is a no-op if an equivalent index already exists.
Types ¶
type FieldChange ¶
type FieldChange struct {
Old any `bson:"old" json:"old"`
New any `bson:"new" json:"new"`
Status string `bson:"status" json:"status"`
}
FieldChange is one changed field's old (live-at-submission-time) and proposed value, plus its own review outcome once decided.
type ProposedChange ¶
type ProposedChange struct {
ID primitive.ObjectID `bson:"_id,omitempty" json:"id"`
RecordType string `bson:"record_type" json:"recordType"`
RecordID string `bson:"record_id" json:"recordId"`
Diff map[string]FieldChange `bson:"diff" json:"diff"`
Status string `bson:"status" json:"status"`
SubmittedBy string `bson:"submitted_by" json:"submittedBy"`
SubmittedAt time.Time `bson:"submitted_at" json:"submittedAt"`
ReviewedBy string `bson:"reviewed_by,omitempty" json:"reviewedBy,omitempty"`
ReviewedAt *time.Time `bson:"reviewed_at,omitempty" json:"reviewedAt,omitempty"`
ReviewNote string `bson:"review_note,omitempty" json:"reviewNote,omitempty"`
}
ProposedChange is a submitter's proposed edit to a live record, pending admin/editor review.
func Get ¶
func Get(ctx context.Context, id string) (*ProposedChange, error)
Get fetches a single proposed change by ID.
func ListPending ¶
func ListPending(ctx context.Context, recordType, recordID string) ([]*ProposedChange, error)
ListPending returns every pending proposed change for the given record, oldest first.
func (*ProposedChange) DeriveStatus ¶
func (p *ProposedChange) DeriveStatus()
DeriveStatus recomputes Status from each field's individual outcome: pending while any field is undecided, accepted/rejected if every decided field agrees, partially_accepted on a mix. Called after any review action so the top-level status never has to be set independently of the fields it's derived from.
Source Files