Hogyan építs irányítópultot: adatforrások, KPI-k, diagramok és hozzáférés

Irányítópult építéséhez indulj ki abból a kérdésből, amelyre választ kell adnia, és az emberekből, akik olvassák, definiálj kevés mutatót pontosan, kösd össze a mutatók mögötti adatokat, és válassz minden mutatóhoz egyszerű diagramot. Ezután döntsd el, ki melyik számokat láthatja. Egy AI-alkalmazásépítő percek alatt elkészíthet egy csiszolt irányítópultot; a nehéz rész, és ez dönti el, hogy bíznak-e benne, az adatok és a definíciók helyes beállítása.

Kérdésekkel kezdj, ne diagramokkal

Az az irányítópult, amely mindent mutatni akar, egyszer lesz megnyitva. Mielőtt diagramokon gondolkodnál, válaszold meg:

• Kinek készül? Az alapítónak, egy értékesítési csapatnak, az üzemeltetésnek, befektetőknek, az ügyfeleidnek?
• Milyen döntéseket támogat? „Kell-e még egy ügyfélszolgálatos?” egy kérdés, amelyre egy irányítópult válaszolhat. „Mutasd meg az adatainkat” nem.
• Milyen gyakran fogják nézni? A napi üzemeltetési irányítópultnak friss adat és riasztás kell; egy havi vezetői nézetnek nem.

Írj három-öt kérdést. Mindegyikből egy vagy két mutató lesz.

Definiáld pontosan minden mutatót

A legtöbb irányítópult-vita valójában definíciós vita. Írj rövid definíciót minden számhoz:

Illessz ezeket a definíciókat a promptba. Az AI különben egy ésszerűnek tűnő számítást választ, amely lehet, hogy nem egyezik azzal, ahogy a vállalkozásod számol.

Honnan jönnek az adatok

Két elv mindenhol érvényes:

1. A kulcsok maradjanak a szerveren. Az API-kulcsok és adatbázisjelszavak az app környezeti változóiban legyenek, soha ne a böngészőkódban.
2. Döntsd el a frissességet. Több API-ból lekérdezni minden oldalbetöltéskor lassú, és elérheti a korlátokat. Sok üzleti irányítópulthoz órás vagy éjszakai szinkron a saját adatbázisodba, az oldalon egy „utoljára frissítve” idővel, egyszerűbb és megbízhatóbb.

Ha az API-k újak neked, az mi az API és mi az adatbázis útmutatók alapokat adnak.

Válaszd ki a megfelelő diagramot

• Egyetlen szám a változással („4,2 millió Ft, 8%-kal több az előző hónapnál”) — mutatókártya. A legtöbb irányítópult leghasznosabb eleme.
• Trend időben — vonaldiagram. Oszlopdiagramot csak kevés időszakhoz használj.
• Kategóriák összehasonlítása — vízszintes oszlopdiagram, érték szerint rendezve.
• Egész része — egymásra halmozott oszlop. A kördiagram csak két-három szeletnél működik.
• Részletek és kivételek — rendezhető, kereshető, szűrhető táblázat. Gyakran hasznosabb bármilyen diagramnál.

A színek legyenek következetesek: egy szín az „ezt az időszakot”, egy halvány a „összehasonlítást”, a piros csak azokra, amelyek figyelmet igényelnek.

Ki mit lát

A hozzáférést építés előtt döntsd el:

• Belső, mindenki mindent lát — a legegyszerűbb. Üzleti adat esetén még mindig kell bejelentkezés.
• Szerepalapú — az értékesítés az értékesítési számokat látja, a pénzügy a fedezeteket, a vezetők a saját csapatukat.
• Ügyfélnek szóló — minden ügyfél csak a saját adatait látja. Minden lekérdezésnek a szerveren kell szűrnie az ügyfél fiókja szerint. Teszteld két különböző ügyfélként való bejelentkezéssel.

Nyilvános URL-en, bejelentkezés nélküli irányítópult bevétel- vagy ügyféladatokkal egy adatszivárgás, amelyre valaki előbb-utóbb rábukkan.

Egy első prompt, amely működik

Építs értékesítési irányítópultot egy 10 fős B2B szoftvercégnek. Közönség: az alapítók és az értékesítési vezető, akik minden hétfőn nézik. Áttekintő oldal: mutatókártyák az e havi új MRR-hez, a teljes MRR-hez, az e havi új ügyfelekhez, az e havi lemondott ügyfelekhez és a csatorna értékéhez, mindegyiknél az előző hónaphoz képest mért változással; vonaldiagram az MRR-ről az elmúlt 12 hónapra; oszlopdiagram az új üzletekről forrás szerint. Üzletek oldal kereshető, rendezhető táblázattal (cég, felelős, érték, szakasz, záró dátum), szűrőkkel felelős és szakasz szerint. Mutatódefiníciók: az MRR az aktív havi előfizetési összegek összege, az éves csomagok osztva 12-vel; a lemorzsolódás azokat az ügyfeleket számolja, akiknek az előfizetése ebben a hónapban megszűnt. Egyelőre használj reális mintaadatot egy adatbázisban — a Stripe-ot később kötjük be. Mutass egy „utoljára frissítve” időt. Bejelentkezés kötelező. Tiszta oldalsávos elrendezés.

Építési lépések

1. Elrendezés mintaadattal. A mutatókat és diagramokat addig egyeztesd, amíg az adatok fiktívek és könnyen módosíthatók.
2. Egy valódi forrás összekötése. Minden számot kézzel ellenőrizz a forrásrendszerrel szemben. Ha az MRR eltér attól, amit a Stripe mutat, derítsd ki, miért, mielőtt továbbmennél.
3. A többi forrás hozzáadása, egyenként, mindegyiket ellenőrizve.
4. Ütemezett frissítés vagy betöltéskori lekérdezések, „utoljára frissítve” címkével.
5. Szűrők — először a dátumtartomány, aztán az egy vagy két további, amelyet az emberek kérnek.
6. Bejelentkezés és szerepek.
7. Üres és hibaállapotok — mit mutasson az oldal, ha egy forrás nem elérhető, vagy egy szűrő nem ad eredményt.
8. Oszd meg a közönséggel, majd egy hónap után távolíts el mindent, amit senki nem néz.

Tedd gyorssá

A lassú irányítópultot ritkábban nézik. Előre számold ki a drága összegeket (egy napi összesítő tábla, ahelyett hogy minden rendelést végigpásztáznál), lapozd a nagy táblázatokat, és először a fő kártyákat töltsd be, hogy az oldal a diagramok befejezése előtt is hasznos legyen. Ha egy szám sokáig számolódik, mutasd, mikor számolták utoljára, ahelyett hogy minden látogatáskor újraszámolnád.

Gyakori hibák

• Túl sok diagram. Ha mindent kiemelsz, semmi sincs kiemelve.
• Definiálatlan mutatók. Két ember, aki ugyanazt az irányítópultot nézi, ugyanarra a következtetésre jusson.
• Soha nem ellenőrzött számok a forrással szemben. Egy rossz szám, és az emberek nem bíznak meg az egész irányítópultban.
• Minden oldalbetöltéskor minden API lekérdezése. Lassú, törékeny és néha drága.
• Nincs dátumkontextus. Mindig mutasd az időszakot és az összehasonlítást.
• Titkok a frontenden. Egy böngészőben látható API-kulcsot bárki kimásolhat, aki megnyitja az oldalt.

Mikor a BI-eszköz a jobb választás

Ha az adataid már egy adatbázisban vagy adattárházban vannak, és a fő felhasználók elemzők, akik fel akarják fedezni, szűrni és saját diagramokat készíteni, akkor egy BI-eszköz — Looker Studio, Power BI, Metabase és mások — jobban szolgálja őket, mint egy egyedi építés. Sok SaaS-eszköznek is van jó beépített riportja; ezeket érdemes ellenőrizni, mielőtt újraépítenéd. Az egyedi irányítópult akkor nyer, ha ügyfeleknek vagy nem elemzőknek készül, olyan logikát vagy jogosultságot igényel, amelyet a BI-eszköz nem tud kifejezni, az üzletedre jellemző módon kombinál forrásokat, vagy egy már meglévő terméked része.

Ha a feladat kevésbé a számok nézése, és inkább rekordok módosítása, akkor adminfelületre vagy belső eszközre van szükséged — lásd: hogyan építs belső eszközt. Ha a számaid ma táblázatban vannak, a hogyan alakíts táblázatot appá a következő jó olvasmány.

Építés a Mythexszel

A Mythexen leírod az irányítópultot, az ügynök pedig az élő előnézetben építi meg az oldalakat és a diagramokat, reális mintaadattal kezdve, és amikor a számoknak meg kell maradniuk, átvált egy dedikált Postgres adatbázisra. A dokumentáció irányítópult használati esete kezdő promptot tartalmaz. Ha az adataid olyan eszközben vannak, mint a Google Sheets, a fiókot a Connectors segítségével kötheted be, és megkérheted az ügynököt, hogy olvassa be és építsen belőle irányítópultot.

Beépített adattárház-összekötők nincsenek magához az appho — a BigQuery, Snowflake, Stripe és hasonlók esetén az app a saját API-jukat hívja, a kulcsokkal, amelyeket projekt-titokként tárolsz. Az irányítópultot nézők bejelentkezése és szerepei az általad épített app részei. Ha promptból indulnál, nézd meg az irányítópult-sablonokat, például a metrikai irányítópultot.

Kérdések