基础代码生成

This commit is contained in:
lu7213 committed 2026-10-22 11:09:36 -04:00
1 parent 352d7d023f
commit 1c0544afe0
122 files changed
+21475

No files matched your search

+169
View File
@@ -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)