Add NTE roll/pull tracker API and marker screenshot URLs (#83)

* Add NTE tracker API and marker screenshot URLs

* Fix tracker test-only atomic imports

* Harden marker comment screenshot URL validation

* Relax tracker pull enum constraints

* Relax tracker pull constraints in original migration

Author: Sammy-x3

migrations/20260616000000_ntehelper_tracker.sql

@@ -0,0 +1,58 @@
+CREATE TABLE ntehelper_tracker_uid_claim (
+    uid bigint PRIMARY KEY,
+    owner_user_id bigint NOT NULL,
+    claim_source text NOT NULL,
+    claimed_at timestamptz NOT NULL DEFAULT now(),
+    updated_at timestamptz NOT NULL DEFAULT now(),
+    CONSTRAINT ntehelper_tracker_uid_claim_owner_user_id_fkey FOREIGN KEY (owner_user_id) REFERENCES users (id) ON DELETE CASCADE,
+    CONSTRAINT ntehelper_tracker_uid_claim_uid_check CHECK (uid BETWEEN 100000 AND 999999999999),
+    CONSTRAINT ntehelper_tracker_uid_claim_source_check CHECK (claim_source IN ('self', 'admin'))
+);
+
+CREATE UNIQUE INDEX ntehelper_tracker_uid_claim_self_owner_idx
+    ON ntehelper_tracker_uid_claim (owner_user_id)
+    WHERE claim_source = 'self';
+
+CREATE INDEX ntehelper_tracker_uid_claim_owner_idx
+    ON ntehelper_tracker_uid_claim (owner_user_id, claimed_at DESC);
+
+CREATE TABLE ntehelper_tracker_pull (
+    uid bigint NOT NULL,
+    record_uid text NOT NULL,
+    pool_group_id text NOT NULL,
+    banner_type text NOT NULL,
+    timestamp_raw text NOT NULL,
+    timestamp_group_ordinal integer,
+    roll_result integer,
+    result_type text,
+    reward_type text NOT NULL,
+    reward_id text NOT NULL,
+    reward_name text NOT NULL,
+    reward_rank text,
+    star_rank integer,
+    quantity integer,
+    imported_at timestamptz NOT NULL DEFAULT now(),
+    PRIMARY KEY (uid, record_uid),
+    CONSTRAINT ntehelper_tracker_pull_uid_fkey FOREIGN KEY (uid) REFERENCES ntehelper_tracker_uid_claim (uid) ON DELETE CASCADE,
+    CONSTRAINT ntehelper_tracker_pull_record_uid_check CHECK (
+        char_length(btrim(record_uid)) BETWEEN 1 AND 128
+        AND btrim(record_uid) !~ '[^A-Za-z0-9_.:-]'
+    ),
+    CONSTRAINT ntehelper_tracker_pull_timestamp_raw_check CHECK (timestamp_raw ~ '^[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$'),
+    CONSTRAINT ntehelper_tracker_pull_timestamp_group_ordinal_check CHECK (timestamp_group_ordinal IS NULL OR timestamp_group_ordinal >= 0),
+    CONSTRAINT ntehelper_tracker_pull_roll_result_check CHECK (roll_result IS NULL OR roll_result >= 0),
+    CONSTRAINT ntehelper_tracker_pull_result_type_check CHECK (result_type IS NULL OR char_length(btrim(result_type)) BETWEEN 1 AND 64),
+    CONSTRAINT ntehelper_tracker_pull_reward_type_check CHECK (char_length(btrim(reward_type)) BETWEEN 1 AND 64),
+    CONSTRAINT ntehelper_tracker_pull_reward_id_check CHECK (char_length(btrim(reward_id)) BETWEEN 1 AND 128),
+    CONSTRAINT ntehelper_tracker_pull_reward_name_check CHECK (char_length(btrim(reward_name)) BETWEEN 1 AND 128),
+    CONSTRAINT ntehelper_tracker_pull_star_rank_check CHECK (star_rank IS NULL OR star_rank IN (3, 4, 5)),
+    CONSTRAINT ntehelper_tracker_pull_quantity_check CHECK (quantity IS NULL OR quantity >= 0)
+);
+
+CREATE INDEX ntehelper_tracker_pull_uid_timestamp_idx
+    ON ntehelper_tracker_pull (uid, timestamp_raw DESC);
+
+CREATE INDEX ntehelper_tracker_pull_uid_banner_timestamp_idx
+    ON ntehelper_tracker_pull (uid, banner_type, timestamp_raw DESC);
+
+

migrations/20260616010000_ntehelper_tracker_claim_detach.sql

@@ -0,0 +1,15 @@
+ALTER TABLE ntehelper_tracker_uid_claim
+    DROP CONSTRAINT ntehelper_tracker_uid_claim_owner_user_id_fkey;
+
+ALTER TABLE ntehelper_tracker_uid_claim
+    ALTER COLUMN owner_user_id DROP NOT NULL;
+
+ALTER TABLE ntehelper_tracker_uid_claim
+    ADD CONSTRAINT ntehelper_tracker_uid_claim_owner_user_id_fkey
+    FOREIGN KEY (owner_user_id) REFERENCES users (id) ON DELETE SET NULL;
+
+DROP INDEX ntehelper_tracker_uid_claim_self_owner_idx;
+
+CREATE INDEX ntehelper_tracker_uid_claim_self_owner_idx
+    ON ntehelper_tracker_uid_claim (owner_user_id)
+    WHERE claim_source = 'self';

migrations/20260617000000_ntehelper_tracker_nickname.sql

@@ -0,0 +1,8 @@
+ALTER TABLE ntehelper_tracker_uid_claim
+    ADD COLUMN nickname text NOT NULL DEFAULT '';
+
+ALTER TABLE ntehelper_tracker_uid_claim
+    ADD CONSTRAINT ntehelper_tracker_uid_claim_nickname_check CHECK (
+        char_length(btrim(nickname)) <= 24
+        AND btrim(nickname) !~ '[[:cntrl:]]'
+    );

migrations/20260623010000_ntehelper_marker_comment_screenshot_urls.sql

@@ -0,0 +1,8 @@
+ALTER TABLE ntehelper_marker_comment
+    ADD COLUMN screenshot_urls jsonb NOT NULL DEFAULT '[]'::jsonb;
+
+ALTER TABLE ntehelper_marker_comment
+    ADD CONSTRAINT ntehelper_marker_comment_screenshot_urls_check CHECK (
+        jsonb_typeof(screenshot_urls) = 'array'
+        AND jsonb_array_length(screenshot_urls) <= 4
+    );