This is a skeleton you can use to start your projects

This project is about a representation of the customer accounts of the E-Commerce website for NYU CSCI-GA 2820, Fall 2023.

The best way to use this repo is to start your own repo using it as a git template. To do this just press the green Use this template button in GitHub and this will become the source for your repository.

You can also clone this repository and then copy and paste the starter code into your project repo folder on your local computer. Be careful not to copy over your own README.md file so be selective in what you copy.

There are 4 hidden files that you will need to copy manually if you use the Mac Finder or Windows Explorer to copy files from this folder into your repo folder.

These should be copied using a bash shell as follows:

    cp .gitignore  ../<your_repo_folder>/
    cp .flaskenv ../<your_repo_folder>/
    cp .gitattributes ../<your_repo_folder>/

The project contains the following:

.gitignore          - this will ignore vagrant and other metadata files
.flaskenv           - Environment variables to configure Flask
.gitattributes      - File to gix Windows CRLF issues
.devcontainers/     - Folder with support for VSCode Remote Containers
dot-env-example     - copy to .env to use environment variables
requirements.txt    - list if Python libraries required by your code
config.py           - configuration parameters

service/                   - service python package
├── __init__.py            - package initializer
├── models.py              - module with business models
├── routes.py              - module with service routes
└── common                 - common code package
    ├── error_handlers.py  - HTTP error handling code
    ├── log_handlers.py    - logging setup code
    └── status.py          - HTTP status constants

tests/              - test cases package
├── __init__.py     - package initializer
├── test_models.py  - test suite for business models
└── test_routes.py  - test suite for service routes

1. Create a customer record

• Description

  This API call is used to create a new customer object.

• Request URL

  Send a POST request to the /customers endpoint to create a customer. The URL is: /customers

• Request Body

  A JSON file including "first name" (< 63 words), "last name" (< 63 words) and "address" (< 200 words)

• Response

  HTTP_201_CREATED if succeed.

2. Update a customer record based on Customer ID

• Description: Update the first name, last name, or address of the Customer

• Request URL: "/customers/int:customer_id"

• Request Body: JSON file containing the updated information of customer.

• Response:

  HTTP_200_OK, if found;

  HTTP_404_NOT_FOUND, if customer does not exist or has been deactivated

  HTTP_405_METHOD_NOT_ALLOWED, if updated status is False

3. Read a cutomer record based on Customer ID

• Description: This API call is used to read a customer's information by its customer id

• Request URL: "/customers/int:customer_id"

• Response:

  • if found, returns a JSON object containing the customer's id, first name, last name, and address
  • if not found, returns a JSON object containing error messages

4. Delete a cutomer record based on Customer ID

• Description

  Delete the customer information based on Customer ID
  

• Request URL:

  "/customers/int:customer_id" DELETE request

• Request Body: /

• Response

  HTTP_204_NO_CONTENT
  

• Example

  "customer/1" -> deletes the customer and its information for the customer with id = 1
  

5. List all customer information

• Description

• Request URL

• Request Body

• Response

• Example

6. Deactivate a cutomer record based on Customer ID

• Description

  Deactivate the customer information based on Customer ID
  

• Request URL:

  "/customers/int:customer_id/deactivate" PUT request

• Request Body: /

• Response

  HTTP_200_OK
  

7. Restore a deactivated customer record

• Description

  This API call is used to restore a deactivated customer record with customer_id from the database.

• Request URL

  "/customers/<int:customer_id>/restore" PUT request

• Request Body

  /

• Response

  HTTP_200_OK if found and successfully restored

  HTTP_404_NOT_FOUND if not found

8. Query by customer first name/last name/name

• Description

  This API is used to query a customer by the name

• Request URL

  /customers?first_name=customer_first_name&last_name=customer_last_name

  /customers?first_name=customer_first_name

  /customers?last_name=customer_last_name

• Response

  HTTP_200_OK if found

  HTTP_404_NOT_FOUND if not found

To test the code from the VScode terminal, run:

green -vvv --processes=1 --run-coverage --termcolor --minimum-coverage=95

To start the service from the VScode terminal, run:

honcho start

Copyright (c) John Rofrano. All rights reserved.

Licensed under the Apache License. See LICENSE

This repository is part of the NYU masters class: CSCI-GA.2820-001 DevOps and Agile Methodologies created and taught by John Rofrano, Adjunct Instructor, NYU Courant Institute, Graduate Division, Computer Science, and NYU Stern School of Business.