Add entity system + unified polymorphic reward type (#19)

* Add entity module — RPG entity system with admin dashboard (#19)

Phase 1 of the entity system: Schema/Blueprint/Skin/FormationConfig
CRUD with full admin dashboard and i18n support.

Backend (apps/server):
- 8 new tables: entity_schemas, entity_blueprints, entity_blueprint_skins,
  entity_instances, entity_slot_assignments, entity_formation_configs,
  entity_formations, entity_action_logs
- Flexible schema system: orgs define entity types (hero, weapon, skill)
  with configurable stats, tags, slots, level/rank/synthesis rules
- Tag-based slot compatibility (e.g. warrior heroes only accept warrior weapons)
- Service layer with full CRUD + alias conflict detection + cascade deletion
- 20 admin REST endpoints with OpenAPI/Zod validation
- 32 service tests (all passing against real Neon DB)
- Migration 0014 generated and applied

Frontend (apps/admin):
- Entity dashboard with tabbed view (schemas + formation configs)
- Schema create/detail pages with dynamic stat/tag/slot editors
- Blueprint create/detail pages with schema-driven forms
- Skin create page
- Formation config create page
- 6 reusable components (SchemaTable, SchemaForm, BlueprintTable,
  BlueprintForm, SkinTable, FormationConfigTable)
- React Query hooks for all CRUD operations
- Full i18n (en + zh) with ~75 new message keys
- Sidebar navigation entry with Sparkles icon

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add entity instance management, progression, slots, and formations

Phase 2-5 of the entity system — all runtime operations:

Instance management:
- acquireEntity: create new instances with computed initial stats
- listInstances: filter by schemaId/blueprintId (backpack categories)
- getInstance: returns instance + equipped slot details
- discardEntity: with lock protection and equipped-check
- toggleLock: prevent accidental discard/synthesis

Progression system:
- addExp: direct experience injection (battle rewards)
- levelUp: consumes item materials per blueprint.levelUpCosts config
- rankUp: consumes materials, advances rank (N→R→SR→SSR)
- synthesize: merge N duplicate entities, consuming feeds + materials

Stat computation pipeline:
- Pure function: base + growth×(level-1) + rank bonuses + equipment + skin
- Cached in computedStats JSONB, recomputed on every mutation
- Read paths return cached values (zero computation)

Slot system:
- equip/unequip with schema + tag compatibility validation
- $owner.class dynamic tag matching (warrior heroes accept warrior weapons)
- Unique constraint: one entity can only be in one slot at a time

Formations:
- updateFormation: upsert with schema/duplicate validation
- listFormations: per-config, per-user

Client API: 14 new endpoints under /api/client/entity/
Tests: 55/55 passing (32 Phase 1 + 23 Phase 2-5)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Unify reward system with polymorphic RewardEntry type

Replace all ItemEntry[] JSONB columns with RewardEntry[] across the
entire platform. RewardEntry uses a polymorphic { type, id, count }
shape instead of the old { definitionId, quantity }.

This means a single column handles all reward types — items, entities,
and future types (points, external goods) — without ever needing to
add new columns.

Changes:
- Add src/lib/rewards.ts with RewardEntry type, grantRewards() and
  deductCosts() dispatch functions, filterByType() helper
- Update all 8 schema files (shop, lottery, mail, exchange, check-in,
  collection, cdkey, entity) to use RewardEntry[] type annotations
- Update itemService.grantItems/deductItems to accept both
  RewardEntry { id, count } and legacy { definitionId, quantity }
- Update all 8 module services, validators, routes, and types to use
  the new RewardEntry format
- Update all test files with new { type: "item", id, count } format
- No schema migration needed (JSONB columns, type change is TS-only)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: dengzhaofun

apps/admin/messages/en.json

@@ -114,6 +114,10 @@
   "common_type": "Type",
   "common_icon": "Icon",
   "common_sort_order": "Sort Order",
+  "common_required": "Required",
+  "common_optional": "optional",
+  "common_yes": "Yes",
+  "common_no": "No",
   "common_dash": "—",
   "dashboard_title": "Dashboard",
   "dashboard_welcome": "Welcome, {name}",
@@ -758,5 +762,78 @@
   "gift_package_deleted": "Gift package deleted",
   "gift_no_settings": "No gift settings configured yet.",
   "gift_no_packages": "No gift packages yet.",
-  "gift_items_count": "Items"
+  "gift_items_count": "Items",
+
+  "nav_entity": "Entity",
+  "entity_title": "Entity System",
+  "entity_schemas": "Entity Schemas",
+  "entity_blueprints": "Blueprints",
+  "entity_skins": "Skins",
+  "entity_formations": "Formation Configs",
+  "entity_new_schema": "New Schema",
+  "entity_new_blueprint": "New Blueprint",
+  "entity_new_skin": "New Skin",
+  "entity_new_formation": "New Formation Config",
+  "entity_schema_created": "Schema created successfully",
+  "entity_schema_updated": "Schema updated",
+  "entity_schema_deleted": "Schema deleted",
+  "entity_blueprint_created": "Blueprint created successfully",
+  "entity_blueprint_updated": "Blueprint updated",
+  "entity_blueprint_deleted": "Blueprint deleted",
+  "entity_skin_created": "Skin created successfully",
+  "entity_skin_updated": "Skin updated",
+  "entity_skin_deleted": "Skin deleted",
+  "entity_formation_created": "Formation config created successfully",
+  "entity_formation_updated": "Formation config updated",
+  "entity_formation_deleted": "Formation config deleted",
+  "entity_no_schemas": "No entity schemas yet.",
+  "entity_no_blueprints": "No blueprints yet.",
+  "entity_no_skins": "No skins yet.",
+  "entity_no_formations": "No formation configs yet.",
+  "entity_stat_definitions": "Stat Definitions",
+  "entity_tag_definitions": "Tag Definitions",
+  "entity_slot_definitions": "Slot Definitions",
+  "entity_level_config": "Level Config",
+  "entity_rank_config": "Rank Config",
+  "entity_synthesis_config": "Synthesis Config",
+  "entity_base_stats": "Base Stats",
+  "entity_stat_growth": "Stat Growth",
+  "entity_level_up_costs": "Level Up Costs",
+  "entity_rank_up_costs": "Rank Up Costs",
+  "entity_synthesis_cost": "Synthesis Cost",
+  "entity_tags": "Tags",
+  "entity_assets": "Assets",
+  "entity_rarity": "Rarity",
+  "entity_max_level": "Max Level",
+  "entity_max_formations": "Max Formations",
+  "entity_max_slots": "Max Slots Per Formation",
+  "entity_accepts_schemas": "Accepted Schemas",
+  "entity_allow_duplicate_blueprints": "Allow Duplicate Blueprints",
+  "entity_stat_bonuses": "Stat Bonuses",
+  "entity_is_default": "Default Skin",
+  "entity_delete_schema_title": "Delete Schema?",
+  "entity_delete_schema_desc": "This will permanently delete the schema and all associated blueprints, skins, and instances.",
+  "entity_delete_blueprint_title": "Delete Blueprint?",
+  "entity_delete_blueprint_desc": "This will permanently delete the blueprint and all associated skins and instances.",
+  "entity_delete_skin_title": "Delete Skin?",
+  "entity_delete_skin_desc": "This will permanently delete this skin.",
+  "entity_delete_formation_title": "Delete Formation Config?",
+  "entity_delete_formation_desc": "This will permanently delete this formation config and all player formations using it.",
+  "entity_enabled": "Enabled",
+  "entity_disabled": "Disabled",
+  "entity_same_blueprint_required": "Same Blueprint Required",
+  "entity_input_count": "Input Count",
+  "entity_ranks": "Ranks",
+  "entity_key": "Key",
+  "entity_label": "Label",
+  "entity_type": "Type",
+  "entity_default_value": "Default Value",
+  "entity_values": "Values",
+  "entity_accepted_schema_ids": "Accepted Schema IDs",
+  "entity_accept_tags": "Accept Tags",
+  "entity_max_count": "Max Count",
+  "entity_add_stat": "Add Stat",
+  "entity_add_tag": "Add Tag",
+  "entity_add_slot": "Add Slot",
+  "entity_add_rank": "Add Rank"
 }

apps/admin/messages/zh.json

@@ -114,6 +114,10 @@
   "common_type": "类型",
   "common_icon": "图标",
   "common_sort_order": "排序",
+  "common_required": "必填",
+  "common_optional": "可选",
+  "common_yes": "是",
+  "common_no": "否",
   "common_dash": "—",
   "dashboard_title": "仪表盘",
   "dashboard_welcome": "欢迎，{name}",
@@ -758,5 +762,78 @@
   "gift_package_deleted": "礼包已删除",
   "gift_no_settings": "尚未配置赠礼设置。",
   "gift_no_packages": "暂无礼包模板。",
-  "gift_items_count": "物品数"
+  "gift_items_count": "物品数",
+
+  "nav_entity": "实体",
+  "entity_title": "实体系统",
+  "entity_schemas": "实体类型",
+  "entity_blueprints": "模板",
+  "entity_skins": "皮肤",
+  "entity_formations": "编队配置",
+  "entity_new_schema": "新建类型",
+  "entity_new_blueprint": "新建模板",
+  "entity_new_skin": "新建皮肤",
+  "entity_new_formation": "新建编队配置",
+  "entity_schema_created": "类型创建成功",
+  "entity_schema_updated": "类型已更新",
+  "entity_schema_deleted": "类型已删除",
+  "entity_blueprint_created": "模板创建成功",
+  "entity_blueprint_updated": "模板已更新",
+  "entity_blueprint_deleted": "模板已删除",
+  "entity_skin_created": "皮肤创建成功",
+  "entity_skin_updated": "皮肤已更新",
+  "entity_skin_deleted": "皮肤已删除",
+  "entity_formation_created": "编队配置创建成功",
+  "entity_formation_updated": "编队配置已更新",
+  "entity_formation_deleted": "编队配置已删除",
+  "entity_no_schemas": "暂无实体类型。",
+  "entity_no_blueprints": "暂无模板。",
+  "entity_no_skins": "暂无皮肤。",
+  "entity_no_formations": "暂无编队配置。",
+  "entity_stat_definitions": "属性定义",
+  "entity_tag_definitions": "标签定义",
+  "entity_slot_definitions": "槽位定义",
+  "entity_level_config": "等级配置",
+  "entity_rank_config": "升阶配置",
+  "entity_synthesis_config": "合成配置",
+  "entity_base_stats": "基础属性",
+  "entity_stat_growth": "属性成长",
+  "entity_level_up_costs": "升级消耗",
+  "entity_rank_up_costs": "升阶消耗",
+  "entity_synthesis_cost": "合成消耗",
+  "entity_tags": "标签",
+  "entity_assets": "资源",
+  "entity_rarity": "稀有度",
+  "entity_max_level": "最大等级",
+  "entity_max_formations": "最大队伍数",
+  "entity_max_slots": "每队最大人数",
+  "entity_accepts_schemas": "接受的类型",
+  "entity_allow_duplicate_blueprints": "允许同模板",
+  "entity_stat_bonuses": "属性加成",
+  "entity_is_default": "默认皮肤",
+  "entity_delete_schema_title": "删除类型？",
+  "entity_delete_schema_desc": "此操作将永久删除该类型及其所有关联的模板、皮肤和实例。",
+  "entity_delete_blueprint_title": "删除模板？",
+  "entity_delete_blueprint_desc": "此操作将永久删除该模板及其所有关联的皮肤和实例。",
+  "entity_delete_skin_title": "删除皮肤？",
+  "entity_delete_skin_desc": "此操作将永久删除此皮肤。",
+  "entity_delete_formation_title": "删除编队配置？",
+  "entity_delete_formation_desc": "此操作将永久删除此编队配置及所有使用它的玩家编队数据。",
+  "entity_enabled": "已启用",
+  "entity_disabled": "已禁用",
+  "entity_same_blueprint_required": "需要同模板",
+  "entity_input_count": "输入数量",
+  "entity_ranks": "阶位",
+  "entity_key": "键名",
+  "entity_label": "标签",
+  "entity_type": "类型",
+  "entity_default_value": "默认值",
+  "entity_values": "可选值",
+  "entity_accepted_schema_ids": "接受的类型ID",
+  "entity_accept_tags": "接受的标签",
+  "entity_max_count": "最大数量",
+  "entity_add_stat": "添加属性",
+  "entity_add_tag": "添加标签",
+  "entity_add_slot": "添加槽位",
+  "entity_add_rank": "添加阶位"
 }

apps/admin/src/components/AppSidebar.tsx

@@ -13,6 +13,7 @@ import {
   Package,
   Shield,
   ShoppingCart,
+  Sparkles,
   Swords,
   Ticket,
   Users,
@@ -39,6 +40,7 @@ function getNavItems() {
     { title: m.nav_dashboard(), to: "/dashboard" as const, icon: LayoutDashboard },
     { title: m.nav_checkin(), to: "/check-in" as const, icon: CalendarCheck },
     { title: m.nav_item(), to: "/item" as const, icon: Package },
+    { title: m.nav_entity(), to: "/entity" as const, icon: Sparkles },
     { title: m.nav_exchange(), to: "/exchange" as const, icon: ArrowLeftRight },
     { title: m.nav_cdkey(), to: "/cdkey" as const, icon: Ticket },
     { title: m.nav_shop(), to: "/shop" as const, icon: ShoppingCart },