SuperAPI AI 工具集

engineering-postgres-game-schema

数据与分析

查看项目

更新于 10-15 21:41

技能介绍

用途:为游戏项目设计通用(不绑定具体品类)的 PostgreSQL 数据库模式,覆盖玩家数据模型、背包系统、排行榜、会话、事件、成就、货币、社交关系与公会等。

主要能力:提供核心表结构模板(boilerplate/schema.ts)、实体扩展模板(templates/entity-template.ts)与常见查询模式(templates/query-patterns.ts),包括背包查询、排行榜查询、事件聚合与 JSONB 过滤。设计原则强调:用 JSONB 存储可扩展的 stats、properties、metadata;所有表带 createdAt/updatedAt;优先软删除(deletedAt)而非物理删除;固定类别用枚举类型;按常见查询建立复合索引;外键按需级联删除;用 drizzle-kit 管理版本化迁移。

使用方式:安装依赖,命令为 bun add drizzle-orm @neondatabase/serverless 与 bun add -d drizzle-kit;在项目根目录创建 drizzle.config.ts;定义模式后执行 bunx drizzle-kit generate 生成迁移,bunx drizzle-kit migrate 运行迁移,然后按查询模式模板读写数据。

适用场景:需要为任意品类(不预设 RPG、MMO 或放置类)搭建游戏后端数据库,或使用 Drizzle ORM + PostgreSQL(含 Neon Serverless)进行数据建模时。

限制与注意:不要将游戏状态整体存为单个 JSON blob,应规范化建表、JSONB 只放可扩展字段;面向玩家的标识不要用自增 ID,改用 UUID 或 nanoid 防止枚举;勿在核心表硬编码品类专属列(如 swordDamage);勿物理删除;勿遗漏 (playerId, type) 等复合索引。该技能为基础技能,无前置要求。其他收费、平台与具体效果信息暂未提供。