Regisztrációtól a REST API-ig — a főbb modulok, beállítások és billentyűparancsok egy helyen. Görgess lefelé, vagy ugorj bárhova a bal oldali tartalomjegyzékből.
Regisztráció, első workspace, első projekt — mindössze pár perc alatt.
Regisztráció
Nyisd meg a spire.hu oldalt, kattints a Regisztráció gombra, és add meg a neved, email címed és egy min. 8 karakteres jelszót. Google fiókkal is beléphetsz — ilyenkor jelszó nem kell, a Google biztosítja az azonosítást.
Munkaterület létrehozása
Regisztráció után az Új workspace oldalra kerülsz. Itt adod meg a workspace nevét, az URL-jét (pl. spire.hu/acme), az időzónáját és a pénznemét.
Első projekt
A sidebarban kattints a Projektek menüpontra, majd az Új projekt gombra, és egyszerűen add meg a projekt nevét, színét és (opcionálisan) ikonját. A projekt key-je (pl. ACME) automatikusan generálódik a névből, és utólag nem módosítható.
Első feladat
A projekt oldalán a Feladat létrehozása gombbal vagy a lista / kanban nézet adott szekciójában helyben adhatsz hozzá új feladatot. A feladat a projekt rövidítésével és egy sorszámmal azonosítódik: ACME-1, ACME-2, …
Csapattag meghívása
A Beállítások → Tagok oldalon email címmel hívsz meg új tagokat a workspace-be (Admin / Tag / Vendég szerepkörrel). Regisztráció után a meghívott az elfogadás linkkel azonnal belép. Projektekhez és csapatokhoz csak workspace-tagok rendelhetők — egyesével, vagy egy egész csapatot (ha van) egyszerre hozzáadva.
Ha bezárod a böngészőt az Új workspace oldalon anélkül, hogy elküldenéd a formot, legközelebbi belépéskor ismét ugyanide kerülsz. A rendszer szándékosan nem hoz létre helyetted „alapértelmezett” munkateret — a név a te döntésed. Ha mégis meggondolod magad, az oldal alján található a Fiók törlése link (GDPR szerinti törléshez való jog).
Amikor sok feladat van, projektekbe rendezve átlátható marad a munka.
Egy projekt a workspace-eden belüli önálló munkaegység — tipikusan egy termék, egy ügyfél, egy szakterület vagy egy nagyobb kezdeményezés. Minden feladat pontosan egy projekthez tartozik. A projekt fejlécében lévő ⭐ ikonnal kedvencekbe teheted — ezek a sidebaron külön blokkban jelennek meg a gyors eléréshez.
| Státusz | Mikor használd |
|---|---|
| Tervezett | Kitaláltuk, de még nem kezdődött el |
| Aktív | Jelenleg folyik rajta a munka |
| Szünetel | Időlegesen leállítva, később folytatjuk |
| Kész | Befejeződött, de még tartogatjuk |
| Archivált | Lezárt, csupán referencia |
Egy projektet három nézetben láthatsz — a Feladatok tab bal oldali eszköztárán, a kereső előtti ikonokkal válthatsz közöttük (desktopon / tableten):
Lista
Táblázatos nézet. Státusz szerint csoportosítva, minden feladat egy sorban. J/K-val léptethető, Enter-rel nyitható.
Kanban
Oszlopok a státuszok szerint. Drag-and-drop-pal mozgathatod a feladatokat, a státusz automatikusan frissül.
Timeline
Idővonalas Gantt-szerű nézet. A feladat létrehozásának napjától annak határidejéig jelenik meg, átlátva az átfedéseket és határidőket.
A Lista és Kanban nézet alapértelmezetten státusz szerint csoportosítja a feladatokat — a csoportosítás-váltóval (a nézet-váltó mellett) átkapcsolhatsz Egyedi szekciók szerinti csoportosításra. A szekciókat a projekten belül tetszés szerint hozhatsz létre (pl. „Ajánlatok”, „Megrendelések”, „Utánkövetés”), sorrendjük drag-and-drop-pal változtatható, és az új feladatok abba a sávba kerülnek, ahol létrehozod őket.
A beépített mezőkön (státusz, prioritás, felelős, határidő, címkék) túl a projekten belül saját adatmezőket is létrehozhatsz a + Egyedi mező gombbal — pl. „Ügyfélszám”, „Büdzsé”, „Forrás”. Nyolc típus közül választhatsz: szöveg, szám, dátum, jelölőnégyzet, URL, email, egy-választós és többválasztós lista. A mezők a projekt minden feladatának részletek paneljén megjelennek, értékét inline töltheted ki.
A feladat a spire alapegysége — minden, ami csinálni kell, egy feladat.
A feladat egy önállóan végrehajtható tétel: egy bug-fix, egy feature, egy tervezési döntés, egy teendő. Minden feladat egy projekthez és opcionálisan egy ciklushoz tartozik, és pontosan egy felelős (assignee) rendelhető hozzá.
| Típus | Mikor használd |
|---|---|
| Feladat | Általános tennivaló — alapértelmezett típus |
| Hiba | Hibás működés, amit javítani kell |
| Igény | Külső / belső ügyfél által kért új funkció |
| Ötlet | Még nem véglegesített gondolat |
| Státusz | Jelentés |
|---|---|
| Várólistán | Még nem priorizált, vár a sorára |
| Teendő | Priorizált, kész elkezdeni |
| Folyamatban | Aktívan dolgozik rajta valaki |
| Ellenőrzés alatt | Kész, de várja az áttekintést |
| Kész | Befejezett és elfogadott |
| Elvetve | Nem lesz megcsinálva |
| Prioritás | Mikor használd |
|---|---|
| Sürgős | Azonnal foglalkozni kell vele |
| Magas | Fontos, mielőbb |
| Közepes | Normál prioritás |
| Alacsony | Ha van idő, ráér |
| Nincs | Nincs eldöntve / nem releváns |
Egy feladatra kattintva jobbról kicsúszik egy slide panel. Itt találod…
@Említéssel (értesítést küld a megemlített tagnak), és emoji-reakciók minden kommenten.Rövidebb, időzített iterációk — a sprint spire-beli megfelelője.
A ciklus egy időintervallum (tipikusan 1–4 hét), amelyben egy feladatcsomagon dolgozol. Egy workspace-en belül bármennyi ciklusod lehet, de egyszerre csak egy lehet aktív.
| Státusz | Jelentés |
|---|---|
| Tervezett | Létrejött, de még nem kezdődött el |
| Aktív | Jelenleg fut — a ciklus-nézeten kiemelve |
| Kész | Lezárt; a statisztika a teljesítményt mutatja |
Egy feladatot a részletek panelből vagy a ciklus oldalán adhatsz hozzá a ciklushoz. A ciklus oldalán három tabot találsz: Áttekintés (statisztika, burndown chart és AI összefoglaló), Feladatok (az összes hozzárendelt feladat listaként), és Részletek (leírás, tulajdonságok).
Az Áttekintés tabon a burndown chart alatt egy AI-generált narratíva segít ránézésre látni a ciklus állapotát — pacing (hol tartasz vs. hol kellene), ki a legaktívabb, milyen típusú feladatok dominálnak (hiba, funkció, ötlet), határidő-csúszások és ajánlás a hátralévő időre. A szöveget egy kattintással frissíted, a csapat mindenki ugyanazt a generált változatot látja (nem külön-külön égetjük a tokeneket). Legalább 3 feladat kell a ciklushoz az összefoglaló generálásához, és naponta 1x frissíthető.
Amikor a ciklus lezárul — vagy a státusza Kész-re vált, vagy a befejezési dátuma elmúlt — az Áttekintés tab alján megjelenik egy 3-kártyás visszatekintő űrlap: „Mi ment jól?", „Mi nem ment jól?", „Mit javítunk?". Mezőnként 500 karakter, automatikusan mentődik gépelés közben. A csapatnak így van egy állandó helye ahol reflektálni tud a ciklusra, a tanulságok pedig a következő ciklus tervezésekor kéznél vannak.
Az értesítéseid központi helye — @Említés, hozzárendelés, státuszváltás, komment.
A Bejövő oldal (/inbox) minden, téged érintő értesítést mutat — a legújabbak legfelül. Az olvasatlanok kékkel jelöltek, és a sidebar / bottom nav Bejövő ikonján is látod a számukat real-time frissülve.
| Típus | Mikor kapod |
|---|---|
| Hozzárendelés | Rád osztanak egy feladatot |
| Státuszváltás | A hozzád rendelt feladat státusza változik |
| Új komment | Valaki hozzászól a feladatodhoz |
| @Említés | Valaki megemlít egy kommentben vagy leírásban |
| Meghívó | Új workspace-be hívnak |
| Határidő | A feladatod határideje ma vagy holnap jár le |
| Parancs | Művelet |
|---|---|
| J | Ugrás a következőre |
| K | Ugrás az előzőre |
| Enter | Megnyitja a kapcsolódó feladatot |
| E | Archiválás |
| Shift+E | Olvasottnak jelölés |
Az in-app értesítések mellett emailt is kaphatsz ugyanezekről az eseményekről — típusonként ki/be kapcsolható a Beállítások → Értesítések oldalon. Az in-app értesítések alapértelmezetten mind be vannak kapcsolva; az emailek közül a hozzászólás, a státuszváltás és az @Említés alapból ki van kapcsolva, hogy ne zajongjon, a többi (hozzárendelés, meghívó) alapból be.
Mondd el szabadon, vagy gépeld be — a spire AI strukturált feladattá alakítja.
Desktopon a sidebar keresőmezőjéből (vagy a ⌘K billentyűparanccsal) a Command palette nyílik meg, amelynek tetején találod a Gyors rögzítés mezőt. Mobilon a bottom nav középső + gombjára nyílik közvetlenül. Ide írhatsz vagy mondhatsz bármit — a rendszer kielemzi és feladatjavaslattá alakítja, amit véglegesítés előtt még módosíthatsz.
A mezőn belüli mikrofon ikonra kattintva beszédet rögzíthetsz — a böngésző Web Speech API-ján keresztül. A beszédet a böngésző fordítja szöveggé (nem küldjük ki a hangot külső szerverre), aztán a szöveg ugyanúgy feldolgozásra kerül, mint gépelés esetén.
Egyszerre több feladatot is felvehetsz — a generált listában bármelyiket szerkesztheted, törölheted, vagy kihagyhatod mielőtt mentesz. Tömeges meeting-jegyzetekből pillanatok alatt lesz feladat-lista.
Az AI feldolgozás havi szinten, felhasználónként 500 hívásig ingyenes — ez bőven elég egy normál munkarend mellett, és a spire-n belüli visszaélést is megakadályozza (a Groq költség miatt). A kvóta UTC-alapon, a naptári hónap elején nullázódik. A Gyors rögzítés oldalán figyelmeztető sávot mutatunk a kvóta 80%-ától; a limit elérése után a generálás átmenetileg szünetel, és kézi rögzítés ugyanúgy működik tovább. Ha tartósan nagyobb használatra van szükséged, írj a support-nak.
Munkaterület-szintű szerepkörök, csapatok és meghívók.
| Szerepkör | Mit tehet |
|---|---|
| Tulajdonos | Mindent, amit az admin + workspace törlése, tulajdonosváltás. Workspace-enként pontosan egy tulajdonos van. |
| Admin | Workspace beállítások, tagok kezelése, címkék, csapatok, API tokenek, webhookok. |
| Tag | Projektek és feladatok létrehozása, szerkesztése, hozzászólás. Nem fér hozzá a beállításokhoz (kivéve saját profil). |
| Vendég | Csak olyan projekteket lát, amikbe kifejezetten meghívták. Nem hozhat létre új projektet. |
A Beállítások → Tagok oldalon adhatsz meg egy email címet és egy szerepkört. A meghívott egy emailt kap egy 7 napig érvényes linkkel, amely egy előnézeti oldalra vezet: látja, melyik munkatérbe hívták és milyen email címre. Ha még nincs spire fiókja, innen továbbléphet regisztrációra (email előre kitöltve); ha van, bejelentkezik. Ezután egyetlen Csatlakozás gombbal lép be a workspace-be a megadott szerepkörrel.
Egy workspace-en belül csapatokba szervezheted a tagokat — például „Marketing”, „Értékesítés”, „Ügyfélszolgálat”. Egy tag több csapathoz is tartozhat. Egy csapatot egyben hozzáadhatsz projekthez is (a csapat tagjai kerülnek be egyenként a projekt tagok közé).
A személyes fiókod és a workspace-ed testreszabása — fülenként egy rövid áttekintés.
Profil
Név, munkakör, profilkép, email cím, nyelv (magyar / angol), időzóna — ezek csak rád vonatkoznak. Itt található a GDPR adat-export és a fiók törlése is.
Értesítések
Email- és in-app értesítések típusonkénti ki/be kapcsolása. Meghatározhatod, milyen események küldenek értesítést.
Biztonság
Jelszó módosítása, kétlépcsős azonosítás (TOTP) be/ki, aktív belépések listája.
Munkaterület
Név, URL (slug), időzóna, pénznem, logó feltöltés.
Tagok
Meghívás email-lel, szerepkör módosítás (tulajdonos / admin / tag / vendég), tagok eltávolítása.
Csapatok
Tagok csoportokba szervezése a workspace-en belül (pl. Marketing, Értékesítés, Ügyfélszolgálat). Egy csapat egyben hozzáadható projekthez is.
Címkék
Workspace-szintű címke-könyvtár (szín, név) — a címkék feladatokhoz rendelhetők.
API tokenek
Programozott hozzáféréshez személyes token generálása, scope-okkal és opcionális lejárattal.
Import / Export
Teljes workspace JSON export (backup / migráció), Zod-validált importálás.
Audit napló
Ki-mikor-mit csinált a workspace-ben. Visszakereshető, szűrhető. Tulajdonos + admin látja.
Számlázás
Aktív csomag, trial státusz, fizetési előzmények (béta alatt ingyenes).
Gyors navigáció, keresés és AI egyetlen inputmezőből — ⌘K.
A Command palette a spire „mindenre egy billentyű” felülete. ⌘+K billentyűparancsra nyílik; desktopon a sidebar keresőmezőjére kattintva, mobilon pedig a bottom nav kereső ikonjára (a + mellett). A tetején található a Gyors rögzítés mező, alatta átkereshető az aktuális workspace minden erőforrása: projektek, feladatok, ciklusok, címkék, workspace-tagok — státusz-pötty, prioritás-ikon és avatarok is megjelennek az eredmények mellett.
| Parancs | Művelet |
|---|---|
| ↑ / ↓ | Eredmény-váltás |
| Enter | Kiválasztott eredmény megnyitása |
| Esc | Palette bezárása (vagy egy szintet vissza) |
A keresésben megjelenő feladatok sorának jobb oldalán egy nyíl (›) ikon drill-in módba vált: státusz, prioritás, felelős és címke módosítható közvetlenül a palette-ből, anélkül hogy meg kellene nyitni a feladat részletes nézetét. A mutáció futása után egy rövid toast jelzi a sikert, a palette bezárul, a lista / kanban / timeline mindenhol azonnal frissül. Esc a pickerben egy szintet vissza lép (az akciókra), kettő Esc teljesen bezárja.
A spire teljes billentyűzet-navigálható. Ezek a leggyakoribbak.
| Parancs | Művelet |
|---|---|
| ⌘+K | Parancs-paletta / keresés |
| ⌘+Z | Utolsó művelet visszavonása (5 másodperces ablak) |
| G+H | Kezdőlap |
| G+N | Bejövő |
| G+P | Projektek |
| G+I | Feladataim |
| G+C | Ciklusok |
| G+S | Beállítások |
| ⌘+/ | Súgó |
| ? | Súgó (alt.) |
| Parancs | Művelet |
|---|---|
| J | Következő tétel |
| K | Előző tétel |
| C | Feladat létrehozása (projekt / feladatok / ciklus oldalon) |
| Enter | Kiválasztott elem megnyitása |
| Esc | Panel bezárása / fókusz törlése |
| Parancs | Művelet |
|---|---|
| ⌘+Enter | Mentés (komment, új feladat, szerkesztés) |
| Esc | Szerkesztés elvetése |
| Parancs | Művelet |
|---|---|
| E | Kiválasztott értesítés archiválása |
| Shift+E | Kiválasztott értesítés olvasottnak jelölése |
Programozott hozzáférés — integrációk, automatizáció, saját kliens.
A spire REST API-ja minden UI-ban elérhető funkciót lefed. Az API tokenek munkaterületenként generálhatók a Beállítások → API tokenek oldalon (tulajdonos + admin).
| Base URL | https://spire.hu/api (éles) / http://localhost:3001/api (dev) |
| Formátum | JSON request body + JSON response |
| Autentikáció | Authorization: Bearer <token> |
| Rate limit | Per-endpoint: auth-jellegű műveletek (register, login, refresh, jelszó reset, 2FA setup, AI, export, import) szigorúbb limittel, a CRUD-endpointok jelenleg nincsenek limitálva. Túllépés esetén 429 válasz Retry-After fejléccel. |
A tenant-scoped (workspace-függő) endpointok a /api/v/ prefix alatt találhatók; az auth- és user-szintű végpontok az /api/ és /auth/ alatt.
| Prefix | Tartalom |
|---|---|
/auth | Bejelentkezés, regisztráció, refresh, Google OAuth, jelszó reset |
/api/workspaces | Workspace lista, létrehozás, váltás, átadás, törlés |
/api/profile | Saját profil, jelszó módosítás, 2FA, onboarding flag |
/api/gdpr | Adat-export, fiók törlés, aktív belépések |
/api/lookup | Cross-workspace erőforrás-feloldás (?type=project&key=ACME) |
/api/invitations | Meghívó előnézet + elfogadás (public + auth) |
/api/v/)| Prefix | Tartalom |
|---|---|
/api/v/projects | Projekt CRUD, tagok, csapatok hozzárendelése |
/api/v/issues | Feladat CRUD, kommentek, reakciók, bulk műveletek |
/api/v/cycles | Ciklus CRUD, feladat-hozzárendelés |
/api/v/labels | Címke CRUD |
/api/v/teams | Csapat CRUD, tag-hozzárendelés |
/api/v/members | Workspace-tagok, meghívás, szerepkör |
/api/v/notifications | Értesítések, olvasottság, preferenciák |
/api/v/search | Teljes szövegű keresés |
/api/v/ai | Gyors Rögzítés (triage) |
/api/v/custom-fields | Egyedi mezők (projekt-szintű) |
/api/v/favorites | Kedvencek toggle + sorrend |
/api/v/sections | Szekciók CRUD, reorder, feladat-mozgatás |
/api/v/home | Kezdőlap statisztikák |
/api/v/attachments | Fájlfeltöltés + kezelés |
/api/v/recurring-issues | Ismétlődő feladatok |
/api/v/data | Workspace JSON export / import |
/api/v/audit-logs | Tevékenységnapló |
/api/v/api-tokens | API tokenek CRUD |
/api/v/webhooks | Webhook CRUD + delivery log |
bashcurl -H "Authorization: Bearer $SPIRE_TOKEN" \ -H "Content-Type: application/json" \ "https://spire.hu/api/v/issues?status=in_progress&per_page=25"
Elérhető query paraméterek: status, priority, type, assignee_id, project_id, cycle_id, parent_id, search, page, per_page (max 100).
json{ "data": [ { "id": "01J7...", "identifier": "ACME-42", "title": "Fizetési flow összecsuklik 3D Secure után", "status": "in_progress", "priority": "high", "type": "bug", "assigneeId": "01J7...", "dueDate": "2026-04-25", "createdAt": "2026-04-18T10:23:11Z", "updatedAt": "2026-04-19T09:11:42Z" } ], "meta": { "total": 1, "page": 1, "perPage": 25 } }
| Kód | Jelentés |
|---|---|
400 | Érvénytelen kérés — lásd error.code |
401 | Hiányzó vagy lejárt token |
403 | Nincs jogosultság az adott erőforráshoz |
404 | Az erőforrás nem létezik vagy nem a te workspace-edben van |
409 | Ütközés (pl. foglalt slug) |
429 | Rate limit túllépés |
500 | Szerverhiba — ha ismétlődik, írj a silner@spire.hu-nak |
/docs) a közeljövőben érkezik a roadmap szerint. Addig a fentiek alapján használhatod a fő CRUD műveleteket — ha valamihez konkrét segítség kell, írj a silner@spire.hu-ra.