Busca Full-Text (Scout + Typesense)

Visao Geral

O sistema usa Laravel Scout com Typesense como engine de busca full-text. Cada tenant tem collections isoladas no Typesense com prefixo do tenant ID (ex: alfa_members, beta_transactions).

Models Pesquisaveis

Model	Collection	Campos de busca	Filtros facetados
Member	{tenant}_members	nome, sobrenome, email, cpf	sexo, situacao, congregacao, congregacao_id
Transaction	{tenant}_transactions	descricao, observacao	tipo, status, categoria, categoria_id, valor, data_transacao
Event	{tenant}_events	titulo, descricao, local	tipo, status, congregacao_id, data_inicio

TenantSearchable Trait

App\Domain\Shared\Traits\TenantSearchable — encapsula o Searchable do Scout com prefixo tenant no searchableAs().

Cada model pesquisavel usa este trait e implementa toSearchableArray() com os campos indexados.

Busca nos Controllers

Os controllers usam um padrao de fallback:

1. Se ha termo de busca E o tenant tem a feature full_text_search → usa Scout
2. Se Scout falha (Typesense indisponivel) → cai no Eloquent automaticamente
3. Sem feature ou sem termo → usa Eloquent diretamente

Controllers com busca: MemberController, TransactionController, EventController.

Feature Flag

full_text_search — disponivel nos planos Crescimento e Expansao. Plano Semente usa busca Eloquent (LIKE).

Typesense (Docker)

Servico typesense no docker-compose.yml:

• Imagem: typesense/typesense:27.1
• Porta: 8108
• Volume: ./typesense_data:/data
• Health: curl http://localhost:8108/health

Variaveis de Ambiente

SCOUT_DRIVER=typesense
SCOUT_QUEUE=true

TYPESENSE_API_KEY=igreja-typesense-key
TYPESENSE_HOST=typesense
TYPESENSE_PORT=8108
TYPESENSE_PROTOCOL=http

Comandos

# Reindexar todos os tenants
docker compose exec app php artisan app:reindex-search

# Reindexar um tenant especifico
docker compose exec app php artisan app:reindex-search --tenant=alfa

Configuracao

Schemas dos models em config/scout.php → typesense.model-settings. Queue configurada como scout para nao competir com jobs de alta prioridade.

Testes

Testes usam SCOUT_DRIVER=collection (definido em phpunit.xml). Nao requer Typesense no CI.

Pendente Futuro

• Barra de busca global (Spotlight/Command Palette) — busca cross-model unificada no header