-- Fresh-install cloud business tables. PHP is the sole writer of these records. -- Public sales geography is independent from the host Agent profile. A -- stable region code is used in URLs and snapshots; the display name may be -- changed without changing an existing order's identity. CREATE TABLE cloud_regions ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, code VARCHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, name VARCHAR(80) NOT NULL, country_code CHAR(2) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, status VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'active', sort INT NOT NULL DEFAULT 0, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_region_code (code), KEY cloud_region_catalog (status, sort, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Lines always exist in the data model. When the feature switch is off, the -- panel uses the one default line created for each region and hides the line -- choice from ordinary users. This avoids a production schema migration when -- differentiated network products are enabled later. CREATE TABLE cloud_network_lines ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, region_id BIGINT UNSIGNED NOT NULL, code VARCHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, name VARCHAR(80) NOT NULL, is_default TINYINT(1) NOT NULL DEFAULT 0, status VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'active', sort INT NOT NULL DEFAULT 0, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_network_line_code (region_id, code), KEY cloud_network_line_catalog (region_id, status, sort, id), KEY cloud_network_line_default (region_id, is_default, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_resource_pools ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, line_id BIGINT UNSIGNED NOT NULL, code VARCHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, name VARCHAR(80) NOT NULL, status VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'active', scheduling_policy VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'balanced', sort INT NOT NULL DEFAULT 0, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_resource_pool_code (line_id, code), KEY cloud_resource_pool_catalog (line_id, status, sort, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_hosts ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, name VARCHAR(80) NOT NULL, region VARCHAR(64) NOT NULL DEFAULT '', country_code CHAR(2) NOT NULL DEFAULT '', enabled TINYINT(1) NOT NULL DEFAULT 0, default_network VARCHAR(128) NOT NULL DEFAULT 'bridge:br0', created_at BIGINT NOT NULL, updated_at BIGINT NOT NULL, KEY cloud_host_name (name) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- The panel owns one purpose-bound sealed HMAC secret per physical host. The -- numeric host_id is also the Agent identity used by the outbound gateway; -- no host Agent address is stored because Agents initiate every connection. CREATE TABLE cloud_host_agents ( host_id BIGINT UNSIGNED NOT NULL PRIMARY KEY, sealed_api_secret LONGTEXT NOT NULL, enabled TINYINT(1) NOT NULL DEFAULT 0, revision BIGINT UNSIGNED NOT NULL DEFAULT 1, tested_revision BIGINT UNSIGNED NOT NULL DEFAULT 0, last_test_status VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'never', last_error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', last_agent_version VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', last_tested_at BIGINT UNSIGNED NOT NULL DEFAULT 0, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, KEY cloud_host_agent_enabled (enabled, last_test_status, tested_revision, revision, host_id), KEY cloud_host_agent_test (last_test_status, last_tested_at) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- The panel stores only the requested host-local directories; the Agent owns -- validation and registration of the five fixed libvirt pools. This row -- points at the latest requested generation; superseded failed generations -- remain immutable in cloud_jobs under their original operation IDs. CREATE TABLE cloud_host_storage_configurations ( host_id BIGINT UNSIGNED NOT NULL PRIMARY KEY, revision BIGINT UNSIGNED NOT NULL DEFAULT 0, managed_directory TEXT NOT NULL, template_directory TEXT NOT NULL, seed_directory TEXT NOT NULL, user_iso_directory TEXT NOT NULL, rescue_directory TEXT NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'applying', operation_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, job_id BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, KEY cloud_host_storage_state (state, updated_at, host_id), UNIQUE KEY cloud_host_storage_operation (operation_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- A physical host may eventually participate in more than one commercial -- resource pool. Compute capacity remains host-global; this relation only -- controls which pools may schedule work onto the host. The first multi-CIDR -- release keeps at most one active membership per host in application logic, -- while the schema is already safe for a later multi-line rollout. CREATE TABLE cloud_host_resource_pool_memberships ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, host_id BIGINT UNSIGNED NOT NULL, resource_pool_id BIGINT UNSIGNED NOT NULL, scheduler_state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'disabled', priority INT NOT NULL DEFAULT 0, weight SMALLINT UNSIGNED NOT NULL DEFAULT 100, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_host_pool_membership (host_id, resource_pool_id), KEY cloud_pool_membership_scheduler (resource_pool_id, scheduler_state, priority, host_id), KEY cloud_host_membership_scheduler (host_id, scheduler_state, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- One attachment references a panel-selected existing host network, such as -- bridge:br0 or network:default. The Agent validates the actual host resource. -- Several CIDR blocks may share the same attachment. Binding the attachment -- to a network line keeps physical egress separate from compute capacity. CREATE TABLE cloud_host_network_attachments ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, attachment_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, host_id BIGINT UNSIGNED NOT NULL, line_id BIGINT UNSIGNED NOT NULL, name VARCHAR(80) NOT NULL, network_mode VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'selector', network_selector VARCHAR(128) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, vlan_id SMALLINT UNSIGNED DEFAULT NULL, routing_table INT UNSIGNED DEFAULT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'active', priority INT NOT NULL DEFAULT 0, desired_revision BIGINT UNSIGNED NOT NULL DEFAULT 1, observed_revision BIGINT UNSIGNED NOT NULL DEFAULT 0, sync_state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'never', last_error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_host_network_attachment_key (host_id, attachment_key), KEY cloud_host_network_attachment_line (host_id, line_id, state, priority, id), KEY cloud_network_attachment_sync (sync_state, updated_at, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- A public pool is an allocation boundary, not a compute resource pool. The -- child cloud_public_ips rows remain the authoritative concrete-address -- ledger used by payment-time placement and reconciliation. CREATE TABLE cloud_public_ip_pools ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, pool_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, host_id BIGINT UNSIGNED NOT NULL, network_attachment_id BIGINT UNSIGNED NOT NULL, name VARCHAR(80) NOT NULL, cidr VARCHAR(18) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, gateway VARCHAR(15) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, guest_prefix_length TINYINT UNSIGNED NOT NULL, dns_servers_json TEXT NOT NULL, reserved_ips_json TEXT NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'active', priority INT NOT NULL DEFAULT 0, desired_revision BIGINT UNSIGNED NOT NULL DEFAULT 1, observed_revision BIGINT UNSIGNED NOT NULL DEFAULT 0, sync_state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'never', last_error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_public_ip_pool_key (host_id, pool_key), UNIQUE KEY cloud_public_ip_pool_cidr (host_id, cidr), KEY cloud_public_ip_pool_attachment (network_attachment_id, state, priority, id), KEY cloud_public_ip_pool_sync (host_id, sync_state, updated_at, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Operator limits and safety reserves are authoritative scheduling policy. -- Zero configured capacity keeps a new host unschedulable until explicitly -- configured; it never means unlimited capacity. CREATE TABLE cloud_host_capacity_policies ( host_id BIGINT UNSIGNED NOT NULL PRIMARY KEY, configured_cpu_cores SMALLINT UNSIGNED NOT NULL DEFAULT 0, configured_memory_mib BIGINT UNSIGNED NOT NULL DEFAULT 0, configured_disk_gib BIGINT UNSIGNED NOT NULL DEFAULT 0, safety_cpu_cores SMALLINT UNSIGNED NOT NULL DEFAULT 0, safety_memory_mib BIGINT UNSIGNED NOT NULL DEFAULT 0, safety_disk_gib BIGINT UNSIGNED NOT NULL DEFAULT 0, max_instances INT UNSIGNED NOT NULL DEFAULT 0, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- PHP reserves one concrete address before a paid provisioning job is queued. -- The host Agent validates the claim on the selected host. An -- uncertain operation keeps the address unavailable until reconciliation. CREATE TABLE cloud_public_ips ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, host_id BIGINT UNSIGNED NOT NULL, public_ip_pool_id BIGINT UNSIGNED DEFAULT NULL, address VARCHAR(45) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, prefix_length TINYINT UNSIGNED NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'available', reservation_id BIGINT UNSIGNED DEFAULT NULL, instance_id BIGINT UNSIGNED DEFAULT NULL, operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_public_ip_address (address), KEY cloud_public_ip_available (host_id, state, id), KEY cloud_public_ip_pool_available (public_ip_pool_id, state, id), UNIQUE KEY cloud_public_ip_reservation (reservation_id), KEY cloud_public_ip_instance (instance_id), UNIQUE KEY cloud_public_ip_operation (operation_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- A base plan describes resources. An offer places and prices that plan in -- one resource pool. Region and line are therefore reached through the pool -- without duplicating mutable labels on this row. CREATE TABLE cloud_offers ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, plan_id BIGINT UNSIGNED NOT NULL, resource_pool_id BIGINT UNSIGNED NOT NULL, code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, name VARCHAR(128) NOT NULL, price DECIMAL(12,2) NOT NULL DEFAULT 0.00, currency CHAR(3) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'USD', price_version INT UNSIGNED NOT NULL DEFAULT 1, revision INT UNSIGNED NOT NULL DEFAULT 1, status TINYINT(1) NOT NULL DEFAULT 1, stock INT NOT NULL DEFAULT -1, sort INT NOT NULL DEFAULT 0, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_offer_code (code), UNIQUE KEY cloud_offer_plan_pool (plan_id, resource_pool_id), KEY cloud_offer_catalog (resource_pool_id, status, sort, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- PHP owns the global image catalog. generation_token is assigned once and -- never changes; revision advances for every mutable metadata/script update. CREATE TABLE cloud_templates ( id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL PRIMARY KEY, name VARCHAR(64) NOT NULL, os_family VARCHAR(32) NOT NULL, os_version VARCHAR(32) NOT NULL, source_type VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, sealed_source_url LONGTEXT NOT NULL, image_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, startup_script MEDIUMTEXT NOT NULL, revision BIGINT UNSIGNED NOT NULL DEFAULT 1, generation_token CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'importing', active_job_id BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_template_generation (generation_token), KEY cloud_template_catalog (state, os_family, os_version, name) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- A PHP catalog entry is usable on a host only after that Agent confirms the -- same immutable generation and current revision. Placement joins this ledger -- so a host missing the selected image can never receive the create request. CREATE TABLE cloud_template_replicas ( host_id BIGINT UNSIGNED NOT NULL, template_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, revision BIGINT UNSIGNED NOT NULL, generation_token CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'pending', image_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', operation_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', job_id BIGINT UNSIGNED DEFAULT NULL, error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, PRIMARY KEY (host_id, template_id), KEY cloud_template_replica_ready (template_id, state, revision, host_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Personal ISO identity and quotas are global PHP policy. Each enabled host -- receives the same opaque ID; host-local progress lives in the replica table. CREATE TABLE cloud_user_isos ( id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL PRIMARY KEY, user_id BIGINT UNSIGNED NOT NULL, name VARCHAR(64) NOT NULL, sealed_source_url LONGTEXT NOT NULL, size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'importing', import_operation_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, active_job_id BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_user_iso_operation (import_operation_id), KEY cloud_user_iso_owner (user_id, state, created_at) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_user_iso_replicas ( host_id BIGINT UNSIGNED NOT NULL, user_iso_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, user_id BIGINT UNSIGNED NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'pending', size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', operation_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, job_id BIGINT UNSIGNED DEFAULT NULL, error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, PRIMARY KEY (host_id, user_iso_id), KEY cloud_user_iso_replica_owner (user_id, state, host_id), KEY cloud_user_iso_replica_operation (operation_id, state) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Rescue templates are host-local, but deletion is still a durable, -- single-dispatch Agent operation. Its terminal tombstone forbids replay. CREATE TABLE cloud_rescue_template_deletions ( host_id BIGINT UNSIGNED NOT NULL, template_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, operation_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, job_id BIGINT UNSIGNED NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, PRIMARY KEY (host_id, template_id), UNIQUE KEY cloud_rescue_delete_operation (host_id, operation_id), KEY cloud_rescue_delete_state (state, updated_at) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Rescue-template imports are host-local durable jobs. The source URL and -- bearer token is retained only inside the encrypted CloudJob payload. CREATE TABLE cloud_rescue_template_imports ( operation_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL PRIMARY KEY, host_id BIGINT UNSIGNED NOT NULL, template_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, job_id BIGINT UNSIGNED NOT NULL, import_type VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, name VARCHAR(64) NOT NULL, size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_rescue_import_template (host_id, template_id), KEY cloud_rescue_import_state (state, updated_at), KEY cloud_rescue_import_host (host_id, created_at) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Local administrator uploads are pulled by each Agent through a distinct, -- short-lived bearer capability. Only its SHA-256 hash is persisted. CREATE TABLE cloud_upload_staging ( id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL PRIMARY KEY, host_id BIGINT UNSIGNED NOT NULL, purpose VARCHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, file_key VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, size_bytes BIGINT UNSIGNED NOT NULL, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, token_hash CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, expires_at BIGINT UNSIGNED NOT NULL, consumed_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_upload_staging_token (token_hash), KEY cloud_upload_staging_expiry (expires_at, consumed_at), KEY cloud_upload_staging_file (file_key, expires_at) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_instances ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, uuid CHAR(36) NOT NULL, host_id BIGINT UNSIGNED NOT NULL, user_id BIGINT UNSIGNED NOT NULL, order_id BIGINT UNSIGNED DEFAULT NULL, plan_id BIGINT UNSIGNED DEFAULT NULL, offer_id BIGINT UNSIGNED DEFAULT NULL, resource_pool_id BIGINT UNSIGNED DEFAULT NULL, reservation_id BIGINT UNSIGNED DEFAULT NULL, current_period_id BIGINT UNSIGNED DEFAULT NULL, name VARCHAR(63) NOT NULL, status VARCHAR(32) NOT NULL DEFAULT 'active', service_status VARCHAR(32) NOT NULL DEFAULT 'exempt', network_status VARCHAR(32) NOT NULL DEFAULT 'active', expires_at BIGINT UNSIGNED DEFAULT NULL, renewal_price DECIMAL(12,2) DEFAULT NULL, renewal_days INT UNSIGNED NOT NULL DEFAULT 0, renewal_traffic_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, traffic_quota_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, traffic_download_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, traffic_upload_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, lifetime_download_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, lifetime_upload_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, traffic_synced_at BIGINT UNSIGNED NOT NULL DEFAULT 0, suspended_at BIGINT UNSIGNED DEFAULT NULL, network_suspended_at BIGINT UNSIGNED DEFAULT NULL, spec_json LONGTEXT NOT NULL, sealed_credential LONGTEXT DEFAULT NULL, created_at BIGINT NOT NULL, updated_at BIGINT NOT NULL, UNIQUE KEY uniq_cloud_host_vm (host_id, uuid), UNIQUE KEY uniq_cloud_instance_order (order_id), UNIQUE KEY uniq_cloud_instance_reservation (reservation_id), KEY cloud_instance_owner (user_id, status), KEY cloud_instance_placement (resource_pool_id, host_id, status), KEY cloud_instance_lifecycle (service_status, expires_at, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Desired/applied host-enforced firewall state. The policy row is the current -- tenant view, immutable versions retain idempotency/audit evidence, and rules -- contain only the typed public DTO (never hypervisor XML or host commands). CREATE TABLE cloud_instance_firewalls ( instance_id BIGINT UNSIGNED NOT NULL PRIMARY KEY, user_id BIGINT UNSIGNED NOT NULL, host_id BIGINT UNSIGNED NOT NULL, enabled TINYINT(1) NOT NULL DEFAULT 0, desired_revision BIGINT UNSIGNED NOT NULL DEFAULT 0, applied_revision BIGINT UNSIGNED NOT NULL DEFAULT 0, desired_digest CHAR(64) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, applied_digest CHAR(64) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, sync_state VARCHAR(24) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'disabled', last_operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, last_success_at BIGINT UNSIGNED NOT NULL DEFAULT 0, last_failure_at BIGINT UNSIGNED NOT NULL DEFAULT 0, last_error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, KEY cloud_instance_firewall_owner (user_id, instance_id), KEY cloud_instance_firewall_host (host_id, sync_state, instance_id), KEY cloud_instance_firewall_operation (last_operation_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_instance_firewall_versions ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, instance_id BIGINT UNSIGNED NOT NULL, revision BIGINT UNSIGNED NOT NULL, enabled TINYINT(1) NOT NULL DEFAULT 0, policy_digest CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, request_hash CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, idempotency_key VARCHAR(128) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'pending', job_id BIGINT UNSIGNED DEFAULT NULL, operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, applied_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_instance_firewall_revision (instance_id, revision), UNIQUE KEY cloud_instance_firewall_idempotency (instance_id, idempotency_key), KEY cloud_instance_firewall_version_job (job_id), KEY cloud_instance_firewall_version_operation (operation_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_instance_firewall_rules ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, version_id BIGINT UNSIGNED NOT NULL, sequence SMALLINT UNSIGNED NOT NULL, direction VARCHAR(8) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'ingress', protocol VARCHAR(8) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, source_cidr VARCHAR(18) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, port_from SMALLINT UNSIGNED DEFAULT NULL, port_to SMALLINT UNSIGNED DEFAULT NULL, description VARCHAR(100) NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_instance_firewall_rule_sequence (version_id, sequence), KEY cloud_instance_firewall_rule_version (version_id, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Administrator-owned deny-only test catalog. The single state row provides -- optimistic concurrency and a stable revision for provisioning snapshots. -- Rules are soft-deleted for audit, but deployed instances never read this -- catalog again: their effective policy is sealed into the create job. CREATE TABLE cloud_platform_test_policy_state ( id TINYINT UNSIGNED NOT NULL PRIMARY KEY, revision BIGINT UNSIGNED NOT NULL DEFAULT 0, updated_by BIGINT UNSIGNED DEFAULT NULL, updated_at BIGINT UNSIGNED NOT NULL DEFAULT 0 ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; INSERT IGNORE INTO cloud_platform_test_policy_state (id, revision, updated_by, updated_at) VALUES (1, 0, NULL, 0); CREATE TABLE cloud_platform_test_policy_rules ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, rule_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, service VARCHAR(120) NOT NULL, protocol VARCHAR(8) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, port_from SMALLINT UNSIGNED NOT NULL, port_to SMALLINT UNSIGNED NOT NULL, direction VARCHAR(8) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, reason VARCHAR(500) NOT NULL, created_by BIGINT UNSIGNED NOT NULL, updated_by BIGINT UNSIGNED NOT NULL, deleted_by BIGINT UNSIGNED DEFAULT NULL, deleted_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_platform_test_policy_rule_key (rule_key), KEY cloud_platform_test_policy_active (deleted_at, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- PHP-owned catalog for same-host local recovery points. Only opaque keys and -- bounded metadata are stored here; Agent volume names and host paths never -- cross into the business database or tenant API. CREATE TABLE cloud_instance_snapshots ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, snapshot_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, instance_id BIGINT UNSIGNED NOT NULL, user_id BIGINT UNSIGNED NOT NULL, host_id BIGINT UNSIGNED NOT NULL, name VARCHAR(64) NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'creating', consistency VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, size_bytes BIGINT UNSIGNED DEFAULT NULL, last_operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, ready_at BIGINT UNSIGNED DEFAULT NULL, last_restored_at BIGINT UNSIGNED DEFAULT NULL, deleted_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_instance_snapshot_key (snapshot_key), KEY cloud_instance_snapshot_slots (instance_id, state, id), KEY cloud_instance_snapshot_owner (user_id, instance_id, id), KEY cloud_instance_snapshot_operation (last_operation_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Portable, object-storage-backed VM system-disk backups. The immutable -- source/spec and sealed storage target snapshots keep old backups restorable -- after the global object-storage configuration changes. Object URLs and -- provider credentials never appear in browser responses. CREATE TABLE cloud_instance_backups ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, backup_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, source_instance_id BIGINT UNSIGNED NOT NULL, source_host_id BIGINT UNSIGNED NOT NULL, user_id BIGINT UNSIGNED NOT NULL, source_uuid CHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, name VARCHAR(80) NOT NULL, purpose VARCHAR(24) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'portable', state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'creating', consistency VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, object_key VARCHAR(512) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, object_size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, virtual_size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', spec_json LONGTEXT NOT NULL, sealed_storage_runtime LONGTEXT NOT NULL, sealed_credential LONGTEXT DEFAULT NULL, storage_revision BIGINT UNSIGNED NOT NULL, active_job_id BIGINT UNSIGNED DEFAULT NULL, last_operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', ready_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_instance_backup_key (backup_key), UNIQUE KEY cloud_instance_backup_object (object_key), KEY cloud_instance_backup_source (source_instance_id, state, id), KEY cloud_instance_backup_owner (user_id, id), KEY cloud_instance_backup_operation (last_operation_id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- An ordinary restore creates a separate administrator-managed VM and does not -- copy billing state. Maintenance migration also uses this table for its -- hidden, pre-reserved target, but keeps target_instance_id NULL and preserves -- the original business instance row through cloud_instance_migrations. CREATE TABLE cloud_backup_restores ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, restore_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, backup_id BIGINT UNSIGNED NOT NULL, target_host_id BIGINT UNSIGNED NOT NULL, target_instance_id BIGINT UNSIGNED DEFAULT NULL, reservation_id BIGINT UNSIGNED DEFAULT NULL, job_id BIGINT UNSIGNED DEFAULT NULL, operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, new_uuid CHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, new_name VARCHAR(63) NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'restoring', error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', ready_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_backup_restore_key (restore_key), UNIQUE KEY cloud_backup_restore_operation (operation_id), UNIQUE KEY cloud_backup_restore_reservation (reservation_id), UNIQUE KEY cloud_backup_restore_instance (target_instance_id), KEY cloud_backup_restore_backup (backup_id, state, id), KEY cloud_backup_restore_host (target_host_id, state, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- A maintenance migration keeps the original business instance row and its -- billing/traffic periods. This separate ledger binds the cold source backup, -- hidden target restore and optional source cleanup without overloading the -- independent-restore contract above. CREATE TABLE cloud_instance_migrations ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, migration_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, instance_id BIGINT UNSIGNED NOT NULL, backup_id BIGINT UNSIGNED NOT NULL, restore_id BIGINT UNSIGNED DEFAULT NULL, source_host_id BIGINT UNSIGNED NOT NULL, source_uuid CHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, source_reservation_id BIGINT UNSIGNED NOT NULL, target_host_id BIGINT UNSIGNED NOT NULL, target_uuid CHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, target_reservation_id BIGINT UNSIGNED DEFAULT NULL, backup_job_id BIGINT UNSIGNED NOT NULL, restore_job_id BIGINT UNSIGNED DEFAULT NULL, firewall_job_id BIGINT UNSIGNED DEFAULT NULL, activate_job_id BIGINT UNSIGNED DEFAULT NULL, rollback_job_id BIGINT UNSIGNED DEFAULT NULL, cleanup_job_id BIGINT UNSIGNED DEFAULT NULL, cleanup_mode VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, state VARCHAR(24) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'backing_up', source_was_running TINYINT(1) DEFAULT NULL, source_autostart_enabled TINYINT(1) DEFAULT NULL, source_service_status VARCHAR(24) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, source_network_status VARCHAR(24) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', cutover_at BIGINT UNSIGNED DEFAULT NULL, completed_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_instance_migration_key (migration_key), UNIQUE KEY cloud_instance_migration_backup (backup_id), UNIQUE KEY cloud_instance_migration_restore (restore_id), UNIQUE KEY cloud_instance_migration_backup_job (backup_job_id), UNIQUE KEY cloud_instance_migration_restore_job (restore_job_id), UNIQUE KEY cloud_instance_migration_firewall_job (firewall_job_id), UNIQUE KEY cloud_instance_migration_activate_job (activate_job_id), UNIQUE KEY cloud_instance_migration_rollback_job (rollback_job_id), UNIQUE KEY cloud_instance_migration_cleanup_job (cleanup_job_id), KEY cloud_instance_migration_instance (instance_id, state, id), KEY cloud_instance_migration_source (source_host_id, source_uuid), KEY cloud_instance_migration_target (target_host_id, target_uuid) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Immutable object-store artifacts that exist only for one maintenance -- migration. Ordinary cloud backups remain a single system.qcow2 object and -- never create rows in this table. CREATE TABLE cloud_migration_bundle_artifacts ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, migration_id BIGINT UNSIGNED NOT NULL, source_snapshot_id BIGINT UNSIGNED NOT NULL, snapshot_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, name VARCHAR(64) NOT NULL, consistency VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, object_key VARCHAR(512) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, object_size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, virtual_size_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'creating', snapshot_created_at BIGINT UNSIGNED NOT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_migration_bundle_snapshot (migration_id, snapshot_key), UNIQUE KEY cloud_migration_bundle_source_snapshot (migration_id, source_snapshot_id), UNIQUE KEY cloud_migration_bundle_object (object_key), KEY cloud_migration_bundle_state (migration_id, state, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Last-known Agent power state for fast instance-list first paint. This is -- an observation cache only; cloud_instances remains the lifecycle source of -- truth and the host Agent remains authoritative for the current power state. CREATE TABLE cloud_instance_runtime ( instance_id BIGINT UNSIGNED NOT NULL PRIMARY KEY, host_id BIGINT UNSIGNED NOT NULL, uuid CHAR(36) NOT NULL, power_state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'unknown', sync_state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'never', last_success_at BIGINT UNSIGNED NOT NULL DEFAULT 0, last_attempt_at BIGINT UNSIGNED NOT NULL DEFAULT 0, revision BIGINT UNSIGNED NOT NULL DEFAULT 0, last_error_code VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_instance_runtime_identity (host_id, uuid), KEY cloud_instance_runtime_sync (sync_state, last_success_at), KEY cloud_instance_runtime_host (host_id, updated_at) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_orders ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, user_id BIGINT UNSIGNED NOT NULL, plan_id BIGINT UNSIGNED NOT NULL, offer_id BIGINT UNSIGNED DEFAULT NULL, resource_pool_id BIGINT UNSIGNED DEFAULT NULL, host_id BIGINT UNSIGNED DEFAULT NULL, reservation_id BIGINT UNSIGNED DEFAULT NULL, idempotency_key VARCHAR(128) NOT NULL, request_hash CHAR(64) NOT NULL, amount DECIMAL(12,2) NOT NULL, currency CHAR(3) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'USD', status VARCHAR(32) NOT NULL DEFAULT 'queued', spec_json LONGTEXT NOT NULL, sealed_payload LONGTEXT DEFAULT NULL, instance_id BIGINT UNSIGNED DEFAULT NULL, refunded_at BIGINT DEFAULT NULL, stock_reserved_at BIGINT UNSIGNED DEFAULT NULL, stock_released_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT NOT NULL, updated_at BIGINT NOT NULL, UNIQUE KEY uniq_cloud_order_request (user_id, idempotency_key), UNIQUE KEY uniq_cloud_order_reservation (reservation_id), KEY cloud_order_owner (user_id, id), KEY cloud_order_offer_state (offer_id, status, id), KEY cloud_order_placement (resource_pool_id, host_id, status), KEY cloud_order_admin_created (created_at, id), KEY cloud_order_admin_status (status, created_at, id), KEY cloud_order_admin_user (user_id, created_at, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Reservations are the auditable resource ledger. The per-host capacity -- policy row is locked before sums over held/committed/uncertain rows are -- evaluated, serializing concurrent schedulers without an Agent round trip. CREATE TABLE cloud_resource_reservations ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, reservation_key CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, order_id BIGINT UNSIGNED DEFAULT NULL, backup_restore_id BIGINT UNSIGNED DEFAULT NULL, offer_id BIGINT UNSIGNED DEFAULT NULL, resource_pool_id BIGINT UNSIGNED NOT NULL, host_id BIGINT UNSIGNED NOT NULL, user_id BIGINT UNSIGNED NOT NULL, instance_id BIGINT UNSIGNED DEFAULT NULL, network_attachment_id BIGINT UNSIGNED DEFAULT NULL, public_ip_pool_id BIGINT UNSIGNED DEFAULT NULL, public_ip_id BIGINT UNSIGNED DEFAULT NULL, cpu_cores SMALLINT UNSIGNED NOT NULL, memory_mib BIGINT UNSIGNED NOT NULL, disk_gib BIGINT UNSIGNED NOT NULL, state VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'held', expires_at BIGINT UNSIGNED DEFAULT NULL, released_at BIGINT UNSIGNED DEFAULT NULL, release_reason VARCHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY cloud_resource_reservation_key (reservation_key), UNIQUE KEY cloud_resource_reservation_operation (operation_id), UNIQUE KEY cloud_resource_reservation_order (order_id), UNIQUE KEY cloud_resource_reservation_backup_restore (backup_restore_id), KEY cloud_resource_reservation_host (host_id, state, expires_at, id), KEY cloud_resource_reservation_pool (resource_pool_id, state, id), KEY cloud_resource_reservation_instance (instance_id), KEY cloud_resource_reservation_network (network_attachment_id, public_ip_pool_id), KEY cloud_resource_reservation_ip (public_ip_id), CONSTRAINT chk_cloud_resource_reservation_source CHECK ( (order_id IS NOT NULL AND backup_restore_id IS NULL AND offer_id IS NOT NULL) OR (order_id IS NULL AND backup_restore_id IS NOT NULL AND offer_id IS NULL) ) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_service_periods ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, instance_id BIGINT UNSIGNED NOT NULL, user_id BIGINT UNSIGNED NOT NULL, plan_id BIGINT UNSIGNED DEFAULT NULL, order_id BIGINT UNSIGNED DEFAULT NULL, renewal_id BIGINT UNSIGNED DEFAULT NULL, starts_at BIGINT UNSIGNED NOT NULL, ends_at BIGINT UNSIGNED NOT NULL, traffic_quota_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, download_base_bytes BIGINT UNSIGNED DEFAULT NULL, upload_base_bytes BIGINT UNSIGNED DEFAULT NULL, download_used_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, upload_used_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, status VARCHAR(16) NOT NULL DEFAULT 'scheduled', activated_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY uniq_cloud_period_order (order_id), UNIQUE KEY uniq_cloud_period_renewal (renewal_id), KEY cloud_period_timeline (instance_id, starts_at, ends_at), KEY cloud_period_activation (status, starts_at, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_renewals ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, instance_id BIGINT UNSIGNED NOT NULL, user_id BIGINT UNSIGNED NOT NULL, plan_id BIGINT UNSIGNED DEFAULT NULL, period_id BIGINT UNSIGNED DEFAULT NULL, idempotency_key VARCHAR(128) NOT NULL, request_hash CHAR(64) NOT NULL, amount DECIMAL(12,2) NOT NULL, validity_days INT UNSIGNED NOT NULL, traffic_bytes_added BIGINT UNSIGNED NOT NULL DEFAULT 0, previous_expires_at BIGINT UNSIGNED NOT NULL, new_expires_at BIGINT UNSIGNED NOT NULL, created_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY uniq_cloud_renewal_request (user_id, idempotency_key), KEY cloud_renewal_instance (instance_id, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_invoices ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, invoice_no VARCHAR(40) NOT NULL, purpose VARCHAR(16) NOT NULL DEFAULT 'renewal', instance_id BIGINT UNSIGNED DEFAULT NULL, order_id BIGINT UNSIGNED DEFAULT NULL, user_id BIGINT UNSIGNED NOT NULL, plan_id BIGINT UNSIGNED DEFAULT NULL, offer_id BIGINT UNSIGNED DEFAULT NULL, renewal_id BIGINT UNSIGNED DEFAULT NULL, renews_expires_at BIGINT UNSIGNED DEFAULT NULL, due_at BIGINT UNSIGNED NOT NULL, amount DECIMAL(12,2) NOT NULL, currency CHAR(3) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'USD', validity_days INT UNSIGNED NOT NULL, traffic_quota_bytes BIGINT UNSIGNED NOT NULL DEFAULT 0, status VARCHAR(16) NOT NULL DEFAULT 'open', paid_via VARCHAR(32) DEFAULT NULL, payment_reference VARCHAR(80) DEFAULT NULL, paid_at BIGINT UNSIGNED DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY uniq_cloud_invoice_no (invoice_no), UNIQUE KEY uniq_cloud_invoice_order (order_id), KEY cloud_invoice_period (instance_id, renews_expires_at, status), UNIQUE KEY uniq_cloud_invoice_renewal (renewal_id), KEY cloud_invoice_owner (user_id, status, due_at), KEY cloud_invoice_due (status, due_at, id), KEY cloud_invoice_overview_paid (status, paid_at, purpose, plan_id), KEY cloud_invoice_admin_created (created_at, id), KEY cloud_invoice_admin_status (status, created_at, id), KEY cloud_invoice_admin_purpose (purpose, created_at, id), KEY cloud_invoice_admin_user (user_id, created_at, id), KEY cloud_invoice_admin_method (paid_via, created_at, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_invoice_payments ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, invoice_id BIGINT UNSIGNED NOT NULL, user_id BIGINT UNSIGNED NOT NULL, provider VARCHAR(24) NOT NULL, provider_order_no VARCHAR(64) NOT NULL, idempotency_key VARCHAR(128) NOT NULL, amount DECIMAL(12,2) NOT NULL, status VARCHAR(24) NOT NULL DEFAULT 'creating', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY uniq_cloud_invoice_provider_order (provider, provider_order_no), UNIQUE KEY uniq_cloud_invoice_payment_request (user_id, idempotency_key), KEY cloud_invoice_payment_invoice (invoice_id, id), KEY cloud_invoice_payment_admin_created (created_at, id), KEY cloud_invoice_payment_admin_status (status, created_at, id), KEY cloud_invoice_payment_admin_provider (provider, created_at, id), KEY cloud_invoice_payment_admin_user (user_id, created_at, id), CONSTRAINT chk_cloud_invoice_payment_status CHECK (status IN ( 'creating','pending','paid_invoice','credited_balance', 'not_created','creation_unknown' )) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_mail_outbox ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, invoice_id BIGINT UNSIGNED NOT NULL, kind VARCHAR(32) NOT NULL, status VARCHAR(16) NOT NULL DEFAULT 'pending', attempts INT UNSIGNED NOT NULL DEFAULT 0, available_at BIGINT UNSIGNED NOT NULL, lease_token CHAR(32) DEFAULT NULL, lease_until BIGINT UNSIGNED NOT NULL DEFAULT 0, sent_at BIGINT UNSIGNED DEFAULT NULL, last_error VARCHAR(500) NOT NULL DEFAULT '', created_at BIGINT UNSIGNED NOT NULL, updated_at BIGINT UNSIGNED NOT NULL, UNIQUE KEY uniq_cloud_invoice_mail (invoice_id, kind), KEY cloud_mail_delivery (status, available_at, lease_until, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_jobs ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, operation_id CHAR(32) NOT NULL, request_idempotency_key VARCHAR(128) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, request_fingerprint CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, parent_job_id BIGINT UNSIGNED DEFAULT NULL, order_id BIGINT UNSIGNED DEFAULT NULL, invoice_id BIGINT UNSIGNED DEFAULT NULL, instance_id BIGINT UNSIGNED DEFAULT NULL, snapshot_id BIGINT UNSIGNED DEFAULT NULL, backup_id BIGINT UNSIGNED DEFAULT NULL, backup_restore_id BIGINT UNSIGNED DEFAULT NULL, user_id INT NOT NULL, host_id BIGINT UNSIGNED DEFAULT NULL, kind VARCHAR(32) NOT NULL, execution_mode ENUM('agent','local','aggregate') CHARACTER SET ascii COLLATE ascii_bin NOT NULL, phase VARCHAR(24) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'accepted', outcome VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, status VARCHAR(32) NOT NULL DEFAULT 'queued', sealed_payload LONGTEXT NOT NULL, attempts INT NOT NULL DEFAULT 0, dispatch_attempts TINYINT UNSIGNED NOT NULL DEFAULT 0, dispatch_deadline_at BIGINT UNSIGNED NOT NULL, dispatch_started_at BIGINT UNSIGNED DEFAULT NULL, agent_accepted_at BIGINT UNSIGNED DEFAULT NULL, receipt_deadline_at BIGINT UNSIGNED DEFAULT NULL, terminal_at BIGINT UNSIGNED DEFAULT NULL, effect_may_have_applied TINYINT(1) DEFAULT NULL, safe_to_resubmit TINYINT(1) DEFAULT NULL, effect_resolution VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'not_applicable', effect_resolved_at BIGINT UNSIGNED DEFAULT NULL, effect_resolved_by BIGINT UNSIGNED DEFAULT NULL, effect_resolution_reason VARCHAR(500) NOT NULL DEFAULT '', finalization_incident TINYINT(1) NOT NULL DEFAULT 0, finalization_error_code VARCHAR(128) DEFAULT NULL, completion_event_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, read_at BIGINT UNSIGNED DEFAULT NULL, dispatched_at BIGINT DEFAULT NULL, lease_token CHAR(32) DEFAULT NULL, lease_until BIGINT NOT NULL DEFAULT 0, available_at BIGINT NOT NULL, error_code VARCHAR(128) DEFAULT NULL, result_json LONGTEXT DEFAULT NULL, created_at BIGINT NOT NULL, updated_at BIGINT NOT NULL, UNIQUE KEY uniq_cloud_operation (operation_id), UNIQUE KEY uniq_cloud_job_request (user_id, request_idempotency_key), UNIQUE KEY uniq_cloud_job_completion_event (completion_event_id), UNIQUE KEY uniq_cloud_provision_order (order_id), CONSTRAINT chk_cloud_job_dispatch_once CHECK (dispatch_attempts <= 1), CONSTRAINT chk_cloud_job_attempt_shape CHECK (attempts = dispatch_attempts), CONSTRAINT chk_cloud_job_phase CHECK (phase IN ('accepted','dispatching','awaiting_receipt','terminal')), CONSTRAINT chk_cloud_job_outcome CHECK (outcome IS NULL OR outcome IN ('succeeded','failed')), CONSTRAINT chk_cloud_job_effect_resolution CHECK (effect_resolution IN ('not_applicable','unknown','applied','not_applied')), CONSTRAINT chk_cloud_job_finalization_incident CHECK ( (finalization_incident = 0 AND finalization_error_code IS NULL) OR (finalization_incident = 1 AND phase = 'terminal' AND finalization_error_code IS NOT NULL) ), CONSTRAINT chk_cloud_job_terminal_shape CHECK ( (phase = 'terminal' AND outcome IS NOT NULL AND status = outcome AND terminal_at IS NOT NULL AND effect_may_have_applied IS NOT NULL AND safe_to_resubmit IS NOT NULL AND ( (outcome = 'succeeded' AND effect_may_have_applied = 0 AND safe_to_resubmit = 0 AND effect_resolution = 'applied' AND error_code IS NULL) OR (outcome = 'failed' AND ( (effect_may_have_applied = 1 AND safe_to_resubmit = 0 AND effect_resolution IN ('unknown','applied','not_applied')) OR (effect_may_have_applied = 0 AND effect_resolution = 'not_applied') )) )) OR (phase <> 'terminal' AND outcome IS NULL AND terminal_at IS NULL AND effect_may_have_applied IS NULL AND safe_to_resubmit IS NULL AND status IN ('queued','running') AND effect_resolution = 'not_applicable') ), CONSTRAINT chk_cloud_job_dispatch_shape CHECK ( phase = 'terminal' OR (phase = 'accepted' AND execution_mode IN ('agent','local') AND status = 'queued' AND attempts = 0 AND dispatch_attempts = 0 AND dispatch_started_at IS NULL AND agent_accepted_at IS NULL AND dispatched_at IS NULL AND receipt_deadline_at IS NULL) OR (phase = 'dispatching' AND execution_mode IN ('agent','local') AND status = 'running' AND attempts = 1 AND dispatch_attempts = 1 AND dispatch_started_at IS NOT NULL AND dispatched_at IS NOT NULL AND receipt_deadline_at IS NOT NULL) OR (phase = 'awaiting_receipt' AND execution_mode = 'agent' AND status = 'running' AND attempts = 1 AND dispatch_attempts = 1 AND dispatch_started_at IS NOT NULL AND dispatched_at IS NOT NULL AND receipt_deadline_at IS NOT NULL) OR (phase = 'awaiting_receipt' AND execution_mode = 'aggregate' AND host_id IS NULL AND parent_job_id IS NULL AND status = 'running' AND attempts = 0 AND dispatch_attempts = 0 AND dispatch_started_at IS NULL AND dispatched_at IS NULL AND receipt_deadline_at IS NOT NULL) ), CONSTRAINT chk_cloud_job_target_shape CHECK ( (execution_mode = 'agent' AND host_id IS NOT NULL) OR (execution_mode = 'local' AND host_id IS NULL AND parent_job_id IS NULL AND kind = 'payment_create') OR (execution_mode = 'aggregate' AND host_id IS NULL AND parent_job_id IS NULL AND kind IN ('template_import','template_metadata_sync','template_delete', 'user_iso_import','user_iso_delete')) ), CONSTRAINT chk_cloud_job_effect_shape CHECK ( effect_may_have_applied IS NULL OR effect_may_have_applied = 0 OR safe_to_resubmit = 0 ), CONSTRAINT fk_cloud_job_user FOREIGN KEY (user_id) REFERENCES `user` (id) ON DELETE RESTRICT ON UPDATE RESTRICT, KEY cloud_job_poll (phase, dispatch_deadline_at, id), KEY cloud_job_receipt_deadline (phase, receipt_deadline_at, id), KEY cloud_job_instance_state (instance_id, status, id), KEY cloud_job_invoice_state (invoice_id, phase, id), KEY cloud_job_snapshot (snapshot_id, id), KEY cloud_job_backup (backup_id, id), KEY cloud_job_backup_restore (backup_restore_id, id), KEY cloud_job_overview_state (kind, order_id, phase, outcome, terminal_at, created_at), KEY cloud_job_owner (user_id, id), KEY cloud_job_parent (parent_job_id, id) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Agent terminal receipts are immutable transport events. Retransmission of -- the same event is safe and never replays the host mutation. CREATE TABLE cloud_agent_completion_events ( event_id VARCHAR(80) CHARACTER SET ascii COLLATE ascii_bin NOT NULL PRIMARY KEY, host_id BIGINT UNSIGNED NOT NULL, operation_id CHAR(32) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, payload_sha256 CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, outcome VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, effect_may_have_applied TINYINT(1) NOT NULL, safe_to_resubmit TINYINT(1) NOT NULL, error_code VARCHAR(128) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT '', result_json LONGTEXT DEFAULT NULL, disposition VARCHAR(16) CHARACTER SET ascii COLLATE ascii_bin NOT NULL DEFAULT 'received', received_at BIGINT UNSIGNED NOT NULL, applied_at BIGINT UNSIGNED DEFAULT NULL, UNIQUE KEY uniq_cloud_completion_operation (host_id, operation_id), CONSTRAINT chk_cloud_completion_outcome CHECK (outcome IN ('succeeded','failed')), CONSTRAINT chk_cloud_completion_disposition CHECK (disposition IN ('received','applied','duplicate','late','rejected')) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_ssh_keys ( id BIGINT UNSIGNED NOT NULL AUTO_INCREMENT PRIMARY KEY, user_id BIGINT UNSIGNED NOT NULL, name VARCHAR(80) NOT NULL, public_key TEXT NOT NULL, fingerprint VARCHAR(80) NOT NULL, created_at BIGINT NOT NULL, UNIQUE KEY uniq_cloud_user_key (user_id, fingerprint) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; CREATE TABLE cloud_sessions ( id CHAR(64) NOT NULL PRIMARY KEY, user_id BIGINT UNSIGNED NOT NULL, version BIGINT NOT NULL, fingerprint CHAR(64) NOT NULL, auth_driver VARCHAR(16) NOT NULL, auth_reference TEXT DEFAULT NULL, active TINYINT(1) NOT NULL DEFAULT 1, expires_at BIGINT NOT NULL, created_at BIGINT NOT NULL, UNIQUE KEY uniq_cloud_session_fingerprint (fingerprint), KEY cloud_session_owner (user_id, active) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci; -- Browser console tickets are one-use, panel-owned mappings to the short-lived -- Agent ticket. Only a purpose-bound sealed Agent ticket is stored at rest. CREATE TABLE cloud_console_tickets ( ticket_hash CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL PRIMARY KEY, session_id CHAR(64) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, user_id BIGINT UNSIGNED NOT NULL, instance_id BIGINT UNSIGNED NOT NULL, host_id BIGINT UNSIGNED NOT NULL, vm_uuid CHAR(36) CHARACTER SET ascii COLLATE ascii_bin NOT NULL, sealed_agent_ticket LONGTEXT NOT NULL, agent_expires_at BIGINT UNSIGNED NOT NULL, ticket_expires_at BIGINT UNSIGNED NOT NULL, connection_expires_at BIGINT UNSIGNED NOT NULL, consumed_at BIGINT UNSIGNED DEFAULT NULL, connection_id CHAR(64) CHARACTER SET ascii COLLATE ascii_bin DEFAULT NULL, created_at BIGINT UNSIGNED NOT NULL, KEY cloud_console_ticket_session_expiry (session_id, ticket_expires_at), KEY cloud_console_ticket_connection_expiry (connection_id, connection_expires_at), KEY cloud_console_ticket_instance (instance_id, created_at) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;