"""离线验证租赁 DDL 的索引语义、文档覆盖及资金算例。 运行:python docs/rental/check_schema.py 仅使用标准库。SQLite 内存库只映射实际 DDL 的列名和唯一键, 用于验证冲突/NULL 占位语义,不替代 MySQL 方言、类型或并发事务测试。 """ from decimal import Decimal from pathlib import Path import re import sqlite3 import unittest ROOT = Path(__file__).resolve().parents[2] DDL = (ROOT / "sql/rent_init.sql").read_text(encoding="utf-8") TABLES = {} for match in re.finditer( r"CREATE TABLE IF NOT EXISTS `([^`]+)` \((.*?)\n\) ENGINE=.*?;", DDL, re.S, ): name, body = match.groups() columns = re.findall(r"^ `([^`]+)` (.+?)(?:,)?$", body, re.M) unique = [ (key, re.findall(r"`([^`]+)`", fields)) for key, fields in re.findall( r"UNIQUE KEY `([^`]+)` \(([^)]+)\)", body ) ] TABLES[name] = (columns, unique) class RentalDesignChecks(unittest.TestCase): def setUp(self): self.db = sqlite3.connect(":memory:") self.serial = 0 for table, (columns, unique) in TABLES.items(): definitions = [ '"id" INTEGER PRIMARY KEY' if field == "id" else f'"{field}" TEXT' for field, _ in columns ] definitions.extend( "UNIQUE (" + ",".join(f'"{field}"' for field in fields) + ")" for _, fields in unique ) self.db.execute(f'CREATE TABLE "{table}" ({",".join(definitions)})') self.addCleanup(self.db.close) def insert(self, table, **values): self.serial += 1 # 为与本用例无关的唯一列使用独立值,避免错误命中其他唯一键。 row = { field: f"row-{self.serial}-{field}" for field, _ in TABLES[table][0] if field != "id" } row.update(values) self.db.execute( f'INSERT INTO "{table}" ({",".join(row)}) ' f'VALUES ({",".join("?" for _ in row)})', tuple(row.values()), ) def conflict(self, table, **values): with self.assertRaises(sqlite3.IntegrityError): self.insert(table, **values) def test_table_and_document_coverage(self): self.assertEqual(len(TABLES), 17) self.assertEqual(len(re.findall(r"CREATE TABLE", DDL)), 17) doc = (ROOT / "docs/rental/table-functional-flows.md").read_text("utf-8") sections = set(re.findall(r"### 2\.\d+ (rent_\w+):", doc)) self.assertEqual(sections, set(TABLES)) for table, (columns, unique) in TABLES.items(): fields = {name for name, _ in columns} self.assertEqual(len(fields), len(columns), table) self.assertTrue({"id", "version", "created_at", "updated_at"} <= fields) for name, definition in columns: self.assertIn("COMMENT '", definition, f"{table}.{name}") for key, parts in unique: self.assertTrue(set(parts) <= fields, f"{table}.{key}") executable = re.sub(r"--[^\n]*", "", DDL) self.assertNotRegex(executable, r"(?i)\b(DROP|ALTER|DELETE|TRUNCATE)\b") def test_document_local_links(self): for path in (ROOT / "docs/rental").glob("*.md"): for target in re.findall(r"\]\(([^)]+)\)", path.read_text("utf-8")): if "://" not in target and not target.startswith("#"): self.assertTrue((path.parent / target.split("#")[0]).exists(), target) def test_order_relation_exclusion_and_null_release(self): key = dict(wallet_id=7, receiver_address="receiver-A", resource_type="ENERGY") self.insert("rent_order", **key, relation_slot=1) self.conflict("rent_order", **key, relation_slot=1) self.insert("rent_order", **key, relation_slot=None) self.insert("rent_order", **key, relation_slot=None) self.insert("rent_order", **{**key, "resource_type": "BANDWIDTH"}, relation_slot=1) self.insert("rent_order", **{**key, "receiver_address": "receiver-B"}, relation_slot=1) def test_wallet_execution_shared_by_delegate_and_reclaim(self): key = dict(wallet_id=7, resource_type="ENERGY", wallet_execution_slot=1) self.insert("rent_task", **key, task_type="DELEGATE") self.conflict("rent_task", **key, task_type="RECLAIM") self.insert("rent_task", **{**key, "resource_type": "BANDWIDTH"}) self.insert("rent_task", **{**key, "wallet_execution_slot": None}) self.insert("rent_task", **{**key, "wallet_execution_slot": None}) def test_task_attempt_active_slot(self): key = dict(order_id=11, task_type="DELEGATE", active_slot=1) self.insert("rent_task", **key, attempt_no=1) self.conflict("rent_task", **key, attempt_no=2) self.insert("rent_task", **{**key, "active_slot": None}, attempt_no=2) self.conflict("rent_task", **{**key, "active_slot": None}, attempt_no=2) def test_refund_request_deduplication(self): self.insert("rent_refund", order_id=11, request_no="request-A") self.conflict("rent_refund", order_id=11, request_no="request-A") self.insert("rent_refund", order_id=11, request_no="request-B") def test_multiple_partial_refund_webhooks(self): self.insert("rent_webhook", order_id=11, event_type="REFUNDED", event_key="REFUND:R1", order_event_sequence=2) self.insert("rent_webhook", order_id=11, event_type="REFUNDED", event_key="REFUND:R2", order_event_sequence=3) self.conflict("rent_webhook", order_id=11, event_type="REFUNDED", event_key="REFUND:R1", order_event_sequence=4) self.conflict("rent_webhook", order_id=11, event_type="REFUNDED", event_key="REFUND:R3", order_event_sequence=3) def test_payout_and_payment_reference_uniqueness(self): self.insert("rent_settlement", payout_no="P1", payment_reference="MAINNET:tx:0") self.conflict("rent_settlement", payout_no="P1", payment_reference=None) self.conflict("rent_settlement", payout_no="P2", payment_reference="MAINNET:tx:0") self.insert("rent_settlement", payout_no=None, payment_reference=None) self.insert("rent_settlement", payout_no=None, payment_reference=None) def test_settlement_order_source_not_reusable_after_paid(self): self.insert("rent_settlement_item", order_id=11, active_slot=1) self.conflict("rent_settlement_item", order_id=11, active_slot=1) self.insert("rent_settlement_item", order_id=11, active_slot=None) def test_topup_global_business_key(self): key = "TOPUP:MAINNET:" + "a" * 64 + ":2147483647" self.assertLessEqual(len(key), 160) self.insert("rent_ledger", account_id=1, business_key=key) self.conflict("rent_ledger", account_id=2, business_key=key) def test_one_transaction_per_task_and_hash(self): self.insert("rent_transaction", task_id=11, network="NILE", tx_id="tx1") self.conflict("rent_transaction", task_id=11, network="NILE", tx_id="tx2") self.conflict("rent_transaction", task_id=12, network="NILE", tx_id="tx1") def test_supplier_fee_return_example(self): # 精确金额算例:账户待结算增量必须与来源订单可结算额一致。 gross, fee = Decimal("10"), Decimal("0.5") returned, reversed_net = Decimal("0.2"), Decimal("0.3") ledger_pending = gross - fee + returned - reversed_net order_source = Decimal("9.5") - reversed_net + returned self.assertEqual(ledger_pending, order_source) self.assertEqual(order_source, Decimal("9.4")) # 退商户的手续费已包含于M:基础退款+手续费退款=M,不能M+F。 merchant_refund, merchant_fee_part = Decimal("1"), Decimal("0.2") self.assertEqual((merchant_refund - merchant_fee_part) + merchant_fee_part, merchant_refund) if __name__ == "__main__": unittest.main(verbosity=2)