KAMIWAZA Gate
Zbudowałem narzędzie do kontroli dokumentów z biblioteką Python, interfejsem wiersza poleceń i ekranem przeglądu. Reguły YAML wskazują błędy, a człowiek może zatwierdzić wyjątek lub zwrócić dokument. Historia zachowuje zarówno wykryte uchybienie, jak i decyzję.
Projekt
System przyjmuje znormalizowany JSON i sprawdza wymagane pola, daty, duplikaty oraz sumy według deklaratywnych reguł. Każde wykryte uchybienie zawiera identyfikator reguły, wskazanie pola i powód wstrzymania dokumentu.
Bibliotece Python i narzędziu wiersza poleceń towarzyszy lokalny interfejs do przeglądania, zatwierdzania i zwracania wstrzymanych dokumentów. Eksport zachowuje rozróżnienie między automatycznym przejściem kontroli a wyjątkiem zaakceptowanym przez człowieka.
Jak to działa
Sprawdzenie dokumentu
System porównuje pola i sumy w dokumencie z regułami, przypisując każdemu problemowi uzasadnienie.
Akceptacja lub ocena człowieka
Dokumenty bez uchybień przechodzą automatycznie; w pozostałych przypadkach człowiek decyduje o zatwierdzeniu lub zwrocie.
Eksport z zapisem decyzji
Eksport obejmuje tylko dokumenty zaakceptowane automatycznie lub przez człowieka, z zachowaniem tego rozróżnienia oraz pierwotnych uchybień i decyzji.
Odtworzenie wyniku wymaga dokumentu, konfiguracji reguł, daty odniesienia i historii wcześniejszych dokumentów. Kwoty są obliczane z dziesiętnych wartości zapisanych jako tekst, a reguły nie zawierają wykonywalnych wyrażeń Python.
Oceny i decyzje człowieka są dopisywane do SQLite i łączone za pomocą SHA-256. Zatwierdzenie zachowuje pierwotne uchybienia, a weryfikacja historii pozwala porównać końcowy skrót łańcucha z punktem kontrolnym przechowywanym niezależnie.
Co wynika z dokumentacji
Dla 20 dołączonych reguł przygotowano przypadki poprawne i błędne, a lokalnie pomyślnie zakończyło się 426 testów. Sprawdzono przepływ od kontroli przez decyzję człowieka po eksport, korzystając z narzędzia wiersza poleceń, biblioteki i interfejsu przeglądu.
Kontrole potwierdziły, że zatwierdzenie zachowuje pierwotny błąd, zwrócone dokumenty nie trafiają do eksportu, a zmiana zdarzenia audytu powoduje wykrywalną niezgodność skrótu.
- Dołączone reguły
- 20
- Testy lokalne
- 426 zakończonych pomyślnie
Zakres
To lokalna implementacja sprawdzona na danych syntetycznych, bez doświadczeń z eksploatacji produkcyjnej. Jej zakres nie obejmuje ekstrakcji dokumentów, działającego połączenia z LLM ani uwierzytelniania użytkowników. Wykrycie przepisania i ponownego obliczenia całego łańcucha audytu wymaga niezależnie przechowywanego punktu kontrolnego.