Projektová data a součinnost¶
Tato metodika slouží jako checklist pro sběr dat a přístupů od klienta před zahájením implementace. Je určena pro projektové manažery a AI agenty, kteří analyzují požadavky a připravují podklady pro vývoj.
Cílem je zajistit, aby byly k dispozici všechny potřebné klíče, data a kontakty pro hladký průběh integrací a migrací.
Metodika sběru¶
Každý projekt vyžaduje specifickou sadu dat. Níže uvedený seznam pokrývá nejčastější scénáře. Pro každou položku je nutné definovat: 1. Zdroj: Kdo data poskytne (Klient / Vendor / IT oddělení). 2. Formát: Jak data vypadají (API Key, XLSX, SQL Dump). 3. Status: Požadováno / Dodáno / Ověřeno.
1. Integrace a API (Externí systémy)¶
Propojení s třetími stranami je kritickou částí většiny projektů. Bez těchto údajů nelze integraci realizovat ani testovat.
| Oblast | Služba / Systém | Co je potřeba získat (Checklist) | Poznámka |
|---|---|---|---|
| E-shop | Shoptet | E-shop ID, API Access Token |
Nutné nastavit práva v doplňku API. |
| WooCommerce | Consumer Key, Consumer Secret, URL webu |
Read/Write oprávnění. | |
| PrestaShop | Webservice Key, URL webu |
Povolit příslušné resources (GET, POST...). | |
| Účetnictví | Pohoda (mServer) | IP adresa/URL, Port, IČO, Username, Password |
Často vyžaduje VPN nebo veřejnou IP. |
| Abra Flexi | URL instance, Username, Password, Company ID |
||
| Money S3 | Export XML nebo přímý přístup k DB | API bývá omezené, často se řeší přes soubory. | |
| Doprava | PPL / DHL | Client ID, Client Secret, Rozsah čísel (Ranges) |
Vyžádat testovací i produkční údaje. |
| Zásilkovna | API Klíč (Heslo), API Štítek |
Pozor na rozdíl mezi klientským a dopravním API. | |
| GLS / DPD | Username, Password, Customer ID |
Často vyžadují specifický formát štítků. | |
| Banky | Fio Banka | API Token (pouze čtení) |
Pro stahování výpisů. |
| Komerční banka | Certifikát, API klíče |
Složitější autorizace (PSD2). | |
| Specializované | Signi (Podpisy) | API Key, Contract Template ID |
Specifikovat, zda jde o Sandbox nebo Production. |
| SmartEmailing | Username, API Token |
Pro synchronizaci kontaktů. | |
| Raynet / Pipedrive | API Key, Instance URL |
Pro migraci nebo obousměrný sync. | |
| ARES / Justice.cz | Veřejné zdroje | Obvykle není třeba klíč, ale pozor na limity IP. |
2. Migrace dat (Historická data)¶
Přenos dat ze starého systému. Zde je klíčová kvalita a čistota dat.
| Entita | Typický formát | Co kontrolovat / Specifika |
|---|---|---|
| Adresář (Klienti) | XLSX, CSV, SQL | Oddělení Jméno/Příjmení, IČO validace, Duplicity, GDPR souhlasy. |
| Kontaktní osoby | XLSX, CSV | Vazba na firmu (Company ID), E-maily, Telefony. |
| Produktová báze | XLSX, XML Feed | Kódy (SKU/EAN), Ceny (s DPH/bez), Skladové karty, Kategorie, Obrázky (URL). |
| Otevřené Objednávky | XLSX, JSON | Stav objednávky, Položky objednávky, Vazba na zákazníka. |
| Faktury (Historie) | SQL Dump, PDF | Často se migrují jen nezaplacené (pohledávky) nebo kompletní historie pro statistiky. |
| Skladové zásoby | XLSX (Inventura) | Přesné množství k datu spuštění, Skladové ceny (nákupní). |
Požadavky na soubory: * Kódování: UTF-8 (preferováno), Windows-1250 (české Excel). * Struktura: První řádek musí obsahovat názvy sloupců. * Mapovací tabulka: Pokud se mění stavy (např. "Done" -> "Uzavřeno"), klient musí dodat převodník.
3. Infrastruktura a Přístupy¶
Technické zázemí pro běh aplikace a přístup vývojářů.
| Typ přístupu | Účel | Potřebné údaje |
|---|---|---|
| Hosting / Server | Nasazení aplikace | IP adresa, SSH Port, Root/User login, SSH Key (preferováno). |
| Databáze | Přímý přístup k datům | DB Host, DB Name, User, Password, Port (obvykle 3306/5432). |
| DNS / Doména | Nastavení e-mailů a webu | Přístup k registrátorovi (Wedos, Forpsi...) nebo kontakt na správce DNS. |
| SMTP (E-maily) | Odesílání notifikací | SMTP Server, Port (465/587), Username, Password, SSL/TLS. |
| IMAP (E-maily) | Párování příchozí pošty | IMAP Server, Port (993), Username, Password. |
| VPN | Přístup do vnitřní sítě | Konfigurační soubor (.ovpn), Certifikáty, Login údaje. |
| Vzdálená plocha | Správa Windows serverů | RDP adresa, Username, Password (TeamViewer/AnyDesk jako záloha). |
4. Firemní podklady (Design a Obsah)¶
Vizuální identita a nastavení systému.
- [ ] Logo: Vektorový formát (SVG, AI, EPS) nebo kvalitní PNG (transparentní pozadí).
- [ ] Barvy: Brand manuál nebo HEX kódy hlavních barev.
- [ ] Šablony dokumentů: Vzor faktury, dodacího listu, nabídky (PDF nebo Word).
- [ ] E-mailové podpisy: HTML kód nebo vzor podpisu pro uživatele.
- [ ] Seznam uživatelů: Jméno, Příjmení, E-mail, Telefon, Role/Pozice v systému, Přístupová práva.
- [ ] Číselné řady: Jak mají vypadat čísla faktur? (např.
2024001,FV-2024-001).
5. Kontakt na IT podporu (Tech Contacts)¶
Pro hladkou komunikaci při technických problémech.
- Interní IT správce: Jméno, Tel, Email.
- Správce sítě/Serveru: Jméno, Tel, Email (pokud je externí).
- Dodavatel účetního systému: Kontakt na firmu spravující Pohodu/Abru.
- Dodavatel webu/E-shopu: Kontakt na vývojáře e-shopu (pro API integrace).