{ "cells": [ { "cell_type": "markdown", "metadata": {}, "source": [ "![Logo 1](https://git.wmi.amu.edu.pl/AITech/Szablon/raw/branch/master/Logotyp_AITech1.jpg)\n", "
\n", "

Przygotowanie do projektu badawczo-rozwojowego

\n", "

7. Specyfikacja projektu informatycznego[wykład]

\n", "

Krzysztof Jassem (2021)

\n", "
\n", "\n", "![Logo 2](https://git.wmi.amu.edu.pl/AITech/Szablon/raw/branch/master/Logotyp_AITech2.jpg)" ] }, { "cell_type": "markdown", "metadata": {}, "source": [] }, { "cell_type": "markdown", "metadata": {}, "source": [ "
\n", " \n", "

Zakres systemu informatycznego

\n", " \n", "Zakres systemu to obszar tego, co projektujemy – precyzyjnie odgraniczony od tego, co leży poza projektem (np. jest zadaniem projektowym kogoś innego).\n", "\n", "Zakres funkcjonalny – zestaw usług oferowanych przez system.\n", "\n", "Zakres projektowy – zasięg przestrzenny systemu – obejmuje zbiór sprzętu i oprogramowania, które zlecono nam wykonać.\n", "
" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# Jak zdefiniować zakres projektu?\n", "\n", "Zakres projektu jest stopniowo uściślany za pomocą następującyh działań:\n", "\n", "1. Określenie ogólnego zakresu projektu, a w nim:\n", "\n", " * Określenie koncepcji projektu, np. w postaci prezentacji lub diagramu\n", " * Charakterystyka wykonawców\n", " * Lista „wykonawca-cel”\n", " * Lista „in-out”\n", "\n", "2. Specyfikacja wymagań\n", " * Wymagania funkcjonalne\n", " * Wymaganie niefunkcjonalne\n", " \n", "3. Opis przypadków użycia" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# 1. Określenie ogólnego zakresu projektu" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Uczestnicy i wykonawcy" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "
\n", "

Uczestnik

\n", " \n", "Uczestnik – ktoś lub coś, mający interes związany z zachowaniem systemu.\n", "\n", "\n", "Uczestnik może być osobą, firmą lub przedsiębiorstwem, programem komputerowym lub systemem komputerowym.\n", "
" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "
\n", "

Wykonawca

\n", " \n", " Wykonawca to Uczestnik, który kontaktuje się z systemem.\n", "\n", " Wykonawca główny to Wykonawca, który kontaktuje się z systemem w celu uzyskania jednej z jego usług. Wykonawca główny najczęściej rozpoczyna przypadek użycia. \n", "\n", " Wykonawca pomocniczy to Wykonawca z zewnątrz wykonujący usługi dla systemu (drukarka, usługa WWW, osoby, które mają dostarczyć pewne badania).\n", "\n", "
" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "
\n", " \n", "Uczestnik ma interesy. \n", "Wykonawca ma zachowania.\n", "
" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Charakterystyka wykonawców\n", "Charakterystykę wykonawców można opisać za pomocą tabeli. \n", "\n", "Przykład tabeli dla systemu Cybertest2:\n", "\n", "\"Lista" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Lista Wykonawca-Cel\n", "Na podstawie charakterystyki wykonawców oraz zakresu systemu tworzy się listę **Wykonawca - Cel**, w której dla każdego typu wykonawców określa się cele, jakie wykonawca stawia przed systemem. \n", "\n", "Jeśli projektowany system dotyczy interesów uczestników niebędących wykonawcami, pożądane może być sporządzenie szerszej listy: **Uczestnik – Cel**. \n", "\n", "Przykład tabeli dla systemu Cybertest2:\n", "\n", "\"Lista\n" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Lista In-Out\n", "Na podstawie listy Wykonawca-Cel, biorąc pod uwagę priorytety celów, tworzy się listę In-Out, która precyzyjnie określa zakres systemu. \n", "\n", "Przykład tabeli dla systemu Cybertest2:\n", "\"Lista" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# 2. Specyfikacja wymagań" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "
\n", " \n", "

Specyfikacja wymagań

\n", " \n", "Specyfikacja wymagań to dokument, w którym zebrano wszystkie oczekiwania stawiane przyszłemu systemowi (np. wymagania funkcjonalne i niefunkcjonalne aplikacji).\n", " \n", "
" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### Wymagania użytkownika\n", "**Wymagania użytkownika** to ogólny opis oczekiwań względem systemu w języku naturalnym, będacy rezultatem wstępnych rozmów wykonawcy z zamawiającym lub użytkownikiem.\n", " * Skierowane są do:\n", " * menedżerów zamwiającego.\n", " * menedżerów wykonawcy,\n", " * potencjalnych użytkowników systemu.\n", " \n", "Przykład wymagań użytkownika (system wspomagania tłumaczenia):\n", "\n", "\"Przykład" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "### Wymaganie systemowe\n", "**Wymagania systemowe** to sformalizowany opis oczekiwań względem systemu.\n", " * Skierowane są do:\n", " * inżynierów zamawiającego,\n", " * twórców oprogramowania, \n", " * architektów systemu. \n", " \n", "Wymagania systemowe dzielą się na:\n", " * funkcjonalne,\n", " * niefunkcjonalne" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "#### Wymagania funkcjonalne\n", " * Opisują funkcje (czynności, operacje) wykonywane przez system.\n", " * Dotyczą rezultatów oczekiwanych przez użytkownika podczas kontaktu z systemem.\n", " \n", "Przykłady wymagań funkcjonalnych (system do prowadzenia testów na wykładzie):\n", "\n", "\"Przykład\n", "\n", "\"Przykład" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "#### Wymagania niefunkcjonalne\n", " * Opisują warunki, przy których system musi realizować swoje funkcje:\n", " * Wymagania dotyczące produktu\n", " * Wymagania dotyczące procesu\n", " * Wymagania zewnętrzne\n", " * Wymagania niefunkcjonalne powinny być weryfikowalne. Realizowane jest to przy pomocy systemu miar opisujących wymagane cechy systemu.\n", "\n", "Przykłady miar wymagań niefunkcjonalnych:\n", "\n", "\"Przykłady\n", "\n", "Przykład wymagań niefunkcjonalnych (system wspomagania tłumaczenia):\n", "\n", "\"Przykład" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "# 3. Opis przypadków użycia" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "
\n", " \n", "

Przypadek użycia (PU)

\n", " \n", "Przypadek użycia określa umowę między uczestnikami systemu względem jego zachowania.\n", "\n", "\n", "
" ] }, { "cell_type": "markdown", "metadata": {}, "source": [ "## Elementy składowe opisu przypadku użycia \n", "1. Wykonawca główny (który rozpoczyna wykonanie przypadku użycia)\n", "2. Poziom celu\n", "3. Warunki początkowe\n", "4. Wyzwalacz\n", "5. Gwarancje minimalne\n", "6. Gwarancja powodzenia\n", "7. Scenariusz powodzenia\n", "8. Rozszerzenia scenariusza" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### 3.1. Przypadek użycia. Poziom celu\n", "Poziom celu określa stopień ogólności przypadku użycia:\n", " * Poziom streszczenia – najbardziej ogólny,\n", " * Poziom użytkownika – pośredni,\n", " * Poziom podfunkcji – najbardziej szczegółowy.\n", " \n", "#### Poziom streszczenia\n", "Przypadki użycia o poziomie streszczenia pokazują kontekst, w którym występują przypadki użycia niższego poziomu:\n", " * Pokazują kolejność działania przypadków użycia niższego poziomu,\n", " * Stanowią spis treści przypadków użycia niższego poziomu (użytkownika).\n", " \n", "Przykład przypadku użycia o poziomie streszczenia (podkreśleniem oznaczone są przypadki niższego poziomu):\n", "\n", "\"Przykład\n", "\n", "#### Poziom użytkownika\n", "Przypadki użycia o poziomie użytkownika opisują cel, który chce osiągnąć wykonawca główny, żeby wykonać swoje zadanie. \n", " * Najczęściej spełniają warunek: „jedna osoba i jedno krótkie posiedzenie”.\n", " * Przypadki te są najbardziej warte opisania w specyfikacji.\n", " \n", "Przykład przypadku użycia o poziomie użytkownika:\n", "\n", "\"Przykład\n", "\n", "#### Poziom podfunkcji\n", "Przypadki użycia o poziomie podfunkcji opisują podcele, które są potrzebne do osiągnięcia celów użytkownika.\n", " * Uwzględniane są w opisie przypadków tylko w sytuacjach absolutnie niezbędnych („nie musisz – nie pisz”).\n", " * Trzy przykłady przypadków użycia o poziomie podfunkcji:\n", " > Wybierz odpowiedź na pytanie testowe. \n", " > Przejdź do następnego pytania. \n", " > Zaloguj się w systemie. " ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### 3.2. Przypadek użycia. Warunki początkowe\n", "**Warumek początkowy** to proste stwierdzenie o stanie świata w chwili otwarcia przypadku użycia. \n", " * Warunek początkowy może być wyrażony za pomocą przypadków użycia, które musiały zajść przed otwarciem opisywanego przypadku. \n", " * Warunek początkowy określa, co musi być zapewnione przed zezwoleniem na przypadek użycia. \n", " \n", " Przykład warunku początkowego (system do testów):\n", "\n", "\"Przykład" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### 3.3. Przypadek użycia. Wyzwalacz\n", "**Wyzwalacz** to zdarzenie, które automatycznie powoduje rozpoczęcie przypadku użycia.\n", "\n", " Przykłady wyzwalaczy (system do testów):\n", " \n", "\"Przykłady" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### 3.4. Przypadek użycia. Gwarancje minimalne\n", "**Gwarancje minimalne** to najmniejsze obietnice składane przez system.\n", " * Są realizowane zarówno wtedy, gdy cel wykonawcy głównego jest spełniony (scenariusz powodzenia) i gdy nie jest on spełniony. (Szczególnie w tym drugim przypadku minimalne gwarancje są istotne).\n", " * Zapisywane są w postaci kilku stwierdzeń, które będą na pewno prawdziwe po zakończeniu przypadku użycia.\n", " \n", " Przykłady gwarancji minimalnych:\n", " \"Przykłady" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### 3.5. Przypadek użycia. Gwarancja powodzenia\n", "**Gwarancja powodzenia** ustala, jakie interesy uczestników są zaspokojone po udanym zakończeniu przypadku użycia (scenariusz powodzenia).\n", " * Zapisywana jest w postaci prostych stwierdzeń, opisujących świat po udanym zakończeniu przypadku użycia.\n", " * Często ma postać rozszerzenia minimalnych gwarancji.\n", " \n", "Przykłady gwarancji powodzenia:\n", "\n", " \"Przykłady\n" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### 3.6. Przypadek użycia. Scenariusz powodzenia\n", "**Scenariusz powodzenia** to ciąg akcji od rozpoczęcia do zakończenia przypadku użycia, który realizuje gwarancje powodzenia.\n", "Scenariusz powodzenia opisuje najbardziej typowe zachowanie systemu i nie bierze pod uwagę zdarzeń niesprzyjających. \n", "\n", "**Wskazówki przy pisaniu scenariusza powodzenia:**\n", "\n", "#### 1. Używaj prostych składni zdań\n", "\"Przykład\n", "\n", "### 2. Jasno i jednoznacznie wskaż podmiot czynności\n", "\"Przykład\n", "\n", "##### 3. Pisz \"z lotu ptaka\"\n", "\"Przykład\n", "\n", "##### 4. Przesuwaj proces wyraźnie do przodu\n", "\"Przykład\n", "\n", "##### 5. Stwierdzaj \"że\", a nie - sprawdzaj \"czy\"\n", "\"Przykład\n", "\n", "##### 6. Wyraźnie oznaczaj przypadki użycia, do których się odwołujesz\n", "\"Przykłady\n", "\n", "##### 7. Stosuj iteracje, jeśli jest taka potrzeba\n", "\"Przykłady" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "### 3.7. Przypadek użycia. Rozszerzenia scenariusza\n", "**Rozszerzenie scenariusza** to niestandardowe zachowanie systemu, które\n", " * zaczyna się w konkretnym kroku w scenariuszu powodzenia,\n", " * gdy zdarzają się niestandardowe sytuacje – zwane **warunkami rozszerzenia scenariusza**.\n", " \n", "#### Warunki rozszerzenia scenariusza\n", "**Warunki rozszerzenie scenariusza** to sytuacje, w których system zachowuje się inaczej, niż to przewidziano w scenariuszu powodzenia.\n", "* Warunki rozszerzenia sformułowane są z punktu widzenia systemu (co system może wykryć, a nie - co się stało).\n", "\"Przykłady\n", "\n", "##### Jak znajdować potencjalne rozszerzenia scenariusza?\n", " * Przemyśl alternatywne ścieżki scenariusza, np.\n", " * Wykonawca głóny postępuje niepoprawnie\n", " * Brak działania wykonawcy głównego\n", " * Wykonawca pomocniczy reaguje z opóźnieniem\n", " * Przeanalizuj wszystkie wystąpienia wyrażeń typu „System stwierdza, że...”\n", " * Przeanalizuj sytuacje awaryjne\n", " * Awarie wewnętrzne projektowanego systemu, które należy wykryć i obsłużyć\n", " * Awarie wewnętrzne systemu, które wystarczy wykryć" ] }, { "attachments": {}, "cell_type": "markdown", "metadata": {}, "source": [ "# Podsumowanie - jak stworzyć specyfikację systemu informatycznego?\n", " 1. Określenie koncepcji projektu, np. w postaci prezentacji lub diagramu \n", " 2. Charakterystyka wykonawców \n", " 3. Lista „Wwykonawca-Cel” \n", " 4. Lista „In-Out” \n", " 5. Wymagania funkcjonalne \n", " 6. Wymaganie niefunkcjonalne \n", " 7. Opis przypadków użycia " ] } ], "metadata": { "author": "Krzysztof Jassem", "email": "jassem@amu.edu.pl", "kernelspec": { "display_name": "Python 3", "language": "python", "name": "python3" }, "lang": "pl", "language_info": { "codemirror_mode": { "name": "ipython", "version": 3 }, "file_extension": ".py", "mimetype": "text/x-python", "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", "version": "3.8.5" }, "subtitle": "07. Specyfikacja projektu informatycznego[wykład]", "title": "Przygotowanie do projektu badawczo-rozwojowego", "year": "2021" }, "nbformat": 4, "nbformat_minor": 4 }