Dokumentace

Kaloko

Stáhnout
Markdown s obrázky (.zip)Složka pro Docusaurus (.zip)Složka pro VitePress (.zip)Složka pro MkDocs (.zip)HTML pro offline čtení (.zip)PDFNovinky jako JSON
Stránky

Doklady o kvalitě pro váš systém kvality

Stránka je pro lidi z kvality, validace a vydávání, jejichž tým pracuje v systému řízení kvality: podle ISO 9001, ISO 13485, IEC 62304, ISO 27001, nebo podle GxP ve farmacii a zdravotnických prostředcích, kde jsou pravidla nejpřísnější. Kaloko z vás neudělá organizaci ve shodě ani certifikovanou a samo podle žádné z těchto norem certifikované není. Dává vám doklady: záznam, který se dá ověřit, data, která vaše vlastní dokumenty potřebují, a poctivý přehled toho, co dělá a co ne, aby ho váš QMS mohl použít a vy jste si to použití mohli validovat po svém.

K čemu tu Kaloko slouží

Kaloko prochází obrazovky webové nebo mobilní aplikace podle kritérií, která jste napsali, zaznamená, co vidělo (snímky, stav stránky, výsledky), a sbírá, co o tom rozhodli lidé: schválení, vrácení, komentáře a přijetí běhu. Z toho vznikne záznam podepsaný službou, který si kdokoli může později ověřit.

Není to váš eQMS. Nespravuje řízené dokumenty, odchylky, CAPA, školení ani žádosti o změnu a sám nic neuvolňuje. Hodnotitelé s AI mohou výsledek navrhnout, jejich verdikty jsou ale jen doporučení: rozhodují lidé.

Co Kaloko zaznamená a na co se můžete spolehnout

Záznam obsahuje:

  • běh, scénář a prostředí, s verzí scénáře, SHA-256 souboru scénáře tak, jak se procházel, a základní URL
  • každé kritérium tak, jak se procházelo (jeho tehdejší text, ne dnešní), výsledek v každém jazyce a velikosti obrazovky a kdo ho hodnotil: člověk, deterministická kontrola, nebo model AI (jmenovitě, jako doporučení, pokud nerozhodl člověk)
  • odkazy na požadavky (refs:) u scénáře, jeho kroků a kritérií
  • záznamy, ke kterým běh patří, a proč se šlo, pokud je běh uvádí (viz níže)
  • SHA-256 každého snímku a manifestu běhu
  • rozhodnutí o krocích a o běhu, se soubory přiloženými k rozhodnutí o kroku (název, velikost, SHA-256, kdo a kdy) a s dřívějšími rozhodnutími o kroku; schválení převzatá z dřívějších běhů i s tím, odkud pocházejí, a schválení tokenů a agentů odděleně od lidských
  • elektronické podpisy a důvody změn, pokud podepisujete v Kaloku
  • verze CLI, Node.js, operačního systému, prohlížečů a služby
  • výsledky mimo akceptační kritéria (například kontroly kondice), označené jako doplňkové

Balíček dokladů k tomu přidá matici dohledatelnosti, auditní stopu běhu, snímky a soubory přiložené k rozhodnutím o krocích (decisions/<krok>/), s manifestem SHA-256 všech souborů podepsaným stejným klíčem.

Na co se můžete spolehnout:

  • Ověříte si to bez nás. kaloko signoff --verify ověří záznam i balíček proti veřejnému klíči na /.well-known/kaloko-signoff.json, offline a bez účtu. Změněný bajt ověřením neprojde.
  • Staré záznamy jdou ověřit dál. Vyřazené klíče zůstávají zveřejněné.
  • Formáty se nemění pod rukama. qawalk.evidence.v1 a kaloko.signoff.v1 v rámci verze jen přibírají pole; nekompatibilní změna dostane novou verzi a starou půjde dál číst.
  • Lidé a stroje jsou oddělení. Výsledek AI, o kterém nikdo nerozhodl, je označený jako doporučení, a tokeny ani agenti se nikdy nepočítají jako lidé a nepodepisují.

Dvě cesty

Kaloko jako záznam o provedení, podpis ve vašem eQMS. Je to výchozí stav a nic se nenastavuje. Kaloko zaznamená, co se prošlo a kdo co rozhodl; vaše vlastní nástroje si doklady stáhnou (kaloko evidence, balíček dokladů nebo webhook evidence.ready), udělají z nich vaše dokumenty a vaši lidé je podepíšou ve vašem eQMS. Každý doklad to říká přímo: acceptance je none, accepted nebo returned a signing je none, takže generátor může napsat „provedeno v Kaloku, schváleno v našem eQMS“, aniž by hádal. Váš systém pak pokrývá elektronický podpis, jeho význam, opětovné ověření, vazbu mezi podepsaným dokumentem a doklady (uložte do něj SHA-256 záznamu) a jak dlouho balíček uchováte.

Podpis přímo v Kaloku. V plánech Business a Enterprise může admin zapnout elektronické podpisy v Nastavení → Zabezpečení, pro všechny projekty nebo jen pro některé. Kdo pak přijímá běh (a pokud chcete, i schvaluje krok), vybere, co podpis znamená, z vlastního seznamu vaší organizace, znovu potvrdí druhý krok ověření a záznam uvede jeho jméno, e-mail, čas v UTC i v jeho časovém pásmu a význam podpisu. Podepisující vidí významy ve svém jazyce (Reviewed, Approved a Verified jsou přeložené, vlastním připíšete český název za svislou čáru: QA release | Uvolnění QA) a záznam uchová název, který viděl, jeho id a jazyk. Podpis pokrývá i samotné rozhodnutí: poznámku a SHA-256 souborů, které k němu někdo přiložil. Změna podepsaného rozhodnutí chce důvod; podpis v záznamu zůstane, označený jako odvolaný, i s tím, kdo, kdy a proč. Tokeny a agenti nepodepisují nikdy. Když jsou podpisy vypnuté, nic se nemění: lidé přijímají a schvalují jako dosud.

Dohledatelnost

Identifikátory požadavků napište do scénáře tak, jak je vede váš QMS:

refs: [URS-12]
nodes:
  - id: release-form
    refs: [FS-3.4]
    criteria:
      - id: AC1
        text: Před uvolněním je vidět číslo šarže
        refs: [URS-12.1, RA-7]

Kaloko je nijak nevykládá. Matice dohledatelnosti má řádek pro každý požadavek, kritérium, krok, jazyk a velikost obrazovky, se snímkem a jeho SHA-256, výsledkem, tím, kdo ho hodnotil, a rozhodnutími o kroku a běhu. Je pro každý běh i release, jako JSON (qawalk.evidence.v1, stabilní kontrakt pro generátory) a CSV.

Každý řádek matice navíc říká, kdo krok provádí a do které části procesu patří: session: kroku (role, třeba expert QC) a jeho řádek na plachtě (lanes:, dílčí proces, třeba sběr dat). Když scénář lanes: nemá, dostane každá session vlastní řádek. Validátor si tak matici vyfiltruje na jednu roli v jednom dílčím procesu. Odkaz končící #lane=<číslo> (počítá se od 0) otevře plachtu na tomto řádku, #session=<klíč> zvýrazní kroky jedné role.

Snímek kroku si ve vlastním portálu s dokumentací zobrazíte vedle testovacího kroku tak, že ho portál stáhne tokenem jen pro čtení, omezeným na projekt: GET /api/v1/orgs/<org>/runs/<run>/steps/<step>/screen?locale=cs&viewport=desktop&size=thumb&sha256=<hash>. Uložte si běh, krok a SHA-256 snímku z matice dohledatelnosti. Když běh obsahuje jiný soubor, odpověď je 409, nikdy novější obrázek. Stránky Kaloka nejde vložit do jiných webů, takže portál ukáže stažený obrázek a odkáže na krok na plachtě, kde se čtenář přihlásí vlastním účtem.

Jeden scénář, víc záznamů

Scénář se napíše jednou a prochází se znovu u každé změny: zkušební běh na lokálu pro změnové řízení CC-2026-001, formální běh na stagingu pro totéž řízení, později smoke test na produkci pro CC-2026-002. Záznam a účel uveďte při startu běhu:

kaloko start --scenario qa/batch.yml --env staging --ref CC-2026-001 --purpose formal

V CI udělají totéž KALOKO_REFS=CC-2026-001 (víc hodnot oddělte čárkou nebo mezerou) a KALOKO_PURPOSE=formal. Běh unese až 20 odkazů, každý nejvýš 80 znaků: písmena, číslice a . _ - / : # +. Účel je dry_run, formal nebo smoke; je to štítek pro lidi a portály a na tom, jak se o běhu rozhoduje, nic nemění.

Plátno ukáže obojí v hlavičce běhu. Váš portál si s tokenem pro čtení vypíše běhy daného záznamu, aniž by musel číst soubory scénářů nebo hádat z názvů: GET /api/v1/orgs/<org>/runs?ref=CC-2026-001 vrátí každý běh s verdiktem, prostředím, refs a purpose; &purpose=formal ponechá jen formální. Doklady je nesou jako run.refs a run.purpose a doklady releasu berou stejné ref a purpose, aby v nich zůstaly jen tyto běhy.

Jak to zapadá do vašeho rámce

U uvedených článků auditoři takové záznamy obvykle hledají. Co se počítá jako doklad, rozhoduje vaše QA.

RámecJak Kaloko pomůžeCo zůstává na vás
ISO 9001Podepsané záznamy, které nejde nepozorovaně změnit, s auditní stopou (7.5); záznamy o ověření návrhu a vývoje: běhy podle kritérií, rozhodnutí lidí, odkazy na požadavky (8.3.4); záznam o přijetí říká, podle jakých kritérií, na jaké verzi a kdo přijal (8.6)Řízení dokumentů, uchování záznamů ve vlastním archivu, samotné rozhodnutí o uvolnění
ISO 13485Podklady k validaci softwaru použitého v QMS: shrnutí pro posouzení dodavatele, pevná verze CLI, naše řízení změn, verze nástrojů v každém záznamu (4.1.6); čitelné, identifikovatelné záznamy chráněné podpisem a otisky (4.2.5); výsledky ověření a validace navázané na požadavky (7.3.6, 7.3.7)Validace vašeho použití Kaloka podle rizika, doba uchování a archiv, plán ověření a validace
IEC 62304Dohledatelnost od požadavku přes test k výsledku v matici dohledatelnosti; záznamy o testování softwarového systému: co se testovalo, na jaké verzi, s jakými nástroji, kdy a kdo rozhodl; podklady k záznamu o vydáníPlán vývoje, bezpečnostní klasifikace, řízení rizik, zbylé anomálie a samotné vydání
ISO 27001Akceptační kritéria a jejich výsledky jako záznam o bezpečnostním testování při vývoji a přijetí (A.8.29); přijetí navázané na verzi, PR a lidi pro řízení změn (A.8.32); balíček, který si auditor ověří offlineISMS, posouzení rizik, prohlášení o aplikovatelnosti a váš proces změn
GxP (21 CFR Part 11, EU GMP Annex 11)Viz oddíl nížeValidace (CSV nebo CSA), SOP, školení, archivace a váš výklad jednotlivých požadavků
ISO 26262, IEC 61508Podpůrný nástroj: záznamy z kontrol UI jako doplňkový dokladKvalifikace nástroje a bezpečnostní případ; Kaloko samo o sobě nástrojem pro bezpečnostní ověření není

Kontroly, které platí dnes

  • Přístup: role v organizaci a v projektech, omezené projekty a hosté; dvoufázové ověření lze vyžadovat po všech (Business); délka relace a odhlášení po nečinnosti (Business); firemní přihlášení, SCIM a povolené IP adresy (Enterprise). API tokeny mají omezený rozsah, vyprší a dají se zrušit.
  • Auditní stopa: bezpečnostně důležité akce, verdikty běhů, podpisy, smazaná rozhodnutí o krocích a stažení záznamů jdou do auditního logu, do kterého se jen přidává, i s tím, kdo, kdy, odkud a jak (prohlížeč, token nebo agent). Rozhodnutí o krocích a verdikty kritérií se ukládají s autorem a časem. Auditní stopa běhu v balíčku dokladů spojuje obojí. Záznamy o rozhodnutích běhu zůstávají, dokud existuje běh; ostatní dva roky.
  • Neměnnost záznamu: podpisy Ed25519 nad kanonickým JSON, SHA-256 každého souboru, zveřejněné veřejné klíče; vyřazené klíče zůstávají zveřejněné, aby starší záznamy šlo ověřit dál.
  • Uchování: v plánech Business a Enterprise zůstávají přijaté běhy (a běhy, které si ponecháte) i s jejich záznamy, dokud plán trvá. Ostatní běhy vyprší po době uchování podle plánu. Člověk s odpovídající rolí může běh smazat i tak (7 dní zůstane v koši a smazání je v auditním logu). Balíčky dokladů, které potřebujete, si uložte ve vlastním systému.
  • Zálohy: databázi lze obnovit k libovolné minutě posledních 30 dnů; soubory změněné za posledních 30 dnů se navíc každou noc kopírují do odděleného úložiště.
  • Čas: časy služby jsou v UTC z hodin služby, které synchronizuje poskytovatel hostingu. Časy průchodu jsou z hodin stroje, který procházel.

Naše řízení změn

CLI vychází v npm se sémantickými verzemi a changelogem; kdy aktualizovat, rozhodujete vy, a verzi můžete zafixovat. Datové formáty mají verze (qawalk.run.v1, qawalk.evidence.v1, kaloko.signoff.v1): verze jen přibírá pole a nekompatibilní změna dostane novou verzi, přičemž starou půjde dál číst. Služba se aktualizuje průběžně; každý záznam uvádí verzi služby, která ho podepsala.

GxP: 21 CFR Part 11 a EU GMP Annex 11

GxP je nejpřísnější profil, se kterým Kaloko počítá. Kaloko není validovaný systém a netvrdí shodu s Part 11 ani Annex 11; tady je, co dává k požadavkům, na které se lidé ptají nejdřív.

PožadavekCo dává KalokoCo musí vyřešit vaše validace
Part 11 §11.10 (kontroly uzavřeného systému)Přístup podle rolí, auditní stopa s tím, kdo, kdy a jak, kontrola oprávnění při přijetí a podpisu, přesné kopie záznamů (JSON, PDF, balíček)Jestli tyto kontroly stačí pro vaše zamýšlené použití; SOP a školení
Part 11 §11.50 (projev podpisu)Jméno, čas s časovým pásmem a význam u každého podpisu v záznamuVáš seznam významů
Part 11 §11.70 (vazba podpisu a záznamu)Podpis je navázaný na běh i na rozhodnutí (jeho poznámku a přiložené soubory přes SHA-256); podepsaný záznam nejde nepozorovaně změnitUložit SHA-256 záznamu do dokumentů, které podepisujete jinde
Part 11 §11.200 (složky podpisu)Relace člověka a při podpisu čerstvý druhý krok, který je jeho vlastní (klíč nebo aplikace s kódy)Jestli tahle dvojice odpovídá vašemu výkladu §11.200; hesla nejsou
Annex 11 §4 (validace)Shrnutí pro posouzení dodavatele, pevná verze CLI, verzované formáty a naše řízení změnValidace vašeho použití
Annex 11 §9 (auditní stopa)Auditní log a auditní stopa běhu v balíčkuKontrola auditní stopy tak, jak ji chtějí vaše SOP
Annex 11 §12 (bezpečnost)Role, povinné dvoufázové ověření, limity relací, firemní přihlášení, povolené IP adresySpráva uživatelů a kontroly přístupů
Annex 11 §14 (elektronický podpis)Volitelné podpisy s významem a novým ověřením, odvolat jdou jen s důvodemKde podepisujete: v Kaloku, nebo ve vašem eQMS

Jak to napojit na váš přístup k validaci:

Vaše činnostCo dává Kaloko
Posouzení dodavateleShrnutí pro posouzení dodavatele, changelog a stránka o důvěře
Instalace (IQ)Pevná verze CLI z npm (kaloko@x.y.z); každý záznam uvádí verze CLI, Node.js, prohlížeče a služby, se kterými běh proběhl
Provoz (OQ)Vlastní scénář nad stránkou, kterou máte pod kontrolou, se známými úspěchy a známými chybami: deterministické kontroly musí chyby zachytit, záznamy a balíčky musí projít ověřením a změněný soubor musí ověření neprojít
Výkon nebo UAT (PQ)Vaše skutečné scénáře s refs:, procházené na validačním prostředí; záznam nebo balíček je doklad o provedení, rozhodnutí lidí jsou kontrola
Zajištění podle rizika (CSA)Deterministické kontroly pro kritéria s vysokým rizikem, kritéria s AI jen jako doporučení s rozhodnutím člověka, matice dohledatelnosti pro pokrytí

Známé mezery

  • Kaloko nikdo necertifikoval ani nevalidoval a netvrdíme shodu s žádným z rámců výše.
  • Zprávu SOC 2 zatím nemáme; jak daleko je příprava, popisuje stránka o důvěře.
  • Podpis v Kaloku stojí na relaci člověka (odkaz z e-mailu nebo firemní přihlášení) a čerstvém druhém kroku, který je jeho vlastní (klíč nebo aplikace s kódy). Hesla nejsou. Podpis za člověka vytvoří služba, ne jeho vlastní certifikát, a není to kvalifikovaný elektronický podpis podle eIDAS.
  • Službu nejde podržet na určité verzi; zafixovat jde jen CLI.
  • Zdroj času není validovaný a záznamy zatím nenesou časové razítko od nezávislé autority.
  • Uchování se řídí plánem: není možné běh právně zablokovat proti smazání a PDF není PDF/A. Balíček archivujte sami.
  • Auditní log drží jiné záznamy než rozhodnutí dva roky. Přibývají do něj jen přes službu, nic mimo službu ho ale nezapečetí; nezávisle si ověříte podepsaný balíček.
  • Úprava textu komentáře nenechává předchozí verzi a změna rozhodnutí, které není podepsané, nechce důvod.
  • Maskování osobních údajů mění to, co snímek ukazuje. Rozhodněte, jestli běhy, které si necháváte jako doklad, maskovat, nebo ne.
  • Hotový balíček pro audit dodavatele zatím nemáme; na vyžádání vyplníme dotazník a popíšeme řízení změn, zálohy a obnovu.
  • Hodnotitelé s AI běží u externích poskytovatelů a jejich modely se mění; jejich verdikty zůstávají doporučením.

Co si vyjasnit s vaším QA

  • Kterému rámci mají doklady sloužit a u kterých článků pomáhají.
  • Kterou cestou jdete: podpis v Kaloku, nebo podpis vygenerovaných dokumentů ve vašem eQMS.
  • Jaké významy podpisu používáte a jestli se podepisuje i schválení kroků.
  • Kde se balíčky dokladů archivují a jak dlouho.
  • Která kritéria smí vůbec hodnotit AI a kdo o nich rozhoduje.
  • Jak naložíte s aktualizacemi služby, které nejde odložit.
Na této stránceNa této stránce