# GUI

Kodu — kinnisvaraportaal aadressil `kodu.comm.ee` — ja see on tema
kasutusjuhend. Üks toode ja üks raam (KODU-4): otsing, kuulutuse leht ja Minu
konto on sama mööbel eri sisuga.

**Portaalini viib viis nime ja neist neli on keel** (KODU-22).
`kodu.comm.ee` on eestikeelne ja see on nimi, millega iga link vermitakse;
`home.comm.ee` on inglise, `doma.comm.ee` vene ja `dim.comm.ee` ukraina keel.
Sama toode, samad kuulutused, sama konto — muutuvad ainult sõnad, ja iga sõna
on kirjutatud: riba, filtrid, kuulutuse leht, vormid ja tingimused loetakse
selle ukse keeles, kust sisse tulid (KODU-26). Riba keelepill käib uksest üle
ja jäetakse meelde. Viies nimi, `pind.comm.ee`, on see, kuidas portaali ühe
päeva kutsuti; ta vastab endiselt, ei sunni ühtki keelt peale ja järgib sinu
brauseri enda eelistust. Maakondade ja linnaosade *nimed* on ainus, mida
ukraina keeles ei ole: need jäävad eestikeelsele kujule (GAP-196).

See juhend on fail kaustas `projects/kodu/docs/et/` ja see ekraan on tema
lugemine — üks koopia keele kohta, kaks lugemist (KDOC-2, KDOC-13). Juhend on
kirjutatud kõigis neljas keeles, milles portaal on, ja sina loed seda, mille
valisid; sildid on siin tsiteeritud nii, nagu portaal neid selles keeles
ütleb.

Kõik peale kaardi töötab ilma igasuguse JavaScriptita. Iga filter, keelevalija
ja kontomenüü on `<details>`; iga kirjutamine on vorm, mis postitab.

## Riba

Üks navigatsioon, iga ekraani vasakus servas (KODU-18), kandmas postkastirakenduse
riideid: kitsas tulp, ikoon sildi kohal, toon ikoonikastil ja mitte real
(KODU-21).

| Toiming | Kuidas |
|---|---|
| Vali tehing | **Müük · Üür · Uusarendused · Äripinnad**. Avalehel jääb see avalehele ja muudab, millised filtrid paneelil on; mujal on see selle tehingu otsing |
| Ava kaart | **Kaart** — sama otsing, joonistatuna |
| Ava turutabel | **Turuülevaade** |
| Mis sul alles on | **Lemmikud** — arv sõidab ikoonil |
| Müü midagi | **Lisa kuulutus** — riba ainus täidetud kirje |
| Vaheta keelt | **ET / EN / RU / UK** pill oma näo kohal. See näitab keelt, mida sa loed, ja avaneb ülejäänud kolmele (KODU-26); valimine kirjutab aastase küpsise, nii et ka järgmine leht on selles keeles |
| Kõik sinu kohta | Sinu nägu, jala juures |

Sinu nägu avaneb valikutele **Minu konto · Konto seaded · Minu bürood · Arved
· Assistent · Dokumentatsioon · Tingimused · Logi välja** — neli esimest on
sinu enda juured, igaüks oma ekraan (KODU-109), ja operaatorile seisab nende
järel **Admin** (KODU-108). Külalisele pakutakse selle asemel **Logi sisse ·
Dokumentatsioon · Tingimused** — tee sisse ja kaks lehte, mis on avalikud.

Ekraanil, mis on kitsam kui 860px, heidab riba pikali alumiseks ribaks ning
Uusarendused, Äripinnad ja Turuülevaade kolivad samasse volti, joone alla, mis
ütleb, et nad on riba ülejääk ja mitte sinu oma. Alla 560px kaovad sõnad ja
ikoonid seisavad nende eest; ♥ arv jääb, sest see on ribal ainus asi, mida
lugeja joonistuselt välja ei loe.

## Assistent

Sisse logitud lugeja igal ekraanil, all paremas nurgas: vajutus avab paneeli
lehe **kõrvale** ja mitte selle peale — leht ise jääb loetavaks, sest sa küsid
tavaliselt just selle kohta, mida sa parasjagu vaatad. Telefonis paneeli jaoks
kõrvalruumi ei ole, seega võtab ta ekraani.

| Toiming | Kuidas |
|---|---|
| Küsi midagi | Kirjuta kasti ja vajuta saatmisnoolt. Robot otsib turult, loeb kuulutusi ja piirkondi ning vastab portaali juhendi järgi |
| Vaata ajalugu | **Assistent** pealkirja all olev volt — sinu varasemad vestlused, uusim ees, ja **New chat** alustab uue |
| Ava vestlus mujalt | Iga rida on ka päris aadress `/assistant?c={number}`, nii et ta töötab ka väljalülitatud skriptimisega |
| Sulge | ✕ paneeli päises või Escape |
| Vaheta mudelit | **Assistent** nime paremas servas on hammasratas — assistendi seaded. Esimesena on seal, mis mudel vastab. Kui neid on rohkem kui üks, on see valik — vali teine ja järgmine küsimus läheb sinna. Valik jääb sinu külge, mitte vestluse külge |

Paneel käib sinuga lehelt lehele kaasa ja jääb samale vestlusele: seda peetakse
meeles küpsises `commee_dock`, mitte aadressil. **Assistent** riba menüüs ja
lehe jalas avab seesama paneeli.

**Robot võib avada lehe enda kõrval.** Kui palud otsingut, kuulutust või Lisa
kuulutus vormi, avaneb see sinu poolel ekraanist niipea, kui vastus on valmis
— sama aadress, mille ekraan ise oleks kirjutanud, samade filtritega. Aadressi
ta välja ei mõtle: ta nimetab ekraani ja selle enda argumendid ning portaal
koostab tee, nii et vestlusest ei saa tulla linki portaalist välja. Leht
avaneb **sinuna**: see, mida sa aadressi ise kirjutades ei näeks, ei avane ka
nii.

Robot loeb, aga ei muuda midagi ise: iga muudatus kirjutatakse üles kinnitust
ootama, ja kinnitamise ekraan ei ole veel valmis (GAP-181), nii et praegu on
assistent portaalis lugeja ja mitte kirjutaja. Kõige lähemal kirjutamisele on
Lisa kuulutus vormi täitmine: kastid tulevad ette ehitisregistri vastusega ja
**Avalda** on ikka sinu vajutus. Kui mudelit pole ühendatud, ütleb paneel seda
ausalt.

## Otsing (avaleht, `/`)

Filtririba, pealkiri, kohad, mida enamik küsib, ja selle tehingu uusimad
kuulutused, mida sa parasjagu vaatad.

**Filtrid on ekraani ülaosa** (KODU-23) ja **nad kõik on seal** (KODU-28). Nad
jooksevad üle lehe kogu laiuse, lamedad ja kandilised, voolates vasakult
paremale ja murdudes alla — iga filter, mis portaalil on, **Otsi** voolust
paremal — ning pealkiri nende all, mitte nende kohal. Miski ei oota enam
"Rohkem filtreid" voldi taga.

**Filter on üks küsimus, seega on ta oma sõnad** (KODU-20, KODU-28). Ei kasti,
ei tausta, ei nooleotsa — silt väike ja vaikne, väärtus lehe enda tindis:
`Kinnisvara tüüp kõik` seni, kuni midagi on valitud, ja `Kinnisvara tüüp
Korter, Maja` pärast seda. Sõnadele vajutamine hüpitab valikud lahti; see, mis
juba valitud on, istub ülal, igaüks kandmas **×**, mis ta ära võtab. Vajutus
kuhugi mujale paneb selle kinni.

**Paneel otsib ise ja ekraan jääb paigale** (KODU-24, KODU-29). Umbes sekund
pärast viimast muudatust läheb ta küsima — nii et Korteri linnukesele
vajutamine ja siis Maja järele sirutamine on üks otsing, mis kannab mõlemat,
mitte kaks — ja tagasi tuleb *vastus*: paneeli all olevad tulemused muutuvad,
aadress muutub ja menüü, millest sa parasjagu valid, jääb sulle kätte
lahti. Ekraanil ei ole otsingunuppu (KODU-36) — paneeli enda otsimine *on*
otsing — kuigi Enter mis tahes kastis saadab ikka vormi teele, ja seda teeb ka
brauser, milles JavaScripti ei jookse, läbi nupu, mis sõidab kaasa ekraanilt
väljas. **Piirkonnad** on ainus filter, mille kell rahule jätab — see valitakse
*läbi* ja mitte ühe liigutusega, seega **Kinnita valik** on see, mis ta
rakendab, ja kuni tema ekraan on lahti, ei rakenda selle all ka miski muu.

**Piirkonnad avanevad terve ekraanina** (KODU-25). Puu vasakul; paremal seesama
kaart, mida iga teine ekraan joonistab (KODU-36) — maakond on number,
vajutamine tõmbab maakonna täis ja see, mis su praeguste filtritega müügis on,
on tema peal — ja **Kinnita valik** all paremas nurgas on see üks vajutus, mis
valiku rakendab ja vastusega tagasi tuleb. Selle ekraani ülemises paremas
nurgas olev **×** lahkub ilma otsimata, ja Escape teeb sedasama. Puu on see,
mis valib; kaart on see, kust vaadatakse.

| Toiming | Kuidas |
|---|---|
| Vali kinnisvara tüübid | **Kinnisvara tüüp** — Korter, Maja, Majaosa, Krunt, Suvila, Garaaž elutehingutel; Büroo, Kauplus, Ladu, Tootmine Äripindadel. Kaht komplekti ei segata kunagi |
| Vali piirkonnad | **Piirkonnad** — avaneb terve ekraanina, oma nimi üle pea: vasakul puu maakond → linn või vald → linnaosa, paremal elav kaart, all **Kinnita valik**. Valimiseks tee puusse linnuke **või vajuta kohale kaardil** — number või maa, kumbki valib, ja uus vajutus võtab valiku maha (KODU-41); kaart ütleb seda iseenda peal, sest otsingukaardil sama vajutus hoopis suurendab (KODU-44). Valitu on joonistusel valgustatud. Kirjuta kasti, et puud kitsendada (täpitähtede suhtes pime, ja ta avab voldid, mille sees vaste on). Valitud piirkonnad on kiipidena ×-ga. Järjestatud selle järgi, kui palju kuulutusi neis on, mitte tähestikuliselt. Telefonis on ainult puu |
| Sea hind | **Hind** — üks nupp, mis ütleb ühe fraasi (`kuni 350 000 €`, `alates 100 000 €`). Tema eelseaded on tema sees ja seavad sama vahemiku, mille seavad ta kaks kasti. Üüril on hind kuu kohta |
| Toad | **Tube** — 1, 2, 3, 4+ |
| Pind, krunt, ehitusaasta | Igaühel vahemikud kastide all (KODU-31): Kasutuspind `kuni 40 · 40–70 · 70–100 · 100–150 · 150+`, Krundi suurus `kuni 1200 · 1200–3000 · 3000–10 000 · 10 000+`, Ehitusaasta `kuni 2010 · 2011+` |
| Seisukord | **Seisukord** — korraga ükskõik millised neist: `Uus · Renoveeritud · Heas korras · Vajab renoveerimist`; iga valitu kannab oma × |
| Ülejäänu | Korrus, energiaklass, maja tüüp, katuse tüüp ja lisad — ekraanil koos kõige muuga. Rida on igal tehingusakil sama; erineb ainult kinnisvaratüüpide sõnavara, ja filter, millele saab vastata vaid korter või maja (korrus, krunt, seinad), järgib valitud tüüpe, mitte sakki. Möbleeritud on lisa igal tehingul; *Koduloomad lubatud* on ainus lisa, mis on üksnes üüril, *Pakkujad* on vold büroodest, millel on midagi turul, mitu korraga, ja *Otse omanikult* vastab *Jah* või *Ei* — ainult see, mille taga ühtki bürood ei ole, või ainult see, mille taga mõni on (KODU-79, KODU-84) |
| Otsi | Lõpeta filtrite muutmine ja ta otsib sekundi pärast ise, uuendades tulemusi kohapeal. **Otsi** on endiselt vormis, aga ekraanilt väljas (KODU-36): tema on see, mida Enter vajutab, millega ekraanilugeja otsib, ja kogu mehhanism siis, kui skriptimine on väljas. Mitu vastab, on omaette rida ja mitte nupu peal (KODU-34) |
| Alusta otsast | **Tühjenda** |

Millised filtrid olemas on, sõltub sellest, mida sa otsid: korrus ainult
korteritel ja majaosadel, krunt ainult majadel, kruntidel, suvilatel ja
majaosadel, maja- ja katusetüüp ainult hoonetel ning *Möbleeritud* ainult
Üüril. See on üks funktsioon, seega ei saa paneel kunagi pakkuda filtrit, mida
otsing eiraks.

## Tulemused (`/search`)

Kuulutused, seesama filtririba nende kohal, mis on avalehel (KODU-27): sama
paneel, lapikult üle ekraani ülaosa, hoidmas otsingut, mis selle lehe tegi. Ta
rakendab end samamoodi — muuda midagi ja sekundi pärast on tema all uued
tulemused. Enter otsib ükskõik millisest tema kastist, ja just selleks on
ekraanilt väljas olev Otsi (KODU-24, KODU-36).

**Nimekiri / Kaart on üks lüliti ülal** (KODU-32), ja poolele vajutamine
vahetab selle, mis seisab tema *all*: kaardid või kaart, mis joonistab
täpselt sama otsingu — filtripaneel jääb mõlema kohal lahti ja kehtib
mõlemale. Kaart ei kanna midagi peale suurendusnuppude.

**Piirkonnale vajutamine suurendab sinna sisse** (KODU-39): maakond, siis
omavalitsus, siis hooned ise — tema number ja tema kuju teevad sama asja.
Hoonete seas **majale osutamine näitab, mis see on** (KODU-43): väike kaart
nõela kõrval hinna, kuulutuse enda esimese foto ja aadressiga, ja sellele
vajutamine — kaardikesele või nõelale — avab selle kuulutuse. Tab jõuab nõelteni ja näitab sama
kaardikest; Escape paneb selle ära. Nõel, mille taga on mitu, ütleb, mitu neid
on, tema kaardike ütleb, millise vahemiku nad katavad, ja sellele vajutamine
loetleb nad ükshaaval — see nimekiri jääb, kuni sa ta ära saadad, teisele
majale osutad või kaarti liigutad. Kõik muu kaob niipea, kui sa mujale vaatad.
Kaardilt avatud kuulutus tuleb tagasi täpselt sellesse vaatesse, ristkülik
kaasa arvatud.

| Toiming | Kuidas |
|---|---|
| Loe arvu | Filtrite all: "304 kuulutust vastavad otsingule" — mõlemas vaates |
| Vaheta vaadet | **Nimekiri / Kaart** ülal — sama otsing, teine joonistus |
| Sordi | Üks rippmenüü: **Uuemad enne · Odavamad enne · Kallimad enne** |
| Vaheta paigutust | **Kaardid / Nimekiri**, kõrvuti |
| Lehita | **Eelmine / Järgmine** tulemuste all |
| Pane lemmikuks | ♥ kaardil või real. Külaliselt, kes sellele vajutab, küsitakse sisselogimist, ja ta tuleb tagasi samasse kohta nimekirjas |
| Ava üks | Vajuta kaardile või tema nõelale kaardil — või eelvaatekaardikesele, mida nõel osutamisel näitab |
| Mine kaardil sisse | Vajuta piirkonnale, et sinna suurendada, uuesti omavalitsuse jaoks, veel kord majade jaoks; **+ / − / ⤢** nurgas |

Sinu enda kuulutused on märgitud **Sinu kuulutus**. Siin on ainult see, mis on
turul: mustand ja kinnitust ootav kuulutus on sinu konto ekraanil ja mitte
kusagil mujal.

Filter, mida kellelgi ei ole — valesti kirjutatud aadress — tuleb tagasi
paneelina, mis töötab, koos märkusega, mis nimetab sõna, millest aru ei saadud.
Sama teeb lehekülje suurus või kursor, mille otsing tagasi lükkab: mida vale
aadress kunagi ei ütle, on see, et midagi ei vastanud.

Aadress, mis ei kanna üldse tehingut — kirjutatud `/search`, järjehoidjasse
pandud `/search?page=2`, jagatud `/search?view=map` — avab **Müügi**, sellel
ekraanil ja kaardil (KODU-17). Valesti kirjutatud tehing lükatakse endiselt
tagasi.

## Kuulutus (`/listing/{id}`)

Aadress ülal, **♥** tema kõrval, ja siis kaks tulpa (KODU-42). **Vasakul see,
mida vaadatakse**: galerii ja selle all kaart, mis on avatud hoone enda peal,
ainult see üks kuulutus tema peal — sa näed, milline tänav ja milline ots
sellest, enne kui midagi vajutad, ja **+ / −** suurendavad ja vähendavad.
Sellel kaardil ei ole miski vajutatav: sa oled juba lehel, mille tema nõel
avaks. Kuulutusel, mida geokodeerija ei ole kunagi paika pannud, ei ole kaarti
— see on parem kui kaart eikuskilt.

**Paremal see, mida loetakse**, järjekorras, milles küsimused tulevad:
hinnakaart, faktivõre (Tube, **Üldpind**, Korrus, Ehitusaasta, Energiaklass,
Seisukord, Maja tüüp, Katuse tüüp, Lisad), kirjeldus ja maakleri kaart. Mis
veel sarnane on, on mõlema all.

**Kes müüb, on mõlema all esimesena** (KODU-83). Büroo kuulutuse all on sama
büroo teised sama liiki kuulutused — üüri all üürid, müügi all müügid —
maakleri oma all sama maakleri omad, ja eraisiku oma all **Teised otse
omanikult**. Viis tükki, ja kui neid on rohkem, siis rea lõpus **Näita
kõiki** koos arvuga, mis viib turule ainult nende kuulutustega. Maakleri
kaardil on büroo nimi link büroo enda lehele ja maakleri nimi maakleri
omale. Büroo, kes müüb ja üürib oma vara — arendaja, üürileandja, nagu
Lumi Kodud — on **Omanik**, mitte vahendaja: tema kuulutuse all seisab
brändi kõrval **Otse omanikult**, riba on **Sama omaniku teised
kuulutused**, ja filtri **Otse omanikult · Jah** loeb need kaasa. Rolli
ütleb büroo ise oma seadetes (**Roll turul**: Vahendaja või Omanik).
Kuulutus, mille tõi partneri voog, seisab portaali enda kohal — **Kodu
import** — ja mitte ühegi inimese omal: kaardil on büroo, ja kui partner
nimetab oma lehel kontaktisiku, kes siin kohta ei hoia, on tema nimi seal
sõnadena (**Kontakt: …**), ilma näo ja lingita. Kui büroo on sama
aadressiga inimese endale kohale kutsunud, seisab kuulutus tema peal ja
kaart näitab teda nagu iga maaklerit.

Tagasinool viib otsingusse, millest see avati — filtrid, lehekülg, kaardi
ristkülik — ja maandub selle kuulutuse enda kaardil, valgustatuna (KODU-30).

| Toiming | Kuidas |
|---|---|
| Vaata kuumakset | **Kuumakse alates** hinnakaardil — 15% sissemakse, 30 aastat, 4,2%. Hinnang, ja ta ütleb seda |
| Küsi selle kohta | **Saada päring** → sinu e-post ja sõnum. See saadetakse tavalise e-kirjana, sinu aadress vastuseaadressina, nii et vastus tuleb otse sulle ja ei lähe kunagi sellest süsteemist läbi |
| Hoia alles | ♥ |
| Vaata pilte suurelt | Vajuta ükskõik millist fotot või **⤢ 1 / 3** selle nurgas: seesama riba täidab ekraani. **‹ ›**, nooleklahvid või sõrmega libistamine lehitsevad; **Esc**, **×** või vajutus pildi kõrvale sulgevad, ja leht jääb fotole, kuhu sa jõudsid |
| Mine tagasi | Nool, tulemustesse, kust tulid |

Galerii on üks riba, mis näitab korraga ühte fotot — libista seda, keera
rullikut või vajuta **‹ ›** selle peal — ja iga foto pisipilt selle all, kust
hüpata, vaadatav ringiga (KODU-69). Fotodeta kuulutus ütleb seda, selle
asemel et pakkuda juhtnuppu, mis midagi ei tee.

Vana link, poolik jagatud URL või id, mis ei ole number, on portaali enda
**Lehte ei leitud**, portaali enda raamis.

## Büroo (`/provider/{slug}`) ja maakler (`/provider/{slug}/{number}`)

Büroo avalik leht aadressil `/provider/{slug}`: `kodu.comm.ee/provider/lumikodud`
(KODU-83). Logo või nimetähed, **Kinnisvarabüroo**, brändinimi, juriidiline
nimi ja mitu kuulutust turul on; siis iga tehinguliigi kohta, milles neil
midagi on, viis uusimat ja **Näita kõiki** koos arvuga — turg ainult selle
büroo kuulutustega, mida **Pakkujad**-vold näitab ja mille tema kiibi
**×** maha võtab; ja lõpus
**Maaklerid**: igaüks, kellel on bürood kohal koht ja kuulutus turul, või
maakleri koht, pillina oma lehele. Maakleri leht on sama kuju, büroo nimi
lingina tema kohal ja iga **Näita kõiki** ainult tema omadega. Kellel bürood
ei ole, seda lehte ei ole — **Lehte ei leitud**. `/@{slug}` on endiselt büroo
enda laud ja küsib kohta.

## Kaart (`/map`)

Sama küsimus mis `/search`, joonistatuna (KODU-17), omaette täisekraanina koos
otsingukastiga. Alates KODU-32-st ei paku seda ekraani miski — `/search`-i
lüliti joonistab kaardi filtripaneeli alla —, aga aadress vastab edasi ja tema
peal olev lüliti kannab filtrid kummalegi vaatele üle.

| Toiming | Kuidas |
|---|---|
| Leia koht | Kast leiab maakonna, omavalitsuse, linnaosa, tänava, aadressi või koordinaadi ja sobitab akna selle järgi. Mis seal müügis on, saabub koos sellega |
| Liiguta ja suurenda | Lohista, keri või **+ / −** nupud |
| Loe nõela | Nõel on kinnisvaratüübi enda joonistus. Kus ühel aadressil seisab mitu, ütleb ta, mitu; vajutus võtab summa laiali. Välja suurendatuna on maakond number, mitte maja |
| Ava üks | Vajuta talle ja siis kaardile, mis avaneb |
| Jaga vaadet | Neli nurka on aadressis, nii et aken, mida sina vaatad, on aken, mille saab igaüks, kellele sa ta saadad |

Ta lükkab tagasi selle, mille lükkab tagasi nimekiri: filter, mida kellelgi ei
ole, tuleb tagasi märkusena, mis nimetab sõna, mitte tühja Eesti kaardina
(KODU-17).

See on portaali ainus ekraan, mis vajab skripti. Tee tagasi `/search`-i on
märgendis olemas juba enne, kui skript jookseb.

## Turuülevaade (`/market`)

Ainus ekraan, mis räägib korpusest ja mitte ühest kuulutusest selles. Neli
tabi pealkirja all, samas järjekorras nagu ribal — **Üür · Müük ·
Uusarendused · Äripinnad** — ja igaüks on sama ülevaade oma tehingust
(KODU-86); Üür on lahti, kui aadress muud ei ütle, ja tema all on €/m² kuu
oma.

Lisa kuulutuse kuju (KODU-110, KODU-112): kaks nummerdatud lõiku pealkirja
all ja mitte ühtegi kasti. **01 Ülevaade** on kolm arvu reas — **Kuulutusi
portaalis**, **Eesti keskmine**, **Kalleim maakond**, viimane link selle
maakonna kuulutustesse — ja **02 Maakonnad** on tabel, read joone all.

| Toiming | Kuidas |
|---|---|
| Võrdle maakondi | **Maakond · Kuulutusi · Keskmine €/m² · 12 kuud**, kalleim ees, iga maakonna keskmine ka tulbana kalleima vastu joonistatud. Maakonnad, kus keegi midagi ei müü, on all ja mitte üleval, kuhu null nad paneks |
| Ava maakond | Vajuta tema reale — iga rida on link selle maakonna kuulutustesse, nii et tabel on tee otsingu *sisse* ja mitte lehekülg numbreid imetlemiseks |

**12 kuu tulp on igal real `—`**, ja rida tabeli all ütleb, miks: portaal hoiab
kuulutuse kohta ühte hinda ja ei mingit ülestähendust selle kohta, mis see oli,
seega ei ole veel aastat, millega võrrelda (GAP-187). Null loeks nii, nagu
"hinnad ei ole liikunud", ja seda ei ole keegi väitnud. Maakond, kus turul
midagi ei ole, loeb oma hinnatulbas samuti `—` ja mitte `0 €/m²`.

## Lemmikud (`/favourites`)

Kõik, mille sa südamega märkisid, ridadena Lisa kuulutuse kujus (KODU-112):
pisipilt, aadress, koht ja hind, rea lõpus täis süda — vajutus sellele laseb
kuulutuse lahti ja toob sind siia tagasi. Lõigu **01 Salvestatud** nime all on
arv, mitu sul on. Kuulutus, mis on peatatud, jääb siia, kandes kiipi, mis
ütleb, kuhu ta läks — sinu riiulilt lahkumine ei ole miski, mida tema omanik
sinuga teha saab. Tühi riiul pakub otsingut.

## Lisa kuulutus (`/publish`)

Täisekraanivorm, üks tulp, loetakse ülevalt alla (KODU-33). **Avaldad kui**
tuleb esimesena, sest see on hetk, mil kuulutus oma omaniku saab (CTX-13).

Tehingu liik ja kinnisvara tüüp, siis **Asukoht**, mis on **üks väli**
(KODU-40): **Aadress**. Hakka kirjutama ja kaardi enda kohaotsing pakub, mida
leiab — tänavaid, maju, asulaid ja linnaosi, mida filtrid kasutavad — ning see,
mille sa valid, toob kaasa oma piirkonna ja oma koha kaardil, nii et keegi ei
küsi sinult, millises seitsmekümne üheksast omavalitsusest sinu tänav on.
Kirjuta aadress ja avalda nimekirja puutumata ning portaal vaatab selle ise
järele — sama juhtub brauseris, milles skripti ei jookse. Aadress, mille kohta
midagi leida ei ole, lükatakse tagasi juba seal väljal, sest kuulutus, mida
portaal paika panna ei oska, on selline, mida keegi kaardilt ei leia ega
filtriga kätte saa.

Tallinnas, Tartus ja Pärnus järgneb veel üks küsimus: **Linnaosa**.
Aadressiregister märgib linna ja mitte linnaosa — iga Tallinna aadress kannab
linna enda koodi —, seega on see viimane samm sinu oma, selle linna
linnaosade seas ja mitte kellegi teise omade seas. Ülejäänud seitsekümmend
kuus omavalitsust ei küsi seda kunagi. Siis hind ja pind ühel real, toad ja
kirjeldus. **Avalda kuulutus** salvestab kuulutuse ja saadab selle kõigepealt
ülevaatusele (KODU-107): iga lisatud või muudetud kuulutus **ootab
kinnitust**, ja Minu konto rida ütleb seda. Kõigepealt loeb seda portaali
enda mudel (KODU-114) — sõnu, esimesi pilte ja seda, kes pakub — ning
paneb ehtsa kuulutuse ise üles, harilikult minuti jooksul; selle, mis ei
ole kinnisvarakuulutus, on rämpspost, kannab pettuse tunnuseid või sisaldab
sündsusetuid sõnu või pilte, lükkab ta põhjusega tagasi; ja selle, mille
kohta ta otsustada ei oska, jätab operaatorile, kes kinnitab selle või
lükkab põhjusega tagasi. Tagasilükatud kuulutuse rida kannab põhjust, kes
selle ka andis, **Paranda** avab vormi, mille kohal sama põhjus seisab;
salvestamine saadab kuulutuse uuesti ülevaatusele — ja mudel loeb seda
uuesti. Kinnitatud kuulutus läheb kohe turule.

**Kuulutus ei maksa midagi** (BILL-11). Käik on üks ja seesama, ükskõik
kellena sa avaldad, iseendana või büroona: laed üles → ootab kinnitust →
üleval. Ühelgi sammul ei seisa raha ees ja operaatori sõna on ainus ootamine.
Erand on büroo, kes toob kuulutused vooga: need lähevad üles voo enda käe läbi.

Üleslaadimine ei ole avaldamine. Turult eemal võib hoida kuni 10 kuulutust —
mustandeid ja peatatuid (BILL-2); üheteistkümnendat vorm ei salvesta ja ütleb,
miks. **Tuvastamata kontol saab olla üks kuulutus** (BILL-12), ükskõik mis
seisus — üleval, ootel või peatatud. Kui see üks on olemas, avab **Lisa
kuulutus** vormi asemel 1 € kaardi: kinnita oma konto 1 € ülekandega enda
nimelt Gravitational Wave OÜ kontole — saaja, IBAN ja täpne viitenumber on
kaardil — ja kui raha on kohal, on vorm tagasi. Kinnitatud kontol piiri ei
ole peale nende kümne.

**Kirjeldus kolmes teises keeles** (KODU-72). Kirjelduse all on lüliti
**Tõlgi automaatselt teistesse keeltesse**, sisse lülitatud: tehisaru tõlgib
sinu kirjutatu mõne minuti jooksul kolme keelde, milles sa ei kirjutanud, ja
inglise, vene või ukraina ukse lugeja näeb enda oma — märgitud
*Masintõlge*, et keegi ei peaks mudeli lauset sinu omaks. **Muuda** vaates on
sama lüliti voldi **Tõlked** all, kus on kast iga keele kohta: see, mida
tehisaru tegi ja mida sa võid parandada, või sinu enda tõlge, mida tehisaru
kunagi üle ei kirjuta. Tühjaks jäetud kast jääb tehisaru tõlkida, ja
varasem kuulutus saab tõlked, kui lülitad lüliti sisse ja salvestad.
Paigaldusel, kus abilist ei ole, lülitit ei joonistata.

## Maksekaart (`/me/listing/{id}/pay`, ja büroo puhul `/@{slug}/listing/{id}/pay`)

Leht, mille peal makstakse kuulutuse arve, kui selline arve on. Täna ei tekita
seda ükski uks — kuulutus on tasuta (BILL-11) — ja kaart seisab selle jaoks,
mida kuulutuse peale hiljem müüakse.

Kõik, mida on vaja ühe ülekande tegemiseks: saaja, IBAN, neto, 24% käibemaks,
bruto ja — see osa, mis loeb — **täpne selgitus**. Makse seotakse selle koodi
järgi ja mitte kunagi sinu nime järgi, nii et vale selgitusega ülekanne on
selline, mida keegi omistada ei oska.

**Ükski nupp sellel ekraanil ei avalda midagi.** Raha peab päriselt kohale
jõudma. Kaart ütleb, kas see on juhtunud (**Makse on laekunud**) või oodatakse
ikka veel (**Ootame makse laekumist**), ja ülekande tegemine on see, mis
tingimused vastu võtab.

## Kinnitamine (`/me/verification`, ja büroo puhul `/@{slug}/verification`)

Sama kaart, ja **vabatahtlik** (BILL-11). Ühekordne 1 € ülekanne — 0,81 €
teenust ja 0,19 € käibemaksu, ja euro on see, mis kontolt maha läheb — sinu
enda või büroo nimelt, seotud oma `#VER-` või `#VAL-` koodi ja maksja nime
järgi.

Mida ta annab, on kiip Minu kontol: **Isik tuvastatud** eraisikule ja
**Kinnitatud büroo** bürool. Miski ei oota teda: kuulutused avaldatakse ka
ilma selleta, ja tema maksmine ei liiguta ühtegi kuulutust ega too ühtegi kuud.

Mida ta veel annab (KODU-111), on märk sinu kuulutustele: **Tuvastatud
müüja** igal kaardil ja sinu nime all kuulutuse lehel, koos reaga, mis ütleb,
mida see tähendab — **Kinnitatud büroo**, kui kuulutus on büroo oma — nii et
ostja näeb, mille sa valisid. API ütleb sama väljas `verified`.

## Minu konto (`/me`, ja büroo puhul `/@{slug}`)

See, kellena sa tegutsed, otsustab sellel ekraanil kõik, ja see on aadressis
ja mitte küpsises — nii et järjehoidja tähendab homme sama ja ekraanipilt on
millegi tõend (CTX-5).

| Toiming | Kuidas |
|---|---|
| Vaheta konteksti | **Minu bürood** näomenüüs (KODU-109): sina ise ja iga büroo, kus sul koht on, kaartidena. Ekraan, millel sa oled, jääb alles |
| Vaata, kas sa oled end kinnitanud | Kiip sinu nime kõrval: **Isik tuvastatud / Isik tuvastamata** või **Kinnitatud büroo / Kinnitamata**. Ta ütleb, kas sa valisid 1 € ülekande teha, ja mitte midagi muud — avaldamine teda ei oota (BILL-11) |
| Loe numbreid | Kuulutusi · Aktiivseid · Vaatamisi · Lemmikuid · Päringuid, selle konteksti kohta |
| Halda kuulutust | Iga rida kannab oma olekut ja oma tegevusi: **Muuda**, **Peata** või **Aktiveeri**, **Kustuta** — ja miski real ei maksa midagi (BILL-11). **Ootab kinnitust** on iga äsja lisatud või muudetud kuulutus (KODU-107): teda ei liiguta ükski sinu vajutus; **Tagasi lükatud** kannab operaatori põhjust ja **Paranda**; mustand ütleb **Valmis avaldamiseks** ja **Aktiveeri** saadab ta ülevaatusele. Peatatud kuulutus lahkub otsingust ja **Aktiveeri** toob ta tagasi. Kui turult eemal on juba 10, ei saa kuulutust peatada — rida ütleb seda **Peata** asemel, ja edasi viib mõne vana kustutamine (BILL-2) |
| Tee büroo | **Uus büroo**, Minu bürood all |
| Liigu profiili osade vahel | Tabid lehe ülaosas: **Kuulutused** ja **Konto seaded** (KODU-109). **Arved** ja **Minu bürood** on omaette juured näomenüüs. Büroo all näeb haldur ainult kuulutusi |

Kui operaator on sinu konto blokeerinud (KODU-113), seisab kuulutuste kohal
teade, mis jääb: kuulutused on turult maas, ükski rida ei paku Peata ega
Aktiveeri ning uut kuulutust, muudatust ega pilti vastu ei võeta, kuni blokk
on eemaldatud. Muuda ja Kustuta jäävad.

Mustandid ja kinnitust ootavad kuulutused on sellel ekraanil ja mitte ühelgi
teisel. Mustand kannab kiipi **Valmis avaldamiseks**: tema ees ei seisa muud
kui vajutus (BILL-11).

**Sooduskood** (BILL-10) sisestatakse üks kord, **Arvete** all, ja võtab oma
protsendi maha igalt kuulutuse arvelt nendel kuudel, mil ta kehtib —
tasumata arvetelt kohe, hilisematelt nende tekkimisel. Täna ei tekitata neid
arveid ühtegi, sest kuulutus on tasuta; kood on masinavärk, mis on alles
selle jaoks, mida kuulutuse peale müüakse, ja 1 € kinnitusmakset ta kunagi ei
puuduta. Lehed, mis nimetavad kehtivat avalikku koodi, jagamiseks: `/free`,
`/free/agencies` ja `/ai`.

## Arved (`/me/invoices`, ja büroo puhul `/@{slug}/invoices`)

Omaette juur näomenüüs (KODU-109), ainult omanikule; riba lehe ülaosas on uks
igasse kontekstisse, mille raha sa näed — sina ise ja iga büroo, mille omanik
sa oled. Ta näitab seda, mille see kontekst tellis ja maksis: 1 €
kinnitusmakset, kui sa selle tegid, ja kõike, mida kuulutuse peale kunagi
müüma hakatakse. Kuulutus ise on tasuta (BILL-11), nii et inimene, kes end ei
kinnitanud, näeb tühja ekraani.

Iga kuu on kaart: read — aadress, mis see maksis, mille kood maha võttis, mis
on tasuda — kuu seis (**Makstud**, **Jooksev kuu**, **Tasumata**) ja **Maksa**
real, mis veel ootab. Kuude kohal **Sooduskood**: kontol seisvad koodid oma
viimase päevaga, ja lahter. Sisestatud kood vastab samal ekraanil — rakendatud
või sellist koodi ei ole.

## Minu bürood (`/me/providers`)

Kontod, kellena sa tegutseda võid (KODU-109): sina ise ja iga büroo, kus sul
koht on, kaartidena, ja nende kõrval **Uus büroo**. Kaardi valimine vahetab
konteksti ja jätab ekraani, millel sa oled, alles (CTX-5).

## Uus büroo (`/new-agency`)

Toote kõige lühem päris vorm, ja ta küsib meelega kahte nime: **Büroo nimi
(bränd)** on bränd, mida ostja näeb, ja **Juriidiline nimi** on äriregistris
olev ettevõte, kes arve maksaks ja 1 € ülekande teeb. Lisaks arve e-post,
registrikood ja KMKR number.

Ühe loomine teeb sind samas lauses tema esimeseks omanikuks, nii et ei ole
hetkegi, mil büroo on olemas ja kellelegi ei kuulu. Ta alustab
**kinnitamatuna**, ja see ei takista midagi (BILL-11): tema kuulutused on
tasuta ja lähevad pärast ülevaatust üles nagu kõigil teistel. Kinnitamine on
valik ja annab kiibi **Kinnitatud büroo**.

## Konto seaded (`/settings`)

Minu konto teine tab, ja näomenüü **Konto seaded** (KODU-109). **Pilt** on
nägu ise: vajuta
sellele või lohista foto peale, ja see läheb üles kohe — telefon joonistab
foto enne näosuuruseks JPEG-iks, nii et kaamera enda fail ei ole kunagi liiga
suur (SPEC 3.2). **Eemalda** võtab selle uuesti maha. Ilma skriptita avab
sama nägu valija ja **Salvesta** postitab faili tervikuna, kuni 8 MB.

Kolm sektsiooni. **Profiil** näitab sinu nime ja aadressi ning ütleb, kus neid
muudetakse — need on sinu comm.ee konto omad, üks konto konsooli, postkasti ja
selle portaali peale — ning võtab vastu sinu telefoninumbri ja isikukoodi, mida
avaldamine vajab ja otsimine mitte. **Keel** pakub kolme neljast, mida pakub
riba — ukraina keel ei ole nende seas, sest salvestatud eelistus on
andmebaasitulp, mille väärtused on `et`, `en` ja `ru` (GAP-198). Seda tulpa ei
loe praegu ka miski lehe vastamiseks: see, milles ekraan tegelikult
joonistatakse, on pill, küpsis tema taga ja uks, kust sa sisse tulid (KODU-12,
KODU-22). **Teavitused** on kolm lülitit: lemmikute hinnalangused, päringud
minu kuulutustele ja uudiskiri.

Ükski neist kolmest ei saada veel midagi. Eelistus salvestatakse ja ekraan
ütleb seda, selle asemel et lubada kirja, mida keegi ei saada.

## Admin (`/admin`)

Operaatori oma (KODU-108): ainult superadminile, kõigile teistele *Ei
leitud*. Neli tabi. **Ülevaade** (`/admin/overview`, KODU-115) on see, mis
toimub: külastajad — kui palju, kui palju uusi kolmekümne päevaga, kui palju
tuli tagasi, külastused ja vaatamised, ning viimati loendatud inimesed
sellega, millal nad esimest korda tulid ja viimati siin olid;
registreerimised, iga vajutus liitumise uksel koos sellega, mis sellest
sai — konto loodud, oli juba olemas, või tagasi lükatud koos põhjusega; ja
inimeste üles laetud kuulutused, uusim eespool, igaühel see, kus ta seisab,
kes esitas, kelle sõna teda liigutas — mudeli või operaatori oma — ja
põhjus, kui ta tagasi lükati, ning nende kõrval vajutused, mille uks tagasi
lükkas enne, kui kuulutust üldse oli (see üks, kuni euro kohale jõuab,
kümme peatatut, blokeeritud konto). Pilk, mitte vajutus: miski sellel
lehel ei muuda midagi. **Ootel kuulutused** (`/admin/review`) on iga
kuulutus, mis ootab kinnitust, pikim ootus eespool — pilt, aadress, hind,
kes esitas ja millal, sõnad, ja see, mida mudel ütles, kui ta vaatas ja
ootama jättis (KODU-114) — ning kaks vajutust: **Kinnita** paneb kuulutuse
kohe turule, midagi ei ole selle eest võlgu (BILL-11), ja **Lükka tagasi**
avab põhjuse lahtri, mis on kohustuslik: omanik loeb põhjust oma real ja
vormi kohal ning saadab kuulutuse parandatuna uuesti. Mudel loeb sama
järjekorda esimesena ja otsustab, mida oskab; operaatori sõna on selle
jaoks, mille ta jättis, ja selleks ajaks, kui mudelit ei ole. Sama riba
seisab ootava kuulutuse enda lehe kohal. Kolmas vajutus real on **Blokeeri konto** (KODU-113): esitaja konto —
isik või büroo — läheb ühe vajutusega turult maha (tema aktiivsed kuulutused
peatatakse, ootavad jäävad ootama, aga järjekorras neid ei näidata) ja uut
kuulutust, muudatust ega pilti ta lisada ei saa, kuni blokk eemaldatakse.
Omaenda kontot operaator blokeerida ei saa. **Blokeeritud kontod**
(`/admin/blocked`) on need kontod, uusim eespool — nimi või büroo, liik,
millal — igaühel **Eemalda blokk**: blokk kaob, ootavad kuulutused tulevad
järjekorda tagasi ja peatatud jäävad peatatuks, kuni omanik need ise
aktiveerib. **Sooduskoodid** (`/admin/codes`, BILL-10, KODU-74) on
kampaaniate koodid: vermi, vaata seisu ja kasutusi, lõpeta.

## Tingimused (`/terms`)

Seitse sektsiooni, ja operaator on nimetatud koos oma registrikoodi ja KMKR
numbriga. See on leht, mille maksekaart ütleb ülekandega vastu võetavat.
Teenus on tasuta (BILL-11): kuulutus ei maksa midagi. Ainus, millel täna hind
on, on vabatahtlik 1 € kinnitusmakse, ja see euro on see, mis üle kantakse,
24% käibemaks sees.

## Dokumentatsioon (`/docs`)

See juhend, avalik ja kättesaadav ilma sisse logimata, ja selles keeles, milles
sa portaali loed (KDOC-13). Kolm raamatut kõigile: **GUI**, see, mida sa loed,
ning **REST** ja **MCP**, kaks masinapinda. Neljas, **Internal** — miks portaal
on ehitatud nii, nagu ta on —, on operaatori enda lugemine, ilmub ainult
superadminile ja on ingliskeelne, kus iganes sa seisad. Iga sakk nimetab faili
hoidlas, millest ta joonistatakse, sest ta *on* see fail ja mitte tema koopia —
**Show as Markdown** peas näitab neid baite nii, nagu nad on, koos
kopeerimisnupuga.

REST-i ja MCP peal istub raamatu kohal kokkupandud **Test panel**: vali
operatsioon, muuda tema eeltäidetud parameetreid, vajuta Run, ja vahetus —
päring ja vastus — jääb lehele. See on päris klient: REST-i kutse läheb
`/api/v1`-le sinuna, sinu sessiooniga, ja MCP kutse jõuab sama tööriistani,
milleni jõuab agent — lugemine jookseb, muudatus avab kinnituse vormi. Tööriista
käivitamiseks on vaja sisse logitud sessiooni; avalikud REST-i teed vastavad ka
külalisele. Paneel ise räägib igal uksel inglise keelt (KDOC-11): tema sildid
on liini enda sõnad.

## Sisse ja välja logimine

Eraldi registreerumist ei ole: konto on seesama comm.ee konto, mida kasutavad
konsool ja postkast. Ekraan, mis seda vajab, küsib seda portaali enda raamis,
selle asemel et ulatada sulle mõne teise toote lehte — parool või ühekordne
link e-postiga, ja kood seal, kus kontol on kaheastmeline kinnitus.

**Logi välja** on vorm, mis postitab, seega töötab ta ka väljalülitatud
skriptimisega, ja ta toob su tagasi ekraanile, kus sa teda vajutasid.

## Keeled

Eesti, inglise, vene ja ukraina keel (KODU-26). See, mille sa valid,
jäetakse aastaks meelde ja käib üle selle, mida su brauser eelistab; brauseri
eelistust austatakse ainult keele puhul, milles portaal on tegelikult
kirjutatud, ja kõik muu on eesti keel — sest see on eesti portaal ja neutraalset
vaikeväärtust ei ole olemas. Hinnad on € vormingus `et-EE` läbivalt.