Presjek stanja · 20. 7. 2026.
Presjek Zelena šuma
Lipanjski rad na karti sadnje nikad nije spojen u main, a main je u srpnju otišao dalje — i jednu funkciju sad imamo napravljenu dvaput. Ovdje je točno stanje, kako se povlači zadnji kod, kako sustav radi, koja je shema, gdje su rupe i što je cilj po zadnjim planovima.
01Gdje smo stali
Zadnji commit na našoj grani je 24. 6. Nakon toga su se dogodile dvije stvari koje nisu bile planirane.
Glavno18 commita nikad nije dobilo pull request
Grana feature/zs-karta-sadnje stoji od 24. 6. PR-ovi #13–#24 su svi spojeni; naša grana i jedna grana s ograničenjem prijava su jedine dvije bez PR-a. Kompletan lipanjski rad — GPS import, više timova, smjene, lokacije — postoji samo na toj grani. Na mainu je SCHEMA_VERSION = 2 i moduli gps, teams, shifts, locations ne postoje.
SukobOdabir lokacije sadnje napravljen je dvaput, različito
PR #21 (9. 7., spojen) radi odabir s karte, s JS modulom web/src/map-picker.js i testovima (tests/map-picker.test.ts). Naša grana radi isto iz popisa parcela, s registrom na strani jezgre (locations.json, funkcije known_locations / forget_location). Obje verzije rade; samo jedna može ostati.
Druga granaOgraničenje prijava od 3. 7. također visi nespojeno
fix/zs-prijave-limit — jedan commit, 9 datoteka, +184/−52: uvodi gornju granicu prijava po smjeni i obavijest koordinatoru, dira api/signup.ts, api/shifts.ts i testove. Sukobljava se s našom granom na 3 mjesta, jer su obje dirale endpointe za prijave.
02Kako povući zadnji kod
Jezgra se spaja čisto. Sukobi su samo u sučelju i dokumentaciji — pet datoteka.
git fetch origin --prune
git checkout feature/zs-karta-sadnje
git merge origin/mainTaj merge javlja 5 sukoba: .gitignore, README.md, mobile/src/screens/Karta.tsx, web/src/karta.js, web/src/index.html. Sve ostalo — cijeli zs-core s migracijama V3/V4/V5 — spaja se automatski, što je i najvrjedniji dio.
map-picker.js) i odbaci našu verziju s popisom parcela — mainova je već u produkciji, pokrivena testovima i uklapa se u ostatak sučelja koji je otišao na kartu. Zadrži sve ostalo s grane. Isto vrijedi za README.md: main je upute za agente prebacio u AGENTS.md, pa naše izmjene dokumentacije idu u tu datoteku.
Nakon toga ide PR. Granu s ograničenjem prijava treba spojiti prvo (manja je i starija), pa onda našu na već spojen main — obrnutim redom razrješavaš iste sukobe oko prijava dvaput.
03Kako sustav radi
Tri aplikacije nad jednom jezgrom. Osobni podaci volontera nikad ne izlaze van — baza ih čuva, objava rendera javni katalog, sync nosi samo njega.
Tri aplikacije
- Portal (statičke stranice) — ono što posjetitelj vidi: akcije, karta, prijave, obavijesti, pretraga. Jedino ovo ide na produkciju.
- Admin panel (Node, port 4500) — lokalni alat za koordinatore nad
data/, nikad se ne deploya. - Mobilna aplikacija (React Native) — prijava, smjene, GPS zapis sadnje, sync. Jezgra
zs-corenosi svu logiku: 58 funkcija uSession, 34 izložene kroz HTTP API za portal i admin panel.
04Shema baze
SQLite u data/zs.db, 16 tablica, migracije V1→V5 u jednoj transakciji. Stupac „verzija" kaže kad je tablica dodana.
| tablica | verzija | čemu služi |
|---|---|---|
| volunteers | V1 | volonteri: ime, kontakt, suglasnost, vještine, dostupnost |
| actions | V1 | akcije sadnje: lokacija, datum, broj sadnica, koordinator, opis |
| action_volunteers | V1 | prijave i poredak — popis je pogled, ne kopija |
| plantings | V1 | zapis sadnje po parceli (samo dodavanje, nikad brisanje) |
| species, planting_species, action_tags | V1 | vrste drveća; planting_species ožičen tek s GPS importom |
| settings, schema_version | V1 | konfiguracija udruge, org_id |
| action_sync | V2 → V4 | pretplate; u V4 ključ postaje (akcija, tim) + scope |
| published_files | V2 → V4 | što je portal objavio; u V4 po odredištu objave |
| sync_state | V2 → V4 | baselines za sync; u V4 po timu |
| gps_tracks, parcel_links | V3 | provenance GPS importa — zato je ponovni import sinkronizacija |
| teams | V4 | više timova po akciji, s koordinatorom u bazi |
| shifts | V4 | smjene i kapaciteti po timu |
| locations | V5 | više lokacija: parcele, rasadnici, zbirna mjesta |
actions, a DROP TABLE uz uključene foreign keyeve kaskadno obriše svaku prijavu na akciju i svaki zapis sadnje. Migracija se zato zagrađuje s PRAGMA foreign_keys OFF. Bez toga se baza otvori bez greške — nad ispražnjenim popisom akcija.
05Rupe u projektu
Poredano po tome što te može stvarno ugristi.
1Pet tjedana nespojenog rada, i to se povećava
Svaki dan bez spajanja znači više divergencije i veću šansu da se neka funkcija napravi dvaput — što se već dogodilo. Dok se ne spoji, GPS import, više timova i lokacije ne postoje u ničemu što pokrećeš s maina.
2backup.sh nikad nije isproban na vraćanju
Noćna kopija baze radi se uredno i skripta javlja uspjeh, ali vraćanje iz kopije nikad nije isprobano na čistom serveru. Ako je kopija nepotpuna, to ćemo saznati tek kad nam zatreba. Jedna proba vraćanja na testnom serveru je jedina prava potvrda.
3GPS čitač nikad nije vidio pravi zapis s terena
Testiran je nad fixture .gpx datotekom koju smo sami generirali po razumijevanju formata. zs gps scan <tvoj.gpx> ništa ne piše — to je prvi korak koji ja ne mogu odraditi umjesto tebe.
4Mobilna aplikacija nije zapakirana
build je konfiguriran za apk i aab, ali nema potpisnog ključa — ovdje postoji samo debug build. Bez potpisa je trgovina aplikacija odbija. Gradi se i pokreće iz izvora; poslati je volonterima još ne možeš.
5Svjesne odgode
- Sync nosi katalog samo zadanog odredišta objave — više njih odjednom treba još plumbanja.
- GeoJSON uvoz granica parcela: čitač postoji i testiran je, uvoz ga još ne zove (čita samo točke sadnje).
SyncOutcome.rejectedisignup_conflictsvide se u CLI-ju, ne u sučelju.- Zajednički pregled svih udruga — odgođen tvojom odlukom, shema je spremna za njega.
06Cilj po zadnjim planovima
Iz dev-docs/plan-timova.md, kako je dogovoreno 3. 6.
Cilj je koordinacija više timova, lokacija i akcija sadnje, gdje nijedna operacija ne objavljuje osobne podatke volontera osim ako to izričito ne zatražiš.
- Akcija je sadnja na jednoj ili više lokacija s popisom prijava pokraj nje. Jedna udruga ih vodi više, aplikacija ih sve zna i prebacuje se između njih.
- Glavni server udruge dvostruko služi: nosi portal posjetiteljima (
web) i istovremeno je kanal za sync među koordinatorima (full— popisi sa svim detaljima). To je ono „ono što se vidi na portalu i ono što se ne vidi". - Prijenos je djelomičan ili potpun, po izboru: mobitel na terenu povuče
webopseg za pregled, koordinatorfullza vođenje akcije. - Objava na bilo koje odredište bilo koje akcije, s oznakom iz kojeg je tima došla. Primatelj ne mora ništa lokalno skidati — akcija postoji na serveru i vidi se kao udaljena; preuzme je ako i kad želi.
- Zajednički pregled (kasnije) agregira sve udruge: koje akcije postoje, njihovi timovi, status po (akcija, tim, opseg), kad je koji koordinator zadnji viđen. Kroz njega zatražiš da tim objavi dio ili cijelu akciju, a drugi je preuzme.
Tri pravila koja to drže na mjestu
- Stabilni id-evi — svaka akcija ima
action_id, svaki timteam_id. Provenance ide u izvještaje operacija, nikad u sinkronizirani sadržaj: id pojedinog uređaja unutar sinkroniziranog dokumenta znači da ista akcija izgleda različito na svakom uređaju i dvije strane si je zauvijek prebacuju. To se doslovno dogodilo i uhvaćeno je u reviewu. - Stanje po (akcija, tim), nikad globalno — pretplate, baselines i evidencija objava.
- Zahtjevi su savjetodavni — zajednički pregled traži, tim izvršava kroz iste
Sessionfunkcije s istim invarijantima. Nijedan novi put pisanja ne zaobilazi jezgru.
zs: prostor imena — nama čitljiv svugdje, a u javni izvoz nikad ne ulazi. Baza ostaje autoritet.
07O sastancima
Provjerio sam kalendar: 12 sastanaka je u lipnju i srpnju, ali kalendar je zajednički za cijelu udrugu i naslovi ne kažu kojem projektu sastanak pripada — od njih se za ovaj projekt sigurno vežu „Pokretanje karte sadnje” (2. 6.), „Timovi i smjene” i „Probna akcija” (oba 24. 6.), a srpanjski niz „Priprema sezone” (14.–16. 7.) vremenski odgovara prelasku dokumentacije na statički host, ali to iz naslova ne mogu potvrditi.
Pouzdan zapis je git: PR-ovi #13–#24 spojeni, dvije grane bez PR-a. Po tome je slika jednoznačna i ne ovisi o tome tko je na kojem sastanku što dogovorio.