qs

ws2011/BP/QS-Dokument/QS-Dokument.tex

@@ -141,7 +141,7 @@ Die Ma
 \subsection{Erweiterbarkeit} 
 \label{Ziel:Codequalitaet}
 >>Any fool can write code that a computer can understand. Good programmers write code that humans can understand.<< \cite{fowler}. \\ \\
-Der Quellcode des Projektes ist offen für Erweiterungen und wird von weiteren Gruppen genutzt. Daher muss darauf geachtet werden, dass sämtliche Codebausteine auch für Außenstehende lesbar und verständlich sind. Geplant ist die Veröffentlichung des Quellcodes, so dass auch unifremde Entwickler Zugriff haben und von der bestehenden Codequalität profitieren. Damit das Projekt in Zukunft in der Open-Source-Szene anerkannt wird, werden die Open Standards nach \cite{opensource.org} angewendet. Hierbei dürfen keine kommerziellen Tools im Projekt eingesetzt werden.\\\\
+Der Quellcode des Projektes ist offen für Erweiterungen und wird von weiteren Gruppen genutzt. Daher muss darauf geachtet werden, dass sämtliche Codebausteine auch für Außenstehende lesbar und verständlich sind. Geplant ist die Veröffentlichung des Quellcodes, so dass auch unifremde Entwickler Zugriff haben und von der bestehenden Codequalität profitieren. Es werden die Open Standards nach \cite{opensource.org} angewandt. Diese schließen den Einsatz von kommerziellen Tools im Projekt aus.\\\\
 Die Maßnahmen, die wir ergreifen, um das beschriebene Qualitätsziel zu erreichen, sind in Abschnitt \ref{Masnahme:Erweiterbarkeit} aufgeführt.
 
 
@@ -176,24 +176,24 @@ Die Ma
 Zur Sicherung der einzelnen Funktionalitätsmerkmale werden die folgenden Maßnahmen ergriffen:
 \begin{itemize}
 \item Richtigkeit: \\
-Zur Sicherstellung der Richtigkeit werden \glspl{whitebox} mit \gls{PHPUnit} und \glspl{blackbox} mit \gls{Selenium} durchgeführt. Die korrekten Datenbankinteraktionen werden durch die Einhaltung der Vorgaben von \gls{Propel} sichergestellt. \gls{PHPUnit} erlaubt duch die integrierten Funktionen das einfache Testen von PHP-Methoden. Somit können auftretende Fehler schnell beseitigt werden. \gls{Selenium} testet automatisiert die Anbindung der Daten an die Visualisierung. Hierzu wird eine Benutzereingabe aufgezeichnet, die nun im weiteren Entwicklungsprozess durch Selenium wiederholt ausgeführt werden kann.
+Zur Sicherstellung der Richtigkeit werden \glspl{whitebox} mit \gls{PHPUnit} und \glspl{blackbox} mit \gls{Selenium} durchgeführt. Die korrekten Datenbankinteraktionen werden durch die Einhaltung der Vorgaben von \gls{Propel} sichergestellt. \gls{PHPUnit} erlaubt durch die integrierten Funktionen das einfache Testen von PHP-Methoden. Somit können auftretende Fehler schnell beseitigt werden. \gls{Selenium} testet automatisiert die Anbindung der Daten an die Visualisierung. Hierzu wird eine Benutzereingabe aufgezeichnet, die nun im weiteren Entwicklungsprozess durch Selenium wiederholt ausgeführt werden kann.
 
 \item Sicherheit: \\
 Das von uns verwendete ORM-Framework \gls{Propel} nutzt Prepared Statements, mit denen sich \glspl{SQL-Injection} wirksam unterbinden lassen. Hierbei werden SQL-Code und Daten getrennt. Zudem erfordert Propel keine SQL Kentnisse, wodurch für neue Entwickler der Einstieg erleichtert wird. Der Eintrag der Daten über die \gls{API} erfolgt mittels HTTP-GET Parameter. Bevor die Aufnahme neuer Daten in die Datenbank erfolgen kann, ist eine Authentifizierung des Nutzers notwendig. Die Implementierung der Authentifizierung unterliegt nicht unserem Aufgabenbereich.
 
 \item Interoperabilität: \\
-Um die Interoperabilität mit den einzelnen Webbrowsern sicherzustellen, werden manuelle Tests durchgeführt. Hierzu wird jeweils die aktuelle Version des Webbrowsers verwendet. In jedem Browser werden exakt diesselben Benutzereingaben ausgeführt. Die jeweiligen Ausgaben können somit direkt verglichen werden.\\
-Zudem erhalten wird durch die Auswertung des Fragenbogens, der im Rahmen der Benutzerstudie an Probanden ausgegeben wird, eine Rückmeldung über eventuell auftretende Fehler der Visualisierung.
-% Benutzerstudie, manueles Testen
+Um die Interoperabilität mit den einzelnen Webbrowsern sicherzustellen, werden manuelle Tests durchgeführt. Hierzu wird jeweils die aktuelle Version des Webbrowsers verwendet. Jeder Browser wird mit den selben Benutzereingaben ausgefuehrt. Die jeweiligen Ausgaben erlauben einen direkten Vergleich.\\
+Ausserdem werden, im Rahmen der Benutzerstudie, Fragebögen an Probanden ausgegeben. Die Auswertung dieser Fragebögen ermöglicht es uns, Rückschlüsse auf eventuell auftretende Fehler in der Visualisierung zu ziehen und zu beseitigen.
 \end{itemize}
 
 
 
 \subsection{Benutzbarkeit}
 \label{Masnahme:Benutzbarkeit}
-Eine von uns durchgeführte Benutzerstudie stellt das Qualitätsmerkmal der Benutzbarkeit des neuen \glspl{Webinterface} sicher. Die Studie wird in der ersten Märzwoche 2012 (Kalenderwoche 9) durchgeführt. Somit bleibt uns genug Zeit die Ergebnisse auszuwerten und Schwachstellen in der Benutzeroberfläche zu beseitigen.
+% TODO: -> Die Benutzerstudie kann das Qualitätsmerkmal nicht sicherstellen. Sie kann nur Grundlage für anschließende Maßnahmen sein!
+Die Benutzstudie wird in der ersten Märzwoche 2012 (Kalenderwoche 9) durchgeführt. Somit bleibt uns genug Zeit die Ergebnisse auszuwerten und Schwachstellen in der Benutzeroberfläche zu beseitigen.
 Zur Benutzerstudie werden freiwilligen Probanden Fragebögen ausgeteilt, welche der Bewertung der einzelnen Kriterien (aus Abschnitt \ref{Ziel:Benutzbarkeit})  der Benutzbarkeit des \glspl{Webinterface} dienen. Durch die Benutzerstudie können somit Defizite des \glspl{Webinterface} aufgespürt und beseitigt werden. \\
-Das Ziel der Benutzerstudie ist es eine Rückmeldung zu erhalten, ob und wie sich der Benutzer auf der Website zurechtfindet. Es gilt herauszufinden, ob der User in einer für ihn angemessenen Zeit die gewünschten Informationen abrufen kann. Da das fertige Projekt eine breite Masse an Personen erreichen wird, ist es wichtig, dass die Benutzerstudie möglichst viele verschiedene Personengruppen umfasst. Das heißt, es werden Personen mit wenig bis viel Interneterfahrung bzw. junge bis ältere Personen als Probanden eingesetzt. Zudem können durch die Studie unvorhersehbare Probleme entdeckt werden, da ein Benutzer anderst mit der Website umgeht als ein Entwickler. \newline \\
+Das Ziel der Benutzerstudie ist es eine Rückmeldung zu erhalten, ob und wie sich der Benutzer auf der Website zurechtfindet. Es gilt herauszufinden, ob der User in einer für ihn angemessenen Zeit die gewünschten Informationen abrufen kann. Da das fertige Projekt eine breite Masse an Personen erreichen wird, ist es wichtig, dass die Benutzerstudie möglichst viele verschiedene Personengruppen umfasst. Das heißt, es werden Personen unterschiedlichen Alters und mit unterschiedlicher Interneterfahrung eingesetzt. Zudem können durch die Studie unvorhersehbare Probleme entdeckt werden, da ein Benutzer anderst mit der Website umgeht als ein Entwickler. \newline \\
 \textbf{Was wir wissen wollen:}
 \begin{itemize}
 			\item Ist die Visualisierung einfach zu verstehen und ansprechend?
@@ -204,8 +204,8 @@ Das Ziel der Benutzerstudie ist es eine R
 Die Benutzerstudie setzt sich aus den zwei Teilen \textit{Beobachtung} und \textit{Fragebogen} zusammen. Somit erhalten wir zwei unterschiedliche Informationsquellen, welche in Korrelation zueinander stehen.
 
 \subsubsection{Beobachtung}
-Die Beobachtung des Probanden beim Bedienen der Website ist die einfachste Methode, um auftretende Probleme festzustellen. Hierbei bleibt der Entwickler in der Position des Beobachters und protokolliert. Der Proband surft fünf Minuten frei nach seinem Willen durch die Website. In dieser Zeit kann er sich mit der Benutzeroberfläche vertraut machen. Anschließend bekommt er konkrete Aufgaben gestellt, die er lösen muss. \\
-Bei der Beobachtung gilt es folgende Stichpunkte zu beachten:
+Die Beobachtung des Probanden während der Bedienung der Website, stellt die einfachste Methode dar, um auftretende Probleme frühzeitig zu erkennen. Hierbei nimmt der Entwickler die Position des Beobachters ein und führt Protokoll. Dem Probanden stehen fünf Minuten zur Verfügung, um sich mit der Benutzeroberfläche vertraut zu machen. Anschließend werden ihm Aufgaben gestellt, die er mit Hilfe der Website lösen muss. \\
+Während der Beobachtung achtet der Entwickler auf folgende Punkte:
 \begin{itemize}
 \item Unerwartete Fehler
 \item Probleme mit der Bedienung

ws2011/BP/QS-Dokument/QS-VV-2.txt

@@ -7,14 +7,13 @@
 
 	   "Die Open Standards werden nach [OSI] angewendet. Dieser schliesst den Einsatz kommerzieller 
 		Tools im Projekt aus." [Anmerkung: schliesst schreibt man mit scharfem S!]
+
+-> leicht abgeändert eingefügt!
 		
 3.1 "Funktionalitaet"
 
 	-> "Richtigkeit":
-		
-		   "PHPUnit erlaubt duch die integrierten Funktionen [..]"
-			
-			Korrektur des Rechtschreibfehlers in "duch"
+
 			
 	-> "Interoperabilitaet":