- Wersja
- Pobierz 420
- Wielkość pliku 7.76 MB
- Liczba plików 1
- Data utworzenia 2 maja 2026
- Ostatnia aktualizacja 12 maja 2026
DEMO - specyfikacja techniczna aplikacji System Sprzedaży z Katalogu
"Brak specyfikacji kosztował wykonawcę cały kontrakt [wyrok SA we Wrocławiu, I ACa 796/13]. Analiza przedwdrożeniowa i specyfikacja oprogramowania to dwa zupełnie różne dokumenty. Analiza mówi CO chcemy osiągnąć. Specyfikacja mówi JAK to dokładnie ma działać. Mylenie ich lub pomijanie specyfikacji kosztowało wykonawcę w tej sprawie cały kontrakt i przegraną w sądzie. Wykonawca, co istotne, przygotował specyfikację funkcjonalną, ale nie zadbał o osobną specyfikację techniczną dla jednego z kluczowych modułów systemu. Efekt? W trakcie realizacji umowy nie dało się ustalić, do czego dokładnie wykonawca się zobowiązał. System nie działał jako całość: moduły nie wymieniały danych poprawnie, a oprogramowanie nie nadawało się do użytku biznesowego. Zamawiający odstąpił od umowy."
Celem tego projektu jest demonstracja Specyfikacji Technicznej Aplikacji (ale nie jej środowiska). Czas opracowania z pomocą narzędzia CASE, wraz z testowaniem modeli, liczony jest w godzinach. Niniejszy dokument PDF jest opracowany także w tym samym narzędziu CASE, więc pracochłonność związana z jego aktualizacją jest zerowa, ewentualny dodatkowy nakład pracy, pojedyncze godziny, to rozwój projektu. Implementacja może być realizowana na podstawie PDF, możliwe jest wygenerowanie szkieletu kodu i późniejsza synchronizacja z pomocą narzędzia IDE wykorzystywanego przez dewelopera. Deweloperzy korzystający z AI dostają plik XMI (UML).
Dokument ten to przykład Specyfikacji Technicznej Aplikacji.
Aplikacja to zbiór procedur, dla wygody zarządzania kodem (utrzymanie i rozwój) oraz z uwagi na bezpieczeństwo, dzielimy te procedury na osobne i niezależne grupy zamykane w komponenty. Podział na komponenty wynika z grupowania treści w dokumenty ukierunkowane na to czy są opisem faktu (zdarzenia) czy przedmiotu (człowiek, budynek, itp.). Dane, jako dokumenty, są tu przechowywane w repozytoriach NoSQL, głównie w bazach key-value i dokumentowych.
Na końcu dokumentu umieszczono bibliografię.
Narzędzia CASE (ja używam Visual Paradigm) pozwala na prowadzenie analiz i dokumentowania ich wyników w sposób zapewniający pełną zgodność ze standardami, swobodę pracy on-line oraz minimalny nakład pracy na tworzenie dokumentacji dostępnej dla każdego: klientom wysyłam spójne dokumenty pdf a nie pliki źródłowe .vpp.
- Model to drzewiasta struktura elementów systemów i ich połączeń,
- Diagrams to diagramy stanowiące zobrazowanie tego modelu z każdej wymaganej perspektywy
- Documentation to dokument udostępniany w formacie pdf, html, docx, tworzony wewnątrz narzędzia CASE dzięki czemu nakład pracy na jego tworzenie i aktualizację jest znikomy.
Dlatego kosztem analizy i projektowania jest wyłącznie mój czas spędzony nad analizą i projektowaniem, samo tworzenie i aktualizowanie dokumentacji praktycznie nie stanowi kosztu dla moich klientów, takiej pozycji nigdy nie ma na moich fakturach.
