e-commerce

Progetto

Il seguente progetto contiene il backend di un sito di e-commerce, ed include le seguenti componenti:

• un modello per i customers, ovvero coloro che acquistano i prodotti in vendita
• un modello per i fornitori, ovvero coloro che registrano nel sito i prodotti da vendere
• un modello per i trasportatori, ovvero coloro che consegnano i prodotti ai customer
• dei server ai quali i customers si connettono per interagire con il sistema
• dei server ai quali i fornitori si connettono per interagire con il sistema
• dei server ai quali i trasportatori si connettono per interagire con il sistema
• dei test generator per le operazioni del customer
• dei test generator per le operazioni dei fornitori
• dei test generator per le operazioni dei trasportatori
• un database per i dati
• un database per i log di sistema
• monitor per proprietà funzionali e non funzionali

Relazione

All'interno della repository è presente una relazione, contenente dettagli implementativi sull'architettura del progetto.

Prerequisiti

Per compilare il progetto sono necessari i seguenti prerequisiti:

Librerie

• g++
• make
• PostgreSQL
• Redis
• hiredis (https://github.com/redis/hiredis)
• PostgreSQL Libraries

Ubuntu

Il progetto è testato su Ubuntu, ed è possibile installare i prerequisiti menzionati è possibile eseguire lo script seguente:

sh install.sh

Compilazione

Una volta clonata la repository eseguendo

git clone https://github.com/aflaag/e-commerce.git

è possibile compilare il database e proggrammi del progetto attraverso il seguente script:

sh compile.sh

Esecuzione

Una volta che la compilazione è andata a buon fine, è possibile eseguire i vari programmi del progetto mediante il seguente script:

sh run.sh

inoltre, per terminare tutti i vari processi del progetto è sufficiente eseguire lo stesso script attraverso la seguente flag:

sh run.sh --kill

---

Documentazione API

Supplier

• add-product

  • code: ProductCode
  • name: StringS
  • description: StringL
  • price: RealGEZ

    add-product code banana name yoyo description ahahahaha##baba price 341.3243
    

• add-restock

  • quantity: IntGZ
  • supplier: StringS
  • product: ProductCode

    add-restock quantity 10 supplier Supplier1 product P1
    

• add-supplier

  • business_name: StringS

    add-supplier business_name Supplier5
    

• update-product

  • code: ProductCode
  • description: StringL

    update-product code P1 description ho##capito
    

• view-statistic

  • supplier: StringS

    view-statistic supplier Supplier1
    

Courier

• take-purchase-delivery

  • courier: StringS
  • purchase: integer
  • deliverycode: DeliveryCode

    take-purchase-delivery courier courier1 purchase 1 deliverycode aifjifa
    

• update-assigned-delivery

  • deliverycode: DeliveryCode
  • start: timestamp
  • lost: timestamp
  • end: timestamp

    update-assigned-delivery deliverycode bho2 lost 2024-02-29##19:41:42
    

• update-refund-request

  • refund: integer
  • switch
    • option
      • courier: StringS

        update-refund-request courier UPS refund 46
        

    • option
      • refund_start: timestamp
      • refund_end: timestamp

        update-refund-request refund 1 refund_end 2024-03-02##11:05:42.660825
        

• view-available-purchase

  view-available-purchase
  

Customer

• add-address

  • email: Email
  • zip_code: ZipCode
  • street_number: StreetNumber
  • street: StringM
  • city: IntGZ

    add-address email [email protected] zip_code 2C4A street_number 2B street aldo city 1
    

• add-card

  • number: CardNumber
  • email: Email

    add-card email [email protected] number 007865432872
    

• add-curtomer

  • name: StringS
  • surname: StringS
  • email: Email
  • phone-number: PhoneNumber

    add-customer name user surname resu email [email protected] phone-number +393714393392
    

• add-purchase [order matters]

  • fare: RealGEZ
  • customer: Email
  • card: CardNumber
  • zip_code: ZipCode
  • street: StringM
  • street_number: StreetNumber
  • product: ProductCode
  • quantity: IntGZ
  • product: ProductCode
  • quantity: IntGZ

    add-purchase fare 0.95 customer [email protected] card 007865432872 zip_code 2C4A street aldo street_number 23B product P1 quantity 2  $\dots$ quantity 4 product P2
    

• add-rating

  • product: ProductCode
  • customer: Email
  • stars: Stars

    add-rating product P1 customer [email protected] starts 4
    

• add-refund-request

  • assigned_delivery: DeliveryCode
  • product: ProductCode
  • quantity: IntGZ
  • product: ProductCode
  • quantity: IntGZ

    add-refund-request assigned_delivery 3321AD34 product P1 quantity 2 ... quantity 4 product P2
    

• delete-purchase

  • purchase: IntGZ

    delete-purchase purchase 1
    

• search-products

  • product_name: StringS

    search-products product_name a
    

• view-order

  • purchase_id: IntGZ

    view-order purchase_id 2
    

• view-refund

  • refund_id: IntGZ

    view-refund refund_id 1