ruledomain / opensourcefinancials

Open Source Financials is intended to be an "add-on" to OpenSourcePOS, providing additional modules, the first of which is a Purchasing module. This is my first Laravel project so there is going to be a bit of delay as I learn the technologies involved and the different conventions.

About Open Source Financials

OpenSourceFinancials is an open source Laravel based extension to OpenSourcePOS hosted at https://github.com/opensourcepos/opensourcepos

The first module to be developed will be Purchasing. More information can be found at the Wiki by Purchasing

Modules on the TODO list include:

• Purchasing
• Accounts Payable
• Accounts Receivable.
• Tax Reporting
• General Ledger

This system will not be competing with the heavy hitters in the industry. It is intended to "get the job done" for small companies

Migration

There will be few new tables introduced with the migration script, but this project's MINIMUM REQUIREMENT is that OPSPOS 3.3 or later be installed first. See the installation instructions for more detail.

Future Technology

Originally I was going to implement GraphQL and Vue.js right from the start, but with the limited amount of time that I have it is best if I start with smaller technology bites.

So the first draft with Purchasing is going to limit the new technology to just Laravel, BootStrap and SASS. I will continue to develop the schema for GraphQL so that I can explore it as time allows, but it will not be a priority.

Contributing

Contributions are not being accepted at this time. But thanks for being interested. I will open it up for contributions once the first draft is working to my satisfaction.

I want to give a "shout out" to Brandon Share at https://github.com/BrandonShar for providing a working example of the architecture I wanted to use in this project. He also wrote a couple of articles that provided numerous insights into the framework. I struggled with numerous configuration issues until I found his GitHub project.

License

The OpenSourceFinancials is open-source software licensed under the MIT license. The Laravel is open-source software licensed under the MIT license.

opensourcefinancials's Issues

Composite Keys

Learned that Laravel does not provide support for composite keys and that the Laravel Decider has decided not to provide support for composite keys.

Unfortunately OSPOS does have a few composite key tables.

Fortunately there appears to be at least two packages that provide some basic composite key support that just might get the job done. So I will be including one of those packages.

In my opinion this is a serious strike against Laravel because a deliberate decision was made to NOT play in the world of relational database design. It's a weakness that will need to be worked around ... off to a bad start.