README

🌐 Visão Geral

O Filabiz é uma plataforma moderna de gestão empresarial construída sobre o sólido framework Apache OFBiz.
Nosso objetivo é trazer a robustez de um ERP modular de código aberto para um contexto mais flexível, intuitivo e contemporâneo, reduzindo a curva de aprendizado e acelerando a adoção em projetos de negócios digitais.

🚀 Motivações

Complexidade do Apache OFBiz
- Embora extremamente poderoso, o OFBiz pode ser intimidador para novos desenvolvedores e empresas, exigindo grande esforço inicial de configuração e personalização.
Necessidade de uma experiência moderna
- Startups e empresas digitais buscam soluções mais ágeis, com interfaces limpas, integração facilitada e documentação acessível.
Comunidade e inovação
- O projeto pretende reduzir barreiras técnicas, aproximar a comunidade open-source e estimular a criação de novos módulos e integrações.

⚙️ Ganhos Técnicos

O Filabiz herda a arquitetura robusta do Apache OFBiz, mas agrega melhorias significativas:

🔧 Estrutura Modular Simplificada
Reorganização de módulos para facilitar extensão e manutenção.
📦 Integrações Modernas
Suporte facilitado para APIs REST/GraphQL, mensageria e microsserviços.
🖥️ Interface Contemporânea
Camada de front-end desacoplada, inspirada em frameworks modernos (React, FilamentPHP, Vue, etc.).
⚡ Produtividade Acelerada
Ferramentas CLI e scripts de automação que simplificam setup, deploy e testes.
🔒 Segurança e Boas Práticas
Configurações padrão mais seguras, autenticação flexível (OAuth2, Keycloak) e camadas de autorização claras.
📊 Observabilidade e Monitoramento
Logs estruturados, métricas e dashboards nativos de acompanhamento de performance.

🏗️ Arquitetura

  +-------------------+
  |   Frontend (UI)   |
  +-------------------+
            |
  +-------------------+
  |  API Layer (REST) |
  +-------------------+
            |
+-----------------------+
| Apache OFBiz Core ERP |
+-----------------------+
            |
  +-------------------+
  |   Banco de Dados  |
  +-------------------+

Core: Baseado no Apache OFBiz, garantindo solidez em contabilidade, estoque, CRM, e-commerce e mais.
API Layer: Middleware simplificado para integração com aplicações modernas.
UI: Interfaces adaptadas para experiência fluida e contemporânea.

📈 Por que usar o Filabiz?

Mais rápido para começar do que configurar o Apache OFBiz puro.
Mais amigável para times de desenvolvimento modernos.
Mais flexível para integrações em ambientes cloud-native.

What's Included

Core Dependencies

Laravel 11.x - The PHP framework
FilamentPHP 3.x - Admin panel with SPA mode, custom theme, and MFA enabled
nunomaduro/essentials - Better Laravel defaults (strict models, auto-eager loading, immutable dates)

Development Tools

larastan/larastan - Static analysis
laravel/pint - Code style fixer
pestphp/pest - Testing framework
rector/rector - Automated refactoring
barryvdh/laravel-debugbar - Development insights

Testing

Includes a comprehensive test suite with PEST 4.x including browser testing - perfect for learning testing or as a reference for your own tests.

GitHub Workflows

Comes with pre-configured GitHub Actions workflows for automated quality assurance:

Tests - PEST 4.x testing with 4 parallel shards for faster CI/CD
PHPStan - Static analysis and type checking
Pint - Automated code style fixing with auto-commit

Quick Start

composer create-project filabiz/dist your-project-name
cd your-project-name 
composer install
npm install
npm run build
php artisan serve

Features

Filament Admin Panel

SPA mode enabled
Custom login page with autofilled credentials in local environment
Custom theme included
Profile management enabled
MFA (App Authentication) enabled

Filament Tables

Striped rows for better visual separation
Deferred loading for improved performance

Development Workflow

composer review  # Runs Pint, Rector, PHPStan, and Pest

Customizations

Migration Stubs

Custom stubs remove the down() method by default. Remove the custom stubs to use Laravel's default templates.

Helper Functions

Add your own helpers in app/Helpers.php:

if (! function_exists('example')) {
    function example(): string
    {
        return 'Your helper function here.';
    }
}

Terminal Aliases

Simple Alias

alias filabiz="composer create-project --prefer-dist filabiz/dist"
filabiz my-project

Advanced Function (Example with Herd)

Add this to your ~/.bashrc, ~/.zshrc, or shell configuration file:

function larament() {
  local cmd="$1"
  shift

  case "$cmd" in
    new)
      if [[ -z "$1" ]]; then
        return 1
      fi

      local project_name="$1"
      composer create-project --prefer-dist filabiz/dis "$project_name" || return 1
      cd "$project_name" || return 1

      # Update APP_URL in .env
      if [[ -f ".env" ]]; then
        sed -i '' "s|^APP_URL=.*|APP_URL=https://${project_name}.test|" .env
      fi

      herd link --secure && herd open
      ;;
    *)
      return 1
      ;;
  esac
}

Usage:

larament new my-project

🤝 Contribuição

Quer contribuir com o Filabiz?

Faça um fork do repositório
Crie uma branch para sua feature/fix
Envie um Pull Request 🚀

📜 Licença

O projeto segue a licença Apache 2.0, assim como o Apache OFBiz.

filabiz / filabiz-app-starter

Maintainers

Details