Projektrapport COURSEPRESS

Transkript

1 1DV411 Webbprojekt I Projektrapport COURSEPRESS Projektgrupp Mirja Lundevall-Tuori, Marcus Olsson, Lisa Övermyr 1

2 Sammanfattning I vårt projekt har vi Johan Leitet som kund, där han önskade en utvidgning för CoursePress som är tänkt som den nya kursplattformen för studenter vid Linéuniversitetet/ Webbprogramerare. Den nya kurssidan kommer att till stora delar vara öppen publikt. Så utomstående som är intresserade av kurser eller prgrogram kan få en uppfattining om hur kursen är uppbyggd titta på föreläsning etc. Samt för studenter som har gått programmet och vill hänga med på vad som händer. CoursePress är ett plugin till BuddyPress som i sin tur är ett plugin till WordPress. Resultatet blir en kursida med ett socialt nätverk knutet till sig. Tanken är att en inloggad kursdeltagare inte ska behöva lämna kurssidan för att kunna ställa frågor som rör kursen. Från huvudsidan BuddyPress kan man lätt få tillgång till de andra forumen eller andra uppdateringar från lärare etc. Vår uppgift var att skapa ett plugin som skulle knyta samman forumet med kurssidan då denna funktionalitet inte fanns, i det ingick att lägga till en länk för att kunna få in forumet på kursidan, och även notifikations symbol/siffra som visar om det har kommit till nya topics eller kommentarer. Vad som också efterfrågades var ett nytt tema/utseende till kurs-hemsidan som skulle vara inbyggt i coursepress pluginet. 2

3 Förord Detta projekt har gjorts inom ramen för kursen 1DV411 Webbprojekt I 7,5 hp, på Högskolan i Kalmar. Med denna rapport beskriver vi hur vårt projekt och arbete har gått till. Det har varit en rolig kurs att delta i då man har fått känna hur det är att jobba i projekt och samarbeta med olika personer. Vi är känner att våra kunskaper hur ett webbprojekt genomförs har ökats ytterligare och det har gett oss en erfarenhet att ta med oss ut i arbetslivet. Av Mirja Lundevall Tuori, Lisa Övermyr, Marcus Olsson 3

4 Innehållsförteckning Sammanfattning Förord Innehållsförteckning 1. Introduktion Bakgrund Syfte Mål Projektorganisation Genomförande Metodik Teknik Testning Resultatbeskrivning/måluppfyllelse Avvikelser/efterkalkyl Slutsats Vidareutveckling Förslag till förbättringar inför kommande projekt Övertagande organisation Referenser Diskussion Bilagor

5 1. Introduktion I denna rapport kommer vi att redogöra för hur vi (Mirja Lundevall, Marcus Olsson och Lisa Övermyr) arbetat i detta projekt, om bakgrunden och målet med projektet samt hur vi arbetat för att uppnå dessa mål. 1.1 Bakgrund Sedan en tid tillbaka har några lärare på Linneuniversitetet arbetat med att ta fram en ny kurswebb för universitetet. De har tagit fram pluginet CoursePress som bygger på och är en utvidgning av pluginet BuddyPress, med hjälp av pluginet kan man skapa nya kurssidor och för varje nyskapad kurssida skapas även en grupp och ett gruppforum. Visionen är att skapa en social kurswebb, man ska inte behöva gå till en extern tjänst som Yammer för att kunna diskutera med andra kursdeltagare eller lärare. Detta är alltså ett redan påbörjat projekt som vi nu involveras i. 1.2 Syfte Projektets huvudsakliga syfte är att utöka CoursePress-plugin:et för att öka integreringen mellan WordPress och BuddyPress. Bland annat ska inloggade användare via en kurssida kunna ta del av nya händelser i den tillhörande gruppen och forumet. Utöver detta är även syftet att vi i projektgruppen ska lära oss mera om att jobba i grupp i ett skarpt projekt mot en kund. 1.3 Mål Målet är att undersöka hur vi på bästa sätt kan utvidga CoursePress för att integrera WordPress och BuddyPress och implementera detta. 1.4 Projektorganisation 5

6 Detta är vår projektorganisation. Projektledare har bytts ut för varje ny iteration. Så alla har varit projektledare en eller fler gånger under projektets gång. 2. Genomförande 2.1 Metodik 6

7 Varje projektdeltagare hade totalt 180 timmar att lägga på projektet. Inom ramen för dessa timmar skulle vi genomföra planeringsarbetet, konstruktionen av produkten, testning, dokumentation mm. Dessa timmar kartlades i en tidsrapport där varje deltagare efter veckans slut rapporterade hur många timmar den lagt på projektet den veckan. En sammanställning gjordes för att visa hur många timmar alla projektdeltagare tillsammans lagt den veckan, samt totalt per person. Under de första veckorna hade vi ett stående möte varje vecka med vår handledare. Vi inledde varje vecka/iteration med ett gruppmöte där vi med hjälp av en Sprint backlog utifrån vårt mål och kravspecifikation lade upp planen för veckan. Varje morgon hade vi sedan ett avstämningsmöte för att snabbt följa upp hur arbetet fortskred och kunna reda ut frågetecken som uppstått. Mer eller mindre varje iteration har resulterat i leverens till kund som sedan följts upp med ett kundmöte där vi tagit del av kundens feedback och kunnat ställa frågor om vårt fortsatta arbete. För att visa på för hur vi arbetat under projektet kommer vi redogöra för projektets fyra faser: Inception, Elaboration, Construction och Transition Inception Under Inceptionfasen knöts kontakt med kund och handledare. Av kunden, Linnéuniversitetet genom Universitetsadjunkt Johan Leitet, fick vi vid vårt första möte en grundlig genomgång av bakgrunden och syftet med projektet. Något som vi sedan började reda i för att kunna utforma en plan som vi ansåg var rimlig både tidsmässigt och beroende på gruppens kompetens. Av vår handledare, Martin Fredriksson, får vi hjälp med hur vi ska börja strukturera upp och skriva dokumentation. Mycket tid går här åt att sätta sig in i de tekniker vi ska använda oss av för att se vad som är möjligt att göra. Vi studerar BuddyPress-dokumentation men framförallt tar det tid att sätta sig in i CoursePress-pluginet, att förstå hur det är uppbyggt är lättare sagt än gjort men helt nödvändigt för att kunna gå vidare i projektet Elaboration Nu började arbetet med att göra en mer detaljerad planering. En projektplan och mjukvaruarkitektur påbörjades med hjälp av vår handledare. Mjukvaruarkitekturen leverades till kunden, och efter lite bollande fram och tillbaka kom vi överens om den arkitektur vi skulle hålla oss till. För att samla all dokumentation satte vi upp en wiki-sida, där alla planeringsdokument, protokoll och annat som hela gruppen behövde ta del av samlades. Under denna fas fick vi från kunden nya krav på hur den slutgiltiga produkten skulle se ut, något som ställde till med lite problem då vi redan hade gjort en planering utifrån de krav vi från början hade fått. I gruppen kom vi överens om en kompromiss som vi kände var genomförbar som vi levererade till kunden och fick godkänd av denne Construction Med en detaljerad planering i ryggen satte vi igång arbetet med pluginet. Funktioner skapades, testades och levererades till kund för utvärdering. Arbetetet flöt på bra och kontakten med kunden blev allt tätare under denna period. Vi hade som mål att göra en leverans i slutet på varje vecka vilket vi följde upp med ett möte med kunden måndag därpå för att ta del av feedback. Men även mellan dessa möten hölls samtal för mindre frågor och funderingar. Vid slutet av denna period lade vi upp en färdig version av vår produkt på den testserver vi använde oss av och bad kunden att utifrån instruktioner vi skrivit testa alla funktioner. 7

8 2.1.4 Transition Projektet börjar dra sig mot sitt slut. Fasen inleds med ett kundmöte där vi får feedback på det vi levererat. Förutom att finslipa produkten fokuserar vi under denna fas på att knyta ihop säcken, projektrapporten och all övrig dokumentation skall färdigställas, presentationen av projektet förbereds och en sista testgenomgång genomförs. 2.2 Teknik Val av teknik för projektet var något vi inte kunde påverka då detta var ett projekt som redan påbörjats. De tekniska ramar vi hade för projektet var att vi skulle skapa WordPresskomponenter, närmare bestämt en vidareutveckling av det befintliga WordPress-plugin:et CoursePress samt ett tillhörande tema. Temat skulle också följa riktlinjerna i LNU:s designmanual. För att skriva WordPress-komponenter används programmeringsspråket PHP. Inom dessa ramar hade vi dock stor frihet att implementera kraven såsom vi ville och ansåg passande. 2.3 Testning Utifrån kravspecifikationen skrev vi testfall som reflekterade de krav vi valt att fokusera på. Testfallen var alltså tänkta att hjälpa oss med att säkerställa att vi verkligen implementerat kraven på ett korrekt och fungerande sätt. Efter genomfört test loggades resultatet för att de eventuella felen som fanns skulle kunna åtgärdas. Som komplement till denna testlogg upprättades även en bugglista för att snabbt kunna få överblick över vilka fel som återstod att rätta till. Testspecifikation med testfall samt bugglista är bifogat i rapporten. 3. Resultatbeskrivning/måluppfyllelse Projektgruppen har lyckats med att bli klar med projektet inom den tidsram som blev satt för deadline. Vi kan lämna till kund en färdig och användbar produkt. Resultatet av vårt arbete blev att plugin:et CoursePress utökades med funktionalitet för att till varje ny kurssida som skapas även skapa en undersida för gruppens aktivitetsflöde, funktion för att hämta ut gruppnotifikationer (för att kunna meddelande inloggade användare om när nya gruppaktiviteter skett) och ett tema för kurssidorna. Bilder på funktionaliteten bifogas i bilagsdelen 4. Avvikelser/efterkalkyl Ett krav/önskemål från kundens sida var att det skulle synas en räknare för varje nytt inlägg i 8

9 forumet, vilket vi efter efterforskning insåg inte var möjligt. Resultatet blev att det istället dyker upp en indikation i form av ett utropstecken i menyraden när det finns nya inlägg. 5. Slutsats Vi är nöjda med vårt arbete då vår produkt är färdig inom tiden för deadline. En del i projekt som kan vara svårt är att ha en balans mellan kundens vision och vad som är genomförbart inom de tidsramar som är satta för projektet. Vi tycker att gruppen har prioriterat och fattat bra beslut när det kommer till att ha realistiska slutmål kontra kundens önskemål, och vi kan lämna över en genomarbetad komponent som fungerar och är möjlig att vidareutveckla. Vi tycker att våra diskussioner med vår handledare Martin har varit mycket givande, i början av projektet var de kanske lite stapplade men ju längre projektet fortskred och vi haft mer frågor desto mer hjälp har han gett oss. Han har också gjort ett bra jobb med att visa hur vi kan ta med våra erfarenheter från projektet till arbetslivet. Kontakt med kund i projektet har varit bra, han har varit tillgänglig för bokade möten, via mail och möten med kort varsel och visat stort engagemang för vårt projekt. Vi känner att vi har fått bra feedback under projektets gång och att det varit lätt att diskutera fram kompromisser som är möjliga att genomföra då vi känt att kundens krav varit för stora för att kunna genomföras inom ramen för projektet. Vår kund är också utvecklaren av CoursePress så han har även haft stor förståelse för vårt arbete och kunnat hjälpa oss med rent tekniska frågor vilket har varit till stor hjälp. Att vi alla i gruppen tidigare har haft kunden, Johan Leitet, som lärare lär även det ha bidragit till att kommunikationen flöt på bra. Kommunikationen inom gruppen har fungerat väldigt bra, detta trots att en av gruppmedlemmarna under projektet bodde i Thailand och vi alltså var tvungna att ta hänsyn till en tidsskillnad på 7 timmar. Detta gjorde att de timmar under dygnet vi alla i gruppen var tillgängliga för kommunikation blev ganska få. På grund av detta beslutade vi oss för att boka in ett gruppmöte varje dag där alla kunde närvara vilket gav en tydlig struktur till vårt arbete. Vår situation har även gjort oss tvungna att vara väldigt tydliga i vår skriftliga kommunikation för att alla ska kunna ta del av beslut och information även när de andra gruppdeltagarna inte är tillgängliga. 6. Vidareutveckling Nyhetsflöde. En av möjliga vidareutvecklingar som redan har diskuterats på initiativ av kund är ett nyhetsflöde som gör att du kan se uppdateringar i forum och diskussioner i realtid, liknande som facebook har. Vi anser att det inte kommer att krävas allt för stor påbyggnad för att göra det möjligt då funktionerna för att hämta denna information redan är på plats. Gillaknapp och möjlighet att kommentera En vidarutveckling som kunden själv tog upp i sista interationsveckan, vi tycker att det är en 9

10 bra ide och inte svår att genomföra. Fördelen med det är att det blir ännu lättare att vara aktiv i kursforumet. 7. Förslag till förbättringar inför kommande projekt Något som vi i projektets slutskedet diskuterade tillsammans med vår handledare var att det hade varit bra att ha en tydligare överenskommelse med kunden angående hur långt vårt ansvar sträcker sig. Då vårt projekt handlade om att göra en vidareutveckling av en redan befintlig komponent hade det till exempel varit bra att göra det tydligt hur vi skulle förhålla oss till den komponenten, vem är det som har ansvar för eventuella buggar i den befintliga koden och hur ska vi hantera den eventuella situationen där det visar sig att grundkomponenten inte erbjuder den funktionalitet som krävs för att vi ska kunna implementera de krav som satts upp. Helt enkelt handlar det om att tidigt tydligt definiera hur långt vårt ansvar sträcker sig för att inte hamna i en situation där arbetsbördan helt plötsligt blir mycket större än vad man trodde eftersom att man har att göra med en dåligt eller felaktigt kodad komponent. Detta är verkligen något vi kommer att ta med oss till kommande projekt. Vi tror också att man genom att ställa denna typen av frågor till kunden, om de risker som finns, framstår som erfaren och professionell. 8. Övertagande organisation Projektet kommer att lämnas över till Johan Leitet/ Linnéuniversitetet för att fritt kunna använda eller vidareutveckla komponenten. 9. Referenser/Dokumethänvisning Då projektet är gjort i WordPress hänvisar vi till dokumentationen för WP Hur man bygger ett child theme till BuddyPress Referenser till BuddyPress funktioner och klasser Länkt till hur BuddyPress hanterar notifikationer Diskussion 10

11 Vad gjorde vi bra respektive vad gjorde vi mindre bra? Med tanke på att detta är för oss första gången vi arbetar i ett projekt så måste vi säga att det har fungerat smidigt. Vi har varit bra med att hålla tidschemat, alla uppgifter som vi har satt upp för varje iteration har blivit genomförda. En sak som kunde ha genomförts lite bättre är att tidigare i processen fått bekräftelse på exakt vilka delar som vi skulle implementera. Utvärdering av tidplanen - höll den? Vad beror det på? Vår tidplan höll med goda marginaler, det finns flera orsaker till att den höll, bland annat så tror vi att våra gruppmöten, ett stort på Måndagen och ett mindre varje förmiddag gjorde att vi kunde stämma av hur vi låg till och hur långt vi hade kommit med tidsplanen. Vi såg också till att allt som skulle göras fanns med på planeringen även småsaker som kanske annars hade blivit bortglömt. En ytterligare faktor var att två av gruppmedlemmarna erfarenhet av att arbeta med wordpress och plugins, det gav oss också en bra start. Blev användarhandledningen tillräckligt bra? Kunde vi gjort annorlunda? Med komponenten följer utförliga instruktioner för hur användaren ska installera och använda plugin:et. För dessa instruktioner har vi även skrivit tester som har gått igenom, vilket tyder på handledningen är tillräcklig. Vad som är mindre bra är dock det att instruktionerna är endast testade utav oss internt i gruppen, och då finns alltid risken att vi är partiska, vilket i så fall skulle kunna påverka testutfallen. Vi hade dock ingen möjlighet att testa med externa användare. Hur fungerade informationsflödet mellan projektgrupp och kund? Vad kunde vi ha gjort annorlunda? Vi tycker att informationsflödet har fungerat bra, kunden har varit lätt att få kontakt med, Hur fungerade samarbetet inom och utom projektet? Vi tycker att samarbetet har fungerat bra, vi har konstruktivt kunnat diskutera de problem och frågetecken som uppkommit. Alla har också varit samarbetsvilliga och villiga att ta på sig ansvar. Var projektmöten, styrgruppsmöten med flera lagom långa? Tillräckligt effektiva? Hölls mötena tillräckligt ofta? Kunde vi gjort på annat sätt? I och med att vår grupp är liten bara tre personer ingår i den, så har vi haft en nära daglig kontakt, men mer på en projektivå det har känts överflödigt att dela in den på andra sätt då alla i gruppen. Vår struktur för mötena är vi nöjda med, vi har haft ett gruppmöte varje måndag för att kunna planera varje ny iteration. Under resten av veckan har vi haft avstämmningsmöten varje förmiddag. Våra möten har tagit så lång tid som de har behövts och vi har tagit upp små och stora problem som har uppkommit. I och med att vi har gjort projektet på distans så har vi också sett till att vara tillgängliga så mycket som möjligt under dagarna via Skype. 11

12 Hur var riktlinjerna vi fick? Var de tydliga nog? De riktlinjer vi fick från kunden på vårt första möte var till en början något svåra att greppa. Vi fick väldigt mycket information, inte bara om just det vi skulle arbeta med utan även om det större projektets mål och vision. Bitvis kändes det svårt att till en början förstå vad det var som förväntades av oss. Allt eftersom vi satte oss in i projektet och de delar som redan implementerats klarnade dock bilden allt mer och det blev lättare att ställa direkta frågor till kunden och tillsammans komma fram till hur och vad vi skulle prioritera. Motsvarade vi kundens krav? De kraven som vi mottog i början av projektet från kunden motsvarade vi dock så tillkom det en hel del nytt att bygga vidare på, och idéer från kunden mot slutet som vi inte hade möjligheten att uppfylla. Gav vi realistiska förslag på lösningar? Kunde vi gjort annorlunda? Vi fick en ganska bra beskrivning av kunde och hans vision om hur han vill att hela CoursePress ska fungera. Vi förstod tidigt vad han ville att vi skulle implementera, efter att vi hade undersökt vad som verkligen var genomförbart gav vi förslag på vad vi kunde leverera. I och med att kundens vision är stor så kunde vi tidigare sagt att vilka delar vi implementerar och gett snabbare återkoppling till kunden så att det blev klart för honom vad vi kunde göra. Har vi haft ett system för tidiga varningar om planerna inte följs? Hur har det fungerat? Vi hade inte från början något uttänkt sysyem för om planen inte följdes. Men vi tror att våra regelbundna möten har varit ett varningsystem för oss. Vi har varje dag kunnat stämt av planen med hur långt varje gruppmedlem har kommit med sina uppgifter. Vad blev resultatet på kort och lång sikt? Slutresultatet på kort sikt blev ett fungerande plugin till CoursePress med ett nytt tema till. På lång sikt finns alla möjligheter att bygga vidare på vårt plugin. 12

13 11. Bilagor Testfall TestfallsID: TF1.0 Koppling till krav: FK1.0 Gruppaktivitetsflöde Förkrav: Testaren måste vara inloggad på en WordPress-installation, där BuddyPress och CoursePress finns installerat. Genomförande: 1. Gå in på en kurssida 2. Klicka på länk för senaste aktiviteter 3. Gruppens senaste aktiviteter visas (alternativt ett meddelande om att inga aktiviteter skett om så är fallet). Efterkrav Bara den aktuella kursen/gruppens aktiviteter syns. TestfallsID: TF2.0 Koppling till krav: FK3.0 Skapa aktivitetssida när kurs skapas Förkrav: Testaren måste vara inloggad som admin på en WordPress-installation, där BuddyPress och CoursePress finns installerat. Genomförande: 1. Gå in på adminpanelen. 2. Klicka på nätverksadmin under Mina webbplatser i menyraden högst upp 3. I menyn till vänster, klicka på Webbplatser och sen på Create new course 4. Fyll i uppgifter för en ny kurs och spara Efterkrav Kolla att kurssida, grupp, forum, och undersida till kurssida för aktivitetsflödet skapats. TestfallsID: TF3.0 Koppling till krav: FK1.0 Se att nya gruppaktiviteter skett på kurssidan Förkrav: Testaren måste vara inloggad på en WordPress-installation, där BuddyPress och CoursePress finns installerat. Testaren måste ha tillgång till två användarkonton. Genomförande: 1. Logga in med det ena kontot. 2. Gå in på ett kursforum och skriv ett inlägg. 3. Logga ut och logga in med det andra kontot. 4. Gå in på kurssidan tillhörande den kurs du tidigare skrev ett foruminlägg i. Efterkrav En indikation på att en ny aktivitet skett syns vid länken till gruppaktiviteter. Kolla att aktiviteten syns i kursens aktivitetsflödet. TestfallsID: TF4.0 Koppling till krav: FK4.0 Installation av pluginet Förkrav: Testaren måste ha tillgång till installationsinstruktioner och testmiljö där WordPress kan installeras. Genomförande: 13

14 1. Installera coursepress-pluginet enligt instruktionerna Efterkrav I nätverksadministrationspanelen finns valet "Create new course" och temat coursepress-lnu finns att aktivera TestfallsID: TF5.0 Koppling till krav: FK1.0 Se att nya gruppaktiviteter skett på kurssidan Förkrav: Testare måste ha tillgång till testmiljön men ska inte vara inloggad. Genomförande: 1. Gå in på en kurssida Efterkrav Inga länkar till forum, meddelanden eller gruppaktiviteter syns. Tesrapporter 1. Testrapport CoursePress Testare: Mirja Lundevall Datum Version av system Ref till systemtest (Function, unit, system, etc) Testmiljö Systemtest, pc, testserver Lista av testfall som körs (pass och fail status) Test 1 Testfall 1.0 Referens till test fall Status: Pass Test 2 Testfall 2.0 Referens till test fall Status:Pass Test 3 Testfall 3.0 Referens till testfall Status: Fail 14

15 Brevid länken Senaste aktiviteter syns bara ordet nytt 2. Testrapport CoursePress Testare: Lisa Övermyr Datum Version av system Ref till systemtest (Function, unit, system, etc) Testmiljö Systemtest, mac, testserver Lista av testfall som körs (pass och fail status) Test 1 Testfall 4.0 Referens till test fall Status: Pass Kommentar: Kom inte åt databasen så jag kunde ändra i wp_users-tabellen, men installationen fungerar. Test 2 Testfall 2.0 Referens till test fall Status: Pass Test 3 Testfall 3.0 Referens till testfall Status: Pass 3. Testrapport CoursePress Testare: Lisa Övermyr Datum Version av system Ref till systemtest (Function, unit, system, etc) Testmiljö 15

16 Systemtest, mac, testserver Lista av testfall som körs (pass och fail status) Test 1 Testfall 5.0 Referens till test fall Status: Pass Bilder på resultatet Kursaktivitets sidan öppen, senaste inläggen visas 16

17 Bugglista 1. När man skapar en ny CoursePress-kurs så visas det att det finns en kursaktivitet, trots att så inte är fallet. Prioritet: 2 Datum: 2/ Status: Åtgärdat 2. Skapar man en ny CoursePress-kurs, med ett namn som innehåller ett mellanslag (exempel Webbprojekt I) så generar den en felaktig länk till det aktuella forumet på kurssidan. I det här exemplet blir länken groups/webbprojekt%20i/forum, rätt är groups/webbprojekt-i/forum. Prioritet: 1 Datum: 2/ Status: Åtgärdad 3. Notifikationer och länkar till forum mm. ska bara synas om användaren är inloggad. Prioritet: 1 Datum: 5/ Status: Inte åtgärdad 4. Meddelandelänken går till forumet istället för privata meddelanden. Prioritet: 1 Datum: 5/ Status: Åtgärdat 5. Senaste aktiviteter visar ibland aktiviteter för även andra grupper än den aktiva Prioritet: 1 Datum 5/

18 Status: Åtgärdat (fungerar där buggen uppstod, men håll koll på detta). 18