Pčela style guide

Dizajn sustav Pčele (engleski Bee): svijetla i tamna tema, shadcn komponente, smjer Bee productive. Izvor: design system HR i EN (4.11.2026).

pčela
pčela
favicon
bee

Načela i pravila

Pčela (engleski Bee) je sustav za orkestraciju rada: vodi priču, zadatak ili dokument kroz korake, pušta AI agente da rade ono što smiju sami i zaustavlja tok tamo gdje mora odlučiti čovjek. Smjer dizajna je Bee productive: mirna, gusta radna površina na kojoj se odmah vidi što je na redu, tko je na potezu i koliko je ostalo vremena. Sučelje je crno-bijelo, a žuta iz znaka označava samo ono što je upravo u radu.

Načela

Tekst u sučelju

Boje

Svijetla i tamna tema

Obje teme su ravnopravne i koriste iste nazive tokena. Tamna tema nije obrnuta svijetla: podloge su grafitne (background #121317, card #1a1c21), primary je bijel (#f4f4f1), a žuta svjetlija (honey #f7d23a), a tekst na destructive, warning i success postaje taman. Tema prati postavku sustava, a korisnik je može promijeniti u izborniku profila (next-themes, klasa .dark na html).

Tipografija

Razmaci, kutovi, sjene

Ikone

lucide-react, kao u shadcn: 16 px u gumbima, izbornicima i značkama, 20 px u praznim stanjima, debljina linije 2, boja currentColor. Agent ima ikonu Sparkles, čovjek User, rok Clock. Emoji se ne koriste.

Logo

Znak je saće od četiri spojene ćelije u dva reda; prva ćelija je limunasta žuta (honey). Datoteke su u grupi Logos: bee-mark-light.svg na svijetloj podlozi, bee-mark-dark.svg na tamnoj i bee-favicon.svg s debljim stijenkama za 16-32 px. Naziv se uz znak piše malim slovima u Lexendu 600 ("pčela", na engleskoj instalaciji "bee"), kao živi tekst, ne kao slika. Znak se ne okreće, ne boji drugim bojama i ne slaže u drugi raspored ćelija.

Whitelabel

Pčela se isporučuje pod klijentovim imenom. Klijent smije zamijeniti logo u bočnoj traci i na prijavi te tokene primary, primary-foreground, ring, sidebar-primary i honey-ink, uz uvjet da zadrže kontrast iz ovog dokumenta. honey ostaje boja znaka Pčele. Stanja procesa (agent, human, success, warning, destructive), tipografija, razmaci i komponente ostaju isti na svakoj instalaciji, da bi urednik koji prijeđe na drugu instalaciju odmah znao što znači koja oznaka.

shadcn

Aplikacija koristi shadcn/ui s Tailwindom; tokeni nose iste nazive kao shadcn CSS varijable, pa se globals.css (:root i .dark) slaže izravno iz tablice boja ispod. Gotov isječak je u design system artefaktu.

Komponente se dodaju s npx shadcn add <komponenta>. Ne prepisivati ih rukom i ne graditi vlastiti okvir stranice: okvir je shadcn Sidebar, na mobitelu Sheet. Komponente Pčele (StepTracker, ApprovalCard) slažu se od shadcn dijelova i žive u components/bee/.

Engleska verzija

Isti sustav na engleskom: https://claude.ai/artifact/FLJvsLggVy3GZkpbRggEy6

Boje

TokenSvijetlaTamnaUpotreba

Tipografija

StilPrimjerVeličinaUpotreba
displayPregled priče36px/40px 600Naslov prazne stranice i prijave. Najviše jednom po ekranu.
h1Plan priča28px/34px 600Naslov ekrana.
h2Čeka odobrenje20px/28px 600Naslov odjeljka i dijaloga.
h3Vlada spušta cijene goriva16px/24px 600Naslov kartice i priče.
bodyUrednik Sporta treba odobriti objavu do 10:30.14px/20px 400Osnovni tekst sučelja.
body-smPredano 10:02 · provjere gotove 10:0313px/18px 400Gusti prikazi: tablice, trag procesa.
labelRubrika13px/18px 500Oznake polja, gumbi, tabovi.
captionPrije 4 min12px/16px 400Pomoćni tekst, vrijeme, opisi ispod polja.
overlineKT3 · ODOBRENJE OBJAVE11px/16px 600Oznaka faze ili kontrolne točke iznad naslova; uvijek velikim slovima.
mono48.200 · +12 min · 0,04 $12.5px/18px 500Brojke, ID-jevi, trošak, vremena u tablicama.

Komponente

Cover

Svijetla
Pčela
Produktivnost i automatizacija procesa.
Tamna

Button

Svijetla
Tamna

Gumb za jednu radnju; u aplikaciji je to shadcn Button iz components/ui/button.

Varijante: default (crni, u tamnoj temi bijeli; primary) za glavnu radnju ekrana, secondary, outline za sporednu radnju uz glavnu, ghost za tihe radnje u tablicama i trakama, destructive za Odbij i Povuci, link za prijelaz u drugi sustav. Veličine: sm 32 px, zadana 36 px, lg 40 px, icon 36 x 36.

Pravila

  • Najviše jedan default gumb po ekranu ili kartici. Na kartici odobrenja to je Odobri.
  • Tekst je glagol u imperativu koji kaže što će se dogoditi: "Odobri objavu", "Vrati na doradu". Ne "U redu", ne "Pošalji" kad se ne šalje ništa.
  • Ikona (lucide, 16 px) ide ispred teksta i samo kad pomaže prepoznati radnju. Gumb samo s ikonom ima aria-label.
  • Odbij, Povuci i Obriši su destructive i traže potvrdu u dijalogu.

Što daje korisnik komponente: tekst ili children, variant, size, onClick, po potrebi disabled i asChild za poveznicu.

Badge

Svijetla
AI radi Prijedlog Čeka urednika Objavljeno Rok za 4 min Odbijeno
Breaking Nacrt Sport
Tamna

Kratka oznaka stanja, kategorije ili vrste priče; shadcn Badge s dodanim varijantama za stanja procesa.

Stanja procesa (Pčela):

  • agent: korak radi AI agent sam (agent na agent-soft, s točkom).
  • suggest: AI je dao prijedlog koji čeka prihvaćanje (isprekidani rub agent).
  • human: korak čeka odluku čovjeka, kontrolnu točku (human na human-soft).
  • success Objavljeno, warning rok ili rizik, destructive Odbijeno ili Povučeno.

Ostale: default (crna) samo za Breaking, secondary za Nacrt i neutralna stanja, outline za kategoriju (Sport, Showbiz, Politika).

Pravila

  • Stanje se nikad ne prikazuje samo bojom: uvijek ima riječ, a stanja agenta i čovjeka i točku.
  • Jedna značka stanja po priči. Kategorija i vrsta mogu stajati uz nju kao outline.
  • Tekst značke je kratak, do tri riječi, velikim početnim slovom.

Card

Svijetla
Sport · Uređivanje

Hajduk dovodi novog trenera do kraja tjedna

Novinar · predano 10:02 · rok 11:00
Čeka urednika Sport 0,04 $
Tamna

Okvir za jednu priču, panel ili skup podataka; shadcn Card s CardHeader, CardTitle, CardDescription, CardContent i CardFooter.

Kartica priče (Plan priča, Ulaz): iznad naslova je overline s kategorijom i fazom, naslov je h3, ispod je meta u muted-foreground (tko, kada, rok). Slijedi red sa značkom stanja, kategorijom i troškom u mono, a u podnožju najviše dva gumba.

Pravila

  • Pozadina je card s rubom border, kut radius-lg, sjena shadow-sm. Ne dodavati obojeni rub sa strane; stanje nosi značka.
  • Unutarnji razmak je space-4, a razmak između kartica space-6.
  • Kartica nije gumb. Ako se cijela klikne, ima jasan glavni gumb ili poveznicu u naslovu.

Input

Svijetla
Vidi ga samo redakcija. Naslov za objavu predlaže Labrador.
Rok je prošao. Upiši vrijeme nakon 10:15.
Tamna

Polje za unos s oznakom i pomoćnim tekstom; shadcn Input uz Label, u obrascu kroz Form (react-hook-form + zod).

Pravila

  • Oznaka je uvijek vidljiva iznad polja (label). Placeholder nije zamjena za oznaku.
  • Pomoćni tekst ispod polja je caption u muted-foreground.
  • Greška: rub destructive, aria-invalid, a poruka kaže što ne valja i kako popraviti ("Rok je prošao. Upiši vrijeme nakon 10:15."). Bez isprika.
  • Visina 36 px, kut radius-md, rub input, fokus prsten ring.

Tabs

Svijetla
Tamna

Prebacivanje između pogleda istog skupa; shadcn Tabs s TabsList i TabsTrigger.

Pravila

  • Za poglede na iste podatke (Ulaz, Praćenje, Odbačeno), ne za korake procesa; za korake je StepTracker.
  • Uz naziv smije stajati broj stavki u mono.
  • Najviše pet tabova; više od toga ide u Select ili filter.

Table

Svijetla
ČlanakKategorijaČitatelji 24 hPrema konkurencijiStanje
Vlada spušta cijene gorivaPolitika48.200+12 minObjavljeno
Hajduk dovodi novog treneraSport--Čeka urednika
Rezultati 12. kolaSport21.940prviObjavljeno
Glazbeni festival otkazanShowbiz--Odbijeno
Tamna

Popis priča i brojki; shadcn Table, a za sortiranje i filtere DataTable (TanStack Table).

Pravila

  • Brojke su desno poravnate, u mono s tabular-nums. Tisuće s točkom, decimale sa zarezom (48.200; 0,04 $).
  • Zaglavlje je caption u muted-foreground, bez velikih slova.
  • Stanje je značka u zadnjem stupcu. Prazna vrijednost je "-", ne nula.
  • Red je visok 44 px, hover muted. Klik na red otvara Pregled priče.

Alert

Svijetla
Labrador je potvrdio objavu
Članak je objavljen u 10:14. Praćenje dosega traje 48 h.
Rok za odluku ističe za 3 min
Ako urednik Sporta ne odluči, signal ide glavnom uredniku.
Tamna

Poruka o stanju sustava ili roku unutar stranice; shadcn Alert s AlertTitle i AlertDescription, varijante info, warning i destructive.

Pravila

  • Naslov kaže što se dogodilo, tijelo kaže što slijedi ili što učiniti.
  • warning za rokove i eskalacije, destructive za greške integracija (Labrador, Teams), info za potvrde.
  • Ikona lucide 16 px uvijek stoji uz boju.
  • Kratke potvrde radnji ("Objava odobrena") idu u Toast (sonner), ne u Alert.

StepTracker

Svijetla
  1. Ulaz
  2. Planiranje
  3. Izrada
  4. Provjera
  5. Objava
  6. Doseg
  1. Ulaz
  2. Planiranje
  3. Izrada
  4. Provjera
  5. Odobrenje
  6. Doseg
Tamna

Faze jedne priče kao ćelije saća; komponenta Pčele izvedena iz znaka, nema je u shadcn.

Stanja ćelije

  • done: puna ćelija u foreground, linija do sljedeće također.
  • current: žuta ćelija (honey) s tamnim rubom; korak u tijeku, najčešće ga radi agent.
  • waiting: ćelija u human-soft s rubom human; čeka kontrolnu točku. Natpis je u human i podebljan.
  • pending: samo rub input.

Pravila

  • Faze su uvijek istim redom i istim nazivima: Ulaz, Planiranje, Istraživanje, Izrada, Provjera, Odobrenje, Distribucija, Doseg. Preskočene faze (Breaking) se ne prikazuju.
  • Samo jedna ćelija je current ili waiting.
  • Komponenta prima listu faza sa stanjem ({ name, state }) i ne računa stanje sama.

ApprovalCard

Svijetla
KT3 · Odobrenje objaveRok 12 min

Hajduk dovodi novog trenera do kraja tjedna

Sport · novinar · predano 10:02
  • Lektura u Labradoru12 prihvaćeno
  • Fact checkBez nalaza
  • Naslov i SEOOdabrano
  • Konkurencija2 portala već imaju temu
Tamna

Kartica kontrolne točke na kojoj čovjek odlučuje; komponenta Pčele složena od shadcn Card, Badge i Button. Isti sadržaj ide i u Teams Adaptive Card.

Dijelovi

  • Traka na vrhu u human-soft: oznaka točke ("KT3 · Odobrenje objave") i preostali rok. Kad rok padne ispod 5 min, traka prelazi u warning-soft i warning.
  • Naslov priče (h3) i meta.
  • Nalazi: jedan red po provjeri, sa značkom ishoda.
  • Odluke: glavna (default), povrat (outline) i odbijanje (ghost u destructive). Odbij i Vrati traže kratko obrazloženje u dijalogu.

Pravila

  • Rub kartice je human, jer kartica čeka čovjeka.
  • Odluke odgovaraju ishodima kontrolne točke u procesu (Odobri, Zakaži, Vrati, Odbij). Gumbi ne nude ono što proces na toj točki ne dopušta.
  • Nakon odluke kartica se zaključava i pokazuje tko je odlučio i kada.

Sidebar

Svijetla
Tamna

Glavna navigacija Deska; shadcn Sidebar (SidebarProvider, SidebarGroup, SidebarMenu, SidebarMenuButton), na mobitelu kao Sheet.

Pravila

  • Na vrhu je znak i naziv. Na whitelabel instalaciji tu je klijentov logo, a znak Pčele ostaje samo u podnožju ("Pokreće Pčela") ako ugovor to dopušta.
  • Grupe: Redakcija (Ulaz, Plan priča, Pregled priče, Doseg) i Postavke (Proces, Agenti). Postavke vidi samo administrator.
  • Aktivna stavka ima sidebar-accent i ikonu u honey-ink. Broj stavki koje čekaju je u mono, desno.
  • Ne graditi vlastiti okvir stranice; okvir je uvijek shadcn Sidebar.