Šablona předávacího protokolu softwarového projektu
Předávací protokol zaznamenává, co dodavatel předal, v jaké verzi a komu patří které účty. Ukážeme si, co do něj patří, a přidáme šablonu ke zkopírování.
Shrnutí a kontext
Předávací protokol se obvykle píše poslední den projektu. Níže najdete, co do předávacího protokolu softwarového projektu patří, šablonu ke zkopírování a vyplněný příklad.
1. Předávací protokol vs. kontrolní seznam
Při předání aplikace se potkávají tyto dva dokumenty. Kontrolní seznam pro předání slouží týmu dodavatele: co je potřeba převést, zkontrolovat a připravit. Předávací protokol dostává klient a podepisuje ho.
Protokol je záznam o tom, co se předalo, v jaké verzi, komu po předání patří které účty a s jakými známými omezeními klient aplikaci přebírá. Klient ho otevře, když řeší reklamaci, změnu dodavatele nebo audit, proto musí být srozumitelný i pro někoho, kdo u předání nebyl.
2. Šablona předávacího protokolu
Šablona pokrývá předání jedné aplikace. Hodnoty ve špičatých závorkách doplňte, části, které se vás netýkají, vynechte. Jak převést repozitář na klienta, popisuje například návod GitHubu Transferring a repository.
# Příklad předávacího protokolu: <název aplikace>
## 1. Strany a datum
- Dodavatel: <firma, odpovědná osoba>
- Klient: <firma, odpovědná osoba>
- Datum předání: <datum>
## 2. Předmět předání
- Aplikace: <název, krátký popis>
- Verze: <číslo verze>, tag v repozitáři <v1.0.0>
- Prostředí: <produkce, staging> s adresami
## 3. Účty a přístupy
| Služba | Vlastník po předání | Převedeno | Kde jsou přístupové údaje |
| --- | --- | --- | --- |
| Repozitář | <klient> | <ano/ne> | <správce hesel klienta> |
| Hosting | <klient> | <ano/ne> | <…> |
| Doména a DNS | <klient> | <ano/ne> | <…> |
| E-mailová služba, platební brána, … | <…> | <…> | <…> |
## 4. Dokumentace
- Vývojová a provozní dokumentace: <odkaz>
- Uživatelská dokumentace: <odkaz>
- Přehled odkazů k aplikaci: <odkaz>
## 5. Stav aplikace
- Známé chyby a omezení: <seznam nebo odkaz>
- Technický dluh: <seznam nebo odkaz>
## 6. Otevřené úkoly
- <úkol, kdo ho dokončí, termín>
## 7. Podpora po předání
- Záruční doba: <do data>
- Smlouva o podpoře a SLA: <odkaz>
- Kontakt pro hlášení chyb: <helpdesk, e-mail>
## 8. Převzetí
- Klient převzal předmět předání: <bez výhrad / s výhradami>
- Výhrady: <…>
- Podpisy: <dodavatel, datum> / <klient, datum>3. Vyplněný příklad
Takto může vypadat vyplněná část protokolu u menší webové aplikace, kterou agentura předává klientovi a dál ji pro něj udržuje.
## 2. Předmět předání
- Aplikace: Objednávkový portál pro velkoobchodní zákazníky
- Verze: 2.0.0, tag v repozitáři v2.0.0
- Prostředí: produkce https://objednavky.example.com, staging https://objednavky-test.example.com
## 3. Účty a přístupy
| Služba | Vlastník po předání | Převedeno | Kde jsou přístupové údaje |
| --- | --- | --- | --- |
| Repozitář GitHub | Klient | ano | GitHub, organizace klienta |
| Hosting Azure | Klient | ano | Správce hesel klienta, složka Objednávky |
| Doména example.com | Klient | už dříve | Správce hesel klienta |
| E-mailová služba | Agentura | ne, zůstává ve správě agentury | Správce hesel agentury |
## 5. Stav aplikace
- Známé chyby: export objednávek do CSV nezachová diakritiku v Excelu (oprava ve verzi 2.0.1)
- Technický dluh: platební modul používá starší verzi SDK brány, výměna naplánovaná na 1. čtvrtletí4. Jak předávací protokol sepsat, aby platil i za rok
Protokol, který dává smysl jen lidem, kteří u předání byli, za rok nepomůže. Následující body ho udělají čitelným i pro nového správce nebo dalšího dodavatele.
5. Předávací údaje, které nezastarají
Protokol zachycuje stav v den předání. Za pár měsíců přibude prostředí, nasadí se nová verze nebo se změní kontakt na podporu a protokol už neodpovídá skutečnosti. Pokud aplikaci dál udržujete, klient potřebuje místo, kde najde aktuální stav, a protokol na něj může odkazovat.
V AboutTheApp připojíte ke klientovi odkazy na repozitář, dokumentaci, hosting a podporu, které se týkají jen jeho instalace. Označíte je jako privátní a klient je uvidí se svým odemykacím kódem na své About page spolu s prostředími, nasazenými verzemi a poznámkami k vydání. Kontakty na podporu a odkaz na SLA tak najde na stejném místě.
AboutTheApp drží odkazy a přehled, ale účty nepřevádí. Repozitář, hosting a doménu je potřeba převést přímo v každé službě.
6. Právní upozornění
Šablona a příklady v tomto článku slouží jen pro ilustraci a nejsou právním dokumentem ani právní radou. Konkrétní předávací protokol vždy konzultujte se svým právním zástupcem, který ho přizpůsobí vaší smlouvě a platnému právu.
Časté otázky
Co má obsahovat předávací protokol softwarového projektu?
Strany a datum předání, předávanou aplikaci s verzí a prostředími, seznam účtů s vlastníkem po předání, odkazy na dokumentaci, známé chyby a technický dluh, otevřené úkoly, podmínky podpory po předání a podpisy obou stran.
Kdo podepisuje předávací protokol?
Odpovědná osoba dodavatele, typicky vedoucí projektu, a odpovědná osoba klienta, která má pravomoc potvrdit převzetí. Pokud klient přebírá s výhradami, zapíší se do protokolu před podpisem.
Jaký je rozdíl mezi předávacím protokolem a kontrolním seznamem pro předání?
Kontrolní seznam slouží týmu dodavatele jako přehled úkolů před předáním. Předávací protokol je výsledný dokument pro klienta, který zaznamenává, co se předalo, a obě strany ho podepisují.
Kdy začít připravovat předávací protokol?
Na začátku projektu. Účty, prostředí a dokumentaci je snazší zapisovat průběžně než je dohledávat na konci. Před předáním pak stačí doplnit verzi, stav aplikace a podpisy.
Kde má klient najít informace o aplikaci po předání?
Na jednom místě, které se s aplikací aktualizuje. V AboutTheApp vidí klient na své About page odkazy, prostředí, nasazené verze a kontakty na podporu, které se týkají jeho instalace.
Ve zkratce
Dobrý předávací protokol říká, co se předalo, v jaké verzi a komu co patří, a odkazuje na místo, kde klient najde aktuální stav i po předání.
Chcete předávat aplikace s aktuálním přehledem?
Založte si zdarma aplikaci v AboutTheApp a připojte ke klientovi odkazy, prostředí a kontakty na podporu.