aureuserp / aureuserp

10,634442+7 todayPHP

View on GitHub

Free and Open Source ERP platform

💡 Use Cases

最适合需要免费、可定制且功能全面的现代ERP系统来整合业务流程的中小企业和开发者。

初创公司业务管理

Problem: 初创公司需要管理客户、订单、库存和财务，但预算有限，无法承担昂贵的商业ERP系统。

Solution: 使用Aureus ERP的免费开源特性，快速部署一套包含CRM、销售订单、库存管理和基础财务模块的完整系统。

Example: 一家电商初创公司可以安装销售、库存和发票插件，管理从客户询价到发货开票的全流程，无需为每个功能购买独立软件。

传统企业系统升级

Problem: 企业使用老旧的桌面版管理软件，数据孤岛严重，无法实现多部门协同和移动办公。

Solution: 基于Aureus ERP的现代Web架构和响应式设计，构建统一的业务平台，通过角色权限控制实现各部门数据共享与协作。

Example: 一家制造企业将采购、生产、仓储和财务部门整合到同一平台，采购订单自动生成入库单，生产领料实时扣减库存，财务实时查看报表。

定制化业务需求开发

Problem: 企业有特殊的业务流程，通用ERP系统无法满足，定制开发成本高且难以维护。

Solution: 利用Aureus ERP的Laravel+FilamentPHP技术栈和插件系统，开发定制模块无缝集成到现有平台中。

Example: 一家服务公司需要独特的项目工时核算和成本分摊逻辑，开发者可以基于插件系统快速开发项目管理模块，复用系统的用户、权限和UI框架。

多地点仓库管理

Problem: 拥有多个仓库或门店的企业，需要实时掌握各点库存情况，避免缺货或积压。

Solution: 使用Aureus ERP的多仓库管理功能，通过统一的库存视图和调拨流程，实现库存的精准控制和优化。

Example: 一家连锁零售企业可以设置总仓和分店仓库，在线查看各店库存，发起调拨申请，系统自动更新库存数量并生成调拨记录。

📊 Project Info

Language: PHP
Stars: ⭐ 10,634
Forks: 442
Today: +7
Ranking: #7
Collection: Language
Trending Date: May 27, 2026
Last Push: 5/26/2026

🏷️ Topics

LaravelFilamentPHP企业资源规划业务管理模块化可扩展中小企业开发者

📸 Screenshots

5分钟快速开始Aureus ERP

Aureus ERP是一个基于Laravel 11和FilamentPHP 4构建的开源企业资源规划平台，专为中小型企业设计，提供模块化功能和现代化界面。

🖥️ OS

macOSWindowsLinux

⚙️ Runtime

PHP8.2或更高

MySQL8.0或更高

Node.js18.x或更高

🔧 Tools

Composer— PHP依赖管理

NPM或Yarn— 前端依赖管理

📝 Steps

克隆仓库

从GitHub克隆Aureus ERP项目到本地目录。

克隆主仓库

$ git clone https://github.com/aureuserp/aureuserp.git

✓Expected: 项目文件夹aureuserp被创建，包含所有源代码。

💡确保已安装Git，或直接从GitHub下载ZIP文件解压。

安装依赖

使用Composer和NPM安装PHP和前端依赖包。

进入项目目录

$ cd aureuserp

安装PHP依赖

$ composer install

安装前端依赖

$ npm install

✓Expected: 依赖安装完成，无错误信息。

💡如果Composer或NPM速度慢，可配置镜像源加速。

运行安装向导

执行Artisan命令进行数据库迁移、数据填充和初始设置。

运行安装脚本

$ php artisan aureus:install

✓Expected: 显示安装进度，包括数据库迁移、角色创建和管理员账户生成，最后提示安装成功。

💡确保数据库服务已启动，并提前创建好数据库。

启动开发服务器

使用Laravel内置服务器启动应用，以便在浏览器中访问。

启动本地服务器

$ php artisan serve

✓Expected: 服务器启动在http://localhost:8000，显示Laravel启动信息。

💡保持终端窗口打开以运行服务器，或使用后台进程。

✅ 验证安装成功

在浏览器中访问应用并登录，确认系统正常运行。

✓打开http://localhost:8000显示登录页面
✓使用默认管理员账户登录成功
✓看到Aureus ERP仪表板界面

⚡ Quick Tips

环境检查安装前检查PHP版本是否为8.2+，使用php -v命令验证。

数据库如果数据库连接失败，检查.env文件中的数据库配置是否正确。

扩展功能安装插件使用php artisan plugin:install <插件名>，例如安装库存模块。

🔍 Troubleshooting

❓ Composer安装失败，提示内存不足或依赖冲突。

→ 增加PHP内存限制：composer install -o --prefer-dist，或更新Composer到最新版本。

❓ 运行php artisan serve时端口8000被占用。

→ 使用其他端口：php artisan serve --port=8080，然后访问http://localhost:8080。

❓ 登录页面显示数据库错误或500内部错误。

→ 检查数据库服务是否运行，并运行php artisan migrate:status确认迁移状态。

🎯 Next Steps

探索插件系统

安装财务或库存等业务模块以扩展功能。

自定义界面

使用FilamentPHP工具修改主题和添加自定义组件。

查看文档

访问项目GitHub页面或文档了解更多高级配置和开发指南。

Difficulty

初级

Est. Time

1-2天

Target Audience

具备基本PHP和Web开发知识的初学者，想学习如何使用和定制开源ERP系统，或对Laravel/FilamentPHP生态感兴趣的开发者。

🎯 What You'll Learn

能够成功在本地运行Aureus ERP系统，了解其模块化架构，并掌握安装、管理核心插件以及进行基础定制的能力。

📋 Prerequisites

PHP基础熟悉

Aureus ERP基于PHP 8.2+和Laravel框架构建，理解PHP语法、面向对象编程和Composer依赖管理是理解项目代码和进行定制的基础。

Laravel基础了解

项目基于Laravel 11，了解其MVC架构、路由、Eloquent ORM、Artisan命令和Blade模板将极大帮助理解项目结构和进行开发。

前端基础 (HTML, CSS, JavaScript)了解(optional)

系统使用FilamentPHP和Livewire构建响应式界面，了解前端基础知识有助于理解UI组件和进行界面定制。

数据库基础 (MySQL/SQLite)了解(optional)

系统运行需要数据库支持，了解基本的数据库概念和SQL语句有助于理解数据迁移和模型关系。

Git基础了解(optional)

用于克隆项目、管理代码版本以及后续可能的贡献。

📚 Resources

必看

Laravel 11 官方文档

学习Aureus ERP所依赖的核心框架。重点看“入门指南”、“Eloquent ORM”、“数据库迁移”、“Artisan命令”等章节。

必看

FilamentPHP 4 官方文档

学习构建Aureus ERP后台界面的框架。重点看“快速入门”、“资源（Resources）”、“表单（Forms）”、“表格（Tables）”、“面板（Panel）”等概念。

必看

Aureus ERP GitHub README 和 Wiki（如有）

最直接的项目说明，包含安装、配置、插件管理等核心信息。务必仔细阅读。

🗺️ Learning Phases

环境准备与项目获取

⏱ 1-2小时

检查并配置开发环境

根据README中的“Requirements”部分，确保本地环境已安装PHP 8.2+、Composer、Node.js 18+、NPM/Yarn以及MySQL 8.0+或SQLite。可以使用Laravel官方推荐的Laravel Sail、Laragon、XAMPP或Valet等工具快速搭建环境。

💡使用 `php -v`, `composer --version`, `node -v`, `mysql --version` 命令逐一验证版本。新手推荐使用集成环境如Laragon，可避免复杂的配置。

克隆项目到本地

打开终端，进入你的工作目录，运行 `git clone https://github.com/aureuserp/aureuserp.git` 将项目代码克隆到本地。

💡如果GitHub访问慢，可以考虑使用镜像源或先下载ZIP包。克隆后进入项目目录：`cd aureuserp`。

安装PHP依赖

在项目根目录下运行 `composer install` 命令，安装Laravel框架及所有PHP包依赖。

💡此过程可能需要几分钟，取决于网络速度。如果遇到内存限制错误，可以尝试 `COMPOSER_MEMORY_LIMIT=-1 composer install`。确保在项目根目录执行。

安装前端依赖

运行 `npm install` 或 `yarn install` 来安装Node.js包依赖，如TailwindCSS等。

💡同样需要网络和时间。完成后可以运行 `npm run build` 来编译前端资源，但下一步的安装命令可能会自动处理。

系统安装与初次运行

⏱ 30分钟-1小时

复制环境配置文件并配置数据库

将 `.env.example` 文件复制为 `.env` 文件。然后编辑 `.env` 文件，设置数据库连接（DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD）。对于快速测试，可以将 `DB_CONNECTION` 设置为 `sqlite`，并确保 `database/database.sqlite` 文件存在（或创建它）。

💡使用SQLite可以免去安装配置MySQL的步骤，非常适合新手快速体验。只需注释掉MySQL配置，取消注释 `DB_CONNECTION=sqlite` 即可。

生成应用密钥并运行安装命令

在终端运行 `php artisan key:generate`。然后运行README中“Quick Start”部分Step 3的安装命令（通常是 `php artisan aureus:install` 或类似的Artisan命令）。此命令将执行数据库迁移、填充初始数据、创建管理员账户等。

💡仔细阅读终端输出，它会提示你创建管理员账户的邮箱和密码，务必记下来！安装过程是了解系统初始化步骤的好机会。

启动开发服务器并登录

运行 `php artisan serve` 启动内置PHP开发服务器。打开浏览器，访问 `http://localhost:8000`。使用上一步设置的管理员邮箱和密码登录系统。

💡`php artisan serve` 默认在8000端口。如果端口被占用，可以使用 `--port` 参数指定其他端口，如 `php artisan serve --port=8080`。登录后先花几分钟浏览一下后台界面。

核心功能探索与插件管理

⏱ 2-3小时

熟悉后台界面与核心模块

登录后，查看左侧导航菜单。尝试点击“Analytics”（分析）、“Chatter”（内部交流）、“Support”（支持）等已安装的核心系统插件，了解其基本功能。

💡注意观察FilamentPHP构建的UI特点：响应式布局、数据表格、表单、模态框等。这是感受系统现代架构的第一步。

安装一个功能插件（如Inventories）

参照README“Plugin Installation & Management”部分。在项目根目录打开终端，运行 `php artisan plugin:install inventories`。观察终端输出，理解插件安装过程（包括可能的依赖检查和数据库迁移）。

💡这是理解Aureus ERP模块化精髓的关键步骤。安装成功后，刷新后台页面，看左侧导航是否出现了“Inventories”或相关菜单项。

探索已安装插件的功能

进入新安装的“Inventories”插件（或你安装的其他插件），尝试创建一些测试数据，例如添加一个产品类别、一个仓库、一个产品。了解其CRUD（增删改查）操作流程。

💡关注Filament的资源（Resource）是如何管理模型数据的。可以打开 `app/Plugins/Inventories` 目录（如果存在）查看插件代码结构。

了解插件卸载过程

（可选，谨慎操作）在终端运行 `php artisan plugin:uninstall inventories`。阅读警告信息，理解卸载会删除相关数据表。建议在操作前备份数据库或使用测试数据库。

💡此步骤主要是为了理解系统的完整性。如果不希望丢失测试数据，可以跳过卸载，或安装另一个插件（如 `invoices`）进行体验。

基础定制与概念深化

⏱ 2-4小时

修改基础配置与外观

尝试在系统设置中（如果提供）修改公司名称、时区、语言等。如果系统支持主题，尝试切换不同的主题颜色。了解 `.env` 文件中一些关键配置项的作用。

💡定制往往从配置开始。查找 `config/` 目录下的配置文件，了解Laravel和Filament的配置是如何影响系统的。

了解角色与权限（Filament Shield）

进入“Security”或“用户与角色”相关模块。查看系统预定义的角色（如Admin, User）。尝试创建一个新角色，并为其分配特定的权限（例如，只能查看产品但不能编辑）。然后创建一个新用户并分配该角色，用新用户登录验证权限是否生效。

💡这是企业级应用的重要特性。理解基于角色的访问控制（RBAC）如何通过Filament Shield实现。

浏览项目代码结构

在IDE中打开项目，重点浏览以下目录：`app/` (核心应用逻辑)，`database/migrations/` (数据库迁移文件)，`resources/views/` (视图文件)，`app/Plugins/` (插件目录，如果存在)。尝试找到一个你感兴趣的功能对应的模型、控制器和Filament资源类。

💡不要试图理解所有代码。目标是建立对Laravel项目结构和Filament插件结构的基本认知。可以对照Laravel和Filament官方文档理解目录含义。

运行测试（可选）

如果项目包含测试，运行 `php artisan test` 来执行单元测试和功能测试。观察测试是否通过，这有助于理解代码的质量和预期行为。

💡对于新手，这一步主要是感受现代PHP项目的测试实践。如果测试失败，可能是环境配置问题，不必深究。

⚠️ Common Mistakes

❌ 环境配置错误（PHP版本过低、扩展缺失、数据库连接失败）

✅ 严格按照README的“Requirements”检查。使用 `php -m` 查看已安装扩展，确保必要的扩展（如PDO, OpenSSL, Mbstring等）已启用。数据库连接信息务必准确填写在 `.env` 文件中。

❌ 未正确设置文件权限（存储目录、缓存目录不可写）

✅ 在Laravel项目中，通常需要确保 `storage/` 和 `bootstrap/cache/` 目录对Web服务器进程可写。在Linux/Mac上可能需要运行 `chmod -R 775 storage bootstrap/cache`。

❌ 安装插件时忽略依赖提示，导致功能不完整或错误

✅ 仔细阅读 `php artisan plugin:install` 命令的输出。如果提示需要安装依赖插件，请按照提示先安装依赖项。理解插件间的依赖关系是使用模块化系统的关键。

❌ 直接在生产环境进行实验性操作（如插件卸载、数据库清空）

✅ 始终在本地开发环境或隔离的测试环境中进行学习和实验。在对数据或结构进行破坏性操作（如卸载插件）前，备份数据库。可以使用Laravel的数据库种子（Seeders）来快速重建测试数据。

❌ 试图一次性理解所有代码，导致挫败感

✅ 采用“由外到内，由用到改”的策略。先确保系统能运行并使用基本功能。然后针对一个具体的小功能点（如“产品列表页如何分页？”）去追踪相关代码。循序渐进。

🚀 Next Steps

学完基础后，可以尝试：1. **开发一个简单自定义插件**：参照现有插件结构，创建一个管理“客户反馈”或“内部公告”的简单模块，学习Filament资源创建的全流程。2. **深度定制现有插件**：修改某个已安装插件（如Invoices）的表格列、表单字段或添加一个简单的计算逻辑。3. **集成外部API**：尝试为系统添加一个发送邮件通知或调用第三方天气API显示在仪表板上的功能。4. **研究高级特性**：深入了解队列（Queues）、任务调度（Scheduling）、事件（Events）和通知（Notifications）在Aureus ERP中是如何应用的。5. **参与贡献**：从解决GitHub Issues中的“good first issue”或改进文档开始，逐步参与到开源项目中。