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:

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:

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

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

Co si vyjasnit s vaším QA

Kaloko · latest · 2026-11-21