fix: api descript

desc/sql/player/player_services.sql

@@ -0,0 +1,51 @@
+CREATE TABLE player_services
+(
+    id           BIGINT PRIMARY KEY,
+    player_id    BIGINT         NOT NULL REFERENCES players (id),
+    game_id      BIGINT         NOT NULL,
+    title        VARCHAR(200)   NOT NULL,
+    description  TEXT,
+    price        DECIMAL(10, 2) NOT NULL,
+    unit         VARCHAR(20)    NOT NULL,
+    rank_range   VARCHAR(100),
+    availability TEXT[]                  DEFAULT ARRAY []::TEXT[],
+    rating       DECIMAL(3, 2)           DEFAULT 5.00,
+    is_active    BOOLEAN                 DEFAULT TRUE,
+    created_at   TIMESTAMPTZ    NOT NULL DEFAULT NOW(),
+    updated_at   TIMESTAMPTZ    NOT NULL DEFAULT NOW(),
+
+    CONSTRAINT chk_price_positive CHECK (price > 0),
+    CONSTRAINT chk_service_rating CHECK (rating >= 0 AND rating <= 5)
+);
+
+-- 基础索引
+CREATE INDEX idx_services_player ON player_services (player_id) WHERE is_active = TRUE;
+CREATE INDEX idx_services_game ON player_services (game_id) WHERE is_active = TRUE;
+CREATE INDEX idx_services_price ON player_services (price);
+
+-- 三元组索引用于服务标题模糊搜索
+CREATE INDEX idx_services_title_trgm ON player_services USING gin (title gin_trgm_ops)
+    WHERE is_active = TRUE;
+
+-- 全文搜索索引
+CREATE INDEX idx_services_fulltext ON player_services USING gin (
+                                                                 to_tsvector('simple', title || ' ' || coalesce(description, ''))
+    ) WHERE is_active = TRUE;
+
+-- 复合索引优化价格区间查询
+CREATE INDEX idx_services_game_price ON player_services (game_id, price, rating DESC)
+    WHERE is_active = TRUE;
+
+-- 打手+游戏复合索引
+CREATE INDEX idx_services_player_game ON player_services (player_id, game_id)
+    WHERE is_active = TRUE;
+
+-- GIN 索引优化时间段查询
+CREATE INDEX idx_services_availability ON player_services USING gin (availability)
+    WHERE is_active = TRUE;
+
+CREATE TRIGGER trigger_services_updated_at
+    BEFORE UPDATE
+    ON player_services
+    FOR EACH ROW
+EXECUTE FUNCTION update_updated_at_column();

desc/sql/player/players.sql

@@ -0,0 +1,39 @@
+CREATE TABLE players
+(
+    id BIGINT PRIMARY KEY,
+    user_id BIGINT NOT NULL UNIQUE,
+    status VARCHAR(20) NOT NULL DEFAULT 'offline',
+    rating DECIMAL(3,2) DEFAULT 5.00,
+    total_orders INT DEFAULT 0,
+    completed_orders INT DEFAULT 0,
+
+    -- [注意] 此字段为冗余缓存，通过消息队列与 shop_players 表保持一致
+    shop_id BIGINT,
+    gender bool default 1 not null ,
+    tags TEXT[] DEFAULT ARRAY[]::TEXT[],
+    games BIGINT[] DEFAULT ARRAY[]::BIGINT[],
+    created_at TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+    updated_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+-- 基础索引
+CREATE INDEX idx_players_user ON players (user_id);
+CREATE INDEX idx_players_shop ON players (shop_id) WHERE shop_id IS NOT NULL;
+CREATE INDEX idx_players_status ON players (status);
+CREATE INDEX idx_players_rating ON players (rating DESC);
+
+-- 复合索引优化多条件筛选
+CREATE INDEX idx_players_status_rating ON players (status, rating DESC) WHERE status IN ('available', 'busy');
+
+-- GIN 索引优化数组查询
+CREATE INDEX idx_players_games_gin ON players USING gin(games);
+CREATE INDEX idx_players_tags_gin ON players USING gin(tags);
+
+-- 店铺+状态复合索引
+CREATE INDEX idx_players_shop_status ON players (shop_id, status, rating DESC) WHERE shop_id IS NOT NULL;
+
+CREATE TRIGGER trigger_players_updated_at
+    BEFORE UPDATE
+    ON players
+    FOR EACH ROW
+    EXECUTE FUNCTION update_updated_at_column();