PHPackages                             sierratecnologia/finder - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File & Storage](/categories/file-storage)
4. /
5. sierratecnologia/finder

ActiveLibrary[File & Storage](/categories/file-storage)

sierratecnologia/finder
=======================

Finder de Arquivos

0.4.4(2y ago)014MITPHPPHP ^7.2|^8.0CI failing

Since May 23Pushed 6mo agoCompare

[ Source](https://github.com/SierraTecnologia/Finder)[ Packagist](https://packagist.org/packages/sierratecnologia/finder)[ Docs](https://sierratecnologia.com/packages/finder/)[ Fund](https://ricasolucoes.com.br/open-source/support-us)[ GitHub Sponsors](https://github.com/ricasolucoes)[ RSS](/packages/sierratecnologia-finder/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependencies (41)Versions (23)Used By (0)

SierraTecnologia Finder
=======================

[](#sierratecnologia-finder)

**SierraTecnologia Finder** Various functionality, and basic controller included out-of-the-box.

[![Packagist](https://camo.githubusercontent.com/85df4b6bc7d2fbf98e244e354e33964f86ede5d2c9d5e0d1c6d850ba48fd5a47/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7369657272617465636e6f6c6f6769612f66696e6465722e7376673f6c6162656c3d5061636b6167697374267374796c653d666c61742d737175617265)](https://packagist.org/packages/sierratecnologia/finder)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/1277826c943d057d0089d38177a023a448bfdce73c14b30b8418c38059522f87/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f7369657272617465636e6f6c6f6769612f66696e6465722e7376673f6c6162656c3d5363727574696e697a6572267374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/sierratecnologia/finder/)[![Travis](https://camo.githubusercontent.com/5718858f326eec651c1d962284575e558af5f0d9c92fb9e3aeae5851c67863e8/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f7369657272617465636e6f6c6f6769612f66696e6465722e7376673f6c6162656c3d5472617669734349267374796c653d666c61742d737175617265)](https://travis-ci.org/sierratecnologia/finder)[![StyleCI](https://camo.githubusercontent.com/4191b35d1ee7b0da2e27c1fe2bd612ce3dfe1673a64523a762f99155892e2142/68747470733a2f2f7374796c6563692e696f2f7265706f732f36303936383838302f736869656c64)](https://styleci.io/repos/60968880)[![License](https://camo.githubusercontent.com/9e8deebe9fdab104fe5cb199bca93d9f90f887551befc18f4b40272e4606083a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f7369657272617465636e6f6c6f6769612f66696e6465722e7376673f6c6162656c3d4c6963656e7365267374796c653d666c61742d737175617265)](https://github.com/sierratecnologia/finder/blob/master/LICENSE)

📚 Índice
--------

[](#-índice)

- [Introdução](#-introdu%C3%A7%C3%A3o)
- [Instalação](#-instala%C3%A7%C3%A3o)
- [Arquitetura e Estrutura Interna](#-arquitetura-e-estrutura-interna)
- [Principais Funcionalidades](#-principais-funcionalidades)
- [Uso Prático](#-uso-pr%C3%A1tico)
- [Integração com o Ecossistema SierraTecnologia](#-integra%C3%A7%C3%A3o-com-o-ecossistema-sierratecnologia)
- [Extensão e Customização](#-extens%C3%A3o-e-customiza%C3%A7%C3%A3o)
- [Exemplos Reais](#-exemplos-reais)
- [Guia de Contribuição](#-guia-de-contribui%C3%A7%C3%A3o)

🎯 Introdução
------------

[](#-introdução)

### O que é o Finder

[](#o-que-é-o-finder)

O **Finder** é um pacote Laravel avançado desenvolvido pela SierraTecnologia para gerenciar, otimizar e executar processos de busca, indexação e descoberta de informações em sistemas empresariais. Ele fornece uma camada de abstração poderosa para trabalhar com diferentes fontes de dados, permitindo consultas inteligentes, filtros dinâmicos, ranking de resultados e integração com múltiplos mecanismos de busca.

### Objetivo do Projeto

[](#objetivo-do-projeto)

O Finder foi projetado para:

- **Centralizar a lógica de busca** em aplicações Laravel complexas
- **Abstrair diferentes fontes de dados** (Eloquent, APIs externas, sistemas de arquivos, etc.)
- **Facilitar a indexação automatizada** de conteúdo e documentos
- **Prover ferramentas de Spider/Crawler** para descoberta de informações
- **Gerenciar rastreamento e análise** de arquivos, diretórios e URLs
- **Integrar-se perfeitamente** com outros módulos do ecossistema SierraTecnologia

### Benefícios e Diferenciais

[](#benefícios-e-diferenciais)

- ✅ **Busca Unificada**: Interface consistente para múltiplas fontes de dados
- ✅ **Spider Integrado**: Rastreamento inteligente de arquivos, diretórios e conteúdo web
- ✅ **Extensível**: Arquitetura baseada em contratos e pipelines
- ✅ **Performance**: Cache e otimizações integradas
- ✅ **Observabilidade**: Logging e métricas detalhadas
- ✅ **Laravel Native**: Integração completa com Service Providers, Facades e Artisan Commands

### Contexto no Ecossistema SierraTecnologia

[](#contexto-no-ecossistema-sierratecnologia)

O Finder faz parte do ecossistema **SierraTecnologia / Rica Soluções**, trabalhando em conjunto com outros módulos:

- **Stalker**: Monitoramento e rastreamento
- **Casa**: Gerenciamento de ambiente
- **Operador**: Operações e tarefas automatizadas
- **Integrations**: Integrações com serviços externos
- **MediaManager**: Gerenciamento de mídia e arquivos

📦 Instalação
------------

[](#-instalação)

### Requisitos Mínimos

[](#requisitos-mínimos)

- **PHP**: 8.2 ou superior
- **Laravel**: 10.x ou 11.x
- **Extensões PHP**: `mbstring`, `xml`, `dom`, `curl`, `gd`, `zip`, `pdo`

### Instalação via Composer

[](#instalação-via-composer)

```
composer require sierratecnologia/finder
```

### Publicação dos Arquivos de Configuração

[](#publicação-dos-arquivos-de-configuração)

Publique os arquivos de configuração, views e assets:

```
# Publicar configuração
php artisan vendor:publish --tag=sitec-config

# Publicar views (opcional)
php artisan vendor:publish --tag=sitec-views

# Publicar traduções (opcional)
php artisan vendor:publish --tag=sitec-lang
```

### Registro Automático do Service Provider

[](#registro-automático-do-service-provider)

O Finder utiliza descoberta automática de pacotes do Laravel. O `FinderProvider` será registrado automaticamente através da seção `extra.laravel.providers` no `composer.json`:

```
{
    "extra": {
        "laravel": {
            "providers": [
                "Finder\\FinderProvider"
            ]
        }
    }
}
```

### Configuração

[](#configuração)

O arquivo de configuração principal está em `config/sitec/finder.php`. Após publicar, você pode configurar:

```