OpticsSetting

An optics setting row holds one organisation’s knowledge-base configuration: whether the feature is switched on, and an optional override of the reranker strictness floor.

Purpose

The knowledge base is off by default and enabled per tenant. Retrieval quality is governed by a strictness floor that decides when the engine should abstain rather than answer; each organisation can override the global value. Where a row or a field is absent, the engine falls back to the config('optics.*') defaults.

Usage

Read by the search engine on every query and by the indexing pipeline before it does any work.

app/Services/Optics/KnowledgeSearchService.php — checks enabled and resolves the strictness floor.
app/Jobs/IndexDocumentJob.php — skips indexing for organisations that have not enabled the feature.
app/Services/Optics/OpticsBackfill.php and app/Console/Commands/OpticsIndexBackfill.php — bulk backfill respects the same flag.
app/Filament/Resources/OpticsSettingResource.php — staff toggle the feature per organisation.

Relationships

Relation	Type	Related model
`organization`	`belongsTo`	Organization

Data shape

Table: optics_settings.

Column	Type	Notes
`id`	`uuid`	Primary key
`organization_id`	`uuid`	Unique; FK to `organizations`, cascade delete
`enabled`	`boolean`	Cast to boolean, defaults to `false`
`strictness_floor`	`float`	Nullable; null means use the config default
`created_at`, `updated_at`	`timestamp`