包简介

README 文档

README

Flux ERP

Flux ERP is a modern, open-source ERP built on Laravel and Livewire. It ships as a Composer package that you install into a Laravel application.

Important

Flux is a package, not a standalone app. That is why this repository has no artisan file and no bootstrap/app.php — those belong to the Laravel host application. You cannot run php artisan … inside this repository directly. Install it into a fresh Laravel app as shown below.

Requirements

PHP 8.4 (bcmath, intl, json, pdo, zip)
MySQL 8 / MariaDB
Meilisearch — search (Laravel Scout)
Composer 2

No Node.js or frontend build is needed on the project side. Flux serves its compiled assets straight from the package at runtime.

Installation

# 1. Create a fresh Laravel app
composer create-project laravel/laravel flux-app
cd flux-app

# 2. Require Flux (service provider, migrations, routes and assets auto-register)
composer require team-nifty-gmbh/flux-erp

# 3. Require the license package (provides the install wizard)
composer require team-nifty-gmbh/flux-license

# 4. Run the interactive install wizard
php artisan flux:install

# 5. Link storage for uploaded media
php artisan storage:link

Configure your database, Meilisearch and mail credentials in .env before running the wizard, and remove the default welcome route from routes/web.php (Flux registers its own).

The php artisan flux:install wizard guides you through the remaining setup (migrations, roles and permissions, base data, payment types, and so on). If you prefer to run the steps manually instead, use php artisan migrate and php artisan init:permissions.

Seeding base data

Add the seeder to database/seeders/DatabaseSeeder.php:

$this->call(\FluxErp\Database\Seeders\FluxSeeder::class);

then run php artisan db:seed.

Serve the app with php artisan serve (or Sail) and log in.

Frontend assets

Assets are compiled inside the package and served through its own /flux/… routes. The @fluxStyles and @fluxScripts Blade directives inject them — add these to your <head> and before </body> only if you use a custom layout instead of the shipped one. Nothing to build or publish.

Realtime (Laravel Reverb)

Flux uses Laravel Reverb for realtime features. Broadcasting credentials are read from .env at runtime, so no rebuild is required when they change.

php artisan reverb:start

REVERB_APP_ID=local
REVERB_APP_KEY=local
REVERB_APP_SECRET=local
REVERB_HOST=your.domain.com
REVERB_SCHEME=https
REVERB_PORT=443

In production run Reverb behind your web server as a reverse proxy so websocket traffic reaches it on port 443.

Publishing package resources (optional)

Only needed to override defaults:

Tag	Publishes
`flux-config`	`config/flux.php`
`flux-views`	Blade views into `resources/views/vendor/flux`
`flux-translations`	Language files
`flux-migrations`	Migrations into `database/migrations`
`flux-seeders`	Seeders into `database/seeders`
`flux-docker`	Docker/Sail setup

php artisan vendor:publish --tag=flux-config

Development

Flux publishes a Docker/Sail setup that runs nginx instead of artisan serve:

php artisan vendor:publish --tag=flux-docker

Run the package test suite (uses Testbench) from the package directory:

composer install
composer test

Documentation

Guides for extending Flux live in docs: routes, views, widgets, print views, monitorable jobs, backend customization.

License

Flux ERP is open-sourced software licensed under the MIT license.

team-nifty-gmbh/flux-erp 适用场景与选型建议

team-nifty-gmbh/flux-erp 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 16.85k 次下载、GitHub Stars 达 4，最近一次更新时间为 2023 年 07 月 25 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 team-nifty-gmbh/flux-erp 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 team-nifty-gmbh/flux-erp 我们能提供哪些服务？

定制开发 / 二次开发

基于 team-nifty-gmbh/flux-erp 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 team-nifty-gmbh/flux-erp 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

micschk/silverstripe-groupable-gridfield 7

This module allows drag & drop grouping of items in a GridField

baslik/reader-tools 0

Adds text size controls and text-to-speech controls to Flarum discussion content.

phone-myat-kyaw/blade-date-pickers 0

Native Blade date, datetime, and date range pickers.

krma-cl/kcfinder-symfony-bundle 0

Symfony and Flysystem integration for the maintained KCFinder continuation.

krma-cl/kcfinder-laravel 0

Laravel integration for the maintained KCFinder continuation.

knplabs/phpstan-rules 0

PHPStan rules shared across KnpLabs organization projects

team-nifty-gmbh/flux-erp

包简介