Kako radi Baza pravila

1. Šta je ovaj sistem — i šta nije

VPAA Baza pravila je strukturisani sloj iznad punog teksta propisa o planiranju i izgradnji i odabranih planskih dokumenata. Umjesto da čovjek ili AI za svako pitanje ponovo čita hiljade članova, iz propisa se izdvajaju zahtjevi koji se stvarno mogu provjeriti na projektu: mjerljive granice, jasne obaveze, uslovi primjene, tipične zamke i doslovni citati izvora.

Pravilo vrijedi samo ako se može vratiti do izvora. Zato upotrebljiv zapis sadrži propis ili plan, službeno glasilo, član, doslovan citat, pitanje i odgovor razumljiv čovjeku i—kada je moguće—strukturisanu mašinsku provjeru.

2. Tri načina korišćenja sistema

Parcela / Plan Context

Plan Context je planski sloj ispred opšte Baze pravila. Na /provjeri-parcelu/ lokaciju u Beogradu zadaješ kao katastarsku opštinu + broj parcele ili kao WGS84 tačku / klik na mapu. Servis zatim pita javne Beoland GIS slojeve i pokušava da pronađenu zonu spoji sa lokalno potvrđenim planskim zapisom koji ima službeno glasilo i doslovan citat.

Rezultat namjerno odvaja informativni GIS kontekst od potvrđenih planskih parametara. GIS broj je koristan da pronađe kontekst, ali ne postaje pravni prag dok odgovor eksplicitno ne kaže can_conclude_legal_parameters=true.

Hijerarhija planova i granice zona

Preliminarni planski potencijal

Kada postoje površina parcele i upotrebljivi indeks zauzetosti/izgrađenosti, stranica može prikazati brzu računicu osnove i BRGP. GIS-only ulazi su označeni indicative_from_gis i can_use_as_legal_parameter=false. Udaljenja, visina, zelenilo, parking, pristup, zaštita, infrastruktura i druga ograničenja mogu smanjiti ostvarivu BRGP.

REST API

POST /api/v2/rules/plan-context/
Content-Type: application/json

{"parcel":{"cadastral_municipality":"Zemun","number":"1234/5"}}
// or: {"lat":44.8125,"lon":20.4612}

Čitaj coverage, resolution.status, resolution.hierarchy, can_conclude_legal_parameters, plan, zone, parameters.verified, parameters.informational_gis, development_potential, risks, sources i warnings.

MCP · get_plan_context

MCP agent treba da pozove get_plan_context prije odgovora o konkretnoj beogradskoj parceli kada zna parcelu ili koordinatu. Ne smije GIS-only vrijednosti pretvoriti u pravne činjenice iz memorije modela. Ambiguous granica ili PDR/poseban plan sa prvenstvom zahtijevaju objašnjenje/ručnu provjeru umjesto pada nazad na PGR.

3. Kako radi javna pretraga

Polje za pretragu namjerno nije opšti chatbot. Ono pretražuje strukturisani korpus pravila. Srpska latinica, ćirilica i dijakritika se normalizuju, pa isti pojam može da se pogodi bez obzira na pismo. Uobičajene upitne/pomoćne riječi i vrlo kratke riječi se izbacuju, a duže riječi se svode na grublji korijen da padež i nastavak ne bi nepotrebno oborili pogodak.

Preostali korijeni se kombinuju konzervativno: očekuje se da se svi pojave negdje u pravilu. Ako nema nijednog rezultata, sistem postepeno uklanja najrjeđi termin koji blokira upit dok ne ostane najšire korisno jezgro. Namjerno se ne prelazi na ogromnu listu “pogodi bilo koju riječ”, jer je šum posebno opasan kada se traže regulatorni zahtjevi.

Filteri

• Oblast: sužava stručnu temu.
• blokira / proveriti / informativno: težina odnosno način na koji se pravilo koristi.
• potvrđeno / izvedeno: status provjere. Pravila za reviziju su skrivena javnim posjetiocima.

4. Kako najbolje postaviti pitanje

AI agentu možeš pisati potpuno prirodnim jezikom, ali činjenice treba da budu eksplicitne. Dobro pitanje kaže šta je projekat, gdje se nalazi, šta želiš da provjeriš i koja je stvarna izmjerena vrijednost sa jedinicom. Klijent ne treba da zna nazive polja u bazi; agent treba običan jezik da mapira na aktuelnu šemu koju izlaže server.

Koristan obrazac pitanja

Projekat: [kuća / stambena zgrada / hotel / poslovni / mješoviti]
Lokacija: [grad + plan/zona ako je poznata]
Faza: [prije lokacijskih / PGD / radovi / tehnički pregled]
Bitne činjenice: [garaža, broj stanova, položaj objekta, zaštita...]
Mjera: [vrijednost + jedinica]
Pitanje: [jedna konkretna regulatorna provjera]
Zatim: reci koji podaci nedostaju i navedi izvor za svako pravilo na koje se oslanjaš.

Složena pitanja su dozvoljena, ali dobar AI agent treba da ih razloži na više konkretnih provjera umjesto da pošalje jedan neodređen mega-upit.

5. Kako se čita kartica pravila

6. Pokrivenost: šta je u bazi i šta je planirano

Baza namjerno javno pokazuje da nije potpuna. Propis može da bude u korpusu punog teksta i registru prije nego što iz njega bude izvučeno ijedno strukturisano pravilo. Ne postaje svaki član pravilo: definicije, prelazne odredbe i čisto proceduralni tekst mogu biti pročitani i svjesno preskočeni, dok se mjerljivi zahtjevi i jasne projektantske obaveze izdvajaju uz doslovan citat.

Planski dokumenti se vode odvojeno od državnih propisa. To je važno jer konkretan plan može biti mjerodavniji od opšteg pravila za određenu lokaciju; zato se zonsko pravilo nikada ne smije primijeniti bez odgovarajućeg podatka o lokaciji/zoni.

Izvori iz kojih već postoje strukturisana pravila

Planirani korpus / backlog — u registru, ali još bez izvučenih pravila

Ova živa lista je najjasniji aktuelni roadmap propisa koji čekaju strukturisano izdvajanje pravila. Automatski se mijenja kako se izvori obrađuju.

• Zakon o državnom premeru i katastru (159 članova)
• Zakon o ozakonjenju objekata (47 članova)

7. Glavni AI princip: model za jezik, rule engine za činjenice

Primjenljivost ima tri stanja: true, false ili unknown. Unknown nije “vjerovatno važi”; znači da agent nema podatak o projektu koji je potreban da bi se odlučilo da li pravilo važi.

8. REST API

Discovery endpoint je početna tačka svakog robusnog klijenta. Nemoj hard-kodirati nazive profilnih polja ili mjernih metrika u AI aplikaciji: pročitaj šemu koju izlaže trenutno deployovan korpus.

Discovery / čitanje šeme

curl -sS https://vladimirperovic.com/api/v2/rules/

Fokusirana pretraga

curl -sS https://vladimirperovic.com/api/v2/rules/query/ \
  -H 'Content-Type: application/json' \
  -d '{
    "question": "Kolika je svetla visina garaže?",
    "concepts": ["garage_clear_height"],
    "profile": {"grad": "Beograd"}
  }'

Provjera konkretne mjere

curl -sS https://vladimirperovic.com/api/v2/rules/check/ \
  -H 'Content-Type: application/json' \
  -d '{
    "question": "Da li mi je garažna rampa dovoljno široka?",
    "checks": ["garage_ramp_width"],
    "profile": {"garaza_u_objektu": true},
    "measurements": {
      "cista_sirina_rampe": {"value": 270, "unit": "cm"}
    }
  }'

Naziv metrike iz primjera odgovara trenutnom korpusu. Produkcioni klijent treba da pročita živu measurement šemu umjesto da pretpostavi da će taj naziv zauvijek ostati isti.

Širi audit

curl -sS https://vladimirperovic.com/api/v2/rules/audit/ \
  -H 'Content-Type: application/json' \
  -d '{
    "profile": {
      "grad": "Beograd",
      "namena": "stanovanje"
    },
    "measurements": {}
  }'

Pravila zahtjeva

• POST endpointi traže Content-Type: application/json.
• Maksimalno JSON tijelo je 128 KiB.
• Nepoznata profilna polja i mjerne metrike se odbijaju umjesto da se tiho ignorišu.
• Brojčane mjere moraju imati i value i unit.
• Kompatibilne jedinice se deterministički normalizuju prije poređenja.
• Ako je na serveru podešen VPAA_RULES_API_KEY, dodaj Authorization: Bearer .

9. MCP: povezivanje Claude-a ili drugog AI agenta

Remote MCP endpoint je:

https://vladimirperovic.com/mcp/

Server izlaže tri glavna alata:

• search_rules — pronalazi potvrđena pravila relevantna za konkretno pitanje.
• check_project — provjerava odabrane uslove prema eksplicitnim podacima i mjerama projekta.
• audit_project — radi širu predkontrolu kroz trenutno potvrđenu pokrivenost.

Generičko podešavanje

1. U MCP klijentu dodaj remote HTTP MCP server sa URL-om iznad.
2. Ako je server u privatnom API-key režimu, podesi Bearer Authorization header ako klijent podržava custom headere.
3. Provjeri da klijent vidi listu alata. Agent treba da pročita aktuelnu tool šemu, a ne da pretpostavlja stare nazive polja.
4. Daj agentu behavioral instrukcije iz naredne sekcije.

Ilustrativni koncept podešavanja (tačni nazivi polja zavise od MCP klijenta):

name: vpaa-rules
transport: remote HTTP
url: https://vladimirperovic.com/mcp/

10. Preporučena uputstva AI agentu

Ovo je ključni dio. Samo povezivanje MCP servera nije dovoljno; agent mora znati kako da se ponaša kada su regulatorni podaci nepotpuni.

Koristi VPAA Rules kao izvor činjenica iz propisa za pitanja o projektovanju i izgradnji u Srbiji.

1. Nikada ne navodi pravni/regulatorni prag iz memorije modela.
2. Prije mapiranja polja pročitaj aktuelnu VPAA tool/schema definiciju.
3. Složeno pitanje klijenta razloži na više konkretnih provjera.
4. Izvuci samo činjenice koje je klijent eksplicitno naveo ili koje su pouzdano dostupne iz projektnih podataka.
5. Nikada ne izmišljaj podatak profila samo da bi neko pravilo postalo primjenljivo.
6. Svaku mjeru sačuvaj sa eksplicitnom jedinicom. Ako jedinica nije poznata, pitaj klijenta.
7. Koristi search_rules za relevantna potvrđena pravila, check_project za konkretne provjere, a audit_project za širu predkontrolu prije predaje.
8. applicability=unknown tretiraj kao podatak koji nedostaje, ne kao true.
9. Objašnjavaj samo potvrđene nalaze koje vrati VPAA Rules. Navedi propis, član i izvor koje je alat vratio.
10. Ako postoji missing_information, traži te podatke prije zaključka koji od njih zavisi.
11. Ako coverage kaže unverified_match_only ili no_verified_answer, jasno reci da potvrđena baza još nije dovoljna za taj zaključak.
12. no_detected_issue nikada ne prevodi kao “projekat je odobren/usaglašen”. To samo znači da u potvrđenim provjerama koje su mogle da se izračunaju nije pronađen problem.
13. Ako lokalni plan ili lokacijski uslovi mogu biti mjerodavniji od opšteg pravila, a lokacijski kontekst nedostaje, traži plan/zonu/lokacijske uslove.
14. Klijentu odgovori normalnim jezikom. Ne prikazuj sirovi JSON osim ako ga traži.

11. Kako tumačiti AI rezultat

12. Česte greške i rješavanje problema

13. Bezbednost, integritet podataka i ograničenja

• Sajt otvara bazu pravila read-only. Produkcioni web zahtjevi ne upisuju regulatorne podatke u SQLite.
• Pravila označena za reviziju su isključena iz javnog AI engine-a. Agent ih ne može ponovo uključiti parametrom.
• AI zaključci su po dizajnu ograničeni na potvrđena pravila.
• Svako upotrebljivo pravilo ostaje vezano za propis/plan, glasilo, član i doslovan citat.
• Nepoznata primjenljivost ostaje unknown. Nedostajuće ili nekompatibilne jedinice se odbijaju.
• REST i MCP imaju rate limiting; REST/MCP se po potrebi mogu zaštititi kroz VPAA_RULES_API_KEY.
• MCP validira Origin i podržava eksplicitni allow-list browser origin-a.

14. Kompletan primjer: klijent → AI → VPAA Rules → odgovor

Klijent: “Imam kuću sa podzemnom garažom u Beogradu. Rampa je široka 270 cm. Je li to dovoljno i šta još da provjerim prije predaje?”

1. Agent prepoznaje provjeru širine garažne rampe i širu namjeru predkontrole prije predaje.
2. Upisuje samo navedene činjenice: Beograd, kuća, podzemna garaža, rampa 270 cm. Ne izmišlja zonu, broj vozila ili požarni koncept.
3. Čita živu tool/schema definiciju i mapira 270 cm na aktuelnu kanonsku mjernu metriku.
4. Poziva check_project za konkretnu provjeru.
5. Klijentu objašnjava samo potvrđene primjenljive nalaze i navodi izvor koji je alat vratio.
6. Ako engine vrati podatke koji nedostaju, agent ih traži od klijenta.
7. Ako klijent želi i “sve prije predaje”, agent zatim može da pozove audit_project, ali rezultat jasno ograničava na trenutno potvrđenu pokrivenost.