Bygg databasen till en Eshop (del 2)

Du har utfört en ER-modellering av en databas för en Eshop som du också har påbörjat att implementera i en databas med en webbklient och en terminalklient.

Du skall nu jobba vidare med implementationen av din databas.

Du kan utföra denna uppgift enskilt, eller i samma grupp som du tidigare jobbat i.

Alla lämnar in en egen lösning i sitt kursrepo, även om man jobbat i grupp.

#Förkunskaper

Du har utfört uppgiften “Bygg databasen till en Eshop (del 1)”.

Du har utfört övningarna “Egendefinierade funktioner i databas” och “Index och prestanda i MySQL” så du vet innebörden av egendefinierade funktioner och index.

#Introduktion

Du bygger vidare på det du gjorde i del 1 av uppgiften. Ta en kopia av din gamla katalog och fortsätt utveckla.

#Exempel på studentinlämning

Här kan du se ett exempel på en studentinlämning.

#Kodstandard små bokstäver

Kom ihåg att vi använder en kodstandard som säger små bokstäver på tabeller, vyer, procedurer, triggers och kolumnnamn.

Ett av de vanligaste felen som ger komplettering är att man mixat stora och små bokstäver i namngivningen av databasobjekten och man är sedan inte konsekvent när man använder databasen i skript eller i JavaScript koden.

#Funktioner skall ha karaktäristik

Ett vanligt fel när man definierar databasfunktioner är att man missar att ange en karaktäristik på dem.

ERROR 1418 (HY000) at line XXX: This function has none of DETERMINISTIC, NO SQL, or READS SQL DATA in its declaration a nd binary logging is enabled (you might want to use the less safe log_bin_trust_function_creators variable)

Får du detta felet så har dina databas-funktioner inte karaktäristik angiven. Uppdatera din kod så att funktionen använder en relvant karaktäristik.

#Backup med lagrade procedurer

När du tar din backup måste du ange --routines så att dina lagrade procedurer följer med.

# Utan lagrade procedurer
mysqldump --result-file=eshop.sql eshop

# Med lagrade procedurer
mysqldump --routines --result-file=eshop.sql eshop

Ett vanligt fel som leder till komplettering är att man missat skicka med de lagrade procedurerna i sin backupfil. Du kan alltid verifiera din backupfil mot en annan databas eller öppna den i texteditorn och skrolla längst ned i filen för att se att de lagrade procedurerna följde med.

#Testa din lösning

När du är helt klar med uppgiften så är det ett par saker som du kan göra för att testa din inlämning. Detta testar inte allt, men det är ett minimum av ett flöde som skall fungera.

1. Dubbelkolla att du har en aktuell databasdump.

I webbklienten:

1. Kolla översikt av kunder.
2. Skapa en order till en kund.
3. Beställ ett par befintliga/nyskapade produkter.
4. Försök beställ fler än det finns i lagret, av någon produkt (och se om det går eller inte).
5. Beställ ordern.
6. Kolla orderns status.
7. Se en översikt av alla ordrar.
8. Klicka på ordern och se detaljer om den.

I terminalklienten.

1. Sök efter ordern du nyss skapade.
2. Kolla orderns status.
3. Skapa en plocklista till ordern.
4. Det skall gå att se om beställt antal matchar mot antal i lager.
5. Skeppa/skicka iväg ordern.
6. Kolla orderns status.

#Krav

Uppgiften är indelad i tre huvudsakliga delar, en generell del inklusive databasdetaljer, en för webbklienten och en för terminalklienten.

#Generella krav

1. Du behöver uppfylla de krav du hade i del 1 av uppgiften.

2. En order skall ha kolumner med tidsstämplar för när ordern skapades (1), när ordern senast uppdaterades (2), när/om ordern raderats (soft delete) (3), när/om ordern beställts (4) och när/om ordern skickats till kund (5). Se “Tips från Coachen” nedan, om tidsstämplar.

3. Skapa en egendefinierad funktion order_status() som tar nödvändiga argument av tidsstämplar och returnerar en sträng med någon av statusen “Skapad”, “Uppdaterad”, “Raderad”, “Beställd” eller “Skickad”. Visa den status som är mest aktuell och viktigast.

4. Databasen skall innehålla egenskapade INDEX på minst ytterligare två platser, förutom primärnycklar och främmande nycklar. Analysera var INDEX kan passa in och inför dem.

5. Databasen måste innehålla grunddata med en handfull kunder och produkter som finns på lagret. Du behöver även lägga in ett antal ordrar som har olika status. Dessa grunddata underlättar när man testar din lösning.

#Webbklient

1. Du behöver uppfylla de krav du hade i del 1 av uppgiften.

2. Skapa en sida /eshop/customer som visar en översikt av de kunder som finns. Visa (minst) kundens id, namn, adress, telefon.

3. Bygg stöd för att man kan skapa en order till en kund.

4. Bygg stöd för att man kan lägga till produkter och antal (orderrader) till en order.

5. När ordern är komplett och alla orderrader finns med så kan man ändra status på ordern till “Beställd”.

6. Skapa en sida /eshop/order som visar en översikt av de ordrar som finns. Visa (minst) order id, order datum, kundens id, totalt antal orderrader den innehåller, dess status.

7. Om man klickar på en order kan man se dess detaljer samt en översikt av dess orderrader.

8. Skapa en om-sida på eshop/about som visar namnen på de som jobbat (i gruppen) för att lösa uppgiften.

#Terminalklient

1. Du behöver uppfylla de krav du hade i del 1 av uppgiften.

2. Skapa kommandot order <search>. Om man enbart skriver order så visas samtliga ordrar (order id, order datum, kund id, antal orderrader, status). Om man skriver order search så filtreras resultatet och enbart visar de ordrar som matchar search på order id eller kund id.

3. En plocklista kopplar orderrader till en lagerhylla. Tanken är att lagerpersonalen tar en plocklista, åker runt i lagret och packar ihop paketet med samtliga produkter.

4. Skapa kommandot picklist <orderid> som visar/genererar en plocklista för vald order och dess orderrader. Varje orderrad, med dessa önskade antal, skall matchas och visas mot en plats i lagret där produkten finns (och dess antal).

5. Om varan inte finns i lagret så skall det tydligt framgå i utskriften. Välj själv hur du vill att det skall presenteras för användaren.

6. Skapa kommandot ship <orderid> som ändrar status på en order till “Skickad”. Detta innebär att ordern är paketerad och inlämnad till posten för vidare leverans till slutkund. Naturligtvis borde då lagersaldot uppdateras, men det är överkurs och finns som en extra uppgift.

7. Skapa kommandot about som visar namnen på de som jobbat (i grupp) för att lösa uppgiften.

#Lämna in

1. När du är helt klar och har testkört ditt system mot din egen databas, så tar du en backup av databasen med mysqldump och sparar i sql/eshop/backup.sql. Använd optionen --routines så att procedurerna följer med. Verifiera att backup-filen fungerar och tänk att rättaren kan ladda denna databas för att testköra mot ditt system.

2. Testa och validera din kod.

# Flytta till kurskatalogen
dbwebb test eshop2
dbwebb validate eshop2

Rätta eventuella fel som dyker upp och publisera igen. När det ser grönt ut så är du klar.

#Extrauppgift

Gör följande om du har tid, energi och ro.

1. I webbklienten, gör en snygg sida som visar all information om ordern och samtliga orderrader, precis som det brukar se ut i godtycklig webshop på nätet.

2. I terminalklienten, gör en riktigt snygg och tydlig utskrift av plocklistan och visa tydligt, i utskriften, när en vara inte finns i lagret.

3. När en order ändrar status till “Skickad” så skall lagret uppdateras genom att räkna ned alla antalet produkter som finns i ordern.

4. Lägg till stöd för att radera order via “soft delete” samt möjligheten att göra “undo” på en “soft delete”.

#Tips från coachen

1. Det finns en artikel som hanterar tips om Använd TIMESTAMP för status i databastabellen.

Lycka till och hojta till i forumet om du behöver hjälp!

#Revision history