manual

Process the orders

Process orders after payment.

Required inputs

• server

Instruction set

• Obtain the undelivered orders.
  • Open a secure shell on the server.
  • Activate the virtual environment.
  • Change to the /tinyshop/server directory.
  • Execute python administrate.py. In this instance, administrate.py copies the undelivered orders into orders-undelivered.csv.
  • Execute cat orders-undelivered.csv to output the undelivered orders; if no undelivered orders are output, no further action is necessary.
  • Execute git add orders-undelivered.csv to add orders-undelivered.csv to the staging area.
  • Execute git commit -m "Commit orders-undelivered.csv to the repository." to commit orders-undelivered.csv to the repository.
  • Execute git push origin master to push the repository to GitHub.
  • Exit the server shell.
• Fulfill and record the orders.
  • Open a shell.
  • Change to the /tinyshop directory.
  • Execute git pull origin master to fetch and merge the GitHub private tinyshop repository.
  • Change to the /server directory.
  • Execute wget https://tinyshops.org/assets/orders-update.csv to get the orders-update.csv template.
  • Open orders-update.csv in a spreadsheet editor.
  • Open orders-undelivered.csv in a spreadsheet editor.
  • For each paid order in orders-undelivered.csv:
    • Reference the payment intent in Stripe payments to obtain order information (e.g. shipping address).
    • Fulfill the order.
    • Populate a new row in orders-update.csv.
      • Set id to the order_id.
      • If applicable, set courier_delivery_id (e.g. USPS trackingNumber).
      • Set cache_delivery_status to delivered, canceled, or leave blank. A delivered or canceled order will not reappear in orders-undelivered.csv.
  • Execute git add orders-update.csv to add orders-update.csv to the staging area.
  • Execute git commit -m "Commit orders-undelivered.csv to the repository." to commit orders-update.csv to the repository.
  • Execute git push origin master to push the repository to GitHub.
• Update the orders database table.
  • Open a secure shell on the server.
  • Activate the virtual environment.
  • Change to the /tinyshop directory.
  • Execute git pull origin master to fetch and merge the GitHub private tinyshop repository.
  • Change to the /server directory.
  • Execute python administrate.py. In this instance, administrate.py updates the orders database table given orders-update.csv.
  • Exit the server shell.