Kmom07/10: Projekt och examination

Detta kursmoment avslutar och examinerar kursen.

Alla delar i detta kursmoment skall utföras individuellt och självständigt.

Upplägget är enligt följande:

• Projekt
• Redovisning med videopresentation

Totalt omfattar kursmoment 07/10 i storleksordningen 20–40 studietimmar.

#Introduktion

Här är en video som “pratar” dig igenom projektets upplägg och delar av innehållet i detta dokumentet.

#Bedömning och betygsättning

Det finns ett särskilt dokument som beskriver grunderna för bedömning och betygsättning.

#Projektidé

Du skall fortsätta bygga vidare på din kodbas i me/report och där lägger du till en ny landningssida för projektets webbplats.

Du behöver göra ett aktivt val om vilket projekt du vill utveckla. Här är förslagen till projektidéer.

• Visualisera indikatorer för hållbarhet
• Kortspel (poker/black jack)
• Äventyrsspel
• Eget fokus

Tänk till så att du inte väljer ett alltför stort och komplext projekt som tar alltför mycket tid. Välj ett projekt där du kan slutföra grundkraven inom 20-40h beroende på din ambitionsnivå.

Letar du efter enklaste projektet så är det troligen “sustainability” projektet alternativt en enklare variant av kortspel.

#Krav

Det finns 3 grundläggande krav (1, 2, 3) du måste lösa för att få godkänt. Normalt leder detta till betyg D/E.

Det finns 3 optionella krav (4, 5, 6) som du kan välja att utföra om du har tid, lust, energi och förmåga. Varje komplett utfört optionellt krav kan höja ditt slutbetyg en nivå (C, B, A).

#Krav 1, 2, 3: Webbplats

Din nya webbplats skall minst uppfylla följande krav.

#Innehåll och utseende

1. Skapa en landningssida /proj som syns i navbaren på din report-sida. Denna sida är din förstasida på projektets webbplats.
2. Välj ditt fokus för ditt projekt. Implementera det i din webbplats under proj/.
3. Ditt projekt skall ha en stil och ett utseende som tydligt skiljer sig från din report-sida.
   • Det skall utseendemässigt se ut som en ny webbplats så bygg en “ny” stylesheet eller modifiera din befintliga. Modifiera i någon omfattning färg, typsnitt och utseende på header och footer.
   • Skapa en separat navbar för projektet som enbart innehåller länkarna för projektet.
4. En sida /proj/about som ger en kort introduktion till ditt projekt och vad det handlar om.

#Repo och dokumentation

• Ditt git repo skall ha en README.md.

  • Det skall finnas badges som är klickbara och leder till uppdaterade Scrutinizer rapporter för build, coverage och quality.
  • Beskriv innehållet av repot och berätta varför det finns. som beskriver innehållet i någon omfattning.
  • Instruktion för hur man klonar och startar igång webbplatsen

• Innehållet i docs/ skall vara uppdaterat

  • Kodtäckning sikta på över 90% kodtäckning (exkludera filer som inte är relevanta).
  • Generera dokumentation med phpdoc.
  • Generera metrics med phpmetrics.

#Krav 4: JSON API (optionellt)

1. Skapa ett JSON API till dit projekt och presentera det i sidan proj/api.

2. Skapa minst 5 olika JSON routes varav minst en skall vara en POST route.

3. I sidan skall man kunna klicka på samtliga länkar/knappar för att testa ditt API.

#Krav 5: ORM (optionellt)

1. Din webbplats skall använda databas via ORM.

2. Din databas måste innehålla minst två tabeller.

3. Skapa en sida proj/about/database, och lägg till

   1. En bild på ett ER diagram av tabellerna.
   2. För varje tabell beskriv i en mening vad som sparas i tabellen.
   3. Förklara hur du löste eventuella relationer mellan tabellerna.
   4. Berätta om du använde SQLite eller någon annan databas.
   5. Berätta om du gjorde enhetstester mot databasen.
      • Berätta om/hur du lyckades med enhetstester på Scrutinizer med databasen.

4. Berätta med egna ord (cirka 15 meningar) om hur du ser på fördelar, nackdelar, likheter och skillnader mellan ORM och det sätt vi jobbade med databasen i databaskursen.

5. Från din sida proj/about, lägg till en länk till proj/about/database.

#Krav 6: Avancerade features (optionellt)

Förutsatt att du har uppfyllt krav 4 och krav 5 så kan du även uppfylla krav 6 genom att själv beskriva och lyfta fram 3-5 features/saker som du anser har varit extra svåra och utmanade att lösa i ditt projekt.

Kanske är det saker som är tidskrävande eller så är det saker som varit utmanande att lösa rent tankemässigt.

Det handlar alltså om att beskriva de saker som du gjort förutom baskraven. Du väljer själv vilka delar du anser värda att ta upp.

Välj saker som tydligt kan betraktas att vara utanför ramen för baskraven och för varje sak du lyfter fram så skriver du ett kort textstycke om varför du anser att detta bör räknas in i detta sista optionella krav.

Rättaren gör en bedömning, baserad på din text, om din insats är värd 0, 5 eller 10 poäng. Rättaren väger troligen ockå in det allmänna tillståndet på din lösning och kan eventuellt väga in den bedömda svårighetsnivån.

#Redovisning

Avsluta och redovisa din projektinlämning enligt följande.

1. Testa ditt projekt med dbwebb test kmom10. Se till att alla delar passerar grönt.

2. Tagga som v10.0.0, pusha till GitHub/Lab.

3. Driftsätt din applikation på studentservern. Dubbelkolla att alla delar fungerar, inklusive nollställningen av databasen.

4. På din me/report sida, skriv följande:

   1. För varje krav du implementerat, dvs 1-3, 4, 5, 6, skriver du ett textstycke om ca 5-10 meningar där du beskriver hur du löste kravet. Poängsättningen tar sin start i din text så se till att skriva väl för att undvika poängavdrag. Missar du att skriva/dokumentera din lösning så blir det 0 poäng. Du kan inte komplettera en inlämning för att få högre betyg.

   2. Skriv ett allmänt stycke om hur projektet gick att genomföra. Problem/lösningar/strul/enkelt/svårt/snabbt/lång tid, etc. Var projektet lätt eller svårt? Tog det lång tid? Vad var svårt och vad gick lätt? Var det ett bra och rimligt projekt för denna kursen?

   3. Avsluta med ett sista stycke med dina tankar om kursen och vad du anser om materialet och handledningen (ca 5-10 meningar). Ge feedback till lärarna och förslå eventuella förbättringsförslag till kommande kurstillfällen. Är du nöjd/missnöjd? Kommer du att rekommendera kursen till dina vänner/kollegor? På en skala 1-10, vilket betyg ger du kursen?

5. Ta en kopia av texten på din redovisningssida och kopiera in den på Canvas. Glöm inte att bifoga länken till projektet på studentservern.

6. Spela in en redovisningsvideo för projektet och lägg länken till videon i en kommentar på din inlämning i Canvas. Detta kan du göra dagen efter projektets deadline. Läs mer om hur du kan spela in en redovisningsvideo.

#Revision history