{"id":1074,"date":"2013-01-14T11:00:52","date_gmt":"2013-01-14T10:00:52","guid":{"rendered":"http:\/\/www.cr-online.de\/blog\/?p=1074"},"modified":"2013-03-26T17:39:19","modified_gmt":"2013-03-26T16:39:19","slug":"sachgerechte-technische-leistungsbeschreibung-fur-softwaresysteme","status":"publish","type":"post","link":"https:\/\/www.cr-online.de\/blog\/2013\/01\/14\/sachgerechte-technische-leistungsbeschreibung-fur-softwaresysteme\/","title":{"rendered":"Sachgerechte technische Leistungsbeschreibung f\u00fcr Softwaresysteme"},"content":{"rendered":"<p>H\u00e4ufiger Streitpunkt bei Festpreis-IT-Projekten ist die SOLL-Beschaffenheit einer Software: Welche funktionalen und nicht-funktionalen Eigenschaften waren f\u00fcr den festgelegten Preis eigentlich geschuldet? Dass solche Projekte sp\u00e4ter vor Gericht landen, liegt oft an einer unzureichenden technischen Leistungsbeschreibung im (Werk-)Vertrag.<\/p>\n<p>Es stellt sich damit die Frage, wie der technische Teil einer vertraglichen Leistungsbeschreibung beschaffen sein muss, um seinen Zweck zu erf\u00fcllen. Es geht also \u2013 um die Abstraktheit des Themas zu verdeutlichen \u2013 um <em>die SOLL-Beschaffenheit der Beschreibung der SOLL-Beschaffenheit<\/em> eines Software-Systems.<\/p>\n<p>Dabei ist in der Praxis zu beobachten, dass die technischen Dokumente, die bei Softwareprojekten \u00fcblicherweise als vertragliche Leistungsbeschreibung im Sinne dieses Beitrags verwendet werden, sowohl im Deutschen als auch in der h\u00e4ufigen Projektsprache Englisch jeweils mit ganz unterschiedlichen Begriffen benannt werden (ohne Anspruch auf Vollst\u00e4ndigkeit): Lastenheft, Pflichtenheft, Fachkonzept, Anforderungsspezifikation, L\u00f6sungsdokumentation, Fachfeinkonzept, Detailed Specification, Functional Specification oder auch Software Requirements Specification.<\/p>\n<p>Unabh\u00e4ngig von der konkreten und \u2013 wie oben dargestellt \u2013 weitgehend inkonsistenten Benennung sind f\u00fcr die Betrachtung in diesem Beitrag insbesondere die ben\u00f6tigten <strong>Inhalte<\/strong> und die <strong>Form<\/strong> der betreffenden Dokumente relevant. Beide Aspekte werden im Folgenden diskutiert, wobei zur Einheitlichkeit f\u00fcr die Dokumente immer der Begriff \u201e<em>technische Leistungsbeschreibung<\/em>\u201c verwendet wird, da dieser ihren Zweck aus juristischer Sicht in Abgrenzung zu anderen vertraglich spezifizierten Leistungen (z.B. Zahlung des Kaufpreises) sinnvoll beschreibt.<\/p>\n<p><strong>Welche Inhalte sollte eine technische Leistungsbeschreibung haben?<\/strong><\/p>\n<p>Die einfache, aber leider oft unbefriedigende &#8211; da nur subjektiv zu interpretierende &#8211; Antwort auf die Frage nach den \u00fcblichen Inhalten ist: <em><\/em><\/p>\n<p style=\"padding-left: 60px\"><em>&#8222;Die technische Leistungsbeschreibung sollte grunds\u00e4tzlich alle Anforderungen des Auftraggebers enthalten, <\/em><\/p>\n<p style=\"padding-left: 60px\"><em>a)\u00a0\u00a0\u00a0\u00a0\u00a0 <\/em><em>die der Auftraggeber nicht der Entscheidung des Auftragnehmers \u00fcberlassen will und<\/em><br \/>\n<em>b)\u00a0\u00a0\u00a0\u00a0\u00a0 <\/em><em>die nicht eindeutige, allgemein anerkannte Regeln der Technik sind.&#8220; <\/em><\/p>\n<p style=\"padding-left: 60px\">(typische Abgrenzung)<em><br \/>\n<\/em><\/p>\n<p>Das Problem mit Teil a) dieser Abgrenzung der Inhalte ist, dass die Art der Anforderungen, ihr Detailgrad und die dem Auftragnehmer bei der Umsetzung gew\u00e4hrten Freiheitsgrade sich von Projekt zu Projekt stark unterscheiden k\u00f6nnen. Wird ein innovatives System \u201eauf der gr\u00fcnen Wiese\u201c (d.h. ohne vorhergehende Erfahrungen mit der entsprechenden Systemklasse) aufgesetzt, so gibt es \u00fcblicherweise eher weniger harte Rahmenbedingungen und Detailanforderungen. Viele Gestaltungsentscheidungen k\u00f6nnen noch w\u00e4hrend des Projekts flexibel getroffen werden, wobei dann die N\u00e4he und Qualit\u00e4t der Zusammenarbeit zwischen Auftragnehmer und Auftraggeber w\u00e4hrend des Projekts ein wichtiger Erfolgsfaktor ist.<\/p>\n<p>Wird im Gegensatz dazu ein Altsystem z.B. bei einem Technologiewechsel vom Gro\u00dfrechner-Host auf x86-Infrastruktur abgel\u00f6st, so gibt es \u00fcblicherweise<\/p>\n<ul>\n<li>eine gewisse \u201eBestandserwartung\u201c der Nutzer des Altsystems bzgl. der Ausgestaltung der Funktionalit\u00e4ten, Prozesse und Benutzerschnittstellen,<\/li>\n<li>existierende Schnittstellen des Altsystems zu anderen Systemen,<\/li>\n<li>zu migrierende Altdaten und<\/li>\n<li>ggf. sogar wiederzuverwendende technische Komponenten.<\/li>\n<\/ul>\n<p>Bei einem solchen \u201eAustausch\u201c-Projekt gibt es also zumeist sehr viel mehr Dinge, die ein Auftraggeber aufgrund bereits in der Vergangenheit f\u00fcr das Altsystem getroffener Gestaltungsentscheidungen im neuen Projekt nicht mehr frei w\u00e4hlbar lassen will und kann.<\/p>\n<p>Das Problem mit den eindeutigen, allgemein anerkannten Regeln der Technik (Teil b der Abgrenzung der notwendigen Inhalte, siehe oben) ist, dass dieser Begriff in einem sich schnell ver\u00e4ndernden Gebiet wie der Informatik f\u00fcr Teilbereiche eine unklare Gr\u00f6\u00dfe sein kann. Oft gibt es alternative Vorgehensweisen und Gestaltungsm\u00f6glichkeiten, die dazu f\u00fchren, dass die (im Vertrag nicht explizit ge\u00e4u\u00dferten) Vorstellungen von Auftraggeber und \u2013nehmer im Projekt auseinanderlaufen. Aspekte wie Usability (Benutzbarkeit) werden zudem oft intersubjektiv (d.h. zwischen verschiedenen Personen) unterschiedlich bewertet, so dass auch hier h\u00e4ufige Streitpunkte liegen.<\/p>\n<p><strong>Standards<\/strong><\/p>\n<p>Es gibt zwar Standards f\u00fcr die Inhalte technischer Leistungsbeschreibungen f\u00fcr Software, insbesondere die in der einschl\u00e4gigen Literatur vielzitierte, aber inzwischen ersetzte Norm <a title=\"IEEE 830\" href=\"http:\/\/de.wikipedia.org\/wiki\/IEEE_830\" target=\"_blank\">IEEE 830-1998<\/a> (die aktuellste Version hei\u00dft <a title=\"IEEE\/ISO\/IEC 29148-2011\" href=\"http:\/\/www.iso.org\/iso\/catalogue_detail.htm?csnumber=45171\" target=\"_blank\">IEEE\/ISO\/IEC 29148-2011<\/a>), die jedoch im Gegensatz zu einer verbindlichen rechtlichen Norm wie die meisten technischen Normen eher Empfehlungen und \u201ebest practices\u201c vermittelt. In der Einleitung steht dazu:<\/p>\n<p style=\"padding-left: 60px\">\u201e<em>Use of an IEEE Standard is wholly voluntary. The existence of an IEEE Standard does not imply that there are no other ways to produce, test, measure, purchase, market, or provide other goods and services related to the scope of the IEEE Standard<\/em>.\u201d (IEEE 830-1998, Seite ii).<\/p>\n<p>Die IEEE Norm gibt typische Inhalte einer \u201c<em>Software Requirements Specification<\/em>\u201d (SRS) mit weiterf\u00fchrenden Hinweisen zu Qualit\u00e4tsmerkmalen an und stellt meiner Auffassung nach eine gute Ausgangsbasis f\u00fcr die Erstellung eines solchen Dokument dar:<\/p>\n<p style=\"padding-left: 60px\">\u201e<em>The basic issues that the SRS writer(s) shall address are the following:<\/em><\/p>\n<p style=\"padding-left: 60px\"><em>a)\u00a0\u00a0\u00a0\u00a0\u00a0 <\/em><em>Functionality. What is the software supposed to do?<\/em><\/p>\n<p style=\"padding-left: 60px\"><em>b)\u00a0\u00a0\u00a0\u00a0\u00a0 <\/em><em>External interfaces. How does the software interact with people, the system\u2019s hardware, other<br \/>\nhardware, and other software?<\/em><\/p>\n<p style=\"padding-left: 60px\"><em>c)\u00a0\u00a0\u00a0\u00a0\u00a0 <\/em><em>Performance. What is the speed, availability, response time, recovery time of various software functions,<br \/>\netc.?<\/em><\/p>\n<p style=\"padding-left: 60px\"><em><\/em><em>d)\u00a0\u00a0\u00a0\u00a0\u00a0 <\/em><em>Attributes. What are the portability, correctness, maintainability, security, etc. considerations?<\/em><\/p>\n<p style=\"padding-left: 60px\">e)\u00a0\u00a0\u00a0\u00a0\u00a0 <em>Design constraints imposed on an implementation. Are there any required standards in effect,<br \/>\nimplementation language, policies for database integrity, resource limits, operating environment(s)<br \/>\netc.?<\/em>\u201c<\/p>\n<p style=\"padding-left: 60px\">(IEEE 830-1998, Seite 3).<\/p>\n<p>Im Streitfall muss trotzdem f\u00fcr jeden vermeintlich fehlenden Inhalt nach dieser Norm gepr\u00fcft werden, ob seine Aufnahme in die technische Leistungsbeschreibung im konkreten Projekt tats\u00e4chlich notwendig ist und welche Detailtiefe bei seiner Beschreibung sachgerecht ist.<\/p>\n<p>Beim Vorwurf von falschen oder vergessenen Einzelanforderungen ist in Ermangelung anderer Anforderungsquellen zumeist nicht objektiv ermittelbar, ob der Kunde diese konkrete Anforderung tats\u00e4chlich so hat oder nicht. Eine Pr\u00fcfung der Validit\u00e4t der eigentlichen Anforderungen in einer technischen Leistungsbeschreibung entzieht sich also zumeist einer objektiven Begutachtung.<\/p>\n<p><strong>Welche Form sollte eine technische Leistungsbeschreibung haben?<\/strong><\/p>\n<p>Wie bei den Inhalten gibt es auch bei der Form der technischen Leistungsbeschreibung eine Vielzahl von Ans\u00e4tzen, die alle unterschiedliche St\u00e4rken und Schw\u00e4chen haben. Ende der 90er Jahre wurde mit der Unified Modeling Language (<a title=\"UML bei Wikipedia\" href=\"http:\/\/de.wikipedia.org\/wiki\/Unified_Modeling_Language\" target=\"_blank\">UML<\/a>) ein Standard geschaffen, der den Anspruch erhebt die besten Diagramm- und Modellierungstechniken f\u00fcr Systemspezifikationen der damaligen Zeit in sich zu vereinen (daher \u201eUnified\u201c). Aber auch dieser \u201eStandard\u201c l\u00e4sst noch viele Gestaltungspielr\u00e4ume bei der Auswahl der Diagrammtypen, der problemspezifischen Anpassung der Darstellungsform und der Ausgestaltung der eigentlichen Leistungsbeschreibung.<\/p>\n<p>In der Praxis h\u00e4ngt der Erfolg der Form einer technischen Leistungsbeschreibung stark davon ab, ob die passende Kombination von Darstellungsformen f\u00fcr die wichtigsten Aspekte des geplanten Systems gefunden wird. Wenn ein Softwaresystem beispielsweise seinen prim\u00e4ren Mehrwert aus der Verarbeitung komplexer und kritischer Realweltdaten bezieht (Beispiel: Modellierung von Finanzderivaten und ihrem jeweiligen Risikoprofil), stehen bei der Spezifikation eher Datenmodellierungsmethoden im Vordergrund. Wenn ein System seinen Mehrwert aus der Automatisierung von komplexen, stark verzweigten Gesch\u00e4ftsprozessen zieht (Beispiel: Logistik in der M\u00f6belindustrie), so stehen Diagrammtypen zur Abbildung von Abl\u00e4ufen und Ablaufvarianten im Mittelpunkt.<\/p>\n<p>Eine Projekt- bzw. Spezifikationsmethodik sollte dem Ersteller einer technischen Leistungsbeschreibung zum einen m\u00f6glichst konkrete Darstellungsm\u00f6glichkeiten vorgeben, um eine gewisse Konsistenz der Art der Darstellung gerade bei gro\u00dfen Projekten oder innerhalb von Organisationen zu schaffen. Auf der anderen Seite sollte die Methodik jedoch flexibel genug sein, um dem Ersteller die M\u00f6glichkeit zu geben, die f\u00fcr den Beschreibungsgegenstand jeweils ideale Darstellungsform frei zu w\u00e4hlen.<\/p>\n<p>Es kann also auch f\u00fcr die notwendige Form einer technischen Leistungsbeschreibung festgehalten werden, dass es keine einfachen, allgemeing\u00fcltigen Aussagen gibt, sondern dass im konkreten Ffall die Angemessenheit der gew\u00e4hlten Darstellungsform im Kontext des Einzelfalls gepr\u00fcft werden muss.<\/p>\n<p><strong>Die technische Leistungsbeschreibung als Grundlage f\u00fcr die Abnahme<\/strong><\/p>\n<p>Ein Indiz f\u00fcr eine gute technische Leistungsbeschreibung ist die Gradlinigkeit, mit der sich Abnahmetests aus der Spezifikation ableiten lassen. Wenn die Anforderungen dort konkret und klar beschrieben sind, so kann man \u00fcblicherweise schnell erkennen, welche Anforderungen besonders wichtig sind und wie man diese am zur Abnahme stehenden System \u00fcberpr\u00fcfen kann.<\/p>\n<p>Wenn beispielsweise in der Leistungsbeschreibung nur steht \u201e<em>der Online-Shop muss ein sehr gute Benutzbarkeit vorweisen<\/em>\u201c, so ist die Gestaltung eines treffenden Abnahmetests problematisch. Wenn dort hingegen steht,<\/p>\n<p style=\"padding-left: 60px\">dass \u201e<em>ein technisch nicht versierter Benutzer ohne weitere Einweisung selbst\u00e4ndig und fehlerfrei den Einkaufprozess des Shops von der Produktauswahl bis zum Abschluss des Check-outs durchlaufen k\u00f6nnen muss<\/em>\u201c,<\/p>\n<p>so liegt der passende Abnahmetest schon sehr nah.<\/p>\n<p><strong>Zusammenfassung<\/strong><\/p>\n<p>Es gibt in der Informatik Standards, die Vorschl\u00e4ge f\u00fcr die Inhalte und Darstellungsformen von technischen Leistungsbeschreibungen in Softwareprojekten bieten. Diese Standards haben jedoch nicht den Stellenwert rechtlicher Normen (d.h. es gibt Alternativen). Zudem lassen sie dem Ersteller eines solchen Dokuments \u00fcblicherweise selbst innerhalb des Standards so gro\u00dfe Spielr\u00e4ume, dass im Streitfall eine konkrete Bewertung des Einzelfalls erfolgen muss.<\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>H\u00e4ufiger Streitpunkt bei Festpreis-IT-Projekten ist die SOLL-Beschaffenheit einer Software: Welche funktionalen und nicht-funktionalen Eigenschaften waren f\u00fcr den festgelegten Preis eigentlich geschuldet? Dass solche Projekte sp\u00e4ter vor Gericht landen, liegt oft an einer unzureichenden technischen Leistungsbeschreibung im (Werk-)Vertrag. Es stellt sich damit die Frage, wie der technische Teil einer vertraglichen Leistungsbeschreibung beschaffen sein muss, um seinen [&hellip;]<\/p>\n","protected":false},"author":16,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[250,174,238,166],"_links":{"self":[{"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/posts\/1074"}],"collection":[{"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/users\/16"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/comments?post=1074"}],"version-history":[{"count":22,"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/posts\/1074\/revisions"}],"predecessor-version":[{"id":1099,"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/posts\/1074\/revisions\/1099"}],"wp:attachment":[{"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/media?parent=1074"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/categories?post=1074"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.cr-online.de\/blog\/wp-json\/wp\/v2\/tags?post=1074"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}