Jeżeli chcesz rzetelnych odpowiedzi, musisz mieć rzetelne źródła. To zaczyna się od SSOT: jednej wersji dokumentu, która jest cytowalna, audytowalna i zarządzana w czasie.
W skrócie
SSOT to umowa procesowa: doc_id + wersja, albo nie cytujesz
statusy sterują tym, czy wolno indeksować i używać w odpowiedziach
reindeksacja i review mają być rytmem, nie gaszeniem pożaru
tombstone i log zmian chronią stabilność linków i audyt
Jeśli to ma wejść do procesu, proszę traktować ten rozdział jako standard operacyjny.
SSOT (Single Source of Truth) to nie slogan. To umowa procesowa:
jedna wersja dokumentu jest źródłem, do którego wolno cytować, indeksować i z którego wolno uczyć użytkownika.
1. Definicja: co w praktyce jest SSOT
Dokumenty w Compendium i w bazie wiedzy mogą istnieć w wielu kopiach (PDF, wiki, e‑mail, export),
ale SSOT musi być jeden: identyfikowany przez doc_id i wersję (vX.Y).
Bez wersji nie ma cytowań. Bez cytowań nie ma rzetelności.
2. Statusy: od Draft do Archived
Statusy nie są „dekoracją” w bibliotece. One sterują tym, co wolno robić z treścią (indeksować / cytować / wyświetlać).
Reguła dyscypliny: zmiana treści w statusie Published bez podbicia wersji to błąd procesu.
Konsekwencja jest prosta: cytowania przestają być stabilne.
3. Wersjonowanie i identyfikacja
doc_id — stały identyfikator logiczny dokumentu (niezmienny),
version — semantyczna wersja treści (zmienia się przy każdej modyfikacji),
hash — kontrola integralności (pomaga w audycie i w cache),
index_version — wersja indeksu/embeddingów powiązana z polityką chunkingu.
Minimalny format cytowania wewnętrznego (dla RAG i audytu):
