Přenositelnost a migrace dat
DocuLife vás neuzamyká. Kompletní obsah organizace si kdykoli odnesete ve strojově čitelném formátu — se soubory, popisem struktury a kontrolními součty — a přenesete k jinému poskytovateli. Tři cesty podle situace, v souladu s právem na přenositelnost dat (EU Data Act).
Tři cesty exitu
Od jednorázové kompletní migrace celé organizace po průběžnou synchronizaci do nového systému.
Data celé organizace ve strojově čitelném formátu, včetně přiložených souborů, popisu prostředí a kontrolních součtů. Nejúplnější cesta pro migraci.
Jednotlivá složka do souboru .xlsx, volitelně jako ZIP i s přiloženými soubory. Rychlý přenos konkrétního pohledu.
Postupné stahování změn přes veřejné REST API (feed nových, upravených i smazaných záznamů). Pro průběžnou synchronizaci do cílového systému.
Kompletní balíček
Balíček tvoří samostatné ZIP části dvojího druhu, popis prostředí a přehledový manifest — vše s kontrolními součty.
Datové části nesou records.jsonl — jeden záznam na řádek: schválené hodnoty polí (u výběrů, vazeb a osob s identifikátorem i popiskem), systémová metadata, časy a odkazy na soubory.
Souborové části nesou originály příloh v adresáři soubory/. Odkaz u záznamu ukazuje na cestu do souborové části — přílohy se párují napříč částmi.
structure.json popisuje prostředí — agendy, typy záznamů, pole, pohledy, pravidla termínů a přehled přístupového modelu.
manifest.json je rozcestník: části a jejich kontrolní součty, počty, chyby a přehled toho, co balíček nezahrnuje (AI indexy, provozní logy, konfigurace).
Metadata organizace
Vždy strojově čitelné v JSONL, u vybraných kategorií navíc jako lidsky čitelné CSV otevíratelné v tabulkovém editoru.
| Kategorie | Formát | Obsah |
|---|---|---|
| Členové | JSONL + CSV | Členové organizace: jméno, e-mail, role, stav |
| Skupiny | JSONL | Skupiny a jejich členství |
| Přístupová oprávnění | JSONL | Kdo (uživatel, skupina, token) má jakou úroveň na kterém zdroji |
| Audit uživatelů | JSONL + CSV | Historie správy uživatelů a členství |
| Audit oprávnění | JSONL + CSV | Historie udělení a odebrání přístupů |
| Audit API tokenů | JSONL + CSV | Historie správy tokenů — bez jakýchkoli tajemství |
Formáty a integrita
Registr exportních struktur · Data Act čl. 26
Aby cílový systém věděl přesně, co dostane, zveřejňujeme popis všech struktur exportního balíčku — lidsky i strojově čitelně (JSON, v1).
| Artefakt | Obsah |
|---|---|
| part-NNNNN.zip | Části balíčku v jedné číselné řadě — datové (records.jsonl, max. 50 000 záznamů/část) a souborové (soubory/{record_id}/{file_id}_{název}, ~2 GB/část) |
| structure.json | Prostředí organizace: agendy, typy záznamů s poli, možnosti výběrů, pohledy, pravidla termínů, přehled přístupového modelu |
| {kategorie}-NNNNN.jsonl/.csv | Metadata organizace: členové, skupiny, oprávnění, audit uživatelů / oprávnění / API tokenů |
| manifest.json + .sha256 | Rozcestník: verze schématu, SHA-256 a velikost každé části, počty, chyby, co balíček záměrně neobsahuje (AI indexy, provozní logy, konfigurace infrastruktury) |
| Záznam v records.jsonl | Význam |
|---|---|
| record_id · record_type_id · agenda_id | Stabilní UUID záznamu, typu záznamu (složky) a agendy |
| status · workflow_status · auto_number | Stav záznamu, stav schvalování, automatické číslo |
| created_at · updated_at · created_by_user_id | Časy v ISO-8601, autor |
| fields | Schválené hodnoty polí: skalární přímo; výběr [{option_id, label}]; vazba [{record_id, display_name}]; osoba [{user_id, display_name}] |
| files | Odkazy na přílohy: {file_id, path, original_filename, size_bytes, content_type, checksum_sha256} — path míří do souborové části balíčku |
| schema_version | Verze schématu (aktuálně 1) — v každém řádku, v manifestu i ve structure.json |
Průběžná migrace přes API
Když chcete data synchronizovat do nového systému postupně, ne jednorázovým balíčkem.
Správce organizace vytvoří API token a udělí mu jen úroveň Prohlížející na potřebné složky a pohledy — princip nejmenšího nutného oprávnění. Token lze kdykoli odvolat.
Synchronizace přes feed nových, upravených i smazaných záznamů, po dávkách s postupem přes kurzor. Migrace může běžet dlouhodobě — v klidu, spolehlivě, bez zátěže na provoz.