gplan-2/game/data/schemas/shop_table.gd

# VERTICAL SLICE - NOT FOR PRODUCTION
# Validation Question: 玩家能否在 Boss 前商店房用战斗掉落 GP 购买三属性锻造档，兑现「数值提升→后续战斗改善」的局内成长闭环（P1）
# Date: 2026-09-21（GP+商店房实施批——2026-09-20 用户拍板，设计权威 design/research/proposal-gp-shop-room-2026-09-20.md 裁决记录）
# 数据配置 ShopTable schema（GP 冒险钱包 × 商店房 行族四轴）。
# 行族四轴（数据契约对齐 ConfigDB.shop_* 访问器——消费面一律走访问器，禁直读行集）：
# gp_drops = 战斗掉落掷定行（键 tier：normal/elite/boss 封闭词表；掷定 = roll_min..roll_max 均匀整数，
# mean = 期望锚——roll_min ≤ mean ≤ roll_max，行动经济 条款①期望当量锚同款纪律）；elite 为预留行
#（当前无消费方，随精英节点内容批启用）。level_gp_bonus = 关级掉落加值行（level_index 连续从 1 递增）。
# products = 商品行（键 product_id；三件全陈列无刷新无摇号——2026-09-20 拍板）；
# 现价公式 = base_price + price_level_bonus(关卡) + price_increment × 该商品已购档数（已购档数在 冒险结构）。
# price_level_bonus = 关级定价加值行（level_index 连续从 1 递增）。
# pool_shelf = 共享池货架行（M-4 迭代 11 第②批 T1——需求卡片 v1.3 P1 共享池/P4 ceil）：键 kind_id 词表
# 封闭 = 四切边后种（SHELF_KINDS：attack/max_hp/armor/ap——GP 袋负交易切边、规则改写型特性三轴 doctrine 切边）；
# 库存=上限即库存（账本在 冒险结构 _curio_taken 单点共享，行族不记库存）；price_a/price_b = 乘法价格
# 因子（公式 ceil(base × b^(关序−1) × A^(本次进店已购次数))，provisional 投值——P5 甲研究拍板后置追认）。
# products 行族 + 加法定价随 legacy 模式（shop=off 对照承载）保留，退役归 off 锚换代批。
# 行值全部 provisional 归 难度曲线与Boss（用户拍板骨架先行、数值整体后置）。
class_name ShopTable
extends Resource

@export var gp_drops: Array[Dictionary] = []           # Array[Dictionary] 键 tier
@export var level_gp_bonus: Array[Dictionary] = []     # Array[Dictionary] 键 level_index
@export var products: Array[Dictionary] = []           # Array[Dictionary] 键 product_id
@export var price_level_bonus: Array[Dictionary] = []  # Array[Dictionary] 键 level_index
@export var pool_shelf: Array[Dictionary] = []         # Array[Dictionary] 键 kind_id（迭代 11 第②批 T1）
@export var price_a: float = 0.0                       # 进店已购次数爬价因子（provisional——0 = 未投值即致命域）
@export var price_b: float = 0.0                       # 跨关递增因子（provisional）

const GP_TIERS := ["normal", "elite", "boss"]
const PRODUCT_ATTRS := ["atk", "max_hp", "armor_class"]
const SHELF_KINDS := ["attack", "max_hp", "armor", "ap", "feat_ticket", "heal"]   # 货架候选词表（四切边后种 + T5 门票行 + T6 heal 补回复〔默认原则：分类内成员都入该渠道池〕——奇物批迭代15②）


func validate() -> Array:
	var errs: Array[Dictionary] = []
	# 行族空护栏（legacy 四轴 + pool_shelf 皆为 ConfigDB 消费面——缺族即致命）
	for family in ["gp_drops", "level_gp_bonus", "products", "price_level_bonus", "pool_shelf"]:
		if get(family).is_empty():
			errs.append({"category": "empty_table", "message": "ShopTable 行族为空: %s" % family})
	# gp_drops：tier 词表封闭 + 掷定域 + 均值锚 + tier 唯一
	var seen_tier := {}
	for row in gp_drops:
		var tier: String = row.get("tier", "")
		if not GP_TIERS.has(tier):
			errs.append({"category": "enum", "message": "gp_drops tier 出域 {normal, elite, boss}: %s" % tier})
		if seen_tier.has(tier):
			errs.append({"category": "dup_key", "message": "gp_drops tier 重复: %s" % tier})
		seen_tier[tier] = true
		if String(row.get("display_name", "")) == "":
			errs.append({"category": "domain", "message": "gp_drops %s display_name 空" % tier})
		var rmin: int = int(row.get("roll_min", -1))
		var mean: int = int(row.get("mean", -1))
		var rmax: int = int(row.get("roll_max", -1))
		if rmin < 0 or mean < 0 or rmax < 0 or rmax > 999:
			errs.append({"category": "domain", "message": "gp_drops %s 掷定域越域 [0,999]: %d..%d..%d" % [tier, rmin, mean, rmax]})
		if rmin > mean or mean > rmax:
			errs.append({"category": "cross_field", "message": "gp_drops %s 违反 roll_min(%d) ≤ mean(%d) ≤ roll_max(%d)——均值恒等期望锚" % [tier, rmin, mean, rmax]})
	# level_gp_bonus / price_level_bonus：level_index 连续从 1 递增 + 加值域
	for family in ["level_gp_bonus", "price_level_bonus"]:
		var arr: Array = get(family)
		var seen := {}
		for row in arr:
			var li: int = int(row.get("level_index", 0))
			if seen.has(li):
				errs.append({"category": "dup_key", "message": "%s level_index 重复: %d" % [family, li]})
			seen[li] = true
			var bonus: int = int(row.get("bonus", -1))
			if bonus < 0 or bonus > 999:
				errs.append({"category": "domain", "message": "%s level %d bonus 越域 [0,999]: %d" % [family, li, bonus]})
		for i in arr.size():
			var li: int = int(arr[i].get("level_index", 0))
			if li != i + 1:
				errs.append({"category": "structural", "message": "%s level_index 不连续（须从 1 连续递增）: 位 %d = %d" % [family, i + 1, li]})
				break
	# products：product_id 唯一 + attr 词表 + 价格域 [1,999]
	var seen_pid := {}
	for row in products:
		var pid: String = row.get("product_id", "")
		if pid == "":
			errs.append({"category": "domain", "message": "products product_id 空"})
			continue
		if seen_pid.has(pid):
			errs.append({"category": "dup_key", "message": "products product_id 重复: %s" % pid})
		seen_pid[pid] = true
		if String(row.get("display_name", "")) == "":
			errs.append({"category": "domain", "message": "%s display_name 空" % pid})
		var attr: String = row.get("attr", "")
		if not PRODUCT_ATTRS.has(attr):
			errs.append({"category": "enum", "message": "%s attr 出域 {atk, max_hp, armor_class}: %s" % [pid, attr]})
		var flat: int = int(row.get("flat_value", 0))
		if flat < 1 or flat > 999:
			errs.append({"category": "domain", "message": "%s flat_value 越域 [1,999]: %d" % [pid, flat]})
		var base: int = int(row.get("base_price", 0))
		if base < 1 or base > 999:
			errs.append({"category": "domain", "message": "%s base_price 越域 [1,999]: %d" % [pid, base]})
		var inc: int = int(row.get("price_increment", -1))
		if inc < 0 or inc > 999:
			errs.append({"category": "domain", "message": "%s price_increment 越域 [0,999]: %d" % [pid, inc]})
	# pool_shelf：kind_id 词表封闭（四切边后种）+ 唯一 + display_name + base_price 域 [1,999]（迭代 11 第②批 T1）
	var seen_kind := {}
	for row in pool_shelf:
		var kind: String = row.get("kind_id", "")
		if not SHELF_KINDS.has(kind):
			errs.append({"category": "enum", "message": "pool_shelf kind_id 出域（四切边后种封闭词表）: %s" % kind})
		if seen_kind.has(kind):
			errs.append({"category": "dup_key", "message": "pool_shelf kind_id 重复: %s" % kind})
		seen_kind[kind] = true
		if String(row.get("display_name", "")) == "":
			errs.append({"category": "domain", "message": "pool_shelf %s display_name 空" % kind})
		var base: int = int(row.get("base_price", 0))
		if base < 1 or base > 999:
			errs.append({"category": "domain", "message": "pool_shelf %s base_price 越域 [1,999]: %d" % [kind, base]})
	# 价格因子域（乘法语义——A/b 均 ≥1 单调不降；上界防手滑投值；provisional 值本体归难度曲线与Boss）
	if price_a < 1.0 or price_a > 3.0:
		errs.append({"category": "domain", "message": "price_a 越域 [1.0,3.0]: %f" % price_a})
	if price_b < 1.0 or price_b > 2.0:
		errs.append({"category": "domain", "message": "price_b 越域 [1.0,2.0]: %f" % price_b})
	return errs