Formát souboru .ourcad

.ourcad je nativní přenosový formát dokumentů ourCAD — slouží k záloze dokumentu do souboru, přenosu mezi účty či instalacemi a k výměně rozpracovaných modelů mimo sdílení na serveru. Soubor vytváří server z kanonického stavu dokumentu, takže nese vše podstatné: prvky (features) včetně stromu a závislostí, kompletní náčrty s vazbami a kótami, proměnné, konfigurace i nastavení dokumentu.

Veřejný validátor a converter

Soubor .ourcad si můžete kdykoli zkontrolovat bez přihlášení na www.ourcad.cloud/validator — ověří strukturu, integritu i podpis a vypíše případné chyby. Pro převod mezi .ourcad a výměnnými formáty (STEP, IGES, STL, OBJ, DXF) slouží veřejný converter — podrobně na stránce Converter souborů.

Export a import najdeš v editoru

Strom prvků → menu dokumentu → Exportovat (.ourcad) / Importovat (.ourcad). Exportovat může každý, kdo dokument vidí; import vytváří dokumenty na tvém účtu.

Co soubor obsahuje — a co ne

Obsahuje	Neobsahuje
prvky (features), jejich parametry, strom a závislosti	vypočtenou geometrii (tělesa, meshe) — po importu se přepočítá z parametrů
kompletní náčrty: prvky, vazby, kóty	historii verzí (git) — přenáší se jen aktuální stav
vložené dokumenty sestav (do hloubky, viz níže)
proměnné (equations) a konfigurace	vlastnictví, sdílení a umístění ve složkách — to určuje server při importu
nastavení dokumentu (materiál, jednotky…) a 2D výkres
zdrojové soubory importovaných těles (STEP/IGES/STL/OBJ — viz níže)

Díky tomu je soubor malý (typicky desítky kB) a import vždy končí čerstvě přepočítaným modelem — nikdy nepřenáší potenciálně nekonzistentní geometrii.

Struktura souboru

.ourcad je ZIP archiv se dvěma soubory:

manifest.yaml       metadata exportu (viz níže)
document.yaml       vlastní dokument v čitelném YAML
subdocs/<id>.yaml   přibalené vložené dokumenty (sestavy — viz níže)
sources/<otisk>     zdrojové soubory importovaných těles (schéma 2)

manifest.yaml

Pole	Význam
format / format_version	vždy ourcad / 2
schema_version	verze schématu souboru (aktuálně 2, viz Verze schématu)
exported_at, exported_by	kdy a kým byl export vytvořen
document.id	identita zdrojového dokumentu — podle ní import pozná „tenhle dokument už znám"
document.content_hash	otisk obsahu (viz níže)
document.feature_count	počet prvků (rychlá orientace)
references	seznam vložených dokumentů, na které se dokument přímo odkazuje
subdocs	skutečně přibalené vložené dokumenty (id, název, otisk, kontrolní součet)
sources	zdrojové soubory importovaných těles (jméno, formát, otisk, vazba na prvek)
document_sha256	kontrolní součet souboru document.yaml (detekce poškození)
signature	podpis serveru (viz níže)

Otisk obsahu (content hash)

content_hash je otisk návrhového obsahu dokumentu — počítá se z prvků, náčrtů, proměnných a nastavení, ale záměrně ignoruje proměnlivá technická pole (odkazy na vypočtenou geometrii apod.). Dva dokumenty se stejným otiskem jsou tentýž návrh, i když byly přepočítány v různou dobu.

Právě otisk umožňuje ochranu proti duplicitám: import porovná otisk souboru s dokumenty na serveru a podle výsledku nabídne správnou akci (viz níže).

Podpis (signature)

Server exporty podepisuje. Při importu se podpis ověří:

• platný — soubor je nezměněný export z tohoto serveru,
• chybí — soubor vznikl na serveru bez podpisového klíče; neutrální stav,
• neplatný — soubor byl po exportu upraven nebo poškozen; import zobrazí upozornění.

Ruční úprava souboru není zakázaná — jen ztrácí potvrzený původ a projde přísnější kontrolou. Všechny soubory se validují stejně.

Importovaná tělesa a jejich zdroje (schéma 2)

Těleso importované ze STEP, IGES, STL nebo OBJ nejde přepočítat z parametrů — jeho jediným zdrojem je původní soubor. Proto ho .ourcad od schématu 2 přibaluje do sources/ (jde o jedinou výjimku z pravidla „bez geometrie"). Při importu server tělesa ze zdroje znovu naimportuje, takže dokument je i po přenosu kompletní. Více těles z jednoho STEP sdílí jediný přibalený soubor.

Verze schématu

Schéma	Co přineslo
1	původní tvar souboru
2	sekce sources/ — zdrojové soubory importovaných těles

Soubory se starším schématem se při importu i validaci automaticky převedou na aktuální — starý export zůstává použitelný napořád.

Chování importu

Import probíhá ve dvou krocích: soubor se nejdřív analyzuje (validace + porovnání se serverem) a teprve po tvé volbě se provede akce. Podle výsledku analýzy uvidíš jednu ze situací:

Situace	Co to znamená	Nabízené akce
Beze změn	přesně tento dokument (i obsah) už na serveru je	Otevřít existující · Importovat kopii
Liší se	dokument na serveru existuje, ale obsah se od souboru liší	Importovat kopii (výchozí) · Obnovit obsah · Otevřít existující
Stejný obsah jinde	jiný tvůj dokument má identický obsah	Otevřít existující · Importovat kopii
Nový	dokument ani obsah na serveru nejsou	Importovat kopii

• Importovat kopii vytvoří nový dokument na tvém účtu (nové ID přiděluje vždy server). Kopie si pamatuje, z čeho vznikla — server tak umí sledovat rodokmen importů.
• Obnovit obsah přepíše existující dokument obsahem souboru. Vyžaduje právo úprav a výslovné potvrzení; před obnovou se automaticky uloží záchranný bod do historie dokumentu, takže se lze kdykoli vrátit. Spolupracující uživatelé jsou při obnově krátce odpojeni a znovu se připojí k čerstvému stavu.
• Po importu se model automaticky přepočítá; u větších dokumentů to chvíli trvá.

Vložené dokumenty (sestavy)

Export přibaluje vložené dokumenty do hloubky (i vnořené sestavy; přibalí se jen ty, které při exportu vidíš, max. 1000). Import je pak řeší chytře, aby na serveru nevznikaly zbytečné kopie:

• vložený dokument už na serveru je → jen se propojí (nic se neduplikuje),
• není, ale identický obsah máš v jiném dokumentu → propojí se na něj,
• jinak se importuje jako kopie a vazby se automaticky přesměrují.

Dialog importu vždy ukáže souhrn: kolik vložených dokumentů se propojí a kolik importuje. Odkazy, které přibalené nejsou (např. bez přístupu při exportu), zůstávají jen jako reference — import na ně upozorní a vazby zůstanou nefunkční, dokud dokumenty nedoplníš.

Validace a limity

Každý importovaný soubor prochází vícevrstvou kontrolou: bezpečnost archivu, striktní kontrola schématu (neznámá pole = chyba, ne tiché zahození), referenční integrita (odkazy mezi prvky, vazby náčrtů, cykly v závislostech) a rozumné stropy velikostí. Nevalidní soubor import zastaví se srozumitelným popisem chyb — nikdy se nenaimportuje „půlka dokumentu".

Základní limity: soubor do 50 MB, do 20 000 prvků, do 50 000 prvků v jednom náčrtu.

Ruční úpravy souboru

document.yaml je čitelné YAML — zkušení uživatelé ho mohou upravit (hromadná změna parametru, příprava šablony). Pár zásad:

• drž se existující struktury; neznámá pole import odmítne,
• odkazy mezi prvky (sketch_id, parent_id, závislosti…) musí zůstat konzistentní — validátor visící odkazy ohlásí,
• identifikátory prvků při importu kopie server stejně nahradí vlastními, není třeba je vymýšlet,
• upravený soubor bude mít neplatný podpis — to je očekávané, import to jen oznámí.