TimberTrace — seis v1.0

TimberTrace by ForestSense — puidu jälgimise (chain-of-custody) lahendus. Eesmärk: kontrollida, kas raie-ahela tööde tasud vastavad maha müüdud puidu kogustele. Tuvastada üle-tasud, kadu, sünk-lacunad. Bränd: "puidu ränd kasvavast puust tehasesse". Skoop: NW kontsern (VFF + VZF2) alates 01.01.2025. Granulaarsus: üks rida per raie-projekt × puuliik × sortiment (level 8 C-XXX).

5+1 etapi mõõte-ahel · ±2-3% tolerants

käsi

🌲

Kasvav mets

LATIO 12.01.2026 inventuur · LVM Geo · NW Forest Model v9.2

E1 = m³ planeeritud

›

ETL ootel

🌳

Harvester (raie)

TimberMATIC FINAL · tma_tracking + tma_stems · 4311/4312

E2 ≤ E1 · 2657,91 m³ (3 langit)

›

puudub

🚜

Kokkuvedu

Directo 4321/4322/4323 m³ (Kogus-veerg sünk laienemata)

E3 = E2 ±2-3%

›

osaline

🚛

Transport

EVR · KPDC KVA/PF · LVM Geo CSV · Phenu EE · WhatsApp LV

E4 = E3 ±2-3%

›

tundmatu

🏪

Ladu / vahesalvestus

Klient / NW vahelao mõõtja-staatus

E5 ≤ E4

›

LIVE

💰

Müük

Directo directo_invoices · 3110-3113

E6 ≤ E5 · €/m³

12 andmeallikat · sünk-staatus

LATIO inventuur

käsi

Drive xlsx 12.01.2026

E1 — kasvava metsa hinnanguline maht per kinnistu × liik. Vajab MCP search.

HPR/PRD harvester

Azure AD

tma_tracking, tma_stems · harvester_tma_sync 6 faili

E2 — TimberMATIC FINAL. ETL kood valmis (VS_TASK_3, 03.05). Deploy blokeeritud Azure AD seadistamise ootel.

Directo VFF / VZF2

LIVE

directo_invoices, directo_transactions

E3/E4/E6 — BI Direct sünk töötab. Kogus-veerg (4321-4323 m³) sünk laienemata, planeeritud.

⭐ EVR transpordi-saatelehed

LIVE · NAS cron 03:30

evr_transport_docs · 160 doc · 4 786 m³

E4 EE-haru — kogu Eestisse müüdav puit. VFF 131 doc (4019 m³) + VZF2 29 doc (767 m³). Saajad: Toftan AS (158) + Eesti Puidumüügikeskus TÜ (2). Periood 2025-10 → 2026-05.
🟡 3 NULL-välja: raw_payload (P0), du_code VFF 131/131 (P1), volume_tm 160/160 (P2)

KPDC API

LIVE 21.05

kpdc_documents · 156 Vestman doc

UUS allikas. TDU 75 + KVA 49 + PF 34 + MT 1. Cron 15 min. Ootame prod-rolli (Artūrs).

LVM Geo

3 allikat

JWT POC + Basic Auth proxy + sessioon

E1 polygoonid (Nogabali 6615, Cirsmas 1133), E4 Works. Basic Auth eelistatud (40% katvus). CSV eksport olemas (267 TDU OID).

Phenu (EE saatelehed)

täpsustada

API / CSV vorm teadmata

E4 EE-haru. Erki kinnitas et lahendatud, aga eksport-vorm vajab dokumenteerimist.

⭐ Santa saatelehtede loend

käsi · live

Harvesting_2025.xlsx · SharePoint VFF108

E4 + E6 join-allikas. Santa Liezere täidab käsitsi 15-veerulist Excelit jooksvalt — sh Directo rēķina Nr, Bruto m³, Summa EUR, MU Nr (C-XXXXX), VFF PZ Nr, Pārvadātājs. Microsoft Graph kaudu reaalajas loetav. → ava Excel
L1 id=502 · 17.05 kanoonsed 294/292/296/300/286

WhatsApp LV saatelehed

🔻 varu-kanal

W1 agent · Chrome MCP + OCR

E4 LV-haru. W1 SKILL kirjutatud. Prioriteet langetatud — Santa tabel (eelmine kaart) asendab struktureeritult.

S2 LiDAR

R&D

Riistvara ostetud €3491,75

Sõltumatu mõõtja — turul unikaalne. CAN-bus PGN blokaator. Välitööd kavandatud.

SharePoint VFF108

kood

SP_VFF108_HARVEST

E2 — harvester-raportite teine allikas (paralleelne emailile, PR #59).

Outlook e-mail capture

kood

erki.unn@vestman.ee

E2 — Ruusa OU jt harvester-raportite emailid. Sama prioriteediga SharePoint'iga.

Osalised · 5 kategooriat

Müüjad (Vestman Group)

VFF — Vestman Forest Fund999.55.2001
VZF2 — Vestman Zemes Fonds 2999.55.2102

Ostjad / saaja-tehased

Latvijas FinierisUUSLATFI · LV vineerikoda
LATGRANLATGR · LV pellet
Sodra mežs999.55.4 · LV
Toto999.55.68 · LV
Toftan ASEE saematerjal
ACA Timber, BONO TRADELV

Vedajad

StrobusWA · LV saematerjal
AK Stiga SIAAKSTI · WA · LV muu
Stiga RM999.55.1 · KPDC
SCA pārvadātājs999.55.7788
ACA Forest999.55.9
U&P Trans OÜEE harvester

Raie-töövõtjad

Ruusa OÜ (Sven Otsa)John Deere 1070D
AP Mežs SIAAIMEZ

LVM Geo robotid (KPDC kontod)

vff@lvm.lvVFF Admin · 8 kuud
vzf2@lvm.lvVZF2 Admin · 8 kuud

Auditi-leiud (esimesed reaalsed kasutusjuhud)

🔴 C-00911 VOLUME_MISMATCH

audit ootel

Skaidinas 0091: PRD näitab 260,44 m³fob, Ruusa OÜ arve 20260401 arveldab 208 m³. Vahe 52 m³ (20,1%) — ületab 5-8% normi. Vaja Ruusa OÜ selgitust enne 80% ettemaksu autoriseerimist.

pos_deep_memory id=302 · märts 2026

🟡 Zemites Oak Saw alert

Verify use case

2 tamme (Oak Saw) raiuti 0,37 m³. Tamm on Baltikumis kõige kallim liik — kuid raie-load ei sisaldanud Oak'i. ForestSense Verify tuvastaks selle CNN + CAN-bus võrdlusega reaalajas.

Zemites Thinnig 2 · 12.03.2026

✅ Purini-1 vaheraport-reegel

lukus

VAHERAPORT 06.03.2026 162,02 m³ → LÕPRAPORT 12.03.2026 308,63 m³ (+90,5%). Reegel: arve kontrollimisel kasutada AINULT lõpraportit. Eristamine: lõpraportil KAKS raielangi_lopetamise_kuupaev, vaheraportil üks.

pos_deep_memory id=190 · PR #60

🟡 EVR andmekvaliteet — 3 NULL-välja

P0 blokeerib P1+P2

EVR API töötab (160 doc, 4 786 m³ Eestisse), aga ETL-i upsert_docs() ei serialiseeri korrektselt: P0 raw_payload NULL 160/160 (jsonb bug), P1 du_code VFF NULL 131/131 (C-XXXXX puudub API vastusest — vaja userCustomData või VC→LVM Geo lookup), P2 volume_tm NULL 160/160 (ainult m³).

project_evr_ladu_audit.md · pos_deep_memory id=357

Versioonide ajalugu

Versioon	Kuupäev	Sisu	Asukoht
v0.1 dashboard	25.03.2026	Bränd, FINAL/INTER loogika, Pauguri näidis	`Drive/TimberTrace/`
v0.3	aprill 2026	Dashboard ET/LV/EN	`04_tooted_html/timbertrace_v0_3.html`
v0.4 dashboard	17-18.04.2026	3 lõpraportit, 2657,91 m³, Oak Saw alert, hinnakiri eraldi	`04_tooted_html/timbertrace_v0_4.html`
tagasivaade v0	01.05.2026	Cowork Eiriku audit, kavandatud 5 sammu	`00_alus/timbertrace_tagasivaade_v0.md`
kontseptsioon v0.1	03.05.2026	6 etapi mudel, ±2-3% tolerants, 5+2 lippu	`00_alus/timber_trace_kontseptsioon_v0.1.md`
ETL kood (VS_TASK_3)	03.05.2026	6 Python faili (sync/sharepoint/email_capture/stanford2010/tma_writer/dedup)	`07_skriptid/harvester_tma_sync/`
seis v1.0 ← see	21.05.2026	L0+L1+G süntees · KPDC LIVE lisatud · Latvijas Finieris avastatud	`00_alus/timbertrace_seis_v1.md`

Järgmised 7 sammu (prioriteet)

harvest_reports tabel Supabase'i

Skeem on L1 mälus (id=305) — id uuid, client_id, object_code, site_name, report_type FINAL/INTER, report_date, source_email_id, total_m3sub/sob, species_data jsonb, assortment_data jsonb, raw_json, invoice_ref. Vaja apply_migration.

KPDC ↔ VC mapping uuring

Kontrolli kas KPDC raw_json.sequences[].supplypoint_id = TimberTrace VC_XXXXX kood (teada VC_00845 Pauguri/VZF2, VC_00846 Graudiņi/VFF, VC_00847 Skaidiņas/VFF). Kui kattub — lisa kpdc_documents tabelisse timbertrace_vc_code veerg ja indekseeri.

LVM Geo CSV importer UUDE tabelisse

Mitte kpdc_documents — vale abstraktsioonitase. UUS tabel timbertrace_deliveries (267 TDU OID + 211 KVA + 413 PF + 1000 ridu, sh Latvijas Finieris/AKSTI/AIMEZ partnerid + m³ kolmes mõõtmises).

Artūrs follow-up (KPDC)

3 punkti ühes kirjas: prod-API roll erki.unn@vestman.ee jaoks · UI Administrator-roll VFF (9447) + VZF2 (9448) jaoks (EUDR avaneb) · 2 email-typo parandus (vestman.ee13 + vestman.et). Eelistatav: kustuta vana īpašnieks-konto, anna owner aktiivsele kontole — lahendab 3 probleemi korraga.

⭐ Santa Excel ETL (07_skriptid/santa_xlsx_sync/)

Microsoft Graph API client + Excel sheet reader, UPSERT Supabase tabelisse santa_saatelehed. Reuse harvester_tma_sync/sharepoint.py muster (sama VFF108 sait). Loob join-võtmed Directo arvete + tma_tracking + KPDC KVA-ga. Asendab W1 WhatsApp OCR-i osaliselt.

Dashboard v0.5 plaan

Saatelehtede-rida iga site_id all kõrvuti harvester-raporti ja arvega. Lisa KPDC andmevoog + LVM Geo CSV + Santa Excel. Cowork Eirik haldab visuaalset kihti, VS Eirik tehnilist.

⭐ EVR P0 raw_payload bug fix (07_skriptid/evr_sync/)

upsert_docs() jsonb serialiseerimise bug — kõigil 160 kirjel raw_payload IS NULL. See blokeerib P1 du_code lookup-i (userCustomData asub raw_payload-is) ja takistab verification_engine käivitust. Pärast P0 saame jätkata P1 (VC→LVM Geo→C-number) ja P2 (m³→tm konvert).