Analiza przedwdrożeniowa - co zawiera dokument (przykład w PDF)

Przed wyceną integracji powstaje dokument: 9-24 strony, zależnie od zakresu. Opisuje, który system rządzi którym polem, co się dzieje w każdym scenariuszu i jak system reaguje na sytuacje wyjątkowe.

Poniżej przykładowa wersja do pobrania i opis, co zawiera każda sekcja.

Pobierz przykład

Przykładowa analiza przedwdrożeniowa (PDF, 9 stron) - integracja PrestaShop - BaseLinker - Comarch Optima dla fikcyjnej hurtowni elektrotechnicznej.

Dane w pliku są wymyślone: firma, branża, 12 800 indeksów, architektura, pracochłonność i kwoty. Dokumentów klientów nie publikujemy w żadnej postaci, również zanonimizowanej. Ten plik powstał osobno, żeby pokazać format.

Macierz źródeł prawdy

Tabela: pole - system, który nim rządzi - kierunek przepływu. Osobny wiersz dla SKU, nazwy, opisu, ceny zakupu, ceny sprzedaży, EAN-u, stanu, zamówienia, dokumentu sprzedaży i statusu.

Bez tego ustalenia dwa systemy nadpisują to samo pole w kółko. Objaw: cena albo stan zmienia wartość co cykl synchronizacji, a w logu widać naprzemienne zapisy z obu stron. Zasada w dokumencie brzmi: jedno pole, jeden master, jeden kierunek.

W przykładowym PDF ta tabela zajmuje stronę 3.

Diagram architektury

Gdzie stoi który komponent i czym się łączy. Rozstrzyga dwie rzeczy praktyczne: czy potrzebny jest komponent na serwerze z ERP (gdy dostęp idzie po COM albo wprost po bazie), czy wystarczy połączenie do API, oraz czy dane księgowe wychodzą poza sieć firmy.

Scenariusze krok po kroku

Dla każdego przepływu: diagram sekwencji plus tabela „kierunek - operacja - mechanizm”. W przykładzie są dwa: zamówienie ze sklepu (8 kroków) i synchronizacja stanów.

Tu zapada najwięcej decyzji. Przykład ze strony 5: dokument sprzedaży powstaje po potwierdzeniu kompletacji, nie przy złożeniu zamówienia - inaczej dokument opisuje towar, którego magazyn jeszcze nie wydał, a przy anulowaniu zostaje korekta do faktury, która nie powinna była powstać.

Przypadki brzegowe

Tabela na kilkanaście pozycji: produkt bez SKU, duplikat indeksu, zamówienie na towar o stanie 0, podwójnie dostarczony webhook, ERP niedostępny w trakcie backupu, zwrot częściowy, cena poniżej kosztu, rozjazd zegarów między systemami.

Każdy wiersz ma przypisaną reakcję systemu: kwarantanna, odrzucenie z wpisem w logu, ponowienie z odstępem, alert po N próbach. Do tej tabeli wraca się po wdrożeniu, gdy trzeba rozstrzygnąć, czy system zachował się zgodnie z ustaleniami.

Uzasadnienie decyzji

Tabela: decyzja - powód. Dlaczego ERP jest masterem stanów, dlaczego ceny kontraktowe zostają w ERP zamiast trafiać do sklepu, dlaczego rezerwacja poprzedza dokument.

Sekcja bywa pomijana, a odpowiada na pytania zadawane rok później, gdy osoby prowadzące wdrożenie już w firmie nie pracują.

Stan obecny a docelowy

Dwie kolumny, wiersz na obszar: stany, zamówienia, dokumenty, ceny, nowe indeksy, zwroty, błędy. Przy czytaniu tej tabeli klient zwykle wykreśla jeden albo dwa wiersze - przed wyceną, nie po odbiorze.

Plan prac i kryteria odbioru

Wycena rozbita na pozycje z pracochłonnością w dniach roboczych, pogrupowane w etapy. Każda pozycja ma podkroki z warunkiem akceptacji, na przykład: „dwukrotne dostarczenie webhooka tworzy jeden dokument” albo „przyjęcie dostawy 300 pozycji to jedna operacja zbiorcza, nie 300 wywołań”.

Taki rozkład pokazuje, za co idą pieniądze, i które pozycje można przesunąć na drugi etap.

Dlaczego przed wyceną

Bez macierzy źródeł prawdy nie wiadomo, ile jest pól do zmapowania. Bez listy przypadków brzegowych nie wiadomo, ile reguł trzeba napisać. Bez sprawdzenia, czy ERP ma API, czy trzeba czytać bazę, nie wiadomo, jaka architektura wchodzi w grę - a to różnica kilku dni roboczych i decyzja o tym, gdzie stoi komponent.

Wycena bez tych odpowiedzi zawiera bufor na niewiadome albo kończy się aneksami.

Ile kosztuje

Analiza i dokument: 900 zł netto. Pierwsza rozmowa techniczna (30-45 min), na której ustalamy, czy w ogóle jest o czym rozmawiać, jest bezpłatna.

Dokument zostaje u Was niezależnie od decyzji - również wtedy, gdy wnioskiem będzie „wystarczy gotowa wtyczka” albo gdy wdrożenie zrobi ktoś inny. Nie ma w nim blokad: macierz pól, scenariusze i przypadki brzegowe są opisane na tyle dokładnie, że może z tego pracować dowolny wykonawca.

Jak liczyć samą decyzję wtyczka kontra dedykowana, opisaliśmy osobno.

Opisz, co się rozjeżdża - odpowie zespół techniczny.