Models

See 04-data-model.md for ER diagram. This page highlights important fields:

  • Org/OrgMember: org membership and roles.
  • Project: owns ApiKeys, Runs, Prompts, Datasets, Experiments.
  • ApiKey:
  • keyHash (SHA‑256), keyEnc (encrypted; optional depending on storage)
  • disabled boolean
  • Run:
  • provider, model, inputTokens, outputTokens, costUSD(10,5), latencyMs, status, errorCode?, traceId?
  • promptHash, promptPreview?
  • Prompt/PromptVersion:
  • template text, version unique per prompt
  • Dataset: schemaJson, rowsJson
  • Experiment: matrixJson, gate, relations to prompt version & dataset
  • EvalScore: metric, value, details?
  • OrgSecret: encrypted BYOK key blob per provider

TODO: Add seed/migration notes and sample queries.