PHPackages                             bildvitta/sp-crm - 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. [Utility & Helpers](/categories/utility)
4. /
5. bildvitta/sp-crm

ActiveLibrary[Utility & Helpers](/categories/utility)

bildvitta/sp-crm
================

Pacote Laravel para sincronização e importação de dados do SP via RabbitMQ.

v0.2.0(3w ago)07.5k↓71.4%1MITPHPPHP ^8.0|^8.1|^8.2|^8.3CI passing

Since Aug 10Pushed 3w ago13 watchersCompare

[ Source](https://github.com/bildvitta/sp-crm)[ Packagist](https://packagist.org/packages/bildvitta/sp-crm)[ RSS](/packages/bildvitta-sp-crm/feed)WikiDiscussions develop Synced 2d ago

READMEChangelog (10)Dependencies (14)Versions (26)Used By (1)

`appnave/nave-crm-sp`
=====================

[](#appnavenave-crm-sp)

Visão Geral
-----------

[](#visão-geral)

Pacote privado Laravel para integração do CRM SP via Composer. Ele publica configuração, migrations, seeders e comandos Artisan para instalação, importação de dados e consumo da fila RabbitMQ.

Requisitos
----------

[](#requisitos)

- PHP `^8.0` até `^8.3`
- Laravel `8`, `9`, `10` ou `11`
- Acesso ao repositório privado via Composer
- Banco MySQL para a conexão `crm`
- RabbitMQ para o worker de mensagens

Acesso aos Repositórios Privados
--------------------------------

[](#acesso-aos-repositórios-privados)

No projeto cliente, adicione o repositório VCS no `composer.json`:

```
{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/appnave/nave-crm-sp"
    }
  ]
}
```

Instale o pacote:

```
composer require appnave/nave-crm-sp:dev-develop
```

Autenticação local do Composer com token GitHub:

```
composer config -g github-oauth.github.com
```

Em GitHub Actions, configure `COMPOSER_AUTH`:

```
env:
  COMPOSER_AUTH: >-
    {"github-oauth":{"github.com":"${{ secrets.COMPOSER_GITHUB_TOKEN }}"}}
```

Se o projeto cliente também consumir outras dependências privadas, mantenha a mesma estratégia de `repositories` e autenticação no ambiente de CI.

Instalação Local
----------------

[](#instalação-local)

1. Adicione o repositório VCS no projeto cliente.
2. Instale o pacote com Composer.
3. Execute a instalação do pacote:

```
php artisan sp-crm:install
```

O comando:

- publica `config/sp-crm.php`
- publica as migrations do pacote
- executa `migrate`
- publica `database/seeders/SpCrmSeeder.php`
- executa `db:seed --class=SpCrmSeeder`

Configuração
------------

[](#configuração)

Configure as variáveis usadas pelo pacote:

```
MS_SP_CRM_TABLE_PREFIX=crm_

CRM_DB_HOST=127.0.0.1
CRM_DB_PORT=3306
CRM_DB_DATABASE=forge
CRM_DB_USERNAME=forge
CRM_DB_PASSWORD=

RABBITMQ_HOST=
RABBITMQ_PORT=5672
RABBITMQ_USER=
RABBITMQ_PASSWORD=
RABBITMQ_VIRTUALHOST=/
RABBITMQ_EXCHANGE_CUSTOMERS=customers
RABBITMQ_QUEUE_CUSTOMERS=
```

O arquivo de configuração publicado fica em `config/sp-crm.php`.

Comandos Úteis
--------------

[](#comandos-úteis)

### Instalação

[](#instalação)

```
php artisan sp-crm:install
```

### Importação de clientes

[](#importação-de-clientes)

```
php artisan dataimport:crm_customers --select=500 --offset=0 --with_sales_team
```

Opções:

- `--select` define o lote de registros
- `--offset` define o ponto inicial da importação
- `--with_sales_team` inclui dados de time comercial quando disponível

### Worker RabbitMQ

[](#worker-rabbitmq)

```
php artisan rabbitmqworker:customers
```

### Style

[](#style)

```
composer run check-style
composer run fix-style
```

Documentação da API
-------------------

[](#documentação-da-api)

Este pacote não inclui Swagger/OpenAPI.

Informações Adicionais
----------------------

[](#informações-adicionais)

- O pacote depende do modelo `App\Models\Worker` no projeto cliente para executar a importação.
- A conexão `crm` é configurada em tempo de execução pelo comando de importação.
- O pacote registra automaticamente seus providers, migrations e comandos via `Spatie\LaravelPackageTools`.
- O namespace PHP atual é `BildVitta\SpCrm`.

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance95

Actively maintained with recent releases

Popularity22

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 53.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~70 days

Recently: every ~218 days

Total

21

Last Release

22d ago

PHP version history (2 changes)v0.0.1PHP ^8.0|^8.1

v0.1.3PHP ^8.0|^8.1|^8.2|^8.3

### Community

Maintainers

![](https://www.gravatar.com/avatar/57ede45a8ce528ade98fadbb32397afb6c0234f9d05caae7ac207d3b4d026af1?d=identicon)[hynzhw](/maintainers/hynzhw)

![](https://www.gravatar.com/avatar/e32e39fb848943b1a94bb2c167a2bda11eb45814ba34d539e6b1685a5de6e272?d=identicon)[michaelnakamura](/maintainers/michaelnakamura)

![](https://www.gravatar.com/avatar/ab5f117bbac50e0314758bcc25c9052dc4546568082eff672b65b128be0e2d98?d=identicon)[fabiomartins](/maintainers/fabiomartins)

![](https://www.gravatar.com/avatar/3ce1635f07565fb1531991b47d86c407b9b30955eb1871dad4ed33810aaffe88?d=identicon)[leandrohago](/maintainers/leandrohago)

---

Top Contributors

[![fabiomartins1](https://avatars.githubusercontent.com/u/50298479?v=4)](https://github.com/fabiomartins1 "fabiomartins1 (35 commits)")[![paulodavanco](https://avatars.githubusercontent.com/u/11135122?v=4)](https://github.com/paulodavanco "paulodavanco (18 commits)")[![zerossB](https://avatars.githubusercontent.com/u/8009480?v=4)](https://github.com/zerossB "zerossB (9 commits)")[![michaelnakamura](https://avatars.githubusercontent.com/u/10209108?v=4)](https://github.com/michaelnakamura "michaelnakamura (3 commits)")

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/bildvitta-sp-crm/health.svg)

```
[![Health](https://phpackages.com/badges/bildvitta-sp-crm/health.svg)](https://phpackages.com/packages/bildvitta-sp-crm)
```

###  Alternatives

[spatie/laravel-permission

Permission handling for Laravel 12 and up

12.9k102.4M1.4k](/packages/spatie-laravel-permission)[spatie/laravel-health

Monitor the health of a Laravel application

87512.0M164](/packages/spatie-laravel-health)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M345](/packages/psalm-plugin-laravel)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[illuminate/queue

The Illuminate Queue package.

21332.6M1.6k](/packages/illuminate-queue)[flarum/core

Delightfully simple forum software.

201.4M2.3k](/packages/flarum-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)