Merge remote-tracking branch 'entropy-xu/payment-billing-plans'

# Conflicts:
#	crates/aether-data/src/lifecycle/bootstrap/postgres.rs
#	crates/aether-data/src/lifecycle/migrate/tests.rs
#	frontend/src/views/admin/Users.vue

crates/aether-data/migrations/mysql/20260512090000_add_payment_gateway_plans.sql

@@ -0,0 +1,79 @@
+ALTER TABLE payment_orders
+  ADD COLUMN payment_provider VARCHAR(64),
+  ADD COLUMN payment_channel VARCHAR(64),
+  ADD COLUMN order_kind VARCHAR(64) NOT NULL DEFAULT 'wallet_recharge',
+  ADD COLUMN product_id VARCHAR(64),
+  ADD COLUMN product_snapshot TEXT,
+  ADD COLUMN fulfillment_status VARCHAR(64) NOT NULL DEFAULT 'pending',
+  ADD COLUMN fulfillment_error TEXT;
+
+CREATE INDEX idx_payment_orders_kind_status
+  ON payment_orders (order_kind, status);
+CREATE INDEX idx_payment_orders_product
+  ON payment_orders (product_id);
+
+CREATE TABLE IF NOT EXISTS payment_gateway_configs (
+    provider VARCHAR(64) PRIMARY KEY,
+    enabled BOOLEAN NOT NULL DEFAULT FALSE,
+    endpoint_url VARCHAR(512) NOT NULL,
+    callback_base_url VARCHAR(512),
+    merchant_id VARCHAR(128) NOT NULL,
+    merchant_key_encrypted TEXT,
+    pay_currency VARCHAR(16) NOT NULL DEFAULT 'CNY',
+    usd_exchange_rate DOUBLE NOT NULL DEFAULT 7.2,
+    min_recharge_usd DOUBLE NOT NULL DEFAULT 1,
+    channels_json TEXT,
+    created_at BIGINT NOT NULL,
+    updated_at BIGINT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS billing_plans (
+    id VARCHAR(64) PRIMARY KEY,
+    title VARCHAR(128) NOT NULL,
+    description TEXT,
+    price_amount DOUBLE NOT NULL,
+    price_currency VARCHAR(16) NOT NULL DEFAULT 'CNY',
+    duration_unit VARCHAR(32) NOT NULL,
+    duration_value BIGINT NOT NULL,
+    enabled BOOLEAN NOT NULL DEFAULT TRUE,
+    sort_order BIGINT NOT NULL DEFAULT 0,
+    max_active_per_user BIGINT NOT NULL DEFAULT 1,
+    entitlements_json TEXT NOT NULL,
+    created_at BIGINT NOT NULL,
+    updated_at BIGINT NOT NULL,
+    KEY idx_billing_plans_enabled_sort (enabled, sort_order)
+);
+
+CREATE TABLE IF NOT EXISTS user_plan_entitlements (
+    id VARCHAR(64) PRIMARY KEY,
+    user_id VARCHAR(64) NOT NULL,
+    plan_id VARCHAR(64) NOT NULL,
+    payment_order_id VARCHAR(64) NOT NULL,
+    status VARCHAR(64) NOT NULL DEFAULT 'active',
+    starts_at BIGINT NOT NULL,
+    expires_at BIGINT NOT NULL,
+    entitlements_snapshot TEXT NOT NULL,
+    created_at BIGINT NOT NULL,
+    updated_at BIGINT NOT NULL,
+    KEY idx_user_plan_entitlements_user_active (user_id, status, expires_at),
+    KEY idx_user_plan_entitlements_order (payment_order_id),
+    CONSTRAINT user_plan_entitlements_user_id_fkey FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE,
+    CONSTRAINT user_plan_entitlements_plan_id_fkey FOREIGN KEY (plan_id) REFERENCES billing_plans(id) ON DELETE RESTRICT,
+    CONSTRAINT user_plan_entitlements_payment_order_id_fkey FOREIGN KEY (payment_order_id) REFERENCES payment_orders(id) ON DELETE RESTRICT
+);
+
+CREATE TABLE IF NOT EXISTS entitlement_usage_ledgers (
+    id VARCHAR(64) PRIMARY KEY,
+    user_entitlement_id VARCHAR(64) NOT NULL,
+    user_id VARCHAR(64) NOT NULL,
+    request_id VARCHAR(128) NOT NULL,
+    amount_usd DOUBLE NOT NULL,
+    balance_before DOUBLE NOT NULL,
+    balance_after DOUBLE NOT NULL,
+    usage_date VARCHAR(16) NOT NULL,
+    created_at BIGINT NOT NULL,
+    UNIQUE KEY uq_entitlement_usage_request (user_entitlement_id, request_id),
+    KEY idx_entitlement_usage_user_date (user_id, usage_date),
+    CONSTRAINT entitlement_usage_ledgers_entitlement_fkey FOREIGN KEY (user_entitlement_id) REFERENCES user_plan_entitlements(id) ON DELETE CASCADE,
+    CONSTRAINT entitlement_usage_ledgers_user_id_fkey FOREIGN KEY (user_id) REFERENCES users(id) ON DELETE CASCADE
+);

crates/aether-data/migrations/mysql/20260512110000_add_billing_plan_purchase_limit_scope.sql

@@ -0,0 +1,2 @@
+ALTER TABLE billing_plans
+  ADD COLUMN purchase_limit_scope VARCHAR(32) NOT NULL DEFAULT 'active_period';