Erste - komande

Pregled svih komandi. Alat stoji u E:\Work\AI\erste_tools, radi na čistom Pythonu 3.9+ bez ijedne dodatne biblioteke.

Trenutna podešavanja

Najkraće — svakodnevni rad

cd "E:\Work\AI\erste_tools"

python erste.py prihvat --proba     :: pokaže šta bi uradio, ništa ne dira
python erste.py prihvat             :: premešta foldere iz clipboard-a
python erste.py pregled             :: šta čeka arhiviranje
python erste.py arhiva              :: arhivira (na današnji dan)

Ko ne voli kucanje — dupli klik na Erste.bat (meni sa brojevima).

Sve komande

Engleski nazivi rade isto: ingest, status, archive, cleanup, check, find, menu.

Uz svaku komandu radi i:

prihvat — premeštanje foldera

python erste.py prihvat                          :: iz clipboard-a (podrazumevano)
python erste.py prihvat --fajl spisak.txt        :: iz fajla
python erste.py prihvat --imap                   :: direktno sa mail naloga
python erste.py prihvat --ime JDCID274_20260809_232412 JDTID081_20260810_202529
python erste.py prihvat --proba                  :: proba, ništa se ne dira

Šta se dešava: folder se premešta (move) iz OUT u ...\Dnevna\<današnji datum>\. Sve prihvaćeno istog dana ide u isti dnevni folder. Odmah se pravi i netaknuta kopija u ...\Dnevna\_original\<datum>\ — iz nje kasnije ide arhiva, pa operater sme da meša, preimenuje i briše svoju radnu kopiju bez posledica.

Zašto to nije suvišno: u stvarnoj obradi se svih 19 foldera prerasporedi po broju strana u dva foldera i spoji u dva PDF-a. Od originalne strukture u radnoj kopiji ne ostane ništa. Arhiva ipak ispadne uredna, jer se uzima iz netaknute kopije.

Kod IMAP-a se .eml snima u folder posla na koji se odnosi, pa je svaki posao celina — svi fajlovi + poruka iz koje je došao — i tako završi i u arhivi. ("mail_u_folder": false vraća staro: svi mailovi zajedno u _mail\.)

Ulaz može biti: ceo mail, više mailova odjednom (dele se po „Poštovani"), ili običan spisak imena foldera — po jedan u redu. Prihvataju se gola imena, unix putanje i Windows putanje.

Jedna poruka može da najavi više štampi — svaka u svom redu. Sve se obrađuju kao da su stigle zasebnim porukama, a kopija poruke ide u svaki folder na koji se odnosi. Ista lokacija navedena dvaput se obrađuje jednom.

Spisak je ono između najave i potpisa:

• počinje posle reda ...koja se nalazi na lokaciji:, koji mora biti u prvih 5 nepraznih linija. Ako je dublje — to je nadovezana prepiska, stara najava ispod našeg odgovora — poruka se ne obrađuje;
• staje na potpisu (Pozdrav, Regards, --), citiranom tekstu (>) ili početku prosleđene poruke (-----Original Message-----, From:).

Poruka koja ne počinje najavom se ne obeležava, pa ostaje vidljiva i prijavljuje se u svakom prolazu uz razlog. Isto i ako jedan od foldera fali — poruka se vraća sledeći put, da se ostatak ne izgubi. Ništa se ne gubi tiho.

Izmereno na 21 stvarnoj poruci: najava je uvek na 2. nepraznoj liniji.

Poslovi koji se grupišu

Neke vrste poslova se skupljaju u zajednički folder u radnoj kopiji. Pravila su u config.json pod grupe:

{datum} je dan prihvata.

Dnevna\2026-08-13\
    Erste izvodi 2026-08-13\          <- svi izvodi zajedno
        izvod_a.pdf
        izvod_b.pdf
    Erste uparivanje 2026-08-13\
        DCID215\  podaci.xlsx
        DCID216\  podaci.xlsx

Arhiva se ne grupiše — ostaje po originalnim imenima poslova (Arhiva\2026\08\20\JDICD083_20260701_203829\), pa je pretraživa po nalogu.

Kod „ravno" strukture: isti fajl (ime + veličina + SHA-1) se ne duplira; različit fajl istog imena ide pored (izvod__2.pdf) i prijavi se kao sudar imena. Nikad preko.

nadji — gde je posao kod nas

python erste.py nadji JDCID266              :: po imenu ili delu imena
python erste.py nadji JDCID266 --disk       :: + pretraga celog diska (Everything)

Za svaki pogodak kaže kada je prihvaćen, gde mu je radna kopija, netaknuta kopija i arhiva — i da li te putanje stvarno postoje ili su samo nedostupne. Ako ga nema u evidenciji, proverava da li još stoji u OUT.

--disk traži preko Everything CLI (es.exe). Ako es.exe nije instaliran, jasno to kaže; putanja se može zadati u config.json → everything_es.

pregled — stanje

python erste.py pregled          :: samo ono što čeka arhivu
python erste.py pregled --sve    :: i ono što je već arhivirano

Oznaka [BEZ KOPIJE] znači da je netaknuta kopija nestala — arhiva će za tu stavku morati da traži fajlove po manifestu.

arhiva — kopiranje u arhivu

Pokreće se na dan štampe, koji se po pravilu razlikuje od dana prijema.

python erste.py arhiva                        :: pod današnjim datumom, sve što čeka
python erste.py arhiva --dan 2026-08-13       :: pod drugim datumom
python erste.py arhiva --proba                :: proba
python erste.py arhiva --clipboard            :: samo odštampana serija, spisak iz clipboard-a
python erste.py arhiva --fajl odstampano.txt  :: isti spisak iz fajla
python erste.py arhiva --samo JDCID274_20260809_232412
python erste.py arhiva --paket 2026-08-11     :: samo iz tog dana prihvata
python erste.py arhiva --potvrdi              :: bez pitanja za potvrdu

Koji dan se bira bez --dan

Dan kada pokreneš komandu — ne dan prijema, ne dan iz imena foldera.

Šta ulazi bez filtera

Sve što je prihvaćeno a nije arhivirano, iz svih dnevnih foldera. Zato se pri štampi u serijama koristi --clipboard: odštampaš seriju, kopiraš spisak tih poslova, arhiviraš tačno njih. Neodštampano ostaje u redu i ide kasnije, pod svojim danom štampe.

Ono što je traženo a nije ušlo prijavi se uz razlog — već arhivirano <datum> ili nije prihvaćen.

Rezultat: \\192.168.1.250\ftpusers\erste\PROD\Arhiva\2026\08\13\JDCID266_20260811_033134\ — kopija (ne move), sa nepromenjenom strukturom po folderima.

Fajlovi se uzimaju iz netaknute kopije. Ako nje nema, traže se po manifestu: prvo po imenu i veličini, pa po SHA-1 — tako se nađu i fajlovi koji su u međuvremenu premešteni ili preimenovani. Što se ne nađe, prijavi se poimenično.

ocisti — brisanje starih kopija

python erste.py ocisti --dana 30 --proba    :: šta bi obrisao
python erste.py ocisti --dana 30            :: uz pitanje za potvrdu
python erste.py ocisti --dana 30 --potvrdi  :: bez pitanja

Briše isključivo netaknute radne kopije (...\Dnevna\_original\) stavki koje su već arhivirane, i to starije od zadatog broja dana. Podrazumevano 30 dana; --dana 0 briše sve već arhivirano bez obzira na starost.

Kopija ostaje posle arhiviranja zato što je arhiviranje kopiranje, ne premeštanje. Za automatsko brisanje odmah po uspešnom arhiviranju: "keep_original_after_archive": false (kod delimične arhive kopija svejedno ostaje).

Arhiva je trajna i ova komanda je ne dira. Brisanje bilo čega unutar archive_root ili source_root je zabranjeno u kodu — odbija se i upisuje u log. Ako u arhivi već postoji folder istog imena, novi sadržaj ide pored (ime__2), nikad preko.

provera — da li je sve na mestu

python erste.py provera

Ispisuje sve putanje sa oznakom OK / !!, gde bi danas išla arhiva, i stanje IMAP podešavanja. Prvo što treba pustiti kad nešto ne radi.

mail — IMAP

Podešavanje naloga

python erste.py mail podesi

Vođeno podešavanje: pita server, način povezivanja, korisnika i lozinku, odmah proveri vezu, pa tek onda upiše. Ako prijava ne prođe, config.json ostaje netaknut.

Za server se može nalepiti i pun URL — imaps://korisnik@mail.primer.rs:993/ se sam razloži na host, port i SSL. Zatim se bira:

Na kraju bira gde ide lozinka: promenljiva okruženja (preporučeno — sam pozove setx), config.json (običan tekst), ili nigde (pita svaki put). Posle upisa u promenljivu okruženja otvoriti nov terminal da bi važila.

Ručno, u config.json pod imap: host, port, ssl (true za 993, false za 143 sa STARTTLS), user, processed_folder, timeout.

Provera kredencijala — po koracima

Redom; svaki korak dira manje nego sledeći.

python erste.py mail proba      :: 1) server, prijava, folder za obrađene
python erste.py mail folderi    :: 2) tačna imena foldera na serveru
python erste.py mail pregled    :: 3) šta bi pročitao - poruke se NE diraju
python erste.py prihvat --imap  :: 4) stvarna obrada

mail proba prvo kaže odakle uzima lozinku, pa razdvaja mrežnu grešku od pogrešnih kredencijala:

Uz pregled rade i --kriterijum i --limit.

Šta se smatra neobrađenim — NIJE „nepročitano"

Alat obrađenu poruku obeležava sopstvenom oznakom AutoObrada i traži NOT KEYWORD AutoObrada.

Zašto ne UNSEEN: ako se sanduče čita i preko POP3 (Outlook), server postavlja \Seen već pri POP3 preuzimanju. Poruka postane „pročitana" a da je alat nikad nije video, pa bi sa UNSEEN tiho ispala iz obrade. Custom oznaku POP3 ne dira.

Filter pošiljaoca (deljeno sanduče)

Regex vezuj za domen, ne za adresu — lokalni deo i TLD se menjaju:

(?i)@(?:[a-z0-9-]+\.)*imefirme\.[a-z]{2,6}(?=[>\s]|$)

Završni (?=[>\s]|$) odbija lažni domen (a@imefirme.rs.tudje.com), a vezivanje za @ odbija podvalu preko imena (Ime Firme <podvala@gmail.com>). Neispravan regex zaustavlja rad — filter koji ne radi znači obradu tuđe pošte.

Oznaku dobija samo poruka iz koje je izvučen folder i čiji je prihvat uspeo. Poruka bez putanje ostaje neobeležena i vraća se sledeći put.

Više alata nad istim sandučetom: svakom dati svoj from_contains pa se ne sretnu.

Obrada bez diranja poruka

python erste.py prihvat --imap --ne-diraj-poruke

Folderi se obrade do kraja (premeštanje, netaknuta kopija, .eml, manifest), ali poruke ostaju nepročitane u INBOX-u — pa iste poruke mogu ponovo da se obrade. Korisno kad se prvi put pušta nad stvarnim nalogom.

Ponovno pokretanje je bezbedno: već prihvaćen folder se prepozna i preskoči, a .eml kopija se ne duplira (ime sadrži uid poruke).

Lozinka se traži ovim redom: promenljiva okruženja ERSTE_IMAP_PASSWORD → polje password u config.json → pitanje u terminalu. Preporuka:

setx ERSTE_IMAP_PASSWORD "lozinka"

Šta se dešava sa porukom — tek pošto prihvat uspe: snimi se .eml kopija uz obrađene foldere i poruka se označi pročitanom. Poruka ostaje u INBOX-u.

To je dovoljno: pošto se gledaju samo nepročitane poruke, oznaka „pročitano" i sistemu i operateru govori da je poruka obrađena. Poseban folder za obrađene nije potreban — ako se ipak želi, upiše se ime u processed_folder (podrazumevano prazno) i pravi se sam.

Ako prihvat ne uspe, poruka ostaje nepročitana u INBOX-u i alat to prijavi — pa je nepročitana poruka ujedno i znak operateru da nešto treba pogledati.

Prečice (dupli klik)

Provera i održavanje

python -m unittest discover -s tests -t .   :: 92 testa
python tools\demo.py                        :: ceo tok na izmišljenim folderima
python erste.py init --prepisi              :: nov, prazan config.json

tools\demo.py radi isključivo u %TEMP%\erste_demo — nijedna stvarna lokacija se ne dodiruje.

Pozadinski prihvat — i zašto je bezbedan

Tri kočnice sprečavaju da posao bude uhvaćen na pola:

1. Folder se objavljuje tek kad je ceo gotov. Prenosi se u <dnevni folder>\_uprihvatu\, tamo se napravi i netaknuta kopija, i tek onda se preimenuje na svoje ime. Poluprenet folder se nikad ne vidi pod pravim imenom, pa se ne može odštampati nepotpun posao. Ako prenos pukne, ostatak stoji u _uprihvatu i pregled javi NEDOVRŠEN PRENOS.

2. Brava. Prihvat i arhiviranje se ne mogu preklopiti — drugi posao odbija start uz poruku ko ga drži, sa kog računara i od kada (_erste.lock). Brava starija od sat vremena se smatra zaostalom i preuzima.

3. Manifest se upisuje posle svake stavke. Prekid ne ostavlja preneto ali nezabeleženo. Što nije u manifestu, arhiva ne može ni da pokupi.

Uz to, arhiva označava stavke prihvaćene u poslednjih sat vremena sa <-- prihvaćeno pre N min! i upozori da verovatno nisu odštampane.

Preporuka

Za ~10 poruka dnevno koje se štampaju u jednom sedenju, ručno pokretanje na početku rada je jednostavnije i predvidljivije od rasporeda:

python erste.py prihvat --imap    :: pokupi sve novo
:: ... štampanje ...
python erste.py arhiva --clipboard

Ako ipak ide u raspored, neka interval bude redak i nikad ne puštaj arhiva iz rasporeda — samo operater zna šta je odštampano.

Pravila koja alat poštuje

• Iz mail-a se gleda samo početak poruke i uzima prva putanja. Sve dalje u tekstu se ignoriše — tamo mogu biti stariji delovi prepiske i druge lokacije.
• Putanja mora biti unutar /home/ftpusers/erste/PROD/OUT, na bilo kojoj dubini. Šta je unutra nije bitno. Sve van toga se odbacuje uz jasan razlog.
• Folder koji je jednom prihvaćen ne može se prihvatiti dvaput, bez obzira na dan.
• Iz OUT se premešta (move), u arhivu se kopira (copy).
• Ništa se ne briše samo od sebe.
• Arhiviranje traži potvrdu.
• Sve se piše u logs\erste-GGGG-MM.log.