Maestro

Maestro^TM is The ERP for Engineers^TM, an open-source web-based ERP system that provides Transparency with Trust^TM to design, manufacturing and support teams.

Maesto is in active development and is likely not suitable for production use as-is.

Maestro manages information related to projects, parts, stock, issues and people. Drawing inspiration from Parts&Vendors^TM, Maestro includes enterprise features, single-entry accounting, and true multi-user operation.

Maestro includes a complete data set for the fictional Swift Construction Company (SCC), including projects, parts, stock (unserialized, serialized and lot controlled), issues and users. A demo is hosted on dalescott.net.

Maestro is developed as an open source project and uses the permissive business-friendly BSD 2-Clause License for maximum flexibility of use to the Maestro community. The goal of the Maestro project is to provide a superior integrated business management solution to small-to-medium enterprises (SME) for managing parts, projects, material, issues and people.

Getting Started

Refer to the following documents:

• INSTALL.md - installation procedure (FreeBSD)
• SCC.md - describes structure of SCC master data
• WORKFLOWS.md - describes SCC workflows

Issue Tracking

Issues (and project milestones) are tracked in the Maestro Project Issue Tracker.

Communication Channels

The official (and preferred) communication channel is the Maestro Project Issue Tracker.

Project Documentation

Project documentation is maintained in the Maestro Project Wiki.

Developer Guidelines

The basic development procedure is:

• Create a GitHub account and use GitHub to fork the Maestro project repo
• Clone your fork locally
• Create a local topic branch off the master branch
• Develop and test your work locally
• Push your topic branch to your GitHub clone
• Issue a pull request with your changes to the Maestro project

All development is currently in the master branch.

For more information, see the Maestro project wiki (e.g. Maestro Development). You can also explore inherent conventions using PHP_CodeSniffer.

Legal

Maestro source is copyright by its authors, as recorded in the maestro repository commit log. The Maestro project does not use a Contributor License Agreement (CLA) or a Copyright Assignment Agreement (CAA). By submitting work to the project, you agree to license your contribution according to the BSD 2-Clause License.

Maestro^TM, ERP for Engineers^TM, and Transparency with Trust^TM are used under license according to the Maestro Trademark and Logo Policy.

Parts&Vendors^TM is a trademark of Trilogy Design

Support

If you require assistance, please try the following in order:

• Review the Maestro project Wiki.
• Investigate expected behaviour using the Maestro demo system
• Search the Maestro issue tracker
• Update your repository.
• Submit an issue to the Maestro issue tracker

If posting a new issue to the issue tracker, please try to include answers to the following questions:

• What are you trying to achieve?
• What are the symptoms? Why do you think this is a problem?
• What version of Maestro you are using? (are you using a release version?, current master branch head?)
• Include as an example, the simplest sequence of operations that demonstrates the undesired or unanticipated behaviour.