Arquitetura de Busca¶

# apps/search/client.py
import typesense

client = typesense.Client({
    'nodes': [{
        'host': settings.TYPESENSE_HOST,
        'port': settings.TYPESENSE_PORT,
        'protocol': settings.TYPESENSE_PROTOCOL,
    }],
    'api_key': settings.TYPESENSE_API_KEY,
    'connection_timeout_seconds': 2
})

HYMNS_SCHEMA = {
    'name': 'hymns',
    'fields': [
        {'name': 'id', 'type': 'string'},
        {'name': 'hymn_book_id', 'type': 'string'},
        {'name': 'hymn_book_name', 'type': 'string', 'facet': True},
        {'name': 'hymn_book_slug', 'type': 'string'},
        {'name': 'owner_name', 'type': 'string', 'facet': True},
        {'name': 'number', 'type': 'int32', 'sort': True},
        {'name': 'title', 'type': 'string'},
        {'name': 'text', 'type': 'string'},
        {'name': 'style', 'type': 'string', 'facet': True, 'optional': True},
    ],
    'default_sorting_field': 'number'
}

def index_hymn(hymn: Hymn) -> None:
    """Indexa um hino no TypeSense."""
    document = {
        'id': str(hymn.id),
        'hymn_book_id': str(hymn.hymn_book_id),
        'hymn_book_name': hymn.hymn_book.name,
        'hymn_book_slug': hymn.hymn_book.slug,
        'owner_name': hymn.hymn_book.owner_name,
        'number': hymn.number,
        'title': hymn.title,
        'text': hymn.text,
        'style': hymn.style or '',
    }

    client.collections['hymns'].documents.upsert(document)

@receiver(post_save, sender=Hymn)
def index_hymn_on_save(sender, instance, **kwargs):
    """Indexa automaticamente ao salvar."""
    index_hymn(instance)

poetry run python manage.py reindex_typesense

# apps/search/management/commands/reindex_typesense.py
class Command(BaseCommand):
    def handle(self, *args, **options):
        # Deleta collection existente
        try:
            client.collections['hymns'].delete()
        except Exception:
            pass

        # Recria collection
        client.collections.create(HYMNS_SCHEMA)

        # Indexa todos os hinos
        for hymn in Hymn.objects.select_related('hymn_book'):
            index_hymn(hymn)

def search_hymns(query: str, per_page: int = 20, page: int = 1) -> dict:
    """Busca hinos no TypeSense."""
    search_parameters = {
        'q': query,
        'query_by': 'title,text,hymn_book_name,owner_name',
        'per_page': per_page,
        'page': page,
        'typo_tolerance': True,
    }

    return client.collections['hymns'].documents.search(search_parameters)

search_parameters = {
    'q': 'lua',
    'query_by': 'title,text',
    'filter_by': 'hymn_book_name:=O Cruzeiro',
    'sort_by': 'number:asc',
}

def search_view(request):
    query = request.GET.get('q', '')

    if not query or len(query) < 3:
        return render(request, 'search/search.html', {'results': []})

    # Busca no TypeSense
    response = search_hymns(query)

    # Busca objetos no Django (preservando ordem)
    hymn_ids = [hit['document']['id'] for hit in response['hits']]
    hymns = Hymn.objects.filter(id__in=hymn_ids)

    # Preserva ordem do TypeSense
    hymn_map = {str(h.id): h for h in hymns}
    ordered_hymns = [hymn_map[id] for id in hymn_ids if id in hymn_map]

    return render(request, 'search/search.html', {
        'results': ordered_hymns,
        'query': query,
        'total': response['found'],
    })

# Verificar container
docker ps | grep typesense

# Ver logs
docker logs typesense

# Testar conexão
curl http://localhost:8108/health

# Reindexar
poetry run python manage.py reindex_typesense