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 --verifyověří 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.v1akaloko.signoff.v1v 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ámec | Jak Kaloko pomůže | Co zůstává na vás |
|---|---|---|
| ISO 9001 | Podepsané 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 13485 | Podklady 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 62304 | Dohledatelnost 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 27001 | Akceptač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ěří offline | ISMS, posouzení rizik, prohlášení o aplikovatelnosti a váš proces změn |
| GxP (21 CFR Part 11, EU GMP Annex 11) | Viz oddíl níže | Validace (CSV nebo CSA), SOP, školení, archivace a váš výklad jednotlivých požadavků |
| ISO 26262, IEC 61508 | Podpůrný nástroj: záznamy z kontrol UI jako doplňkový doklad | Kvalifikace 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žadavek | Co dává Kaloko | Co 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áznamu | Váš 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ěnit | Ulož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ěn | Validace vašeho použití |
| Annex 11 §9 (auditní stopa) | Auditní log a auditní stopa běhu v balíčku | Kontrola 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 adresy | Sprá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ůvodem | Kde podepisujete: v Kaloku, nebo ve vašem eQMS |
Jak to napojit na váš přístup k validaci:
| Vaše činnost | Co dává Kaloko |
|---|---|
| Posouzení dodavatele | Shrnutí 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.