基础代码生成
This commit is contained in:
1 parent
352d7d023f
commit
1c0544afe0
122 files changed
+21475
No files matched your search
@@ -0,0 +1,169 @@
|
||||
"""离线验证租赁 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), 16)
|
||||
self.assertEqual(len(re.findall(r"CREATE TABLE", DDL)), 16)
|
||||
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)
|
||||
Reference in new issue
Block a user