Files
usdt/docs/rental/check_schema.py
T

170 lines
7.9 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
"""离线验证租赁 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)