This sample application is a ficticious order entry / inventory management system. All efforts were made to keep this application as simple as possible, with a focus on how business logic can be written with peasy-js and consumed by multiple clients (react, angular, and nodejs).
- Clone the repo:
git clone https://github.com/peasy/peasy-js-samples.git - You can also download the latest release
- nodejs - this application hosts a web api that the client applications rely on and requires node.
- postman, fiddler, cURL, or similar (optional) - these tools help to facilitate communications with http endpoints.
- MongoDB (optional) - this application by default is configured to work with in-memory data proxies, however, you can easily swap data proxies to interact with a mongodb instance if desired. See MongoDB Configuration for more details.
From a command line, navigate to the peasy-js-samples directory and run:
npm run install_dependencies_and_build_projectsnpm run server
By default, the client (react and angular) applications are configured to use http implementations of the data proxies. These data proxies communicate with the http endpoints hosted in node.
In turn, the http endpoints are configured to use in-memory data proxies. However, there are a few configuration possibilities. The configurations section provides details on setting up many potential configurations.
In this scenario, the client consumes business services that are injected with data proxies that communicate with in-memory data stores.
In this scenario, the client consumes business services that are injected with data proxies that use HTTP to communicate with the Web API application. In turn, the Web API application uses business services that are injected with data proxies that communicate with in-memory data stores.
In this scenario, the client consumes business services that are injected with data proxies that use HTTP to communicate with the Web API application. In turn, the Web API application uses business services that are injected with data proxies that communicate with a MongoDB database.
With the application up and running you can navigate to the following urls:
- http://localhost:3000/customers
- http://localhost:3000/orders
- http://localhost:3000/orderitems
- http://localhost:3000/products
- http://localhost:3000/categories
- http://localhost:3000/inventoryitems
This walkthrough covers creating a customer, category, product, and placing an order on behalf of the new customer. It also covers submitting and shipping an order to see how it affects inventory.
Please consider showing your support by starring the project.