Skip to content

Database

LenserFight Community Edition uses PostgreSQL via Supabase with a multi-schema layout. For OSS beta docs, the primary goal is to explain the schemas that external developers can actually inspect and use in this repo.

Canonical Community Edition schemas

SchemaPurposePublic docs priority
lenseslenses, versions, workflows, workflow runsprimary
lensersprofiles and preferencesprimary
contentthreads, replies, tags, reactionsprimary
aimodel/provider registry and API key storageprimary
executionrequest/run/artifact historyprimary
mediastorage objects and attachmentsprimary
tenancyworkspace boundarysupporting
publicRPC gateway functionsprimary

Private or non-canonical for OSS onboarding

These may still exist in migrations or platform-adjacent docs, but they are not the primary Community Edition onboarding surface:

  • authz
  • billing
  • analytics
  • ops
  • system
  • platform-only worker assumptions outside the current repo-backed contract

Why multi-schema?

  • isolation between product domains
  • RLS boundaries that match domain ownership
  • the ability to expose only selected schemas through PostgREST

Start with these pages