Ärvd integration utan dokumentation? Så tar ni tillbaka kontrollen
Det är ett vanligare läge än de flesta tror. En integration som byggdes av en konsult, en byrå eller en tidigare medarbetare fungerar än, men ingen kan längre förklara den. Ingen dokumentation, oklart var koden körs, och en tystnad i andra änden när något behöver ändras.
Läget känns värre än det är. Här är stegen vi själva följer när vi tar över en sådan lösning.
Kartlägg vad som faktiskt körs, och var
Börja med att lista allt ni vet, som vilka system som är inblandade, vilka konton och API-nycklar som finns och var koden verkar köras. Fakturor är en underskattad källa. Hosting, tjänster och domäner som betalas någonstans pekar på var lösningen bor.
Samla åtkomsterna hos er
Konton, nycklar och koder ska ägas av ert bolag, inte av en tidigare leverantör. Återta det som går att återta, byt det som inte går, och samla allt på ett ställe som ni kontrollerar. Detta är den enskilt viktigaste åtgärden, för den avgör om ni kan agera nästa gång något händer.
Dokumentera flödet, inte bara koden
Det viktigaste att skriva ner är inte kodens detaljer utan flödets logik, alltså vad som händer när en order läggs, var den tar vägen och vad som ska hända vid fel. Den beskrivningen gör att vilken kompetent utvecklare som helst kan ta över, och den är ert skydd mot att hamna i samma läge igen.
Sätt övervakning innan ni bygger om något
Instinkten är ofta att bygga om direkt. Vänta med det. Sätt övervakning på det som finns först, så att ni ser hur flödet faktiskt beter sig och upptäcker nästa fel innan kunderna gör det. Med den tryggheten på plats kan beslutet om att stabilisera eller bygga om tas i lugn och ro, på fakta.
- Agera medan integrationen fortfarande fungerar, inte efter haveriet
- Åtkomster först, dokumentation sedan, ombyggnad sist
- En genomgång i lugnt läge kostar lite och tar bort mest risk
Sitter ni i det här läget är vår räddningstjänst byggd för exakt detta, med genomgång och riskbild först, stabilisering till fast pris och dokumentation alltid inkluderad.