Skip to content

ServerKit is a lightweight, modern server control panel for managing web applications, databases, and services on your VPS or dedicated server. Built with Python/Flask backend and React frontend.

perf(models): index every foreign-key column

Juan Denis5417c391009d
diff --git a/backend/app/models/agent_plugin.py b/backend/app/models/agent_plugin.py
index 162407f7..17dae7a2 100644
--- a/backend/app/models/agent_plugin.py
+++ b/backend/app/models/agent_plugin.py
@@ -104,8 +104,8 @@ class AgentPluginInstall(JsonColumnMixin, db.Model):
__tablename__ = 'agent_plugin_installs'
id = db.Column(db.Integer, primary_key=True)
- plugin_id = db.Column(db.Integer, db.ForeignKey('agent_plugins.id'), nullable=False)
- server_id = db.Column(db.Integer, db.ForeignKey('servers.id'), nullable=False)
+ plugin_id = db.Column(db.Integer, db.ForeignKey('agent_plugins.id'), nullable=False, index=True)
+ server_id = db.Column(db.Integer, db.ForeignKey('servers.id'), nullable=False, index=True)
# Installation state
STATUS_INSTALLING = 'installing'
diff --git a/backend/app/models/api_key.py b/backend/app/models/api_key.py
index 1d4558c9..0879ecb4 100644
--- a/backend/app/models/api_key.py
+++ b/backend/app/models/api_key.py
@@ -11,7 +11,7 @@ class ApiKey(JsonColumnMixin, db.Model):
__tablename__ = 'api_keys'
id = db.Column(db.Integer, primary_key=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
name = db.Column(db.String(100), nullable=False)
key_prefix = db.Column(db.String(8), nullable=False)
key_hash = db.Column(db.String(256), unique=True, nullable=False)
diff --git a/backend/app/models/api_usage.py b/backend/app/models/api_usage.py
index 33e1eaef..f9d8672b 100644
--- a/backend/app/models/api_usage.py
+++ b/backend/app/models/api_usage.py
@@ -9,8 +9,8 @@ class ApiUsageLog(SerializableMixin, db.Model):
__tablename__ = 'api_usage_logs'
id = db.Column(db.Integer, primary_key=True)
- api_key_id = db.Column(db.Integer, db.ForeignKey('api_keys.id'), nullable=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ api_key_id = db.Column(db.Integer, db.ForeignKey('api_keys.id'), nullable=True, index=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
method = db.Column(db.String(10), nullable=False)
endpoint = db.Column(db.String(500), nullable=False)
blueprint = db.Column(db.String(100), nullable=True)
@@ -33,8 +33,8 @@ class ApiUsageSummary(SerializableMixin, db.Model):
id = db.Column(db.Integer, primary_key=True)
period_start = db.Column(db.DateTime, nullable=False, index=True)
- api_key_id = db.Column(db.Integer, db.ForeignKey('api_keys.id'), nullable=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ api_key_id = db.Column(db.Integer, db.ForeignKey('api_keys.id'), nullable=True, index=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
endpoint = db.Column(db.String(500), nullable=True)
total_requests = db.Column(db.Integer, default=0)
success_count = db.Column(db.Integer, default=0)
diff --git a/backend/app/models/application.py b/backend/app/models/application.py
index fd174828..3a1dcde7 100644
--- a/backend/app/models/application.py
+++ b/backend/app/models/application.py
@@ -114,14 +114,14 @@ class Application(JsonColumnMixin, TimestampMixin, SoftDeleteMixin, db.Model):
# Environment linking
environment_type = db.Column(db.String(20), default='standalone') # 'production', 'development', 'staging', 'standalone'
- linked_app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=True)
+ linked_app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=True, index=True)
shared_config = db.Column(db.Text, nullable=True) # JSON string for shared resources
# Metadata
last_deployed_at = db.Column(db.DateTime, nullable=True)
# Foreign keys
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
server_id = db.Column(db.String(36), db.ForeignKey('servers.id'), nullable=True, index=True)
# Workspace scoping (#33). Nullable: existing rows are backfilled to a default
# workspace by migration 015; new rows are stamped on create.
diff --git a/backend/app/models/audit_log.py b/backend/app/models/audit_log.py
index f2c7d481..77d44025 100644
--- a/backend/app/models/audit_log.py
+++ b/backend/app/models/audit_log.py
@@ -9,7 +9,7 @@ class AuditLog(JsonColumnMixin, db.Model):
id = db.Column(db.Integer, primary_key=True)
action = db.Column(db.String(100), nullable=False, index=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
target_type = db.Column(db.String(50), nullable=True) # user, app, setting, etc.
target_id = db.Column(db.Integer, nullable=True)
details = db.Column(db.Text, nullable=True) # JSON string
diff --git a/backend/app/models/cf_ops_change.py b/backend/app/models/cf_ops_change.py
index 40cad4fa..a55811ba 100644
--- a/backend/app/models/cf_ops_change.py
+++ b/backend/app/models/cf_ops_change.py
@@ -28,6 +28,6 @@ class CfOpsChange(SerializableMixin, db.Model):
target = db.Column(db.String(256))
result = db.Column(db.String(16), nullable=False, default='ok')
error = db.Column(db.Text)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow, index=True)
diff --git a/backend/app/models/chat_webhook.py b/backend/app/models/chat_webhook.py
index 92716df6..3b03c441 100644
--- a/backend/app/models/chat_webhook.py
+++ b/backend/app/models/chat_webhook.py
@@ -42,7 +42,7 @@ class ChatWebhookConnection(TimestampMixin, JsonColumnMixin, db.Model):
# True when created by the one-time import of legacy notifications.json config.
imported = db.Column(db.Boolean, default=False)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
last_tested_at = db.Column(db.DateTime)
last_test_ok = db.Column(db.Boolean)
diff --git a/backend/app/models/cloud_server.py b/backend/app/models/cloud_server.py
index 3e4296cb..b4bc7c8a 100644
--- a/backend/app/models/cloud_server.py
+++ b/backend/app/models/cloud_server.py
@@ -14,7 +14,7 @@ class CloudProvider(db.Model):
provider_type = db.Column(db.String(32), nullable=False) # digitalocean, hetzner, vultr, linode
api_key_encrypted = db.Column(db.Text)
is_active = db.Column(db.Boolean, default=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
servers = db.relationship('CloudServer', backref='provider', lazy='dynamic')
@@ -35,7 +35,7 @@ class CloudServer(JsonColumnMixin, db.Model):
__tablename__ = 'cloud_servers'
id = db.Column(db.Integer, primary_key=True)
- provider_id = db.Column(db.Integer, db.ForeignKey('cloud_providers.id'), nullable=False)
+ provider_id = db.Column(db.Integer, db.ForeignKey('cloud_providers.id'), nullable=False, index=True)
external_id = db.Column(db.String(128)) # provider's server ID
name = db.Column(db.String(128), nullable=False)
hostname = db.Column(db.String(256))
@@ -68,7 +68,7 @@ class CloudServer(JsonColumnMixin, db.Model):
# Metadata
metadata_json = db.Column(db.Text)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
destroyed_at = db.Column(db.DateTime)
@@ -109,7 +109,7 @@ class CloudSnapshot(SerializableMixin, db.Model):
__tablename__ = 'cloud_snapshots'
id = db.Column(db.Integer, primary_key=True)
- server_id = db.Column(db.Integer, db.ForeignKey('cloud_servers.id'), nullable=False)
+ server_id = db.Column(db.Integer, db.ForeignKey('cloud_servers.id'), nullable=False, index=True)
external_id = db.Column(db.String(128))
name = db.Column(db.String(128))
size_gb = db.Column(db.Float)
diff --git a/backend/app/models/cloudflare_tunnel.py b/backend/app/models/cloudflare_tunnel.py
index d15bef00..cb6f08e8 100644
--- a/backend/app/models/cloudflare_tunnel.py
+++ b/backend/app/models/cloudflare_tunnel.py
@@ -21,7 +21,7 @@ class CloudflareTunnel(SerializableMixin, TimestampMixin, db.Model):
name = db.Column(db.String(128), nullable=False)
account_id = db.Column(db.String(64), nullable=False)
dns_provider_config_id = db.Column(
- db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True)
+ db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True, index=True)
token_encrypted = db.Column(db.Text) # cloudflared connector token (encrypted)
diff --git a/backend/app/models/cloudflare_worker.py b/backend/app/models/cloudflare_worker.py
index 39115543..11fdf0b3 100644
--- a/backend/app/models/cloudflare_worker.py
+++ b/backend/app/models/cloudflare_worker.py
@@ -20,7 +20,7 @@ class CloudflareWorker(TimestampMixin, db.Model):
name = db.Column(db.String(128), nullable=False, index=True) # script name
account_id = db.Column(db.String(64), nullable=False)
dns_provider_config_id = db.Column(
- db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True)
+ db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True, index=True)
source = db.Column(db.Text) # JS module we uploaded
compatibility_date = db.Column(db.String(20))
diff --git a/backend/app/models/container_registry.py b/backend/app/models/container_registry.py
index 3f15b4ea..e89d9023 100644
--- a/backend/app/models/container_registry.py
+++ b/backend/app/models/container_registry.py
@@ -34,7 +34,7 @@ class ContainerRegistry(db.Model):
secret = EncryptedSecret('secret_encrypted', legacy_plaintext=True)
# Nullable FK — a registry can be scoped to one workspace, or global (NULL).
workspace_id = db.Column(db.Integer, db.ForeignKey('workspaces.id'), nullable=True, index=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
last_used_at = db.Column(db.DateTime, nullable=True)
last_tested_at = db.Column(db.DateTime, nullable=True)
last_test_ok = db.Column(db.Boolean, nullable=True)
diff --git a/backend/app/models/db_snapshot.py b/backend/app/models/db_snapshot.py
index 44923fbb..0260008b 100644
--- a/backend/app/models/db_snapshot.py
+++ b/backend/app/models/db_snapshot.py
@@ -25,7 +25,7 @@ class DatabaseSnapshot(JsonColumnMixin, db.Model):
__tablename__ = 'database_snapshots'
id = db.Column(db.Integer, primary_key=True)
- site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False)
+ site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False, index=True)
# Snapshot info
name = db.Column(db.String(200), nullable=False)
@@ -96,8 +96,8 @@ class SyncJob(JsonColumnMixin, TimestampMixin, db.Model):
id = db.Column(db.Integer, primary_key=True)
# Source and target sites
- source_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False)
- target_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False)
+ source_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False, index=True)
+ target_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False, index=True)
# Job name
name = db.Column(db.String(200))
diff --git a/backend/app/models/ddns_host.py b/backend/app/models/ddns_host.py
index 1ed11540..e357bdd8 100644
--- a/backend/app/models/ddns_host.py
+++ b/backend/app/models/ddns_host.py
@@ -10,7 +10,7 @@ class DdnsHost(db.Model):
__tablename__ = 'ddns_hosts'
id = db.Column(db.Integer, primary_key=True)
- zone_id = db.Column(db.Integer, db.ForeignKey('dns_zones.id'), nullable=False)
+ zone_id = db.Column(db.Integer, db.ForeignKey('dns_zones.id'), nullable=False, index=True)
# Record name within the zone: '@' for the apex, or e.g. 'home' for
# home.example.com. Matches DNSRecord.name.
record_name = db.Column(db.String(256), nullable=False, default='@')
diff --git a/backend/app/models/deployment.py b/backend/app/models/deployment.py
index b0f55349..54aa07aa 100644
--- a/backend/app/models/deployment.py
+++ b/backend/app/models/deployment.py
@@ -19,7 +19,7 @@ class Deployment(JsonColumnMixin, db.Model):
__tablename__ = 'deployments'
id = db.Column(db.Integer, primary_key=True)
- app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False)
+ app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False, index=True)
# Version info
version = db.Column(db.Integer, nullable=False) # Sequential version number per app
@@ -38,7 +38,7 @@ class Deployment(JsonColumnMixin, db.Model):
container_id = db.Column(db.String(100), nullable=True)
# Deployment details
- deployed_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ deployed_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
deploy_trigger = db.Column(db.String(20), default='manual') # manual, webhook, rollback
# Build/deploy output
@@ -177,8 +177,8 @@ class DeploymentDiff(JsonColumnMixin, db.Model):
__tablename__ = 'deployment_diffs'
id = db.Column(db.Integer, primary_key=True)
- deployment_id = db.Column(db.Integer, db.ForeignKey('deployments.id'), nullable=False)
- previous_deployment_id = db.Column(db.Integer, db.ForeignKey('deployments.id'), nullable=True)
+ deployment_id = db.Column(db.Integer, db.ForeignKey('deployments.id'), nullable=False, index=True)
+ previous_deployment_id = db.Column(db.Integer, db.ForeignKey('deployments.id'), nullable=True, index=True)
# Diff content (JSON)
files_added = db.Column(db.Text, default='[]')
diff --git a/backend/app/models/deployment_job.py b/backend/app/models/deployment_job.py
index c40a0a8b..5e742795 100644
--- a/backend/app/models/deployment_job.py
+++ b/backend/app/models/deployment_job.py
@@ -31,7 +31,7 @@ class DeploymentJob(RunLifecycleMixin, JsonColumnMixin, db.Model):
# Target
target_server_id = db.Column(db.String(36), db.ForeignKey('servers.id'), nullable=True, index=True)
app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=True, index=True)
- requested_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ requested_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
trigger = db.Column(db.String(30), default='manual')
# Links to the release ledgers (§3 unification): the DeploymentJob is the
diff --git a/backend/app/models/dns_zone.py b/backend/app/models/dns_zone.py
index 4d67d420..e28e8255 100644
--- a/backend/app/models/dns_zone.py
+++ b/backend/app/models/dns_zone.py
@@ -19,7 +19,7 @@ class DNSZone(JsonColumnMixin, TimestampMixin, db.Model):
# whose API token manages this zone. Supersedes the inline token in
# provider_config_json; nullable so manual zones and not-yet-migrated rows work.
dns_provider_config_id = db.Column(
- db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True)
+ db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True, index=True)
status = db.Column(db.String(32), default='active')
last_sync_at = db.Column(db.DateTime)
@@ -54,7 +54,7 @@ class DNSRecord(SerializableMixin, TimestampMixin, db.Model):
__tablename__ = 'dns_records'
id = db.Column(db.Integer, primary_key=True)
- zone_id = db.Column(db.Integer, db.ForeignKey('dns_zones.id'), nullable=False)
+ zone_id = db.Column(db.Integer, db.ForeignKey('dns_zones.id'), nullable=False, index=True)
record_type = db.Column(db.String(10), nullable=False) # A, AAAA, CNAME, MX, TXT, SRV, CAA
name = db.Column(db.String(256), nullable=False)
diff --git a/backend/app/models/domain.py b/backend/app/models/domain.py
index 661d7425..afdd5310 100644
--- a/backend/app/models/domain.py
+++ b/backend/app/models/domain.py
@@ -25,7 +25,7 @@ class Domain(TimestampMixin, SoftDeleteMixin, db.Model):
# Metadata
# Foreign keys
- application_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False)
+ application_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False, index=True)
def to_dict(self):
return {
diff --git a/backend/app/models/email.py b/backend/app/models/email.py
index 0f3248f4..20addfa5 100644
--- a/backend/app/models/email.py
+++ b/backend/app/models/email.py
@@ -20,7 +20,7 @@ class EmailDomain(TimestampMixin, db.Model):
dmarc_record = db.Column(db.String(500))
# DNS provider linkage
- dns_provider_id = db.Column(db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True)
+ dns_provider_id = db.Column(db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True, index=True)
dns_zone_id = db.Column(db.String(255))
@@ -56,7 +56,7 @@ class EmailAccount(TimestampMixin, db.Model):
email = db.Column(db.String(255), unique=True, nullable=False, index=True)
username = db.Column(db.String(255), nullable=False)
password_hash = db.Column(db.String(500), nullable=False)
- domain_id = db.Column(db.Integer, db.ForeignKey('email_domains.id'), nullable=False)
+ domain_id = db.Column(db.Integer, db.ForeignKey('email_domains.id'), nullable=False, index=True)
quota_mb = db.Column(db.Integer, default=1024)
quota_used_mb = db.Column(db.Integer, default=0)
is_active = db.Column(db.Boolean, default=True)
@@ -88,7 +88,7 @@ class EmailAlias(db.Model):
id = db.Column(db.Integer, primary_key=True)
source = db.Column(db.String(255), nullable=False, index=True)
destination = db.Column(db.String(255), nullable=False)
- domain_id = db.Column(db.Integer, db.ForeignKey('email_domains.id'), nullable=False)
+ domain_id = db.Column(db.Integer, db.ForeignKey('email_domains.id'), nullable=False, index=True)
is_active = db.Column(db.Boolean, default=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
@@ -111,7 +111,7 @@ class EmailForwardingRule(db.Model):
__tablename__ = 'email_forwarding_rules'
id = db.Column(db.Integer, primary_key=True)
- account_id = db.Column(db.Integer, db.ForeignKey('email_accounts.id'), nullable=False)
+ account_id = db.Column(db.Integer, db.ForeignKey('email_accounts.id'), nullable=False, index=True)
destination = db.Column(db.String(255), nullable=False)
keep_copy = db.Column(db.Boolean, default=True)
is_active = db.Column(db.Boolean, default=True)
diff --git a/backend/app/models/email_provider.py b/backend/app/models/email_provider.py
index 2cb56bfa..6ce4e10d 100644
--- a/backend/app/models/email_provider.py
+++ b/backend/app/models/email_provider.py
@@ -37,7 +37,7 @@ class EmailProviderConnection(TimestampMixin, JsonColumnMixin, db.Model):
uses_relay = db.Column(db.Boolean, default=False, nullable=False)
relay_priority = db.Column(db.Integer, default=0, nullable=False)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
last_tested_at = db.Column(db.DateTime)
last_test_ok = db.Column(db.Boolean)
diff --git a/backend/app/models/env_variable.py b/backend/app/models/env_variable.py
index 06ab01c1..91d1bcaa 100644
--- a/backend/app/models/env_variable.py
+++ b/backend/app/models/env_variable.py
@@ -16,7 +16,7 @@ class EnvironmentVariable(TimestampMixin, JsonColumnMixin, db.Model):
__tablename__ = 'environment_variables'
id = db.Column(db.Integer, primary_key=True)
- application_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False)
+ application_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False, index=True)
# Parent-side backref so the delete-cascade policy covers the NOT NULL FK:
# env vars hold SECRETS — SQLite can reuse a purged app id, so orphans here
# could silently attach to a future application.
@@ -36,7 +36,7 @@ class EnvironmentVariable(TimestampMixin, JsonColumnMixin, db.Model):
# {"kind":"service","service":"db","property":"connectionString"}.
value_from = db.Column(db.Text, nullable=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
# Unique constraint: one key per application
__table_args__ = (
@@ -140,7 +140,7 @@ class EnvironmentVariableHistory(db.Model):
id = db.Column(db.Integer, primary_key=True)
env_variable_id = db.Column(db.Integer, nullable=False) # Not FK to allow deleted vars
- application_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False)
+ application_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False, index=True)
# Parent-side backref so the delete-cascade policy covers the NOT NULL FK.
application = db.relationship('Application',
backref=db.backref('env_variable_history', lazy='dynamic'))
@@ -152,7 +152,7 @@ class EnvironmentVariableHistory(db.Model):
# several per-variable audit rows. ``batch_id`` keeps those rows grouped
# without weakening the existing one-row-per-key history.
batch_id = db.Column(db.String(36), nullable=True, index=True)
- changed_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ changed_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
changed_at = db.Column(db.DateTime, default=datetime.utcnow)
@classmethod
diff --git a/backend/app/models/environment_activity.py b/backend/app/models/environment_activity.py
index beee2e47..5ca1e67d 100644
--- a/backend/app/models/environment_activity.py
+++ b/backend/app/models/environment_activity.py
@@ -16,8 +16,8 @@ class EnvironmentActivity(JsonColumnMixin, db.Model):
__tablename__ = 'environment_activities'
id = db.Column(db.Integer, primary_key=True)
- site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False, index=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
# Action details
action = db.Column(db.String(50), nullable=False) # create, deploy, promote, lock, unlock, destroy
diff --git a/backend/app/models/error_log.py b/backend/app/models/error_log.py
index 6cebe066..633f82f4 100644
--- a/backend/app/models/error_log.py
+++ b/backend/app/models/error_log.py
@@ -16,7 +16,7 @@ class ErrorLog(JsonColumnMixin, db.Model):
traceback = db.Column(db.Text, nullable=True)
endpoint = db.Column(db.String(255), nullable=True) # API path / page URL
method = db.Column(db.String(10), nullable=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
context_json = db.Column(db.Text, nullable=True) # JSON string
count = db.Column(db.Integer, nullable=False, default=1) # dedup hit counter
first_seen = db.Column(db.DateTime, default=datetime.utcnow)
diff --git a/backend/app/models/event_subscription.py b/backend/app/models/event_subscription.py
index ba7fd8c9..469deeeb 100644
--- a/backend/app/models/event_subscription.py
+++ b/backend/app/models/event_subscription.py
@@ -11,7 +11,7 @@ class EventSubscription(TimestampMixin, JsonColumnMixin, db.Model):
__tablename__ = 'event_subscriptions'
id = db.Column(db.Integer, primary_key=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
name = db.Column(db.String(100), nullable=False)
url = db.Column(db.String(2048), nullable=False)
secret = db.Column(db.String(256), nullable=True)
@@ -86,7 +86,7 @@ class EventDelivery(JsonColumnMixin, db.Model):
__tablename__ = 'event_deliveries'
id = db.Column(db.Integer, primary_key=True)
- subscription_id = db.Column(db.Integer, db.ForeignKey('event_subscriptions.id'), nullable=False)
+ subscription_id = db.Column(db.Integer, db.ForeignKey('event_subscriptions.id'), nullable=False, index=True)
event_type = db.Column(db.String(100), nullable=False)
payload = db.Column(db.Text, nullable=True) # JSON
status = db.Column(db.String(20), default='pending') # pending | success | failed
diff --git a/backend/app/models/invitation.py b/backend/app/models/invitation.py
index 77af8365..14a28ba0 100644
--- a/backend/app/models/invitation.py
+++ b/backend/app/models/invitation.py
@@ -18,10 +18,10 @@ class Invitation(JsonColumnMixin, db.Model):
default=lambda: __import__('secrets').token_urlsafe(32))
role = db.Column(db.String(20), nullable=False, default='developer')
permissions = db.Column(db.Text, nullable=True) # JSON custom permissions
- invited_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+ invited_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
expires_at = db.Column(db.DateTime, nullable=True)
accepted_at = db.Column(db.DateTime, nullable=True)
- accepted_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ accepted_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
status = db.Column(db.String(20), default=STATUS_PENDING, nullable=False, index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
diff --git a/backend/app/models/login_link.py b/backend/app/models/login_link.py
index c78ff0cb..44f8539a 100644
--- a/backend/app/models/login_link.py
+++ b/backend/app/models/login_link.py
@@ -21,7 +21,7 @@ class LoginLink(db.Model):
)
created_by_id = db.Column(
db.Integer, db.ForeignKey('users.id', ondelete='SET NULL'),
- nullable=True,
+ nullable=True, index=True,
)
expires_at = db.Column(db.DateTime, nullable=False)
used_at = db.Column(db.DateTime, nullable=True)
diff --git a/backend/app/models/managed_dns_record.py b/backend/app/models/managed_dns_record.py
index 05d38b6f..8d371ebc 100644
--- a/backend/app/models/managed_dns_record.py
+++ b/backend/app/models/managed_dns_record.py
@@ -19,7 +19,7 @@ class ManagedDnsRecord(SerializableMixin, TimestampMixin, db.Model):
id = db.Column(db.Integer, primary_key=True)
dns_provider_config_id = db.Column(
- db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True)
+ db.Integer, db.ForeignKey('dns_provider_configs.id'), nullable=True, index=True)
provider = db.Column(db.String(64), nullable=False) # cloudflare, ...
provider_zone_id = db.Column(db.String(128), nullable=False, index=True)
provider_record_id = db.Column(db.String(128), index=True) # set once known
@@ -33,7 +33,7 @@ class ManagedDnsRecord(SerializableMixin, TimestampMixin, db.Model):
# a default that could change live DNS behavior.
proxied = db.Column(db.Boolean)
source = db.Column(db.String(40)) # zone|ddns|preset|wordpress|email
- app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=True)
+ app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=True, index=True)
# Serialization comes from SerializableMixin; these columns stay out
diff --git a/backend/app/models/metric_alert.py b/backend/app/models/metric_alert.py
index 5b94383f..24e29893 100644
--- a/backend/app/models/metric_alert.py
+++ b/backend/app/models/metric_alert.py
@@ -50,7 +50,7 @@ class MetricAlert(db.Model):
duration_seconds = db.Column(db.Integer) # how long it was exceeded
status = db.Column(db.String(20), default='active', index=True) # active, acknowledged, resolved
- acknowledged_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ acknowledged_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
resolved_at = db.Column(db.DateTime)
diff --git a/backend/app/models/pending_agent.py b/backend/app/models/pending_agent.py
index 3669fcd4..32343977 100644
--- a/backend/app/models/pending_agent.py
+++ b/backend/app/models/pending_agent.py
@@ -65,7 +65,7 @@ class PendingAgent(db.Model):
last_seen_at = db.Column(db.DateTime, default=datetime.utcnow)
expires_at = db.Column(db.DateTime, nullable=False)
claimed_at = db.Column(db.DateTime, nullable=True)
- claimed_server_id = db.Column(db.String(36), db.ForeignKey('servers.id'), nullable=True)
+ claimed_server_id = db.Column(db.String(36), db.ForeignKey('servers.id'), nullable=True, index=True)
# When claimed, we stash credentials here briefly (Fernet-encrypted) so the
# next /poll call can deliver them to the agent. Cleared after retrieval.
diff --git a/backend/app/models/plugin.py b/backend/app/models/plugin.py
index 8c0023c1..a554acf2 100644
--- a/backend/app/models/plugin.py
+++ b/backend/app/models/plugin.py
@@ -58,7 +58,7 @@ class InstalledPlugin(JsonColumnMixin, db.Model):
# Has backend blueprint
has_backend = db.Column(db.Boolean, default=False)
- installed_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ installed_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
installed_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
diff --git a/backend/app/models/promotion_job.py b/backend/app/models/promotion_job.py
index 84f4e8d9..2f613dff 100644
--- a/backend/app/models/promotion_job.py
+++ b/backend/app/models/promotion_job.py
@@ -18,9 +18,9 @@ class PromotionJob(JsonColumnMixin, db.Model):
id = db.Column(db.Integer, primary_key=True)
# Source and target sites
- source_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False)
- target_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ source_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False, index=True)
+ target_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=False, index=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
# Promotion details
promotion_type = db.Column(db.String(20), nullable=False) # code, database, files, full
@@ -28,7 +28,7 @@ class PromotionJob(JsonColumnMixin, db.Model):
# Status tracking
status = db.Column(db.String(20), default='pending') # pending, running, completed, failed, rolled_back
- pre_promotion_snapshot_id = db.Column(db.Integer, db.ForeignKey('database_snapshots.id'), nullable=True)
+ pre_promotion_snapshot_id = db.Column(db.Integer, db.ForeignKey('database_snapshots.id'), nullable=True, index=True)
error_message = db.Column(db.Text)
# Timing
diff --git a/backend/app/models/registrar_connection.py b/backend/app/models/registrar_connection.py
index 0a98b6bf..dfa80f46 100644
--- a/backend/app/models/registrar_connection.py
+++ b/backend/app/models/registrar_connection.py
@@ -15,7 +15,7 @@ class RegistrarConnection(JsonColumnMixin, TimestampMixin, db.Model):
__tablename__ = 'registrar_connections'
id = db.Column(db.Integer, primary_key=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
provider = db.Column(db.String(40), nullable=False) # 'godaddy'
name = db.Column(db.String(120), nullable=True) # user-facing label
api_key_encrypted = db.Column(db.Text, nullable=True)
diff --git a/backend/app/models/sandbox_run.py b/backend/app/models/sandbox_run.py
index 11a8b5e7..f9207add 100644
--- a/backend/app/models/sandbox_run.py
+++ b/backend/app/models/sandbox_run.py
@@ -22,7 +22,7 @@ class SandboxRun(db.Model):
status = db.Column(db.String(16), nullable=False, default='running', index=True)
results = db.Column(db.JSON)
error = db.Column(db.Text)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow, index=True)
finished_at = db.Column(db.DateTime)
diff --git a/backend/app/models/sanitization_profile.py b/backend/app/models/sanitization_profile.py
index f9915078..5ceae594 100644
--- a/backend/app/models/sanitization_profile.py
+++ b/backend/app/models/sanitization_profile.py
@@ -18,7 +18,7 @@ class SanitizationProfile(JsonColumnMixin, db.Model):
__tablename__ = 'sanitization_profiles'
id = db.Column(db.Integer, primary_key=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
name = db.Column(db.String(100), nullable=False)
description = db.Column(db.Text)
diff --git a/backend/app/models/saved_view.py b/backend/app/models/saved_view.py
index e75ea547..09e6b60f 100644
--- a/backend/app/models/saved_view.py
+++ b/backend/app/models/saved_view.py
@@ -15,7 +15,7 @@ class SavedView(TimestampMixin, SoftDeleteMixin, db.Model):
__tablename__ = 'saved_views'
id = db.Column(db.Integer, primary_key=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='CASCADE'), nullable=False)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='CASCADE'), nullable=False, index=True)
page = db.Column(db.String(80), nullable=False)
name = db.Column(db.String(120), nullable=False)
# URL-safe handle so a view can be linked: /domains?view=ssl-expiring-soon.
diff --git a/backend/app/models/secret_vault.py b/backend/app/models/secret_vault.py
index f2d6028a..f696d04f 100644
--- a/backend/app/models/secret_vault.py
+++ b/backend/app/models/secret_vault.py
@@ -13,7 +13,7 @@ class SecretVault(TimestampMixin, db.Model):
name = db.Column(db.String(200), nullable=False, unique=True)
slug = db.Column(db.String(220), nullable=False, unique=True, index=True)
description = db.Column(db.Text, nullable=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
# Workspace scoping (#33): a vault belongs to a workspace. Backfilled to the
# Default workspace by migration 021; new rows are stamped on create.
workspace_id = db.Column(db.Integer, db.ForeignKey('workspaces.id'), nullable=True, index=True)
diff --git a/backend/app/models/security_alert.py b/backend/app/models/security_alert.py
index 3defc3b1..06a31820 100644
--- a/backend/app/models/security_alert.py
+++ b/backend/app/models/security_alert.py
@@ -37,9 +37,9 @@ class SecurityAlert(db.Model):
# Timestamps
created_at = db.Column(db.DateTime, default=datetime.utcnow, index=True)
acknowledged_at = db.Column(db.DateTime)
- acknowledged_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ acknowledged_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
resolved_at = db.Column(db.DateTime)
- resolved_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ resolved_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
# Relationships
server = db.relationship('Server', backref=db.backref('security_alerts', lazy='dynamic'))
diff --git a/backend/app/models/server.py b/backend/app/models/server.py
index 42a7b12b..8ce27987 100644
--- a/backend/app/models/server.py
+++ b/backend/app/models/server.py
@@ -16,7 +16,7 @@ class ServerGroup(TimestampMixin, db.Model):
description = db.Column(db.Text)
color = db.Column(db.String(7), default='#6366f1') # Hex color for UI
icon = db.Column(db.String(50), default='server') # Icon name
- parent_id = db.Column(db.String(36), db.ForeignKey('server_groups.id'), nullable=True)
+ parent_id = db.Column(db.String(36), db.ForeignKey('server_groups.id'), nullable=True, index=True)
# Fleet Management
auto_upgrade = db.Column(db.Boolean, default=False)
@@ -169,7 +169,7 @@ class Server(TimestampMixin, JsonColumnMixin, db.Model):
registration_token_hash = db.Column(db.String(256))
registration_token_expires = db.Column(db.DateTime)
registered_at = db.Column(db.DateTime)
- registered_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ registered_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
# Cached capability snapshot — written every time the agent reports
# a Capabilities message, so the panel can render the full Overview
@@ -549,7 +549,7 @@ class ServerCommand(SerializableMixin, db.Model):
id = uuid_pk()
server_id = db.Column(db.String(36), db.ForeignKey('servers.id'), nullable=False, index=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'))
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
# Command details
command_type = db.Column(db.String(50)) # docker:container:start, system:exec, etc.
@@ -629,9 +629,9 @@ class AgentRollout(TimestampMixin, db.Model):
__tablename__ = 'agent_rollouts'
id = uuid_pk()
- version_id = db.Column(db.String(36), db.ForeignKey('agent_versions.id'), nullable=False)
- group_id = db.Column(db.String(36), db.ForeignKey('server_groups.id'), nullable=True)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'))
+ version_id = db.Column(db.String(36), db.ForeignKey('agent_versions.id'), nullable=False, index=True)
+ group_id = db.Column(db.String(36), db.ForeignKey('server_groups.id'), nullable=True, index=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
# Configuration
batch_size = db.Column(db.Integer, default=5)
diff --git a/backend/app/models/server_template.py b/backend/app/models/server_template.py
index a3031c20..268b42b0 100644
--- a/backend/app/models/server_template.py
+++ b/backend/app/models/server_template.py
@@ -18,7 +18,7 @@ class ServerTemplate(JsonColumnMixin, TimestampMixin, db.Model):
version = db.Column(db.Integer, default=1)
# Inheritance
- parent_id = db.Column(db.Integer, db.ForeignKey('server_templates.id'), nullable=True)
+ parent_id = db.Column(db.Integer, db.ForeignKey('server_templates.id'), nullable=True, index=True)
parent = db.relationship('ServerTemplate', remote_side=[id], backref='children')
# Expected state specification
@@ -33,7 +33,7 @@ class ServerTemplate(JsonColumnMixin, TimestampMixin, db.Model):
auto_remediate = db.Column(db.Boolean, default=False)
remediation_approval_required = db.Column(db.Boolean, default=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
assignments = db.relationship('ServerTemplateAssignment', backref='template', lazy='dynamic')
@@ -153,8 +153,8 @@ class ServerTemplateAssignment(JsonColumnMixin, db.Model):
__tablename__ = 'server_template_assignments'
id = db.Column(db.Integer, primary_key=True)
- template_id = db.Column(db.Integer, db.ForeignKey('server_templates.id'), nullable=False)
- server_id = db.Column(db.Integer, db.ForeignKey('servers.id'), nullable=False)
+ template_id = db.Column(db.Integer, db.ForeignKey('server_templates.id'), nullable=False, index=True)
+ server_id = db.Column(db.Integer, db.ForeignKey('servers.id'), nullable=False, index=True)
# Compliance status
STATUS_COMPLIANT = 'compliant'
diff --git a/backend/app/models/shared_resource.py b/backend/app/models/shared_resource.py
index 7528ec1f..639a4e2d 100644
--- a/backend/app/models/shared_resource.py
+++ b/backend/app/models/shared_resource.py
@@ -115,7 +115,7 @@ class SharedVariable(db.Model):
id = db.Column(db.Integer, primary_key=True)
group_id = db.Column(db.Integer, db.ForeignKey('shared_variable_groups.id'),
- nullable=False)
+ nullable=False, index=True)
key = db.Column(db.String(255), nullable=False)
encrypted_value = db.Column(db.Text, nullable=False)
is_secret = db.Column(db.Boolean, default=False)
@@ -166,7 +166,7 @@ class SharedVariableGroupAttachment(SerializableMixin, db.Model):
id = db.Column(db.Integer, primary_key=True)
group_id = db.Column(db.Integer, db.ForeignKey('shared_variable_groups.id'),
- nullable=False)
+ nullable=False, index=True)
resource_type = db.Column(db.String(50), nullable=False)
resource_id = db.Column(db.String(255), nullable=False)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
diff --git a/backend/app/models/site_bandwidth.py b/backend/app/models/site_bandwidth.py
index 9347df07..d95bbf88 100644
--- a/backend/app/models/site_bandwidth.py
+++ b/backend/app/models/site_bandwidth.py
@@ -21,6 +21,7 @@ class SiteBandwidthDaily(db.Model):
db.Integer,
db.ForeignKey('applications.id', ondelete='CASCADE'),
nullable=True,
+ index=True,
)
domain = db.Column(db.String(255), nullable=False, index=True)
day = db.Column(db.Date, nullable=False, index=True)
diff --git a/backend/app/models/site_base_domain.py b/backend/app/models/site_base_domain.py
index 73413cb1..d5283448 100644
--- a/backend/app/models/site_base_domain.py
+++ b/backend/app/models/site_base_domain.py
@@ -37,6 +37,7 @@ class SiteBaseDomain(TimestampMixin, db.Model):
db.Integer,
db.ForeignKey('dns_provider_configs.id', ondelete='SET NULL'),
nullable=True,
+ index=True,
)
def to_dict(self):
diff --git a/backend/app/models/site_import.py b/backend/app/models/site_import.py
index 40925dfd..a1c029ef 100644
--- a/backend/app/models/site_import.py
+++ b/backend/app/models/site_import.py
@@ -44,7 +44,7 @@ class SiteImport(JsonColumnMixin, db.Model):
current_step = db.Column(db.String(60), nullable=True)
error = db.Column(db.Text, nullable=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
updated_at = db.Column(db.DateTime, default=datetime.utcnow,
onupdate=datetime.utcnow)
diff --git a/backend/app/models/status_page.py b/backend/app/models/status_page.py
index 0f338054..113ab2b1 100644
--- a/backend/app/models/status_page.py
+++ b/backend/app/models/status_page.py
@@ -57,7 +57,7 @@ class StatusComponent(db.Model):
id = db.Column(db.Integer, primary_key=True)
# Nullable: a monitor can exist with no status page attached (migration 081).
- page_id = db.Column(db.Integer, db.ForeignKey('status_pages.id'), nullable=True)
+ page_id = db.Column(db.Integer, db.ForeignKey('status_pages.id'), nullable=True, index=True)
name = db.Column(db.String(128), nullable=False)
description = db.Column(db.Text)
group = db.Column(db.String(64)) # e.g., "Web Services", "APIs"
@@ -97,7 +97,7 @@ class StatusComponent(db.Model):
# Optional binding to a managed WordPress site. When set, the component's
# status is driven from the site's health checks (#26) rather than a network
# probe, and a real uptime % accrues from the recorded HealthCheck rows.
- wordpress_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=True)
+ wordpress_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=True, index=True)
# Status
STATUS_OPERATIONAL = 'operational'
@@ -170,7 +170,7 @@ class HealthCheck(SerializableMixin, db.Model):
__tablename__ = 'health_checks'
id = db.Column(db.Integer, primary_key=True)
- component_id = db.Column(db.Integer, db.ForeignKey('status_components.id'), nullable=False)
+ component_id = db.Column(db.Integer, db.ForeignKey('status_components.id'), nullable=False, index=True)
status = db.Column(db.String(16)) # up, down, degraded
response_time = db.Column(db.Integer) # ms
status_code = db.Column(db.Integer)
@@ -186,10 +186,10 @@ class StatusIncident(TimestampMixin, db.Model):
id = db.Column(db.Integer, primary_key=True)
# Nullable: an incident auto-opened for a monitor that belongs to no status
# page has no page either (migration 081).
- page_id = db.Column(db.Integer, db.ForeignKey('status_pages.id'), nullable=True)
+ page_id = db.Column(db.Integer, db.ForeignKey('status_pages.id'), nullable=True, index=True)
# Optional link to the component this incident is about. Set when an incident
# is auto-opened from a health check, so it can be auto-resolved on recovery (#26).
- component_id = db.Column(db.Integer, db.ForeignKey('status_components.id'), nullable=True)
+ component_id = db.Column(db.Integer, db.ForeignKey('status_components.id'), nullable=True, index=True)
title = db.Column(db.String(256), nullable=False)
status = db.Column(db.String(32), default='investigating') # investigating, identified, monitoring, resolved
impact = db.Column(db.String(32), default='minor') # none, minor, major, critical
@@ -228,7 +228,7 @@ class StatusIncidentUpdate(SerializableMixin, db.Model):
__tablename__ = 'status_incident_updates'
id = db.Column(db.Integer, primary_key=True)
- incident_id = db.Column(db.Integer, db.ForeignKey('status_incidents.id'), nullable=False)
+ incident_id = db.Column(db.Integer, db.ForeignKey('status_incidents.id'), nullable=False, index=True)
status = db.Column(db.String(32))
body = db.Column(db.Text, nullable=False)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
diff --git a/backend/app/models/system_settings.py b/backend/app/models/system_settings.py
index 20915d57..a702bc95 100644
--- a/backend/app/models/system_settings.py
+++ b/backend/app/models/system_settings.py
@@ -13,7 +13,7 @@ class SystemSettings(JsonColumnMixin, db.Model):
value_type = db.Column(db.String(20), default='string') # string, boolean, integer, json
description = db.Column(db.String(500), nullable=True)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
- updated_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ updated_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
# Relationship to user who last updated
updated_by_user = db.relationship('User', foreign_keys=[updated_by])
diff --git a/backend/app/models/user.py b/backend/app/models/user.py
index c4bc2124..0f52271b 100644
--- a/backend/app/models/user.py
+++ b/backend/app/models/user.py
@@ -26,7 +26,7 @@ class User(JsonColumnMixin, db.Model):
created_at = db.Column(db.DateTime, default=datetime.utcnow, index=True)
updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
last_login_at = db.Column(db.DateTime, nullable=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
@validates('email')
def _normalize_email(self, key, email):
diff --git a/backend/app/models/webhook.py b/backend/app/models/webhook.py
index 0121ca2b..37e291f2 100644
--- a/backend/app/models/webhook.py
+++ b/backend/app/models/webhook.py
@@ -27,7 +27,7 @@ class GitWebhook(TimestampMixin, db.Model):
auto_sync = db.Column(db.Boolean, default=True)
# Deployment configuration
- app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=True)
+ app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=True, index=True)
deploy_on_push = db.Column(db.Boolean, default=False)
pre_deploy_script = db.Column(db.Text, nullable=True)
post_deploy_script = db.Column(db.Text, nullable=True)
@@ -81,7 +81,7 @@ class WebhookLog(db.Model):
__tablename__ = 'webhook_logs'
id = db.Column(db.Integer, primary_key=True)
- webhook_id = db.Column(db.Integer, db.ForeignKey('git_webhooks.id'), nullable=True)
+ webhook_id = db.Column(db.Integer, db.ForeignKey('git_webhooks.id'), nullable=True, index=True)
# Event info
source = db.Column(db.String(50), nullable=False) # 'github', 'gitlab', 'bitbucket'
@@ -137,8 +137,8 @@ class GitDeployment(db.Model):
id = db.Column(db.Integer, primary_key=True)
# Links
- app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False)
- webhook_id = db.Column(db.Integer, db.ForeignKey('git_webhooks.id'), nullable=True)
+ app_id = db.Column(db.Integer, db.ForeignKey('applications.id'), nullable=False, index=True)
+ webhook_id = db.Column(db.Integer, db.ForeignKey('git_webhooks.id'), nullable=True, index=True)
# Deployment info
version = db.Column(db.Integer, nullable=False) # Auto-increment per app
diff --git a/backend/app/models/webhook_gateway.py b/backend/app/models/webhook_gateway.py
index a9f6ee7f..927096f1 100644
--- a/backend/app/models/webhook_gateway.py
+++ b/backend/app/models/webhook_gateway.py
@@ -19,7 +19,7 @@ class WebhookEndpoint(TimestampMixin, JsonColumnMixin, db.Model):
filter_paths = db.Column(db.Text, nullable=True) # JSON list of dotted-path filters
forward_url = db.Column(db.String(500), nullable=True)
retry_count = db.Column(db.Integer, default=3)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True)
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=True, index=True)
# Workspace scoping (#33): backfilled to the Default workspace by migration 021.
workspace_id = db.Column(db.Integer, db.ForeignKey('workspaces.id'), nullable=True, index=True)
diff --git a/backend/app/models/wordpress_site.py b/backend/app/models/wordpress_site.py
index 64400f58..24b4feef 100644
--- a/backend/app/models/wordpress_site.py
+++ b/backend/app/models/wordpress_site.py
@@ -50,7 +50,7 @@ class WordPressSite(JsonColumnMixin, TimestampMixin, db.Model):
# Environment info
is_production = db.Column(db.Boolean, default=True)
- production_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=True)
+ production_site_id = db.Column(db.Integer, db.ForeignKey('wordpress_sites.id'), nullable=True, index=True)
# Sync settings (JSON)
sync_config = db.Column(db.Text) # schedule, search_replace, anonymize, etc.
diff --git a/backend/app/models/workflow.py b/backend/app/models/workflow.py
index 4a300d74..007a98cc 100644
--- a/backend/app/models/workflow.py
+++ b/backend/app/models/workflow.py
@@ -26,7 +26,7 @@ class Workflow(JsonColumnMixin, TimestampMixin, db.Model):
# Metadata
# Foreign keys
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
# Relationships
user = db.relationship('User', backref=db.backref('workflows', lazy='dynamic'))
@@ -60,7 +60,7 @@ class WorkflowExecution(JsonColumnMixin, db.Model):
__tablename__ = 'workflow_executions'
id = db.Column(db.Integer, primary_key=True)
- workflow_id = db.Column(db.Integer, db.ForeignKey('workflows.id'), nullable=False)
+ workflow_id = db.Column(db.Integer, db.ForeignKey('workflows.id'), nullable=False, index=True)
status = db.Column(db.String(20), default='running') # running, success, failed, cancelled
trigger_type = db.Column(db.String(50))
context = db.Column(db.Text, nullable=True) # JSON data passed between steps
@@ -89,7 +89,7 @@ class WorkflowLog(db.Model):
__tablename__ = 'workflow_logs'
id = db.Column(db.Integer, primary_key=True)
- execution_id = db.Column(db.Integer, db.ForeignKey('workflow_executions.id'), nullable=False)
+ execution_id = db.Column(db.Integer, db.ForeignKey('workflow_executions.id'), nullable=False, index=True)
level = db.Column(db.String(10), default='INFO') # INFO, WARNING, ERROR, DEBUG
message = db.Column(db.Text, nullable=False)
node_id = db.Column(db.String(100), nullable=True) # ID of the node that generated the log
diff --git a/backend/app/models/workspace.py b/backend/app/models/workspace.py
index a87950a5..95e76138 100644
--- a/backend/app/models/workspace.py
+++ b/backend/app/models/workspace.py
@@ -34,7 +34,7 @@ class Workspace(JsonColumnMixin, TimestampMixin, db.Model):
# Billing
billing_notes = db.Column(db.Text)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
members = db.relationship('WorkspaceMember', backref='workspace', lazy='dynamic')
api_keys = db.relationship('WorkspaceApiKey', backref='workspace', lazy='dynamic')
@@ -74,8 +74,8 @@ class WorkspaceMember(db.Model):
__tablename__ = 'workspace_members'
id = db.Column(db.Integer, primary_key=True)
- workspace_id = db.Column(db.Integer, db.ForeignKey('workspaces.id'), nullable=False)
- user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False)
+ workspace_id = db.Column(db.Integer, db.ForeignKey('workspaces.id'), nullable=False, index=True)
+ user_id = db.Column(db.Integer, db.ForeignKey('users.id'), nullable=False, index=True)
ROLE_OWNER = 'owner'
ROLE_ADMIN = 'admin'
@@ -108,14 +108,14 @@ class WorkspaceApiKey(JsonColumnMixin, db.Model):
__tablename__ = 'workspace_api_keys'
id = db.Column(db.Integer, primary_key=True)
- workspace_id = db.Column(db.Integer, db.ForeignKey('workspaces.id'), nullable=False)
+ workspace_id = db.Column(db.Integer, db.ForeignKey('workspaces.id'), nullable=False, index=True)
name = db.Column(db.String(128), nullable=False)
key_hash = db.Column(db.String(256), nullable=False)
key_prefix = db.Column(db.String(16))
scopes_json = db.Column(db.Text)
is_active = db.Column(db.Boolean, default=True)
expires_at = db.Column(db.DateTime, nullable=True)
- created_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ created_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
last_used_at = db.Column(db.DateTime)
@@ -157,7 +157,7 @@ class ResourceGrant(db.Model):
resource_type = db.Column(db.String(32), nullable=False) # 'application'
resource_id = db.Column(db.Integer, nullable=False, index=True)
role = db.Column(db.String(16), default='editor') # reserved for view/edit
- granted_by = db.Column(db.Integer, db.ForeignKey('users.id'))
+ granted_by = db.Column(db.Integer, db.ForeignKey('users.id'), index=True)
created_at = db.Column(db.DateTime, default=datetime.utcnow)
__table_args__ = (
diff --git a/backend/migrations/versions/096_index_all_fk_columns.py b/backend/migrations/versions/096_index_all_fk_columns.py
new file mode 100644
index 00000000..2a29d859
--- /dev/null
+++ b/backend/migrations/versions/096_index_all_fk_columns.py
@@ -0,0 +1,61 @@
+"""Index every foreign-key column.
+
+An audit found 102 FK columns with no index: every join, per-parent listing,
+and the ORM delete cascades (app/models/_delete_cascade_policy.py) were
+scanning whole tables on them. The models now declare index=True on every FK
+column; this migration creates the same indexes on existing installs.
+
+Derived from the live schema at upgrade time rather than a frozen list, so it
+is idempotent and matches whatever tables the install actually has: any
+single-column FK that is not already the leading column of an index, not the
+primary key, and not single-column unique gets `ix_<table>_<column>` — the
+same name Flask-SQLAlchemy's index=True produces.
+
+Revision ID: 096_index_all_fk_columns
+Revises: 095_purge_orphaned_child_rows
+Create Date: 2026-08-31
+"""
+
+import sqlalchemy as sa
+from alembic import op
+
+revision = '096_index_all_fk_columns'
+down_revision = '095_purge_orphaned_child_rows'
+branch_labels = None
+depends_on = None
+
+SKIP_TABLES = {'alembic_version', 'sqlite_sequence'}
+EXTENSION_TABLE_PREFIX = 'ext_' # extension-owned; core migrations keep out
+
+created_names = []
+
+
+def upgrade():
+ inspector = sa.inspect(op.get_bind())
+ for table in inspector.get_table_names():
+ if table in SKIP_TABLES or table.startswith(EXTENSION_TABLE_PREFIX):
+ continue
+ indexes = inspector.get_indexes(table)
+ leading = {ix['column_names'][0] for ix in indexes if ix['column_names']}
+ existing_names = {ix['name'] for ix in indexes}
+ pk = set(inspector.get_pk_constraint(table).get('constrained_columns') or [])
+ unique_single = {uc['column_names'][0]
+ for uc in inspector.get_unique_constraints(table)
+ if len(uc['column_names']) == 1}
+ for fk in inspector.get_foreign_keys(table):
+ cols = fk.get('constrained_columns') or []
+ if len(cols) != 1:
+ continue
+ col = cols[0]
+ name = f'ix_{table}_{col}'
+ if (col in leading or col in pk or col in unique_single
+ or name in existing_names):
+ continue
+ op.create_index(name, table, [col])
+ leading.add(col)
+ existing_names.add(name)
+
+
+def downgrade():
+ # Dropping ix_<table>_<col> indexes is safe but pointless — leave them.
+ pass
diff --git a/backend/tests/test_application_soft_delete.py b/backend/tests/test_application_soft_delete.py
index a9363dfb..4094f107 100644
--- a/backend/tests/test_application_soft_delete.py
+++ b/backend/tests/test_application_soft_delete.py
@@ -274,6 +274,30 @@ def test_dangling_on_delete_fk_set_may_only_shrink(app):
f'these entries are fixed — remove them from the set: {sorted(fixed)}')
+def test_every_fk_column_is_indexed(app):
+ """FK columns are born indexed — every join, per-parent listing, and the
+ cascade deletes applied by _delete_cascade_policy scan the whole table
+ without one. Declare index=True on the column (migration 096 covers
+ existing installs). PK and single-column-unique FKs are already served."""
+ with app.app_context():
+ offenders = []
+ seen = set()
+ for mapper in db.Model.registry.mappers:
+ table = mapper.local_table
+ if table is None or table.name in seen:
+ continue
+ seen.add(table.name)
+ leading = {list(ix.columns)[0].key
+ for ix in table.indexes if list(ix.columns)}
+ for c in table.columns:
+ if not c.foreign_keys or c.primary_key or c.unique:
+ continue
+ if c.key not in leading:
+ offenders.append(f'{table.name}.{c.key}')
+ assert not offenders, (
+ f'FK columns without an index — add index=True: {sorted(offenders)}')
+
+
def test_deleting_a_workspace_with_projects_is_refused(app):
"""The Workspace.projects entry in DELIBERATELY_UNCASCADED is only honest
while delete_workspace refuses instead of 500ing."""
diff --git a/docs/MIGRATION_INVENTORY.md b/docs/MIGRATION_INVENTORY.md
index c1940a48..0d9f8346 100644
--- a/docs/MIGRATION_INVENTORY.md
+++ b/docs/MIGRATION_INVENTORY.md
@@ -16,7 +16,7 @@ debt. Regenerate with `python scripts/generate-migration-inventory.py`.
| Routes on bare @jwt_required() | auth_required() / role decorators | 608 | 608 | REGISTERED EXCEPTION: JWT-only is the deliberate default; conversion grants API-key access and happens per route, on decision |
| HTTP statuses chosen by sniffing error text | typed errors from app.exceptions | 0 | 0 | INVARIANT at 0 - migration completed 2026-08-19 |
| API crashes swallowed without recording | app.error_reporting | 0 | 0 | INVARIANT at 0 |
-| Hand-shaped {'error': ...} bodies in app/api | typed errors + the global handler | 1139 | 1150 | migrate when touched; new endpoints raise |
+| Hand-shaped {'error': ...} bodies in app/api | typed errors + the global handler | 1141 | 1150 | migrate when touched; new endpoints raise |
| Raw subprocess calls outside the runners | app/utils/system.py runners | 24 | 24 | migrate when touched |
| Controller-boundary violations (routes doing service work) | service layer extraction | 511 | 511 | migrate when touched (first-wave ratchet) |
| raw api.* calls in pages/ | E1: useServerQuery/useServerMutation | 405 | 405 | migrate when touched |