# Polleo Demand — Upute za korištenje (rola: ADMIN)

Admin vidi **sve module** u aplikaciji i ima administrativne ovlasti (korisnici,
reset lozinki, revizijski dnevnik). Ovo je potpuni pregled po područjima.

## Prijava
Otvori adresu aplikacije → upiši zajedničku ulaznu lozinku (prozor preglednika) → prijavi se
svojim korisničkim imenom i lozinkom. Admin u izborniku ima sve grupe.

## Početak / Executive / AI
**Home** — polazni pregled stanja.
**Executive — Overview** — sažetak ključnih KPI-jeva za upravu (prihod/RUC, zadnja 4 tjedna).
**Polleo AI (Chat)** — pitanja na prirodnom jeziku; alat čita cijelu bazu i odgovori tekstom + grafom.

## Demand (potražnja)
**Upload sales** — učitavanje Rekapitulacija Excela (prodaja) → erp_transactions + osvježi tjedni prikaz.
**Upload stock** — učitavanje stanja zaliha (HR/SI/AT).
**Run forecast** — pokretanje prognoze (StatsForecast) za sve artikle; rezultat ide u Revenue forecast i Stock projection.
**KAM/CM input** — ručni unos on-top količina po kupcu/tjednu (Admin može unositi za bilo koga).
**Weekly KAM upload** — upload tjednog Excela KAM-a s automatskim diffom i zaključavanjem idućih 4 tjedna.
**Buyer listings** — upload asortimana po kupcu (popis SKU-ova).
**Demand planning** — planiranje potražnje (planner faktori, pregled plana).
**Input status** — tko je od KAM/CM-ova predao unose za ciklus.
**S&OP meeting** — paket za sastanak: Mgmt plan vs System plan vs Actuals (RUC) po kanalima.
**Demand review** — konsenzus prognoza za ciklus (pregled/potvrda).
**Wholesale review** — kontrola KAM obećanja vs stvarne nabave (commit-vs-pull / FA).
**Availability (WS)** — ATP po kupcu/tjednu (crveno/zeleno) + Excel izvoz.
**Consensus plan** — usklađeni konsenzus plan.
**Sales weekly** — tjedna prodaja po artiklu. **Revenue forecast** — prihod/RUC prošlost + budućnost.
**Forecast accuracy** — točnost po tieru. **Watchlist** — praćeni artikli. **SKU list** — master lista artikala (tier, XYZ, CV).

## Supply (nabava i zalihe)
**Upload incoming POs** — matrica dolaznih narudžbi → incoming_supply.
**Order entry** — ručni unos narudžbi. **Order proposal** — automatski prijedlog narudžbe po dobavljaču.
**Settings** — postavke (lead time, MOQ master).
**Dashboard** — zalihe po lokaciji. **Inventory health** — zdravlje zaliha. **Stock projection** — projekcija vrijednosti zaliha (€).
**Coverage workbook** — tjedna pokrivenost (weeks of cover). **Reorder alerts** — što treba naručiti.
**Scenario planner** — "što-ako" scenariji. **Store overstock** — višak zaliha po trgovini.
**MOQ analysis** — analiza minimalnih količina. **Logistics** — palete/MOQ/kamioni po dobavljaču/tjednu.
**Costs & margins** — troškovi i marže.

## Promo (akcije)
**Overview / Planner / My proposals / Approvals / Calendar / Forecaster / Past promos / Performance / Past web promos** —
planiranje akcija (mehanika, popust, uplift, RUC, NC30), prijedlozi i odobravanje, kalendar s konfliktima,
preporuka popusta po cilju, te povijest i uspješnost akcija (uplift/kanibalizacija) i web kupona.

## NPL (novi artikli)
**NPL list / New NPL / NPL report** — popis, unos i izvještaj o uvođenju novih artikala.

## Finance
**Dashboard** — ulaz u izvještaje. **Lost sales** — izgubljeni RUC po tieru. **Locked cash** — zaglavljeni novac
u prezalihama (top 10 dobavljača). **Contest risk** — rizik obveza. **Slow movers** — spori artikli po klasi.
**Margin bridge** — most marže (plan → stvarno) po kategoriji.

## Administracija (samo Admin)
**Users** — kreiranje i uređivanje korisnika: postavljanje role (Veleprodaja, Maloprodaja, Nabava,
Marketing, Uprava, Admin), aktivacija, **reset lozinke**.
**On-Top change control** — revizijski dnevnik svih KAM/CM on-top promjena (dodano/promijenjeno/obrisano/
premješteno, po osobi i tjednu; tjedni upload je označen).

## Napomene za admina
- **Tko vidi koji modul** definira se u datoteci `backend/services/role_permissions.yaml`
  (sekcija → popis rola). Izmjena + restart API-ja primijeni nove dozvole.
- **Lozinke** su bcrypt-hashirane; ne mogu se pročitati, samo resetirati (Users → reset).
- Admin nema ograničenja — vidi i radi sve što i ostale role, plus administraciju.