#!/usr/bin/env python3
"""Popis prikaza za objavu: jedini izvor za web, PDF, umanjene slike, ZIP i javni izvoz.

Što smije na web i u PDF određuje ručno uređeni popis dist/assets/viz/galerija.json, a ne
sama prisutnost slike u mapi. Slika koje nema u popisu ne objavljuje se, ma što pisalo u
njezinu popratnom JSON-u. Popis po skupinama nosi javni naslov, opis i puni navod izvora
za svaku sliku, pa web i PDF pokazuju isto.

Modul nema vanjskih ovisnosti (samo standardna biblioteka), da ga mogu uvesti i
scripts/build_report.py, scripts/package_project.py i scripts/publish_public.py.

Uporaba:
  python3 scripts/viz/galerija.py            # provjera popisa i ispis stavki
"""
from __future__ import annotations

import json
import sys
from pathlib import Path

ROOT = Path(__file__).resolve().parents[2]
DIST = ROOT / 'dist'
VIZ = DIST / 'assets/viz'
POPIS = VIZ / 'galerija.json'
PROGRAM = ROOT / 'research/viz/program.json'

OZNAKA = 'AI građanski koncept · PRIJEDLOG · nije projekt'
OZNAKA_GENERATIVNO = 'AI ilustracija, generativna dorada, nije dokaz'
NAVOD_GRAD = 'Fotografija: Grad Zagreb, natječajna dokumentacija; montaža: AI građanski koncept, nije projekt ni stav Grada'
NAVOD_OSM = '© OpenStreetMap contributors (ODbL)'

# Puni navodi podloga prema RIGHTS.md; web i PDF ih ispisuju čitljivo uz prikaze.
NAVODI_PODLOGA = [
    ('OpenStreetMap', '© OpenStreetMap contributors, ODbL 1.0 (https://www.openstreetmap.org/copyright). Podloga postojećeg stanja na tlocrtima i zgrade u renderima.'),
    ('Državna geodetska uprava', 'Sadrži informacije tijela javne vlasti u skladu s Otvorenom dozvolom (https://data.gov.hr/otvorena-dozvola). Izvor: Državna geodetska uprava, Digitalni ortofoto 2024. i Visine INSPIRE. Izmijenjeno. Vodeni žig usluge nije uklanjan.'),
    ('EOX', 'EOxCloudless https://cloudless.eox.at by EOX IT Services GmbH (Contains modified Copernicus Sentinel data 2016), CC BY 4.0. Izmijenjeno: isječak.'),
    ('Copernicus', 'produced using Copernicus WorldDEM-30 © DLR e.V. 2010-2014 and © Airbus Defence and Space GmbH 2014-2018 provided under COPERNICUS by the European Union and ESA; all rights reserved. The organisations in charge of the Copernicus programme by law or by delegation do not incur any liability for any use of the Copernicus WorldDEM-30.'),
    ('Kote terena', 'Geotehnički elaborat GEL-33/2025, prilog 7.1 (natječajna dokumentacija Grada Zagreba). Prava na izvornik ostaju nositeljima.'),
]
NAPOMENA_PODLOGA = 'Nijedan izvor podataka ne podržava koncept niti je sudjelovao u njegovoj izradi. Uvjeti korištenja su u datoteci RIGHTS.md.'

# vrsta -> natpis iznad naslova slike
VRSTE = {
    'montaza': 'FOTOMONTAŽA NA SNIMCI IZ ZRAKA',
    'montaza_priblizna': 'FOTOMONTAŽA · KAMERA PRIBLIŽNA',
    'render': 'RENDER NA MODELU TERENA',
    'render_oci': 'RENDER S VISINE OČIJU · NIJE FOTOGRAFIJA',
    'shema': 'SHEMA IZ PROGRAMA',
    'generativno': 'AI ILUSTRACIJA · GENERATIVNA DORADA · NIJE DOKAZ',
}
MAPE = ('pogledi', 'generativno')
# Nastavci imena koji ne smiju biti glavna slika stavke: snimka bez montaže nikad se ne objavljuje sama, a par
# danas/vizija (M31) objavljuje se samo kao polje "usporedba" uz montažu, s istim navodom.
ZABRANJENI_NASTAVCI = ('_danas.jpg', '_danas.jpeg', '_danas.png', '_danas_vizija.jpg', '_danas_vizija.jpeg', '_danas_vizija.png')
NASTAVAK_USPOREDBE = '_danas_vizija.jpg'

# Javni opisi razina (bez internih oznaka odluka). Ključ je id razine u program.json.
# gumb: kratki natpis; naslov: puni naziv; opis: jedna do dvije rečenice.
RAZINE = {
    'BOR': ('Borongaj', 'Hala Borongaj', 'Hala na današnjoj razini tla: tramvajsko okretište, autobusni terminal i toplo predvorje. Park je iznad, na oko 124 m n. v. Ništa nije ukopano.'),
    'BAZ': ('Bazen i dvorane', 'Bazen i sportski grad', 'Bazen Svetice ostaje u otvorenom dvorištu na današnjem tlu. Uz njega su Sportska ulica, rukometna arena, višenamjenska dvorana i male dvorane ispod parka.'),
    'TLO': ('Ulica i stadion', 'Ulica i stadion', 'Maksimirska i okretište linije 5 ispod pokrova, igralište, predvorja, Trg zdravlja, Navijačka ulica, muzeji i prizemna etaža garaža. Kota 118,0 je radna kota poda ove razine; kolnik Maksimirske je na 118,2 do 120,2 m n. v.'),
    'M1': ('Garaže, 1. kat', 'Garaže, prvi kat', 'Prvi kat garaža pod podijem (druga od četiri etaže garaže jug) i galerija nad toplom avenijom.'),
    'M2': ('Garaže, 2. kat', 'Garaže, drugi kat', 'Drugi kat garaža, gornje prizemlje stadiona, galerije dvorana i gornji kat muzeja.'),
    'M3': ('Garaža, 3. kat', 'Garaža jug, treći kat', 'Najviša, četvrta etaža garaže jug, samo pod trening-terenom s umjetnom travom.'),
    'PARK': ('Park i podij', 'Park i podij', 'Površina novog parka: podij oko stadiona na 128,5, pokrov Maksimirske na 127,1 do 128,2, atletski stadion, Sportski brijeg, trening-teren i park nad Borongajem. Otvoreni sportovi, staze, svjetlarnici i igrališta. List uz trening-teren još navodi hokej na travi; autor ga je 15.11.2026. premjestio izvan obuhvata, a listovi će se ispraviti u sljedećoj inačici programa.'),
    'ST1': ('Stadion, srednji prsten', 'Stadion, srednji prsten', 'Srednji prsten gledališta s ložama i medijima. Nacrtano grubo; PRETPOSTAVKA.'),
    'ST2': ('Stadion, gornji prsten', 'Stadion, gornji prsten', 'Gornji prsten gledališta i gornji obodni hodnik. Nacrtano grubo; PRETPOSTAVKA.'),
}
# Presjeci: ime lista -> (gumb, naslov, opis). Na listovima nose oznake P1 do P4; na webu se zovu po mjestu,
# da se ne miješaju s etažama garaže.
PRESJECI = {
    'P1-1-cijeli': ('Kroz Maksimirsku', 'Presjek kroz Maksimirsku', 'Sjever – jug kroz Maksimirsku, pokrov, podij i igralište. Od kolnika do površine parka je oko 7,8 m; tramvaj i cesta ostaju ispod pokrova.'),
    'P2-1-cijeli': ('Kroz bazen i stadion', 'Presjek kroz bazen i stadion', 'Zapad – istok kroz bazen Svetice, stadion i istočni rub. Bazen ostaje na 116 m n. v. u otvorenom dvorištu.'),
    'P3-1-cijeli': ('Kroz garažu i Borongaj', 'Presjek kroz garažu jug i Borongaj', 'Sjever – jug kroz trening-teren, četiri etaže garaže jug i halu Borongaj. Ništa nije ispod današnjeg tla.'),
    'P4-1-cijeli': ('Kroz Sportski brijeg', 'Presjek kroz Sportski brijeg', 'Sjever – jug kroz dvorište bazena, Sportski brijeg i rukometnu arenu pod njim.'),
}


class PogreskaPopisa(ValueError):
    pass


def hr_broj(x: float) -> str:
    return f'{x:.1f}'.replace('.', ',')


def _tekst(v, polje: str, gdje: str) -> str:
    if not isinstance(v, str) or not v.strip():
        raise PogreskaPopisa(f'{gdje}: polje "{polje}" mora biti neprazan tekst')
    return ' '.join(v.split())


def ucitaj(strogo: bool = True) -> list[dict]:
    """Skupine s provjerenim stavkama. Bez datoteke popisa vraća prazan popis."""
    if not POPIS.is_file():
        return []
    try:
        d = json.loads(POPIS.read_text(encoding='utf-8'))
    except json.JSONDecodeError as ex:
        raise PogreskaPopisa(f'{POPIS}: neispravan JSON ({ex})') from ex
    skupine, vidjene = [], set()
    for s in d.get('skupine', []):
        gdje_s = f'skupina "{s.get("id")}"'
        stavke = []
        for st in s.get('stavke', []):
            gdje = f'{gdje_s}, stavka "{st.get("id")}/{st.get("datoteka")}"'
            mapa, ime = st.get('mapa'), st.get('datoteka')
            if mapa not in MAPE:
                raise PogreskaPopisa(f'{gdje}: mapa mora biti jedna od {MAPE}')
            if not isinstance(ime, str) or '/' in ime or '..' in ime:
                raise PogreskaPopisa(f'{gdje}: datoteka mora biti ime datoteke bez putanje')
            vrsta = st.get('vrsta')
            if vrsta not in VRSTE:
                raise PogreskaPopisa(f'{gdje}: vrsta mora biti jedna od {sorted(VRSTE)}')
            if (mapa == 'generativno') != (vrsta == 'generativno'):
                raise PogreskaPopisa(f'{gdje}: vrsta "generativno" ide samo uz mapu "generativno" i obratno')
            if ime.lower().endswith(ZABRANJENI_NASTAVCI):
                raise PogreskaPopisa(f'{gdje}: slika bez montaže ili usporedni par s tuđom fotografijom ne objavljuje se')
            put = VIZ / mapa / ime
            if strogo and not put.is_file():
                raise PogreskaPopisa(f'{gdje}: nema datoteke {put.relative_to(ROOT)}')
            if (mapa, ime) in vidjene:
                raise PogreskaPopisa(f'{gdje}: ista slika navedena dvaput')
            vidjene.add((mapa, ime))
            stavka = {
                'id': _tekst(st.get('id'), 'id', gdje), 'mapa': mapa, 'datoteka': ime, 'vrsta': vrsta,
                'naslov': _tekst(st.get('naslov'), 'naslov', gdje), 'opis': _tekst(st.get('opis'), 'opis', gdje),
                'navod': _tekst(st.get('navod'), 'navod', gdje), 'put': put, 'popratni': None,
            }
            if st.get('fotografija') == 'grad' and NAVOD_GRAD not in stavka['navod']:
                raise PogreskaPopisa(f'{gdje}: montaža na snimci Grada mora nositi navod "{NAVOD_GRAD}"')
            if vrsta in ('montaza', 'montaza_priblizna') and st.get('fotografija') not in ('grad', 'commons'):
                raise PogreskaPopisa(f'{gdje}: montaža mora imati polje "fotografija": "grad" ili "commons"')
            pop = st.get('popratni')
            if pop:
                pput = VIZ / mapa / pop
                if strogo and not pput.is_file():
                    raise PogreskaPopisa(f'{gdje}: nema popratne datoteke {pput.relative_to(ROOT)}')
                if pput.is_file():
                    pj = json.loads(pput.read_text(encoding='utf-8'))
                    if isinstance(pj, dict) and pj.get('za_objavu') is False:
                        raise PogreskaPopisa(f'{gdje}: popratni JSON kaže "za_objavu": false')
                    # popratni JSON može nositi i oznaku po slici (polje "slike")
                    for sl in (pj.get('slike') or []) if isinstance(pj, dict) else []:
                        if isinstance(sl, dict) and sl.get('datoteka') == ime and sl.get('za_objavu') is False:
                            raise PogreskaPopisa(f'{gdje}: popratni JSON za ovu sliku kaže "za_objavu": false')
                stavka['popratni'] = pput
            usp = st.get('usporedba')
            stavka['usporedba'] = None
            if usp:
                if vrsta not in ('montaza', 'montaza_priblizna'):
                    raise PogreskaPopisa(f'{gdje}: usporedba danas/vizija ide samo uz montažu')
                if not isinstance(usp, str) or '/' in usp or not usp.endswith(NASTAVAK_USPOREDBE):
                    raise PogreskaPopisa(f'{gdje}: usporedba mora biti ime datoteke koje završava na {NASTAVAK_USPOREDBE}')
                uput = VIZ / mapa / usp
                if strogo and not uput.is_file():
                    raise PogreskaPopisa(f'{gdje}: nema usporedbe {uput.relative_to(ROOT)}')
                stavka['usporedba'] = uput
            stavke.append(stavka)
        skupine.append({
            'id': _tekst(s.get('id'), 'id', gdje_s), 'naslov': _tekst(s.get('naslov'), 'naslov', gdje_s),
            'napomena': ' '.join(str(s.get('napomena') or '').split()), 'stavke': stavke,
        })
    return skupine


def stavke(skupine: list[dict] | None = None) -> list[dict]:
    return [st for s in (ucitaj() if skupine is None else skupine) for st in s['stavke']]


def datoteke_za_objavu() -> set[str]:
    """Putanje (od korijena repoa) slika i popratnih JSON-ova koji smiju u ZIP i javni izvoz."""
    out = {POPIS.relative_to(ROOT).as_posix()} if POPIS.is_file() else set()
    for st in stavke():
        out.add(st['put'].relative_to(ROOT).as_posix())
        if st['popratni']:
            out.add(st['popratni'].relative_to(ROOT).as_posix())
        if st['usporedba']:
            out.add(st['usporedba'].relative_to(ROOT).as_posix())
    return out


def listovi() -> list[dict]:
    """Listovi tlocrta i presjeka za web i PDF, redom: razine od najniže, zatim presjeci."""
    program = json.loads(PROGRAM.read_text(encoding='utf-8'))
    out = []
    for r in program['razine']:
        nadjeni = sorted((VIZ / 'tlocrti').glob(f'T??-{r["id"].lower()}-0-pregled.png'))
        gumb, naslov, opis = RAZINE.get(r['id'], (r['naziv'], r['naziv'], ''))
        kota = hr_broj(float(r['kota_poda_mnv']))
        out.append({'ime': nadjeni[0].stem if nadjeni else None, 'kljuc': r['id'], 'skupina': 'razine', 'gumb': gumb,
                    'naslov': f'{naslov} · {kota} m n. v.', 'opis': opis, 'karta': True,
                    'kota': float(r['kota_poda_mnv']), 'kota_hr': kota})
    for ime, (gumb, naslov, opis) in PRESJECI.items():
        out.append({'ime': ime if (VIZ / 'tlocrti' / f'{ime}.png').is_file() else None, 'kljuc': ime, 'skupina': 'presjeci',
                    'gumb': gumb, 'naslov': naslov, 'opis': opis, 'karta': False})
    nema = [l['kljuc'] for l in out if not l['ime']]
    if nema:
        raise PogreskaPopisa('nedostaju listovi tlocrta u dist/assets/viz/tlocrti/ za: ' + ', '.join(nema))
    return out


def main() -> None:
    try:
        sk = ucitaj()
        ls = listovi()
    except PogreskaPopisa as ex:
        sys.exit(f'POGREŠKA: {ex}')
    if not sk:
        print(f'nema popisa {POPIS.relative_to(ROOT)}: pogledi se ne objavljuju')
    for s in sk:
        print(f'{s["id"]}: {s["naslov"]} ({len(s["stavke"])})')
        for st in s['stavke']:
            print(f'   {st["mapa"]}/{st["datoteka"]}  [{st["vrsta"]}]  {st["naslov"]}'
                  + (f'  + usporedba {st["usporedba"].name}' if st['usporedba'] else ''))
    print(f'listova tlocrta i presjeka: {len(ls)}')


if __name__ == '__main__':
    main()
