PHPackages                             fruivita/corporativo - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. fruivita/corporativo

ActiveLibrary[Parsing & Serialization](/categories/parsing)

fruivita/corporativo
====================

Importador de Estrutura Corporativa em formato de arquivo XML para aplicações Laravel

v3.0.0(3y ago)01.1k[2 PRs](https://github.com/fruivita/corporativo/pulls)MITPHPPHP ^8.0

Since Jul 4Pushed 2y agoCompare

[ Source](https://github.com/fruivita/corporativo)[ Packagist](https://packagist.org/packages/fruivita/corporativo)[ Docs](https://github.com/fruivita/corporativo)[ RSS](/packages/fruivita-corporativo/feed)WikiDiscussions 3.x Synced 3w ago

READMEChangelog (4)Dependencies (12)Versions (10)Used By (0)

Importador de Estrutura Corporativa para aplicações Laravel
===========================================================

[](#importador-de-estrutura-corporativa-para-aplicações-laravel)

[![Latest Version on Packagist](https://camo.githubusercontent.com/12a93bba29a30a16e5450ce074841c6493fae8f706d95038d66374a30e0939e5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f66727569766974612f636f72706f72617469766f3f6c6f676f3d7061636b6167697374)](https://packagist.org/packages/fruivita/corporativo)[![GitHub Release Date](https://camo.githubusercontent.com/4ce12c3e5db515dfec0759eca8fc6f35da34659b61ea6e0fb2e2e63650e37dfa/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652d646174652f66727569766974612f636f72706f72617469766f3f6c6f676f3d676974687562)](/../../releases)[![GitHub last commit (branch)](https://camo.githubusercontent.com/2555cddb3b82f51e473369ba615b08c82dd7e4a4964ac46b71820d6c762df383/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f66727569766974612f636f72706f72617469766f2f332e783f6c6f676f3d676974687562)](/../../commits/3.x)[![GitHub Tests Action Status](https://camo.githubusercontent.com/1acde2106739b668ad65c4b8a4b3554379208dc3fc6794cef31aab4bea788fa8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f66727569766974612f636f72706f72617469766f2f74657374732e796d6c3f6272616e63683d332e78266c6162656c3d7465737473)](/../../actions/workflows/tests.yml?query=branch%3A3.x)[![Test Coverage](https://camo.githubusercontent.com/82770e15a75f60d9f53f786bcba1288ec7a89a0d177b361cd827fc599f2dc1f4/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f63386562386263656361626136656366353532382f746573745f636f766572616765)](https://codeclimate.com/github/fruivita/corporativo/test_coverage)[![Maintainability](https://camo.githubusercontent.com/d3a2de1a569b1571ea39451495e142f1c5bfbe463bf42849db5d3cbd99950c70/68747470733a2f2f6170692e636f6465636c696d6174652e636f6d2f76312f6261646765732f63386562386263656361626136656366353532382f6d61696e7461696e6162696c697479)](https://codeclimate.com/github/fruivita/corporativo/maintainability)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/09ece17331c44ea20574c16ff5f9c781d00bdd21e902aff75b0961bddc44a496/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f66727569766974612f636f72706f72617469766f2f7374617469632e796d6c3f6272616e63683d332e78266c6162656c3d737461746963)](/../../actions/workflows/static.yml?query=branch%3A3.x)[![GitHub issues](https://camo.githubusercontent.com/869513baa8dc0470ad47d89ba4b24c7138cbcbed400eaca3fc79eb79713bc6fc/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f66727569766974612f636f72706f72617469766f3f6c6f676f3d676974687562)](/../../issues)[![GitHub repo size](https://camo.githubusercontent.com/49fee8a2f6c725e93fecd59ccff1afd4b4ef5b2d818a8de5e624a88827e3728c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7265706f2d73697a652f66727569766974612f636f72706f72617469766f3f6c6f676f3d676974687562)](https://camo.githubusercontent.com/49fee8a2f6c725e93fecd59ccff1afd4b4ef5b2d818a8de5e624a88827e3728c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f7265706f2d73697a652f66727569766974612f636f72706f72617469766f3f6c6f676f3d676974687562)[![Packagist Total Downloads](https://camo.githubusercontent.com/6644bf3e91e4909affdb5cf7dcdd3eb6ce5340f867085ebcc1b2d865454b42f1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f66727569766974612f636f72706f72617469766f3f6c6f676f3d7061636b6167697374)](https://packagist.org/packages/fruivita/corporativo)[![GitHub](https://camo.githubusercontent.com/2ab993cb9a59d2aac21277b3f815145202e92bad53a5b0f9accf0fa9f973b53c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f66727569766974612f636f72706f72617469766f3f6c6f676f3d676974687562)](../LICENSE.md)

Importa a **Estrutura Corporativa** em formato **XML** para aplicações **[Laravel](https://laravel.com/docs)**.

Este package foi planejado de acordo com as necessidades da Justiça Federal do Espírito Santo. Contudo, ele pode ser utilizado em outros órgãos e projetos observados os termos previstos no [licenciamento](#license).

```
use FruiVita\Corporativo\Facades\Corporativo;

Corporativo::importar($arquivo);
```

---

Table of Contents
-----------------

[](#table-of-contents)

1. [Notes](#notes)
2. [Prerequisites](#prerequisites)
3. [Installation](#installation)
4. [How it works](#how-it-works)
5. [Events](#events)
6. [Testing and Continuous Integration](#testing-and-continuous-integration)
7. [Changelog](#changelog)
8. [Contributing](#contributing)
9. [Code of conduct](#code-of-conduct)
10. [Security Vulnerabilities](#security-vulnerabilities)
11. [Support and Updates](#support-and-updates)
12. [Roadmap](#roadmap)
13. [Credits](#credits)
14. [Thanks](#thanks)
15. [License](#license)

---

Notes
-----

[](#notes)

⭐ **Estrutura Corporativa** é o nome dado à consolidação das informações mínimas sobre pessoal, cargos, funções de confiança e lotações.

⬆️ [Voltar](#table-of-contents)

Prerequisites
-------------

[](#prerequisites)

1. Dependências PHP

    PHP ^8.0

    [Extensões](https://getcomposer.org/doc/03-cli.md#check-platform-reqs)

    ```
    composer check-platform-reqs
    ```
2. [GitHub Package Dependencies](/../../network/dependencies)

⬆️ [Voltar](#table-of-contents)

Installation
------------

[](#installation)

1. Instalar via **[composer](https://getcomposer.org/)**:

    ```
    composer require fruivita/corporativo
    ```
2. Publicar as migrations necessárias

    ```
    php artisan vendor:publish --provider='FruiVita\Corporativo\CorporativoServiceProvider' --tag='migrations'
    ```
3. Opcionalmente publicar as configurações

    ```
    php artisan vendor:publish --provider='FruiVita\Corporativo\CorporativoServiceProvider' --tag='config'
    ```
4. Opcionalmente publicar as traduções

    ```
    php artisan vendor:publish --provider='FruiVita\Corporativo\CorporativoServiceProvider' --tag='lang'
    ```

    As strings disponíveis para tradução são as que seguem. Altere-as de acordo com a necessidade.

    ```
    {
        "O arquivo informado não pôde ser lido": "O arquivo informado não pôde ser lido",
        "O arquivo precisa ser no formato [:attribute]": "O arquivo precisa ser no formato [:attribute]",
        "Validação falhou": "Validação falhou"
    }
    ```

⬆️ [Voltar](#table-of-contents)

How it works
------------

[](#how-it-works)

O arquivo com a **Estrutura Corporativa** deve ser oferecido a este package em formato **XML** estruturado da seguinte forma:

```

```

> Notar que a pessoa não possui ID (será analisada sua unicidade pela matrícula). Isso para permitir que outros usuários/pessoas possam ser cadastrados diretamente na aplicação.

Esse package expõe o seguinte método para realizar a importação:

✏️ **importar**

```
use FruiVita\Corporativo\Facades\Corporativo;

/**
 * @param string $arquivo full path do arquivo XML
 *
 * @throws \FruiVita\Corporativo\Exceptions\FileNotReadableException
 * @throws \FruiVita\Corporativo\Exceptions\UnsupportedFileTypeException
 *
 * @return void
 */
Corporativo::importar($arquivo);
```

🚨 **Exceptions**:

- **importar** lança **\\FruiVita\\Corporativo\\Exceptions\\FileNotReadableException** caso não tenha permissão de leitura no arquivo ou ele não seja encontrado
- **importar** lança **\\FruiVita\\Corporativo\\Exceptions\\UnsupportedFileTypeException** caso o arquivo não seja um arquivo **XML**

⬆️ [Voltar](#table-of-contents)

Events
------

[](#events)

Eventos emitidos durante o processo de importação:

- **\\FruiVita\\Corporativo\\Events\\ImportacaoIniciada**
- **\\FruiVita\\Corporativo\\Events\\ImportacaoConcluida**
- **\\FruiVita\\Corporativo\\Events\\CargoUsuarioAlterado**
- **\\FruiVita\\Corporativo\\Events\\FuncaoConfiancaUsuarioAlterada**
- **\\FruiVita\\Corporativo\\Events\\LotacaoUsuarioAlterada**

⬆️ [Voltar](#table-of-contents)

Testing and Continuous Integration
----------------------------------

[](#testing-and-continuous-integration)

```
composer analyse
composer test
composer coverage
```

⬆️ [Voltar](#table-of-contents)

Changelog
---------

[](#changelog)

Por favor, veja o [CHANGELOG](CHANGELOG.md) para maiores informações sobre o que mudou em cada versão.

⬆️ [Voltar](#table-of-contents)

Contributing
------------

[](#contributing)

Por favor, veja [CONTRIBUTING](CONTRIBUTING.md) para maiores detalhes sobre como contribuir.

⬆️ [Voltar](#table-of-contents)

Code of conduct
---------------

[](#code-of-conduct)

Para garantir que todos sejam bem vindos a contribuir com este projeto open-source, por favor leia e siga o [Código de Conduta](CODE_OF_CONDUCT.md).

⬆️ [Voltar](#table-of-contents)

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Por favor, veja na [política de segurança](/../../security/policy) como reportar vulnerabilidades ou falhas de segurança.

⬆️ [Voltar](#table-of-contents)

Support and Updates
-------------------

[](#support-and-updates)

A versão mais recente receberá suporte e atualizações sempre que houver necessidade. As demais, receberão atualizações por 06 meses após terem sido substituídas por uma nova versão sendo, então, descontinuadas.

VersionPHPReleaseEnd of Life1.0^8.004-07-202222-05-20232.0^8.022-11-202210-06-20233.0^8.010-01-2023dd-mm-yyyy🐛 Encontrou um bug?!?! Abra um **[issue](/../../issues/new?assignees=fcno&labels=bug%2Ctriage&template=bug_report.yml&title=%5BT%C3%ADtulo+conciso+do+bug%5D)**.

⬆️ [Voltar](#table-of-contents)

Roadmap
-------

[](#roadmap)

> ✨ Alguma ideia nova?!?! Inicie **[uma discussão](https://github.com/orgs/fruivita/discussions/new?category=ideas&title=%5BCorporativo%5D)**.

A lista a seguir contém as necessidades de melhorias identificadas e aprovadas que serão implementadas na primeira janela de oportunidade.

- n/a

⬆️ [Voltar](#table-of-contents)

Credits
-------

[](#credits)

- [Fábio Cassiano](https://github.com/fcno)
- [All Contributors](/../../contributors)

⬆️ [Voltar](#table-of-contents)

Thanks
------

[](#thanks)

👋 Agradeço às pessoas e organizações abaixo por terem doado seu tempo na construção de projetos open-source que foram usados neste package.

- ❤️ [The Laravel Framework](https://github.com/laravel) pelos packages:

    - [illuminate/collections](https://github.com/illuminate/collections)
    - [illuminate/database](https://github.com/illuminate/database)
    - [illuminate/support](https://github.com/illuminate/support)
    - [laravel/pint](https://github.com/laravel/pint)
- ❤️ [Orchestra Platform](https://github.com/orchestral) pelo package [orchestral/testbench](https://github.com/orchestral/testbench)
- ❤️ [Nuno Maduro](https://github.com/nunomaduro) pelo package [nunomaduro/larastan](https://github.com/nunomaduro/larastan)
- ❤️ [PEST](https://github.com/pestphp) pelos packages:

    - [pestphp/pest](https://github.com/pestphp/pest)
    - [pestphp/pest-plugin-laravel](https://github.com/pestphp/pest-plugin-laravel)
- ❤️ [Sebastian Bergmann](https://github.com/sebastianbergmann) pelo package [sebastianbergmann/phpunit](https://github.com/sebastianbergmann/phpunit)
- ❤️ [PHPStan](https://github.com/phpstan) pelos packages:

    - [phpstan/phpstan](https://github.com/phpstan/phpstan)
    - [phpstan/phpstan-deprecation-rules](https://github.com/phpstan/phpstan-deprecation-rules)
- ❤️ [ergebnis](https://github.com/ergebnis) pelo package [ergebnis/composer-normalize](https://github.com/ergebnis/composer-normalize)
- ❤️ [Shivam Mathur](https://github.com/shivammathur) pela Github Action [shivammathur/setup-php](https://github.com/shivammathur/setup-php)
- ❤️ [GP](https://github.com/paambaati) pela Github Action [paambaati/codeclimate-action](https://github.com/paambaati/codeclimate-action)
- ❤️ [Stefan Zweifel](https://github.com/stefanzweifel) pelas Github Actions:

    - [stefanzweifel/git-auto-commit-action](https://github.com/stefanzweifel/git-auto-commit-action)
    - [stefanzweifel/changelog-updater-action](https://github.com/stefanzweifel/changelog-updater-action)

💸 Algumas dessas pessoas ou organizações possuem alguns produtos/serviços que podem ser comprados. Se você puder ajudá-los comprando algum deles ou se tornando um patrocinador, mesmo que por curto período, ajudará toda a comunidade **open-source** a continuar desenvolvendo soluções para todos.

⬆️ [Voltar](#table-of-contents)

License
-------

[](#license)

The MIT License (MIT). Por favor, veja o **[License File](../LICENSE.md)** para maiores informações.

⬆️ [Voltar](#table-of-contents)

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity59

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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 ~32 days

Recently: every ~12 days

Total

7

Last Release

1268d ago

Major Versions

v1.0.0 → v2.0.02022-11-22

v2.0.1 → v3.0.02023-01-10

1.x-dev → 3.x-dev2023-01-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/59084dba6352f226a5807e548270a92d5943f1ee8f97931e7a7ccde4142bd71b?d=identicon)[fcno](/maintainers/fcno)

---

Top Contributors

[![fcno](https://avatars.githubusercontent.com/u/71986962?v=4)](https://github.com/fcno "fcno (64 commits)")

---

Tags

laravelphpxmllaravelxmlfruivitaimportadorcorporativo

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/fruivita-corporativo/health.svg)

```
[![Health](https://phpackages.com/badges/fruivita-corporativo/health.svg)](https://phpackages.com/packages/fruivita-corporativo)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[illuminate/queue

The Illuminate Queue package.

21332.6M1.5k](/packages/illuminate-queue)[illuminate/database

The Illuminate Database package.

2.8k54.9M11.5k](/packages/illuminate-database)[craftcms/cms

Craft CMS

3.6k3.6M3.0k](/packages/craftcms-cms)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M184](/packages/laravel-ai)[yajra/laravel-oci8

Oracle DB driver for Laravel via OCI8

8793.2M25](/packages/yajra-laravel-oci8)

PHPackages © 2026

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