1) Šta ova aplikacija radi (bez marketing priče)

• Čuva klijente i njihove podatke.
• Kreira i vodi fakture (nacrt, izdata, plaćena...).
• Generiše PDF za štampu/slanje.
• Omogućava slanje fakture email-om.
• Pravi backup i omogućava restore podataka.
• Ima integracije (Telegram komande, email provider).

Ukratko: cilj je da vlasnik/radnik u servisu što manje klikće i da ne izgubi podatke.

2) Prvi setup (obavezno uraditi ovim redom)

1. Uloguj se.
2. Idi na Settings i unesi podatke firme (naziv, adresa, PIB/matični, kontakt, banka).
3. Idi na Backup, izaberi gde se backup čuva i klikni Test connection.
4. Napravi jednog klijenta u Clients.
5. Napravi probnu fakturu u Invoices.
6. Otvori PDF/print preview da proveriš kako izgleda dokument.

Ako preskočiš korake 2 i 3, kasnije ćeš imati greške kod štampe, slanja i backup-a.

3) Svakodnevni rad (tipičan tok)

1. Nađeš klijenta (ili dodaš novog).
2. Kreiraš fakturu i ubaciš stavke iz kataloga.
3. Sačuvaš kao nacrt ili odmah izdaš.
4. Po potrebi pošalješ PDF email-om.
5. Kada uplata legne, promeniš status na plaćeno.

4) Objašnjenje glavnih sekcija (šta je za šta)

• Dashboard: brz pregled stanja (koliko faktura, šta je plaćeno, šta kasni).
• Clients: podaci o klijentima + istorija saradnje.
• Catalog: šabloni stavki/usluga da ne kucaš isto svaki put.
• Invoices: kompletan rad sa fakturama (kreiranje, izmena, statusi, PDF).
• Backup: čuvanje kopija baze i povrat podataka ako nešto pođe po zlu.
• Integrations: povezivanje email-a/Telegram-a i pomoćnih servisa.
• Users: korisnici koji imaju pristup aplikaciji.

5) Backup i restore (najvažnija sigurnosna stvar)

Ako radiš samo jednu stvar redovno — neka to bude backup. U slučaju greške, lošeg update-a ili ljudske greške, backup spašava posao.

• Run now: odmah pravi novu kopiju.
• Scheduler: automatski backup u zadato vreme (UTC).
• Retention: koliko starih backupova čuvaš pre čišćenja.
• Restore: vraća podatke iz izabrane kopije (pre toga se pravi safety backup).

Detaljna uputstva i primeri su u posebnom dokumentu: Backup Storage uputstvo.

6) Email i PDF (kada treba poslati fakturu klijentu)

1. Otvori fakturu.
2. Generiši PDF (ili print preview).
3. Proveri da su podaci firme i klijenta tačni.
4. Pošalji email-om iz aplikacije.

Ako slanje ne radi, prvo proveri Email provider u Integrations i test konekcije.

7) Najčešće greške (i brzo rešenje)

• Putanja mora biti apsolutna → unesi putanju koja počinje sa /.
• S3 kredencijali nisu podešeni → proveri access key / secret key / endpoint.
• Vreme mora biti HH:MM → npr. 02:30.
• Ne vidiš novu stranu na produkciji → uradi hard refresh ili proveri da je latest deploy stvarno aktivan.
• Ne možeš da uđeš na internu stranu → proveri da li si ulogovan (zaštićene rute traže login).

8) Linkovi ka detaljnim internim dokumentima

• docs/backup-storage-setup.md
• docs/backup-restore-runbook.md
• docs/data-model.md