📊 [LAB] RAPORTY: DOKUMENTACJA

🔬 DOKUMENTACJA BADAWCZA – METODOLOGIA I ZNACZENIE

1. Po co rejestrujemy dane?

Każdy artefakt krzemienny, który trafia do analizy, traci swoją wartość naukową, jeśli zostaje pozbawiony kontekstu. Lokalizacja, typ stanowiska, stratygrafia – to elementy, które zamieniają zwykły kamień w źródło wiedzy o pradziejowych sieciach wydobycia, dystrybucji i technologii.

Narzędzie powyżej to nie tylko generator „raportu PDF”. To prototyp cyfrowego formularza rejestracji terenowej, który wymusza zebranie trzech kluczowych atrybutów:

• Nazwa stanowiska – identyfikator unikalny w obrębie projektu
• Współrzędne GPS – precyzyjna lokalizacja (w przyszłości: automatyczne odczytanie z urządzenia mobilnego)
• Typ stanowiska – klasyfikacja funkcjonalna (kopalnia, pracownia, osada, znalezisko luźne)

Bez tych trzech pól dokumentacja archeologiczna jest niekompletna.

2. Jak działa ten moduł?

Formularz zbiera dane wejściowe i generuje podsumowanie w formie czytelnego komunikatu. Obecnie jest to symulacja – pokazuje, jak mógłby wyglądać docelowy system archiwizacji. W przyszłości:

• kliknięcie przycisku wygeneruje rzeczywisty plik PDF z metadanymi
• dane zostaną zapisane w bazie Silex‑Intel jako nowy rekord terenowy
• współrzędne GPS będą mogły być pobrane automatycznie z geolokalizacji przeglądarki
• każdy raport otrzyma unikalny identyfikator DOI (lub lokalny UID)

Kod JavaScript realizujący funkcję genReport() pokazuje, jak w prosty sposób można zweryfikować kompletność danych i wyświetlić podsumowanie – to pierwszy krok do stworzenia systemu zarządzania dokumentacją terenową.

3. Poziom badawczy – dlaczego to ważne?

W archeometrii krzemienia jednym z największych wyzwań jest standaryzacja dokumentacji. Wiele zespołów badawczych stosuje różne formaty zapisu, co uniemożliwia późniejszą agregację danych. Ten prosty interfejs:

• wymusza ujednolicone pola
• integruje się z istniejącą strukturą Silex (metryki techniczne, cytowania)
• przygotowuje dane pod kątem przyszłych analiz GIS i statystycznych

Z perspektywy badawczej każdy poprawnie udokumentowany punkt stanowi punkt odniesienia (ang. ground truth) dla:

• modeli dystrybucji surowców
• rekonstrukcji szlaków wymiany
• oceny intensywności eksploatacji złóż

To właśnie ten rodzaj danych pozwala przejść od pojedynczych odkryć do systemowej analizy pradziejowej gospodarki surowcowej.

4. Co dalej?

Moduł będzie rozwijany o:

• możliwość dodawania zdjęć (geotagowanych)
• eksport w formacie CSV/GeoJSON do narzędzi GIS
• automatyczne weryfikowanie poprawności współrzędnych
• podpięcie do bazy Silex‑Intel, aby przy wpisywaniu nazwy stanowiska podpowiadać już istniejące rekordy

Docelowo ma służyć jako front-end do zbiorczej bazy danych krzemiennych stanowisk Polski, dostępnej dla środowiska naukowego.