Files
neural-hunt/internal/data/schema.sql
2026-08-10 16:20:59 +02:00

131 lines
5.2 KiB
SQL

PRAGMA foreign_keys = ON;
CREATE TABLE IF NOT EXISTS clients (
id TEXT PRIMARY KEY,
public_jwk TEXT NOT NULL,
created_at INTEGER NOT NULL,
last_seen INTEGER NOT NULL
);
CREATE TABLE IF NOT EXISTS settings (
key TEXT PRIMARY KEY,
value TEXT NOT NULL,
updated_at INTEGER NOT NULL
);
CREATE TABLE IF NOT EXISTS tasks (
id TEXT PRIMARY KEY,
secret TEXT NOT NULL,
public_seed TEXT NOT NULL,
range_bits INTEGER NOT NULL,
status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active','completed','closed')),
paused INTEGER NOT NULL DEFAULT 0,
guess_min_interval_sec INTEGER,
client_submit_interval_sec INTEGER,
revision INTEGER NOT NULL DEFAULT 0,
parent_task_id TEXT REFERENCES tasks(id),
display_name TEXT NOT NULL DEFAULT '',
description TEXT NOT NULL DEFAULT '',
nft_prompt_instructions TEXT NOT NULL DEFAULT '',
nft_negative_prompt TEXT NOT NULL DEFAULT '',
nft_style_reference TEXT NOT NULL DEFAULT '',
created_at INTEGER NOT NULL,
completed_at INTEGER,
winner_client_id TEXT REFERENCES clients(id),
winner_signature TEXT,
winning_guess TEXT,
artifact_status TEXT NOT NULL DEFAULT 'none' CHECK (artifact_status IN ('none','pending','generating','ready','error')),
artifact_uri TEXT,
artifact_manifest_uri TEXT,
artifact_error TEXT
);
CREATE INDEX IF NOT EXISTS tasks_status_created_idx ON tasks(status, created_at);
-- False guesses are intentionally not persisted. This table only keeps the
-- aggregate state needed for the 3D map, ranking, rate limiting and next seq.
CREATE TABLE IF NOT EXISTS task_points (
task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
client_id TEXT NOT NULL REFERENCES clients(id) ON DELETE CASCADE,
score REAL NOT NULL DEFAULT 0,
x REAL NOT NULL DEFAULT 0,
y REAL NOT NULL DEFAULT 0,
z REAL NOT NULL DEFAULT 0,
guess_count INTEGER NOT NULL DEFAULT 0,
next_seq INTEGER NOT NULL DEFAULT 0,
last_guess_at INTEGER,
PRIMARY KEY (task_id, client_id)
);
CREATE INDEX IF NOT EXISTS task_points_rank_idx ON task_points(task_id, score DESC);
-- A browser or shell identity can explicitly choose which active task it works
-- on. The selection is persisted so switching devices with the same exported
-- identity keeps the chosen task (while single-active-connection enforcement
-- still applies at runtime).
CREATE TABLE IF NOT EXISTS client_task_selection (
client_id TEXT PRIMARY KEY REFERENCES clients(id) ON DELETE CASCADE,
task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
updated_at INTEGER NOT NULL
);
CREATE INDEX IF NOT EXISTS client_task_selection_task_idx ON client_task_selection(task_id);
CREATE TABLE IF NOT EXISTS client_unlocks (
client_id TEXT NOT NULL REFERENCES clients(id) ON DELETE CASCADE,
unlock_key TEXT NOT NULL,
task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
created_at INTEGER NOT NULL,
PRIMARY KEY (client_id, unlock_key)
);
-- A short lease enforces one active websocket per browser identity.
CREATE TABLE IF NOT EXISTS presence_leases (
client_id TEXT PRIMARY KEY,
session_id TEXT NOT NULL,
expires_at INTEGER NOT NULL
);
CREATE INDEX IF NOT EXISTS presence_exp_idx ON presence_leases(expires_at);
-- Admin task actions may run immediately or at a future timestamp. Payloads are
-- small JSON objects validated by the Go server before being scheduled.
CREATE TABLE IF NOT EXISTS task_actions (
id TEXT PRIMARY KEY,
task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
action_type TEXT NOT NULL,
payload_json TEXT NOT NULL DEFAULT '{}',
execute_at INTEGER NOT NULL,
status TEXT NOT NULL DEFAULT 'pending' CHECK (status IN ('pending','running','done','error','cancelled')),
created_at INTEGER NOT NULL,
executed_at INTEGER,
error TEXT
);
CREATE INDEX IF NOT EXISTS task_actions_due_idx ON task_actions(status, execute_at);
CREATE INDEX IF NOT EXISTS task_actions_task_idx ON task_actions(task_id, created_at DESC);
-- Successful external image-model calls are logged with the token usage
-- returned by the provider. Costs are local estimates based on pinned public
-- standard token rates. Billing reconciliation still belongs to the provider.
CREATE TABLE IF NOT EXISTS artifact_api_usage (
id INTEGER PRIMARY KEY AUTOINCREMENT,
created_at INTEGER NOT NULL,
task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
kind TEXT NOT NULL CHECK (kind IN ('character_anchor','artifact')),
provider TEXT NOT NULL,
model TEXT NOT NULL,
endpoint TEXT NOT NULL,
size TEXT NOT NULL,
quality TEXT NOT NULL,
request_id TEXT,
input_tokens INTEGER NOT NULL DEFAULT 0,
input_text_tokens INTEGER NOT NULL DEFAULT 0,
input_image_tokens INTEGER NOT NULL DEFAULT 0,
output_tokens INTEGER NOT NULL DEFAULT 0,
total_tokens INTEGER NOT NULL DEFAULT 0,
estimated_cost_usd REAL,
pricing_basis TEXT NOT NULL DEFAULT '',
meta_json TEXT NOT NULL DEFAULT '{}'
);
CREATE INDEX IF NOT EXISTS artifact_api_usage_created_idx ON artifact_api_usage(created_at DESC);
CREATE INDEX IF NOT EXISTS artifact_api_usage_kind_created_idx ON artifact_api_usage(kind, created_at DESC);
CREATE INDEX IF NOT EXISTS artifact_api_usage_task_idx ON artifact_api_usage(task_id);