172 lines
8.0 KiB
Go
172 lines
8.0 KiB
Go
package eventcatalog
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"errors"
|
|
"fmt"
|
|
"strings"
|
|
|
|
"github.com/jackc/pgx/v5"
|
|
"github.com/jackc/pgx/v5/pgxpool"
|
|
)
|
|
|
|
type Import struct {
|
|
Version string `json:"version"`
|
|
CoverageStartJalaliYear int `json:"coverageStartJalaliYear"`
|
|
CoverageEndJalaliYear int `json:"coverageEndJalaliYear"`
|
|
SourceURI string `json:"sourceUri"`
|
|
SourceVersion string `json:"sourceVersion"`
|
|
SourceChecksum string `json:"sourceChecksum"`
|
|
ImportedBy string `json:"importedBy"`
|
|
Events []Event `json:"events"`
|
|
}
|
|
|
|
func ValidateImport(input Import, currentJalaliYear int) error {
|
|
if strings.TrimSpace(input.Version) == "" || strings.TrimSpace(input.SourceURI) == "" || strings.TrimSpace(input.SourceVersion) == "" || strings.TrimSpace(input.SourceChecksum) == "" || strings.TrimSpace(input.ImportedBy) == "" {
|
|
return errors.New("event catalog: import metadata is incomplete")
|
|
}
|
|
if input.CoverageStartJalaliYear > currentJalaliYear-3 || input.CoverageEndJalaliYear < currentJalaliYear+2 {
|
|
return fmt.Errorf("event catalog: coverage must include Jalali years %d through %d", currentJalaliYear-3, currentJalaliYear+2)
|
|
}
|
|
if len(input.Events) == 0 {
|
|
return errors.New("event catalog: import contains no events")
|
|
}
|
|
if err := ValidateEvents(input.Events); err != nil {
|
|
return err
|
|
}
|
|
return ValidateDeclaredCoverage(input.Events, input.CoverageStartJalaliYear, input.CoverageEndJalaliYear)
|
|
}
|
|
|
|
func ValidateApproval(importedBy, reviewedBy string) error {
|
|
if strings.TrimSpace(reviewedBy) == "" {
|
|
return errors.New("event catalog: reviewer is required")
|
|
}
|
|
if strings.EqualFold(strings.TrimSpace(importedBy), strings.TrimSpace(reviewedBy)) {
|
|
return errors.New("event catalog: importer cannot approve the same catalog")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func ValidateReviewableChecksum(checksum string) error {
|
|
normalized := strings.ToLower(strings.TrimSpace(checksum))
|
|
if normalized == "" || strings.Contains(normalized, "review-required") || strings.Contains(normalized, "pending-review") || strings.Contains(normalized, "placeholder") {
|
|
return errors.New("event catalog: source checksum is not independently reviewed")
|
|
}
|
|
return nil
|
|
}
|
|
|
|
type Repository struct{ pool *pgxpool.Pool }
|
|
|
|
func NewRepository(pool *pgxpool.Pool) *Repository { return &Repository{pool: pool} }
|
|
|
|
func (r *Repository) ImportDraft(ctx context.Context, input Import) error {
|
|
if err := ValidateEvents(input.Events); err != nil {
|
|
return err
|
|
}
|
|
tx, err := r.pool.BeginTx(ctx, pgx.TxOptions{})
|
|
if err != nil {
|
|
return fmt.Errorf("starting calendar import: %w", err)
|
|
}
|
|
defer func() { _ = tx.Rollback(context.WithoutCancel(ctx)) }()
|
|
var versionID int64
|
|
err = tx.QueryRow(ctx, `INSERT INTO calendar_catalog_versions(version,status,coverage_start_jalali_year,coverage_end_jalali_year,source_uri,source_version,source_checksum,imported_by)
|
|
VALUES($1,'DRAFT',$2,$3,$4,$5,$6,$7) RETURNING id`, input.Version, input.CoverageStartJalaliYear, input.CoverageEndJalaliYear, input.SourceURI, input.SourceVersion, input.SourceChecksum, input.ImportedBy).Scan(&versionID)
|
|
if err != nil {
|
|
return fmt.Errorf("creating calendar catalog version: %w", err)
|
|
}
|
|
for _, event := range input.Events {
|
|
if event.Variant == "" {
|
|
event.Variant = "PRIMARY"
|
|
}
|
|
categories, err := json.Marshal(event.MerchantCategories)
|
|
if err != nil {
|
|
return fmt.Errorf("encoding calendar event categories: %w", err)
|
|
}
|
|
channels, err := json.Marshal(event.BehavioralChannels)
|
|
if err != nil {
|
|
return fmt.Errorf("encoding calendar event channels: %w", err)
|
|
}
|
|
aliases, err := json.Marshal(event.Aliases)
|
|
if err != nil {
|
|
return fmt.Errorf("encoding calendar event aliases: %w", err)
|
|
}
|
|
themes, err := json.Marshal(event.Themes)
|
|
if err != nil {
|
|
return fmt.Errorf("encoding calendar event themes: %w", err)
|
|
}
|
|
tags, err := json.Marshal(event.CampaignTags)
|
|
if err != nil {
|
|
return fmt.Errorf("encoding calendar event campaign tags: %w", err)
|
|
}
|
|
_, err = tx.Exec(ctx, `INSERT INTO calendar_events(catalog_version_id,event_key,occasion_key,event_variant,title_fa,title_en,aliases,themes,campaign_tags,start_date,end_date,recurrence_rule,event_type,tone,commercial_posture,official_holiday,source_uri,source_version,source_checksum,inclusion_rationale,geographic_scope,merchant_categories,behavioral_channels,lead_days,lag_days,relevance_bps,confidence_bps,importance_bps)
|
|
VALUES($1,$2,$3,$4,$5,nullif($6,''),$7,$8,$9,$10,$11,nullif($12,''),$13,$14,$15,$16,$17,$18,nullif($19,''),$20,$21,$22,$23,$24,$25,$26,$27,$28)`, versionID, event.ID, event.OccasionKey, event.Variant, event.TitleFA, event.TitleEN, aliases, themes, tags, event.StartDate, event.EndDate, event.Recurrence, event.Type, event.Tone, event.CommercialPosture, event.OfficialHoliday, event.SourceURI, event.SourceVersion, event.SourceChecksum, event.InclusionRationale, event.GeographicScope, categories, channels, event.LeadDays, event.LagDays, event.RelevanceBPS, event.ConfidenceBPS, event.ImportanceBPS)
|
|
if err != nil {
|
|
return fmt.Errorf("inserting calendar event %q: %w", event.ID, err)
|
|
}
|
|
}
|
|
if _, err := tx.Exec(ctx, `INSERT INTO calendar_catalog_audit(catalog_version_id,action,actor) VALUES($1,'IMPORTED',$2)`, versionID, input.ImportedBy); err != nil {
|
|
return fmt.Errorf("auditing calendar import: %w", err)
|
|
}
|
|
if err := tx.Commit(ctx); err != nil {
|
|
return fmt.Errorf("committing calendar import: %w", err)
|
|
}
|
|
return nil
|
|
}
|
|
|
|
func (r *Repository) Approve(ctx context.Context, version, reviewer string) error {
|
|
tx, err := r.pool.BeginTx(ctx, pgx.TxOptions{})
|
|
if err != nil {
|
|
return fmt.Errorf("starting calendar approval: %w", err)
|
|
}
|
|
defer func() { _ = tx.Rollback(context.WithoutCancel(ctx)) }()
|
|
var id int64
|
|
var importedBy string
|
|
var sourceChecksum string
|
|
if err := tx.QueryRow(ctx, `SELECT id,imported_by,source_checksum FROM calendar_catalog_versions WHERE version=$1 AND status='DRAFT' FOR UPDATE`, version).Scan(&id, &importedBy, &sourceChecksum); err != nil {
|
|
return fmt.Errorf("loading draft calendar catalog: %w", err)
|
|
}
|
|
if err := ValidateApproval(importedBy, reviewer); err != nil {
|
|
return err
|
|
}
|
|
if err := ValidateReviewableChecksum(sourceChecksum); err != nil {
|
|
return err
|
|
}
|
|
if _, err := tx.Exec(ctx, `UPDATE calendar_catalog_versions SET status='APPROVED',reviewed_by=$2,reviewed_at=now() WHERE id=$1`, id, reviewer); err != nil {
|
|
return fmt.Errorf("approving calendar catalog: %w", err)
|
|
}
|
|
if _, err := tx.Exec(ctx, `INSERT INTO calendar_catalog_audit(catalog_version_id,action,actor) VALUES($1,'APPROVED',$2)`, id, reviewer); err != nil {
|
|
return fmt.Errorf("auditing calendar approval: %w", err)
|
|
}
|
|
return tx.Commit(ctx)
|
|
}
|
|
|
|
func (r *Repository) Activate(ctx context.Context, version, actor string) error {
|
|
tx, err := r.pool.BeginTx(ctx, pgx.TxOptions{})
|
|
if err != nil {
|
|
return fmt.Errorf("starting calendar activation: %w", err)
|
|
}
|
|
defer func() { _ = tx.Rollback(context.WithoutCancel(ctx)) }()
|
|
if _, err := tx.Exec(ctx, `SELECT pg_advisory_xact_lock(hashtextextended('calendar-catalog-activation',0))`); err != nil {
|
|
return fmt.Errorf("locking calendar activation: %w", err)
|
|
}
|
|
var id int64
|
|
var sourceChecksum string
|
|
if err := tx.QueryRow(ctx, `SELECT id,source_checksum FROM calendar_catalog_versions WHERE version=$1 AND status='APPROVED' FOR UPDATE`, version).Scan(&id, &sourceChecksum); err != nil {
|
|
return fmt.Errorf("loading approved calendar catalog: %w", err)
|
|
}
|
|
if err := ValidateReviewableChecksum(sourceChecksum); err != nil {
|
|
return err
|
|
}
|
|
if _, err := tx.Exec(ctx, `UPDATE calendar_catalog_versions SET status='RETIRED' WHERE status='ACTIVE'`); err != nil {
|
|
return fmt.Errorf("retiring active calendar catalog: %w", err)
|
|
}
|
|
if _, err := tx.Exec(ctx, `UPDATE calendar_catalog_versions SET status='ACTIVE',activated_at=now() WHERE id=$1`, id); err != nil {
|
|
return fmt.Errorf("activating calendar catalog: %w", err)
|
|
}
|
|
if _, err := tx.Exec(ctx, `INSERT INTO calendar_catalog_audit(catalog_version_id,action,actor) VALUES($1,'ACTIVATED',$2)`, id, actor); err != nil {
|
|
return fmt.Errorf("auditing calendar activation: %w", err)
|
|
}
|
|
return tx.Commit(ctx)
|
|
}
|