owpengram-server/deploy/migrations/0090_star_gift_collectibles.up.sql
2026-07-16 12:38:53 +08:00

238 lines
13 KiB
PL/PgSQL

-- Collectible Star Gifts: immutable published attribute pools, unique gift instances and
-- peer-owned gift collections. Marketplace/transfer/auction/craft/TON state is intentionally
-- absent from this schema.
CREATE SEQUENCE public.unique_star_gift_id_seq AS bigint START WITH 9200000000000001;
CREATE TABLE public.star_gift_collectible_revisions (
id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
gift_id bigint NOT NULL REFERENCES public.star_gift_catalog(gift_id) ON DELETE RESTRICT,
revision integer NOT NULL,
upgrade_stars bigint NOT NULL,
supply_total integer NOT NULL,
issued integer DEFAULT 0 NOT NULL,
slug_prefix text NOT NULL,
status text DEFAULT 'draft' NOT NULL,
created_by text DEFAULT '' NOT NULL,
command_id text DEFAULT '' NOT NULL,
created_at timestamp with time zone DEFAULT now() NOT NULL,
published_at timestamp with time zone,
CONSTRAINT star_gift_collectible_revision_uniq UNIQUE (gift_id, revision),
CONSTRAINT star_gift_collectible_command_uniq UNIQUE (gift_id, command_id),
CONSTRAINT star_gift_collectible_price_check CHECK (upgrade_stars > 0),
CONSTRAINT star_gift_collectible_supply_check CHECK (supply_total > 0 AND issued >= 0 AND issued <= supply_total),
CONSTRAINT star_gift_collectible_slug_check CHECK (slug_prefix ~ '^[a-z0-9][a-z0-9-]{0,47}$'),
CONSTRAINT star_gift_collectible_status_check CHECK (status IN ('draft', 'published')),
CONSTRAINT star_gift_collectible_publish_check CHECK (
(status = 'draft' AND published_at IS NULL) OR
(status = 'published' AND published_at IS NOT NULL)
)
);
CREATE TABLE public.star_gift_collectible_models (
id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
collectible_revision_id bigint NOT NULL REFERENCES public.star_gift_collectible_revisions(id) ON DELETE CASCADE,
name text NOT NULL,
document_id bigint NOT NULL REFERENCES public.documents(id) ON DELETE RESTRICT,
animation_json jsonb NOT NULL,
animation_sha256 bytea NOT NULL,
source_name text DEFAULT '' NOT NULL,
source_format text NOT NULL,
width integer NOT NULL,
height integer NOT NULL,
frame_rate double precision DEFAULT 0 NOT NULL,
in_point double precision DEFAULT 0 NOT NULL,
out_point double precision DEFAULT 0 NOT NULL,
rarity_permille integer NOT NULL,
sort_order integer DEFAULT 0 NOT NULL,
CONSTRAINT star_gift_collectible_model_name_uniq UNIQUE (collectible_revision_id, name),
CONSTRAINT star_gift_collectible_model_id_revision_uniq UNIQUE (id, collectible_revision_id),
CONSTRAINT star_gift_collectible_model_rarity_check CHECK (rarity_permille BETWEEN 1 AND 1000),
CONSTRAINT star_gift_collectible_model_shape_check CHECK (width = 512 AND height = 512 AND jsonb_typeof(animation_json) = 'object'),
CONSTRAINT star_gift_collectible_model_source_check CHECK (source_format IN ('tgs', 'lottie'))
);
CREATE TABLE public.star_gift_collectible_patterns (
id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
collectible_revision_id bigint NOT NULL REFERENCES public.star_gift_collectible_revisions(id) ON DELETE CASCADE,
name text NOT NULL,
document_id bigint NOT NULL REFERENCES public.documents(id) ON DELETE RESTRICT,
animation_json jsonb NOT NULL,
animation_sha256 bytea NOT NULL,
source_name text DEFAULT '' NOT NULL,
source_format text NOT NULL,
width integer NOT NULL,
height integer NOT NULL,
frame_rate double precision DEFAULT 0 NOT NULL,
in_point double precision DEFAULT 0 NOT NULL,
out_point double precision DEFAULT 0 NOT NULL,
rarity_permille integer NOT NULL,
sort_order integer DEFAULT 0 NOT NULL,
CONSTRAINT star_gift_collectible_pattern_name_uniq UNIQUE (collectible_revision_id, name),
CONSTRAINT star_gift_collectible_pattern_id_revision_uniq UNIQUE (id, collectible_revision_id),
CONSTRAINT star_gift_collectible_pattern_rarity_check CHECK (rarity_permille BETWEEN 1 AND 1000),
CONSTRAINT star_gift_collectible_pattern_shape_check CHECK (width = 512 AND height = 512 AND jsonb_typeof(animation_json) = 'object'),
CONSTRAINT star_gift_collectible_pattern_source_check CHECK (source_format IN ('tgs', 'lottie'))
);
CREATE TABLE public.star_gift_collectible_backdrops (
id bigint GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
collectible_revision_id bigint NOT NULL REFERENCES public.star_gift_collectible_revisions(id) ON DELETE CASCADE,
name text NOT NULL,
backdrop_id integer NOT NULL,
center_color integer NOT NULL,
edge_color integer NOT NULL,
pattern_color integer NOT NULL,
text_color integer NOT NULL,
rarity_permille integer NOT NULL,
sort_order integer DEFAULT 0 NOT NULL,
CONSTRAINT star_gift_collectible_backdrop_name_uniq UNIQUE (collectible_revision_id, name),
CONSTRAINT star_gift_collectible_backdrop_display_uniq UNIQUE (collectible_revision_id, backdrop_id),
CONSTRAINT star_gift_collectible_backdrop_id_revision_uniq UNIQUE (id, collectible_revision_id),
CONSTRAINT star_gift_collectible_backdrop_rarity_check CHECK (rarity_permille BETWEEN 1 AND 1000),
CONSTRAINT star_gift_collectible_backdrop_color_check CHECK (
center_color BETWEEN 0 AND 16777215 AND edge_color BETWEEN 0 AND 16777215 AND
pattern_color BETWEEN 0 AND 16777215 AND text_color BETWEEN 0 AND 16777215
)
);
ALTER TABLE public.star_gift_catalog
ADD COLUMN collectible_revision_id bigint,
ADD CONSTRAINT star_gift_catalog_collectible_revision_fk FOREIGN KEY (collectible_revision_id)
REFERENCES public.star_gift_collectible_revisions(id) ON DELETE RESTRICT;
CREATE TABLE public.unique_star_gifts (
id bigint DEFAULT nextval('public.unique_star_gift_id_seq') PRIMARY KEY,
gift_id bigint NOT NULL REFERENCES public.star_gift_catalog(gift_id) ON DELETE RESTRICT,
collectible_revision_id bigint NOT NULL REFERENCES public.star_gift_collectible_revisions(id) ON DELETE RESTRICT,
source_saved_gift_id bigint NOT NULL REFERENCES public.peer_star_gifts(id) ON DELETE RESTRICT,
title text DEFAULT '' NOT NULL,
slug text NOT NULL,
num integer NOT NULL,
owner_peer_type text NOT NULL,
owner_peer_id bigint NOT NULL,
model_attribute_id bigint NOT NULL,
pattern_attribute_id bigint NOT NULL,
backdrop_attribute_id bigint NOT NULL,
keep_original_details boolean DEFAULT false NOT NULL,
created_at timestamp with time zone DEFAULT now() NOT NULL,
updated_at timestamp with time zone DEFAULT now() NOT NULL,
CONSTRAINT unique_star_gift_slug_uniq UNIQUE (slug),
CONSTRAINT unique_star_gift_number_uniq UNIQUE (gift_id, num),
CONSTRAINT unique_star_gift_source_uniq UNIQUE (source_saved_gift_id),
CONSTRAINT unique_star_gift_owner_check CHECK (owner_peer_type IN ('user', 'channel') AND owner_peer_id > 0),
CONSTRAINT unique_star_gift_num_check CHECK (num > 0),
CONSTRAINT unique_star_gift_model_fk FOREIGN KEY (model_attribute_id, collectible_revision_id)
REFERENCES public.star_gift_collectible_models(id, collectible_revision_id) ON DELETE RESTRICT,
CONSTRAINT unique_star_gift_pattern_fk FOREIGN KEY (pattern_attribute_id, collectible_revision_id)
REFERENCES public.star_gift_collectible_patterns(id, collectible_revision_id) ON DELETE RESTRICT,
CONSTRAINT unique_star_gift_backdrop_fk FOREIGN KEY (backdrop_attribute_id, collectible_revision_id)
REFERENCES public.star_gift_collectible_backdrops(id, collectible_revision_id) ON DELETE RESTRICT
);
ALTER TABLE public.peer_star_gifts
ADD COLUMN unique_gift_id bigint,
ADD COLUMN upgrade_msg_id integer DEFAULT 0 NOT NULL,
ADD COLUMN pinned_order integer DEFAULT 0 NOT NULL,
ADD CONSTRAINT peer_star_gifts_unique_gift_fk FOREIGN KEY (unique_gift_id)
REFERENCES public.unique_star_gifts(id) ON DELETE RESTRICT DEFERRABLE INITIALLY DEFERRED,
ADD CONSTRAINT peer_star_gifts_terminal_state_check CHECK (NOT converted OR unique_gift_id IS NULL),
ADD CONSTRAINT peer_star_gifts_pinned_order_check CHECK (pinned_order >= 0);
CREATE UNIQUE INDEX peer_star_gifts_unique_gift_uniq ON public.peer_star_gifts(unique_gift_id)
WHERE unique_gift_id IS NOT NULL;
CREATE INDEX unique_star_gifts_owner_idx ON public.unique_star_gifts(owner_peer_type, owner_peer_id, id DESC);
CREATE TABLE public.star_gift_upgrade_commands (
user_id bigint NOT NULL,
command_key text NOT NULL,
source_saved_gift_id bigint NOT NULL REFERENCES public.peer_star_gifts(id) ON DELETE RESTRICT,
form_id bigint DEFAULT 0 NOT NULL,
unique_gift_id bigint NOT NULL REFERENCES public.unique_star_gifts(id) ON DELETE RESTRICT,
balance_after bigint NOT NULL,
created_at timestamp with time zone DEFAULT now() NOT NULL,
CONSTRAINT star_gift_upgrade_commands_pkey PRIMARY KEY (user_id, command_key),
CONSTRAINT star_gift_upgrade_command_source_uniq UNIQUE (source_saved_gift_id)
);
CREATE TABLE public.star_gift_collections (
collection_id integer GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
owner_peer_type text NOT NULL,
owner_peer_id bigint NOT NULL,
title text NOT NULL,
sort_order integer DEFAULT 0 NOT NULL,
hash bigint DEFAULT 0 NOT NULL,
created_at timestamp with time zone DEFAULT now() NOT NULL,
updated_at timestamp with time zone DEFAULT now() NOT NULL,
CONSTRAINT star_gift_collection_owner_check CHECK (owner_peer_type IN ('user', 'channel') AND owner_peer_id > 0),
CONSTRAINT star_gift_collection_title_check CHECK (char_length(title) BETWEEN 1 AND 12),
CONSTRAINT star_gift_collection_owner_id_uniq UNIQUE (owner_peer_type, owner_peer_id, collection_id)
);
CREATE INDEX star_gift_collections_owner_order_idx
ON public.star_gift_collections(owner_peer_type, owner_peer_id, sort_order, collection_id);
CREATE TABLE public.star_gift_collection_items (
collection_id integer NOT NULL REFERENCES public.star_gift_collections(collection_id) ON DELETE CASCADE,
saved_gift_id bigint NOT NULL REFERENCES public.peer_star_gifts(id) ON DELETE CASCADE,
sort_order integer DEFAULT 0 NOT NULL,
created_at timestamp with time zone DEFAULT now() NOT NULL,
CONSTRAINT star_gift_collection_items_pkey PRIMARY KEY (collection_id, saved_gift_id)
);
CREATE INDEX star_gift_collection_items_order_idx
ON public.star_gift_collection_items(collection_id, sort_order, saved_gift_id);
CREATE INDEX star_gift_collection_items_saved_idx
ON public.star_gift_collection_items(saved_gift_id, collection_id);
-- Published definitions are immutable. The only permitted update is incrementing issued while
-- all definition columns remain byte-for-byte equal.
CREATE FUNCTION public.telesrv_guard_collectible_revision() RETURNS trigger
LANGUAGE plpgsql AS $$
BEGIN
IF OLD.status = 'published' THEN
IF TG_OP = 'DELETE' THEN
RAISE EXCEPTION 'published collectible revision is immutable';
END IF;
IF NEW.gift_id <> OLD.gift_id OR NEW.revision <> OLD.revision OR
NEW.upgrade_stars <> OLD.upgrade_stars OR NEW.supply_total <> OLD.supply_total OR
NEW.slug_prefix <> OLD.slug_prefix OR NEW.status <> OLD.status OR
NEW.created_by <> OLD.created_by OR NEW.command_id <> OLD.command_id OR
NEW.created_at <> OLD.created_at OR NEW.published_at <> OLD.published_at THEN
RAISE EXCEPTION 'published collectible revision is immutable';
END IF;
END IF;
IF TG_OP = 'DELETE' THEN
RETURN OLD;
END IF;
RETURN NEW;
END;
$$;
CREATE TRIGGER star_gift_collectible_revision_guard
BEFORE UPDATE OR DELETE ON public.star_gift_collectible_revisions
FOR EACH ROW EXECUTE FUNCTION public.telesrv_guard_collectible_revision();
CREATE FUNCTION public.telesrv_guard_collectible_attribute() RETURNS trigger
LANGUAGE plpgsql AS $$
DECLARE
revision_status text;
BEGIN
SELECT status INTO revision_status FROM public.star_gift_collectible_revisions
WHERE id = COALESCE(OLD.collectible_revision_id, NEW.collectible_revision_id);
IF revision_status = 'published' THEN
RAISE EXCEPTION 'published collectible attributes are immutable';
END IF;
IF TG_OP = 'DELETE' THEN
RETURN OLD;
END IF;
RETURN NEW;
END;
$$;
CREATE TRIGGER star_gift_collectible_model_guard BEFORE UPDATE OR DELETE ON public.star_gift_collectible_models
FOR EACH ROW EXECUTE FUNCTION public.telesrv_guard_collectible_attribute();
CREATE TRIGGER star_gift_collectible_pattern_guard BEFORE UPDATE OR DELETE ON public.star_gift_collectible_patterns
FOR EACH ROW EXECUTE FUNCTION public.telesrv_guard_collectible_attribute();
CREATE TRIGGER star_gift_collectible_backdrop_guard BEFORE UPDATE OR DELETE ON public.star_gift_collectible_backdrops
FOR EACH ROW EXECUTE FUNCTION public.telesrv_guard_collectible_attribute();