vapor-po

The website for generating purchase orders.

Usage

Generally the app should be ran through a docker container or docker-compose file. Examples are in the ./docker folder.

Images get built in the CI environment when a tag is pushed to the repository.

Getting Started

When the application is first launched an admin user should be created in the running container. Attach to the container using docker exec or docker compose exec, then run:

./App generate-admin --username "admin" --password "super-secret --confirmPassword "super-secret"

You can then login and generate user, employees, vendors, etc.

After the setup has been completed, then you should generate a mock purchase order and set the id to the value you would like new purchase orders to start from. This should be done through calling the api, as the web interface does not allow users to enter an id value.

Example

These examples use httpie, note the port is used for local development, in a production environment you would just use the FQDN of where the application is running.

Login

http :8080/api/v1/login username="admin" password="super-secret" \
    | jq '.["token"]' \
    | pbcopy

Set the token as environment variable

export API_TOKEN=<clipboard contents>

Get the employees to copy an id to use for the purchase order

http -A bearer -a "$API_TOKEN" :8080/api/v1/employees

Get the vendor branches to copy an id to use for the purchase order

http -A bearer -a "$API_TOKEN" :8080/api/v1/vendors/branches

Generate first po

http -A bearer -a "$API_TOKEN" :8080/api/v1/purchase-orders \
    id:="60000" \
    materials="Test" \
    customer="Testy McTestface" \
    createdForID="<employee-id>"
    vendorBranchID="<vendor-branch-id>"