🌇 SunsetERP 🌇

WARNING: This project is still in development. It is not ready for production use or any use at all. But help is always welcome!

SunsetERP is based on a heavily modified version of OFBiz to run on Quarkus.

Here are some of the features of SunsetERP/OFBiz:

Accounting (agreements, invoicing, vendor management, general ledger)
Asset maintenance
Catalogue and product management
Facility and warehouse management system (WMS)
Manufacturing execution / manufacturing operations management (MES/MOM)
Order processing
Inventory management, automated stock replenishment etc.
Content management system (CMS)
Human resources (HR)
People and group management
Project management
Sales force automation
Work effort management
Electronic point of sale (ePOS)
Electronic commerce (eCommerce)
Scrum (development) (Scrum software development support)
and many more to come...

SunsetERP benefits from OFBiz usage of standard business data models.

Delta with OFBiz

SunsetERP is based on Quarkus
- Why? Quarkus is faster and makes Java projects more lightweight.
SunsetERP is API first (REST and SOAP)
- Why? It makes it easier to integrate with other systems and create an SPA Single Page Application.
- That being said the UI will be made with PatternFLy (of RedHat) and HTMX+RVST+HTMT. Because it looks way better than OFBiz UI. Sorry.
SunsetERP is using a reactive architecture
SunsetERP can be used in a microservices architecture more easily
SunsetERP is using a different authentication system
- Why? It makes it easier to integrate with other systems, to reduce the attack surface and to have something else not to worry about.
- It will soon be able to work out of the box with Keycloak.
  - Keycloak supports SAML 2.0, OpenID Connect, OAuth 2.0 and LDAP. So why reinvent the wheel?
- So for more SSO and authentication options you will have to use Keycloak or some other system.

What stays the same

It is important to not stray away to far from the original OFBiz architecture and data model. This is to make sure that the project stays compatible with OFBiz plugins that already exist.
It is important that it does not feel like a different project.
The Data Models will stay untouched, but we might add new ones if need be.
Entity Engine will stay untouched.
Since Quarkus is used some changes to the usage of Groovy is to be expected.

Why keep SOAP?

SOAP is still used in many places and is still a very valid way of communicating with other systems. It is also very easy to use with Java.
SOAP in the world of accounting, banking and finance is still very much used. It is also used in the world of logistics and supply chain management.

Project Status

Still in dev mode.

Nice to have

https://kogito.kie.org/ (BPM and BRM)
Have a similar plugin system as Keycloak
Adapt ofbiz-plugins to this new setup
Adapt it for better Process Mining

Endpoints

/sunseterp/v1/health - Health check
/sunseterp/v1/info - Info about the framework
/sunseterp/v1/openapi - OpenAPI documentation
/sunseterp/v1/applications - List of applications
/sunseterp/v1/applications/{application} - Info about the application
/sunseterp/v1/applications/{application}/openapi - OpenAPI documentation for the application
/sunseterp/v1/applications/{application}/{actions} - Actions for the application
/sunseterp/v1/applications/{application}/{actions}/openapi - OpenAPI documentation for the actions
/sunseterp/v1/applications/{application}/services - List of services for the application
/sunseterp/v1/applications/{application}/services/{service} - Info about the service
/sunseterp/v1/applications/{application}/services/{service}/openapi - OpenAPI documentation for the service
/q/openapi - OpenAPI documentation
/q/swagger-ui - Swagger UI

History

Confirmed have change for: commit (on Aug 29, 2023)
The following change until Oct 2, 2023 are in none Java files (Groovy, Gradle and themes)
Starting from this commit the changes are missing: commit (Oct 2, 2023)
- framework/widget/dtd/widget-form.xsd - was updated
commit (Oct 10, 2023) - unimportant front end
commit (Oct 11, 2023) - Java library version
commit (Oct 13, 2023) - Java library version
commit (Nov 2, 2023) - Need to apply the changes from OFBiz
- framework/service/entitydef/entitymodel.xml
- framework/service/src/main/java/org/apache/ofbiz/service/job/JobManager.java
- framework/service/src/main/java/org/apache/ofbiz/service/job/PersistedServiceJob.java
commit (Nov 13, 2023) - Java library version
commit (Nov 20, 2023) - Groovy
commit (Nov 24, 2023) - Front end
- framework/widget/src/main/java/org/apache/ofbiz/widget/model/ModelFormField.java
- framework/widget/src/main/java/org/apache/ofbiz/widget/model/XmlWidgetFieldVisitor.java
commit (Dec 5, 2023) - Front end
commit (Dec 5, 2023)
- framework/base/testdef/basetests.xml
commit (Dec 14, 2023)
- framework/webapp/src/main/java/org/apache/ofbiz/webapp/control/LoginWorker.java
commit (Dec 14, 2023)
- framework/webapp/src/main/java/org/apache/ofbiz/webapp/control/LoginWorker.java
commit (Dec 14, 2023)
- framework/common/src/main/java/org/apache/ofbiz/common/CommonEvents.java
- The rest is UI stuff and controller stuff
commit (Dec 15, 2023)
- framework/webapp/src/main/java/org/apache/ofbiz/webapp/control/LoginWorker.java
commit (Dec 18, 2023)
- framework/common/data/GeoData_IN.xml
commit (Dec 23, 2023) - Front end
commit (Dec 31, 2023) -
- pullAllPlugins and pullPlugin scripts
commit (Jan 1, 2024)
- .github/workflows/docker-image.yaml
- .github/workflows/gradle.yaml
- pullAllPluginsSource.sh
commit (Jan 1, 2024)
- NOTICE
- applications/datamodel/data/demo/AccountingDemoData.xml
commit (Jan 1, 2024)
- README.adoc
- build.gradle - It seems they commented out the code to pull plugin source
commit (Jan 2, 2024)
- pull plugin stuff
commit (Jan 2, 2024)
- pull plugin stuff (empty?)
commit (Jan 3, 2024)
- README.adoc
- pull plugin stuff
commit (Jan 3, 2024)
- pull plugin stuff
commit (Jan 4, 2024)
- pull plugin stuff
commit (Jan 4, 2024)
- pull plugin stuff
commit (Jan 4, 2024)
- front end
commit (Jan 6, 2024)
- pull plugin stuff
commit (Jan 8, 2024)
- front end
commit (Jan 8, 2024)
- .github/workflows/docker-image.yaml
commit (Jan 12, 2024)
- framework/webapp/src/main/java/org/apache/ofbiz/webapp/control/ControlFilter.java
commit (Jan 23, 2024)
- applications/content/src/main/java/org/apache/ofbiz/content/content/ContentWrapper.java
- applications/order/src/main/java/org/apache/ofbiz/order/order/OrderContentWrapper.java
- applications/party/src/main/java/org/apache/ofbiz/party/content/PartyContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/category/CategoryContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/config/ProductConfigItemContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductPromoContentWrapper.java
commit (Jan 23, 2024)
- applications/datamodel/entitydef/order-entitymodel.xml
- applications/order/src/main/java/org/apache/ofbiz/order/shoppingcart/ShoppingCart.java
- applications/order/src/main/java/org/apache/ofbiz/order/shoppingcart/ShoppingCartItem.java
- applications/product/servicedef/services_pricepromo.xml
- applications/product/src/main/java/org/apache/ofbiz/product/price/PriceServices.java
commit (Jan 29, 2024)
- applications/accounting/src/main/java/org/apache/ofbiz/accounting/thirdparty/eway/GatewayConnector.java
- applications/accounting/src/main/java/org/apache/ofbiz/accounting/thirdparty/paypal/PayPalEvents.java
- applications/content/src/main/java/org/apache/ofbiz/content/data/DataResourceWorker.java
- framework/base/src/main/java/org/apache/ofbiz/base/config/UrlLoader.java
- framework/base/src/main/java/org/apache/ofbiz/base/conversion/NetConverters.java
- framework/base/src/main/java/org/apache/ofbiz/base/location/StandardUrlLocationResolver.java
- framework/base/src/main/java/org/apache/ofbiz/base/util/HttpClient.java
- framework/base/src/main/java/org/apache/ofbiz/base/util/UtilURL.java
- framework/base/src/test/java/org/apache/ofbiz/base/conversion/MiscTests.java
- framework/common/src/main/java/org/apache/ofbiz/common/email/EmailServices.java
- framework/service/src/test/groovy/org/apache/ofbiz/service/ModelServiceTest.groovy - groovy
- framework/webtools/src/main/groovy/org/apache/ofbiz/webtools/datafile/ViewDataFile.groovy - groovy
- framework/webtools/src/main/java/org/apache/ofbiz/webtools/artifactinfo/ArtifactInfoFactory.java
commit (Feb 1, 2024)
- Some changes in build.gradle
commit (Feb 2, 2024)
- applications/order/src/main/java/org/apache/ofbiz/order/shoppingcart/ShoppingCartItem.java
commit (Feb 2, 2024)
- framework/minilang/src/main/java/org/apache/ofbiz/minilang/MiniLangRuntimeException.java
- framework/minilang/src/main/java/org/apache/ofbiz/minilang/SimpleMethod.java
- framework/minilang/src/main/java/org/apache/ofbiz/minilang/ValidationException.java
- framework/minilang/src/main/java/org/apache/ofbiz/minilang/method/envops/Break.java
- framework/minilang/src/main/java/org/apache/ofbiz/minilang/method/envops/Continue.java
commit (Feb 2, 2024)
- framework/minilang/src/main/java/org/apache/ofbiz/minilang/SimpleMethod.java
commit (Feb 2, 2024) - doc stuff
commit (Feb 2, 2024) - build.gradle
commit (Feb 2, 2024)
- applications/content/src/main/java/org/apache/ofbiz/content/content/ContentWrapper.java
- applications/order/src/main/java/org/apache/ofbiz/order/order/OrderContentWrapper.java
- applications/party/src/main/java/org/apache/ofbiz/party/content/PartyContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/category/CategoryContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/config/ProductConfigItemContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductPromoContentWrapper.java
- applications/workeffort/src/main/java/org/apache/ofbiz/workeffort/content/WorkEffortContentWrapper.java
commit (Feb 2, 2024)
- applications/content/src/main/java/org/apache/ofbiz/content/content/ContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductPromoContentWrapper.java
commit (Feb 2, 2024)
- applications/product/src/main/java/org/apache/ofbiz/product/category/CategoryContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/config/ProductConfigItemContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductPromoContentWrapper.java
- applications/workeffort/src/main/java/org/apache/ofbiz/workeffort/content/WorkEffortContentWrapper.java
commit (Feb 2, 2024)
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductContentWrapper.java
- applications/product/src/main/java/org/apache/ofbiz/product/product/ProductPromoContentWrapper.java
commit (Feb 3, 2024)
- VERSION - Does not seem to be important
commit (Feb 3, 2024)
- build.gradle - Related to groovyScripts
commit (Feb 4, 2024)
- framework/webapp/src/main/java/org/apache/ofbiz/webapp/control/LoginWorker.java
commit (Feb 5, 2024) - Groovy
commit (Feb 5, 2024)
- VERSION
commit (Feb 5, 2024)
- Groovy
commit (Feb 5, 2024)
- build.gradle
commit (Feb 5, 2024)
- build.gradle
commit (Feb 5, 2024)
- build.gradle
commit (Feb 5, 2024)
- build.gradle
commit (Feb 6, 2024)
- framework/common/webcommon/WEB-INF/common-controller.xml
commit (Feb 6, 2024)
- applications/party/widget/partymgr/PartyMenus.xml - View stuff
commit (Feb 8, 2024)
- docker/examples/postgres-demo/docker-compose.yml
commit (Feb 8, 2024) - Doc stuff
commit (Feb 8, 2024) - Doc stuff
commit (Feb 9, 2024) - Front end
commit (Feb 9, 2024) - Doc stuff
commit (Feb 9, 2024) - Doc stuff
commit (Feb 10, 2024) - Doc stuff
commit (Feb 14, 2024) - Doc stuff
commit (Feb 14, 2024) - Doc stuff
commit (Feb 14, 2024) - Front end

Notes about Paths:

groovyScripts {
        groovy {
            srcDirs += getDirectoryInActiveComponentsIfExists('src/main/groovy')
            compileClasspath += sourceSets.main.compileClasspath
            compileClasspath += sourceSets.main.output
        }

Might need to investigate:

sourceSets.main.compileClasspath
sourceSets.main.output

TODO

Abstraction:

A developer should be able to easily build a ERP microservices env.

A developer should not need to put too much energy on the front end and not have any business (or very little) in the front-end (no more Angular and React or whatever else that causes people to replicate everything on the frontend (INSANITY!!))

API first (HATEOAS)

Decoupling should be easy

Make applications lighter and more portable

Add features to be more attractive vs Salesforce and Odoo

Better testing to catch more issues (currently there are broken parts of OFBiz and for some reason it hasn't been caught)

So in other words, we need better QA

Demos help others see what can be done and how

Here is what the architecture should look like after the refactoring:

Comparisons

Getting Started

This project uses Quarkus, the Supersonic Subatomic Java Framework.

If you want to learn more about Quarkus, please visit its website: https://quarkus.io/ .

Running the application in dev mode

You can run your application in dev mode that enables live coding using:

./run-dev.sh

Old:

./gradlew quarkusDev

NOTE: Quarkus now ships with a Dev UI, which is available in dev mode only at http://localhost:8080/q/dev/.

Packaging and running the application

The application can be packaged using:

./gradlew build

It produces the quarkus-run.jar file in the build/quarkus-app/ directory. Be aware that it’s not an über-jar as the dependencies are copied into the build/quarkus-app/lib/ directory.

The application is now runnable using java -jar build/quarkus-app/quarkus-run.jar.

If you want to build an über-jar, execute the following command:

./gradlew build -Dquarkus.package.type=uber-jar

The application, packaged as an über-jar, is now runnable using java -jar build/*-runner.jar.

Creating a native executable

You can create a native executable using:

./gradlew build -Dquarkus.package.type=native

Or, if you don't have GraalVM installed, you can run the native executable build in a container using:

./gradlew build -Dquarkus.package.type=native -Dquarkus.native.container-build=true

You can then execute your native executable with: ./build/sunseterp-1.0.0-SNAPSHOT-runner

If you want to learn more about building native executables, please consult https://quarkus.io/guides/gradle-tooling.

Related Guides

SmallRye OpenAPI (guide): Document your REST APIs with OpenAPI - comes with Swagger UI
RESTEasy Reactive (guide): A Jakarta REST implementation utilizing build time processing and Vert.x. This extension is not compatible with the quarkus-resteasy extension, or any of the extensions that depend on it.
OpenID Connect (guide): Verify Bearer access tokens and authenticate users with Authorization Code Flow
Elytron Security Properties File (guide): Secure your applications using properties files
SmallRye Health (guide): Monitor service health

Provided Code

RESTEasy Reactive

Easily start your Reactive RESTful Web Services

Related guide section...

SmallRye Health

Monitor your application's health using SmallRye Health

Related guide section...

Crypto notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country’s laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

The following provides more details on the included cryptographic software:

Various classes in OFBiz, including DesCrypt, HashCrypt, and BlowFishCrypt use libraries from the Sun Java JDK API including java.security.* and javax.crypto.* (the JCE, Java Cryptography Extensions API)
Other classes such as HttpClient and various related ones use the JSSE (Java Secure Sockets Extension) API

Name		Name	Last commit message	Last commit date
Latest commit History 71 Commits
.amadla		.amadla
.github		.github
.lab		.lab
.old		.old
config		config
docker		docker
docs		docs
gradle/wrapper		gradle/wrapper
lib		lib
runtime		runtime
spotbugs		spotbugs
src		src
.asf.yaml		.asf.yaml
.dockerignore		.dockerignore
.env.dev		.env.dev
.gitattributes		.gitattributes
.gitignore		.gitignore
.pre-commit-config.yaml		.pre-commit-config.yaml
.xmlcatalog.xml		.xmlcatalog.xml
APACHE2_HEADER		APACHE2_HEADER
LICENSE		LICENSE
OFBIZ_APACHE2_HEADER		OFBIZ_APACHE2_HEADER
OPTIONAL_LIBRARIES		OPTIONAL_LIBRARIES
README.md		README.md
VERSION		VERSION
amadla.yml		amadla.yml
build.gradle		build.gradle
common.gradle		common.gradle
dependencies.gradle		dependencies.gradle
export-keycloak.sh		export-keycloak.sh
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
run.sh		run.sh
settings.gradle		settings.gradle

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

🌇 SunsetERP 🌇

Delta with OFBiz

What stays the same

Why keep SOAP?

Project Status

Nice to have

Endpoints

History

Notes about Paths:

TODO

Comparisons

Getting Started

Running the application in dev mode

Packaging and running the application

Creating a native executable

Related Guides

Provided Code

RESTEasy Reactive

SmallRye Health

Crypto notice

Copyright

About

Releases

Packages

Languages

License

jnbdz/SunsetERP

Folders and files

Latest commit

History

Repository files navigation

🌇 SunsetERP 🌇

Delta with OFBiz

What stays the same

Why keep SOAP?

Project Status

Nice to have

Endpoints

History

Notes about Paths:

TODO

Comparisons

Getting Started

Running the application in dev mode

Packaging and running the application

Creating a native executable

Related Guides

Provided Code

RESTEasy Reactive

SmallRye Health

Crypto notice

Copyright

About

Topics

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages