Nostrautica docs

Nostrautica — Průvodce pro organizátory

Nostrautica je aplikace pro akce postavená na jedné myšlence: na vaší akci nejvíc záleží na tom, kdo koho potká. Účastníci si nahrají krátké video, ve kterém se představí, a volitelný AI koordinátor jim na jeho základě řekne, s kým by se měli bavit a proč. Tento průvodce vás provede od úplného začátku až po běžící akci.

Co vás čeká

  1. Vytvoření identity (jednou).
  2. Vytvoření akce — volitelně rovnou s připojeným AI koordinátorem, nebo později.
  3. Sdílení akce — otevřený odkaz, pozvánkové kódy, nebo obojí.
  4. Schvalování účastníků (nebo necháte pozvánkové kódy schvalovat automaticky).
  5. Zveřejňování novinek, úprava vzhledu stránky akce a běh akce.

Všechno běží ve vašem prohlížeči. Nic se nenastavuje na serveru — aplikace ukládá data akce zašifrovaná na otevřené síti Nostr. Klíče akce drží váš prohlížeč, proto používejte jeden prohlížeč, který si necháte (a jakmile vás k tomu aplikace vyzve, zazálohujte si identitu).

Poznámka k uspořádání aplikace. Jakmile jste uvnitř akce, spodní lišta je vázaná na danou akciPřehled, Lidé, Spojení, Novinky a Více se týkají akce, ve které právě jste, a kompaktní hlavička nad nimi ukazuje její název a váš status. Další dvě karty, Přednášky a Chat, se objeví jen tehdy, když tyto funkce zapnete (§6.5) — pro vás i pro účastníky. Vaše globální věci (všechny vaše akce, zprávy, nastavení, vaše identita) jsou v nabídce Více. Jako organizátor tam navíc najdete Správa akce, která otevře administraci popsanou v §3.

1. Vytvoření identity

Otevřete aplikaci. Na úvodní obrazovce napište své jméno a klepněte na Vytvořit mou identitu (můžete přidat i fotku). Žádný e-mail, žádné heslo — účet vznikne okamžitě. Pokud už Nostr používáte, klepněte na Už jste na Nostru? Přihlaste se a místo toho použijte svůj klíč, rozšíření prohlížeče nebo vzdálený podepisovač.

Tip: tento krok nemusíte dělat zvlášť — pokud se odhlášení rovnou pustíte do vytváření akce, aplikace vám organizátorskou identitu vytvoří v rámci téhož odeslání.

Jakmile se vaše identita vytvoří, zobrazí se vám karta se zálohou. Udělejte to hned: klepněte na Kopírovat můj tajný klíč a vložte ho někam bezpečně (do správce hesel). Kdokoli má tento klíč, je vámi; bez něj ztracený profil prohlížeče znamená ztracenou akci. Nabídka „Další způsoby zálohování" nabízí i obnovovací odkaz e-mailem nebo soubor chráněný heslem.

Karta se zálohou klíčeKarta se zálohou klíče

2. Vytvoření akce

Zvolte Vytvořit akci a vyplňte formulář:

Formulář pro vytvoření akceFormulář pro vytvoření akce

Jazyk akce

Vyberte jazyk, ve kterém vaše akce běží. Začněte psát a vyhledejte ho — podle názvu jazyka ve vašem vlastním jazyce nebo podle dvoupísmenného kódu (napište „česk" nebo „cs" a najdete češtinu). Váš vlastní jazyk, jazyky preferované vaším prohlížečem a angličtina/slovenština/čeština jsou připnuté nahoře; zbytek následuje abecedně.

Výběr jazyka akceVýběr jazyka akce

Jazyk dělá tři věci. Nastavuje výchozí jazyk rozhraní pro účastníky, kteří vaši akci otevřou (i tak si ho mohou přepnout v Nastavení). Nastavuje jazyk, ve kterém píše AI: odůvodnění spojení a shrnutí profilů jsou vždy v jazyce vaší akce, bez ohledu na to, jakým jazykem daný účastník skutečně mluví nebo v jakém nahrává — někdo může nahrát své představení anglicky na české akci a všichni si přesto přečtou, proč by se s ním měli potkat, česky. A když účastník napíše své bio v jiném jazyce, koordinátor zveřejní překlad do jazyka akce, aby si ho mohl přečíst zbytek místnosti — původní text dané osoby zůstává vždy zachovaný a zobrazený také. Výchozí je angličtina; pro anglickou akci ji neměňte.

(Kvůli tomu nikdy nic nemusíte spouštět znovu: když účastník aktualizuje své představení, systém automaticky přepočítá jen spojení, jejichž je součástí.)

Všimněte si poznámky pod formulářem: rotace klíčů funguje jen dopředu — odebrání někoho (§4) chrání budoucí obsah, ne to, co už viděl. Retenční období nastavíte v Administrace → Nastavení → Smazat data účastníků po akci (počet dní, nebo prázdné pole pro neomezené uchování) — účastníci vidí deklarované období při připojení, a jakmile uplyne, koordinátor smaže i své vlastní kopie, nejen zveřejněné záznamy. Jde o skutečný úklid, ne o absolutní záruku, že každá poslední kopie je všude pryč (smazání na relayích je jen nejlepší snaha a zálohy jsou samostatná věc) — přesné limity popisuje Šifrování a soukromí.

Po vytvoření dostanete odkaz ke sdílení, kontrolní seznam dalších kroků a potvrzenku — každý zveřejňovací krok se hlásí samostatně, takže částečné selhání je zjevné a dá se zopakovat, ne tiše chybí:

Akce vytvořena — odkaz ke sdílení a kontrolní seznamAkce vytvořena — odkaz ke sdílení a kontrolní seznam

Samotná akce, pokud jste se dostali až sem, se vytvoří vždy. Dva vedlejší kroky mohou selhat nezávisle na sobě při špatném připojení — zápis vás mezi účastníky a odeslání instalačního grantu koordinátorovi, pokud jste ho vybrali na formuláři — a každý má vlastní tlačítko Zkusit znovu přímo v potvrzence, místo aby vás nutil vyplňovat celý formulář znovu. Třetí řádek, záloha čeká, jen znamená, že jste si ještě neuložili klíč (viz krok 1) — není to chyba.

Pořádáte stejnou akci znovu za měsíc? Jakmile existuje, otevřete ji a použijte Duplikovat akci z menu akce: nový formulář na vytvoření, předvyplněný názvem, popisem, obrázky, jazykem a nastaveními této akce (název se změní na „Kopie …") — pořád ho musíte projít a odeslat a vznikne z něj úplně nová akce s vlastními klíči a prázdným seznamem účastníků, ne kopie dat.

3. Otevření administrace a sdílení

Klepněte na Otevřít administraci organizátora (kdykoli dostupné i přes Více → Správa akce). Ovládací panel má dvě záložky, takže běžný provoz akce nikdy neznamená rolovat přes jednorázová nastavení:

Čerstvá akce, zatím žádné žádosti:

Přehled administrace, záložka AdministracePřehled administrace, záložka Administrace

Přehledový pás

Nahoře v Administraci, před jakýmkoli detailem o jednotlivcích, kompaktní přehled ukáže stav celé akce na jeden pohled: počty čekajících / schválených / bez představení, jestli jsou v pořádku párování, koordinátor a fakturace, a cokoli, co si opravdu žádá vaši pozornost (selhané úlohy, přednášky čekající na kontrolu), zobrazené nad běžným detailem, ne zapadlé v něm. Pod ním vyhledávací pole a filtr naráz zúží frontu žádostí i seznam schválených — podle jména, nebo podle stavu (čeká, schválený, bez představení, zpracování selhalo, poslaná přednáška) — takže u 200členné akce nemusíte rolovat, abyste našli toho jednoho, kdo vám napsal e-mail:

Přehled administrace organizátoraPřehled administrace organizátora

Klepnutím na řádek kohokoli otevřete detailní panel — jeho odeslaný profil, média a provozní historii (stav koordinátora, odeslané přednášky) — aniž byste opustili seznam.

Ke sdílení máte tři druhy odkazů:

Vygenerované pozvánkové kódy s QRVygenerované pozvánkové kódy s QR

Víc než pár kódů se už nepohodlně rozdává odkaz po odkazu — Kopírovat vše / Stáhnout vezmou všechny vygenerované odkazy jako obyčejný text pro hromadnou korespondenci a Vytisknout pozvánkový list rozloží po jednom QR kódu na kód, víc na stránku, připravené k rozstříhání a rozdání u dveří.

Sdílený vstupní kód — jeden QR pro celý sálSdílený vstupní kód — jeden QR pro celý sál

4. Schvalování účastníků

Žádosti o připojení se objevují v sekci Žádosti o připojení — každá zobrazuje jméno osoby, krátké id, její dovednosti, značku pozvánka, pokud použila kód, a značku 🎥, pokud už nahrála představení. Tlačítko „N čekajících žádostí ↓" nahoře vás tam přesune.

Čekající žádosti o připojeníČekající žádosti o připojení

Klepněte na Schválit u lidí, které chcete pustit dovnitř jednoho po druhém, nebo na Schválit všechny (N), abyste prošli všechny čekající naráz. Hromadné schvalování hlásí výsledek pro každého zvlášť — ve frontě → zveřejňuje se → potvrzeno, nebo selhalo —, takže výpadek připojení u jednoho člověka nikdy neschová, jestli prošlo i zbylých devět; souhrnný řádek („N schváleno, M je potřeba zopakovat") to na konci shrne a každé selhání má vlastní tlačítko Zkusit znovu, místo abyste museli opakovat celou dávku.

Ne každý čekající potřebuje ano nebo ne hned teď: Odmítnout žádost lokálně schová (účastník se to nedozví a dá se to vrátit zpět z malého pruhu „N odmítnutých"), a Nechat čekat ji jen označí jako prohlédnutou, aniž byste se museli rozhodnout — obojí je jen vaše lokální poznámka, ne akce v protokolu, takže si to můžete kdykoli rozmyslet.

Schválení lidé se přesunou do sekce Schváleno. Každá schválená karta má Zpracovat znovu (znovu zveřejní záznam v adresáři / přepočítá spojení) a Odebrat.

Schválení účastníciSchválení účastníci

Schválení účastníci získají přístup k zašifrovanému seznamu účastníků, představovacím videím ostatních a (s připojeným koordinátorem) svým spojením. Schvalování funguje stejně bez ohledu na to, jestli je připojen koordinátor; jeho připojení (§5) se pořád vyplatí kvůli automatickému schvalování a spojením, už ale není nutné jen k tomu, aby fungovalo ruční schvalování.

Odebrání někoho

Klepněte na Odebrat u schválené karty. Dostanete potvrzení vysvětlující důsledek:

„Odebrat {jméno}? Ztratí přístup ke všemu novému. To, co už viděl, se vzít zpět nedá."

Potvrzení automaticky otočí klíč akce pro všechny ostatní, takže odebraná osoba nedokáže dešifrovat nic zveřejněného od tohoto bodu dál. To, co už viděla, se „odvidět" nedá — pokud si nejste jistí, odeberte dřív.

Schválená karta s akcí OdebratSchválená karta s akcí Odebrat

5. Připojení AI koordinátora (párování)

Koordinátor je malá služba, která přepisuje představovací videa, sestavuje profil každého účastníka a počítá, kdo by měl koho potkat. Bez něj akce pořád plně funguje — seznam účastníků, videa, sledování — jen bez automatických spojení a pozvánkové odkazy potřebují vaše ruční schválení.

Vybrat si ho můžete rovnou na formuláři při vytváření (§2), aby běžel od začátku, nebo ho připojit později — stejný seznam, jen na jiném místě: u existující akce je to v Administrace → Nastavení → AI koordinátor, ne v Administraci (ta záložka je pro věci, které děláte opakovaně; připojení koordinátora je jednorázové nastavení). Tak či onak si vyberete koordinátora ze seznamu — každý se na Nostru ohlašuje svým jménem, funkcemi, zveřejněním ochrany soukromí (které kroky AI opouštějí zabezpečenou enklávu) a svým ceníkem (referenční koordinátor je Zdarma). Klepněte na Použít tohoto koordinátora:

Výběr koordinátora ze seznamuVýběr koordinátora ze seznamu

Chcete provozovat vlastního, nebo vám byl dán konkrétní? Rozbalte Nebo vložte npub koordinátora (pokročilé) a místo toho vložte jeho veřejný klíč. Tak či onak uvidíte potvrzení:

Koordinátor připojenKoordinátor připojen

Placení koordinátoři. Koordinátor může být zpoplatněný (náklady na AI párování rostou s počtem účastníků), takže záznam může ukazovat cenu nebo bezplatnou úroveň (např. „do 20 účastníků zdarma"). Je-li kdy potřeba platba, obrazovka Nastavení zobrazí banner Vyžaduje se platba s odkazem na platbu — současný referenční koordinátor je zdarma.

Koordinátor umí číst přihlášky a zveřejňovat jménem akce — záznamy v adresáři, seznam účastníků, spojení, přednášky — ale nikdy nedokáže vydávat se za vás ani měnit nastavení vaší akce. Vyberte si operátora, kterému s touto pravomocí důvěřujete. Na záložce Administrace se objeví tlačítko ↻ Přepočítat všechna spojení (je to opakovaná akce, ne nastavení); použijte ho po náporu nových účastníků.

Výměna nebo odpojení koordinátora

Nejste spokojení s tím, kterého jste si vybrali, nebo za něj už nechcete platit? V Nastavení → AI koordinátor vám Vyměnit otevře stejný seznam k výběru (nebo pole na npub) pro přepnutí na jiného koordinátora — otočí se tím klíč akce a novému koordinátorovi se udělí grant; starý od té chvíle ztrácí přístup. Odpojit ho odstraní úplně, bez náhrady.

Obojí je pro koordinátora, kterého opouštíte, nevratné — jakmile je vyměněný nebo odpojený, nemůže už nad akcí později znovu získat pravomoc. Odpojení konkrétně znamená:

Připojení nebo odpojení během akce

Obě operace jsou bezpečné i během běžící akce, ale restart koordinátora zahodí to, co právě zpracovával v danou chvíli — logika opakování úloh to obnoví, ale pokud aktivně běží akce, je ohleduplnější k účastníkům udělat takovou změnu mezi nápory zpracování (hned po tom, co se vlna nových příchozích uklidní), ne zrovna ve chvíli, kdy někomu odchází představení.

Spuštění koordinátora je samostatný, technický krok (malý démon, který potřebuje ffmpeg a klíč k poskytovateli LLM/přepisu řeči). Podívejte se na packages/coordinator/coordinator.example.toml, operační příručku a README repozitáře. Jeho relaye nasměrujte na stejný relay, který používá vaše akce.

6. Zveřejňování příspěvků pro účastníky

Karta Příspěvky akce (v administraci pod Komunikace) je váš oznamovací kanál — „program je hotový", „změna místa konání", „dnešní večeře je v…". Zadejte titulek a volitelné shrnutí/hlavičkový obrázek, napište text (funguje Markdown — nadpisy, seznamy, odkazy, tučné písmo) a vyberte, kdo ho může číst:

Klepněte na Zveřejnit příspěvek. Viditelnost je po zveřejnění pevná (text můžete později upravit, ale veřejný příspěvek se potichu nedá přepnout na jen pro členy a naopak). Přímo z výběru v editoru můžete taky vložit odkaz na existující příspěvek a připnout příspěvek nahoru stránky akce.

Editor příspěvků akce — vybráno „jen pro členy"Editor příspěvků akce — vybráno „jen pro členy"

Veřejné příspěvky se zobrazují na stránce akce pro každého; příspěvky jen pro členy se schváleným účastníkům zobrazují v Novinkách a v pruhu „Poslední" na Přehledu akce, označené visacím zámkem. Takhle vypadá zámek příspěvku jen pro členy účastníkovi, který se ještě nepřipojil:

Příspěvek jen pro členy, zamčený pro neschváleného účastníkaPříspěvek jen pro členy, zamčený pro neschváleného účastníka

Přizpůsobení stránky akce a jejího vzhledu

V Administrace → Nastavení jsou ještě dva ovládací prvky:

Vzhled — CSS motivu akce se živým náhledemVzhled — CSS motivu akce se živým náhledem

Nejste si jistí, jak vaše změny vypadají někomu, kdo ještě není uvnitř? Menu akce má přepínač Zobrazit jako návštěvník — schová všechno, co je jen pro členy (uzamčené příspěvky, sekce a položky menu jen pro členy), takže vidíte přesně to, co vidí cizí člověk s odkazem, s opouštěcím pruhem pro okamžitý návrat do běžného organizátorského pohledu. Záměrně neexistuje ekvivalentní režim „zobrazit jako člen" — váš vlastní organizátorský pohled je pohledem člena pro všechno, co není specifické pro návštěvníka.

6.5 Přednášky a skupinový chat (obojí novinka, obojí volitelné)

Přednatočené přednášky. V Administrace → Nastavení → Přednatočené přednášky to přepněte na Zapnuto (nebo Nejprve nahrávka, což v navigaci účastníků posune Přednášky před Lidi — vhodné pro formát „podívejte se předem, setkejte se na místě") a Uložte. Schválení účastníci pak mohou přidávat krátké přednášky — nahrané v prohlížeči, nahrané jako soubor, nebo zadané jako neveřejná YouTube / .mp4 URL (vhodné pro přednášky příliš velké na nahrání; koordinátor tyto nikdy nestahuje, takže URL přednášky jsou jen ke sledování).

Odesílání přednášky — výběr zdroje videa a volitelné zapnutí párováníOdesílání přednášky — výběr zdroje videa a volitelné zapnutí párování

Všimněte si, že přednášky už ve výchozím stavu nevstupují do párování: řečník u každé přednášky zvolí, zda zaškrtne „Zpracovat tuto přednášku pro párování?". Mějte to na paměti, pokud se odeslaná přednáška neobjeví ve zdůvodnění něčích spojení — to je očekávané, pokud se řečník nepřihlásil (a u URL přednášek se to nestane nikdy). Šetří to náklady na přepis přednášek, které nikdo nechtěl párovat.

Pole s URL videa a rozpoznaným YouTube odkazemPole s URL videa a rozpoznaným YouTube odkazem

Odeslané přednášky se samy nezveřejní. Karta Moderování přednášek níž v Administraci zobrazuje všechno, co čeká na kontrolu — u každé klepněte na Ukázka, pak ji buď Zveřejněte, aby si ji účastníci mohli pustit, nebo Zamítněte. Dokud to tady neuděláte, nikdo kromě vás nic, co účastník pošle, neuvidí (zveřejnění navíc potřebuje připojeného koordinátora, stejně jako zbytek administrace). Vyhledávání/filtr v Lidech (§3) má filtr Poslaná přednáška, takže se na rušné akci můžete přesunout rovnou k těm, co na vás čekají, bez rolování celým seznamem.

Skupinový chat (Marmot, experimentální). V Administrace → Nastavení přepněte Skupinový chat a uložte — potřebuje připojeného koordinátora (koordinátor provozuje zašifrovanou skupinu: přidává lidi při schválení, odebírá je při odebrání). Jakmile je zapnutý, schválení účastníci dostanou záložku Chat: jedna koncově šifrovaná místnost pro celou akci, oddělená od soukromých zpráv — normální konverzace, která běží, bez čehokoli, co by si museli sami nastavovat, a každé zařízení, na kterém ji otevřou, se připojí automaticky (podrobnosti o jednotlivých zařízeních, které vidí účastníci, jsou v průvodci pro účastníky, část „Skupinový chat").

Přepínač skupinového chatu v administraciPřepínač skupinového chatu v administraci

Skupinový chat se zprávouSkupinový chat se zprávou

Tohle je zatím v rané fázi: připojení do skupiny může na straně serveru chvíli trvat i po zapnutí, a v rozhraní je záměrně označené jako Experimentální — zatím se na něj nespoléhejte jako na jediný způsob, jak se dostat k účastníkům během akce. Příspěvky (§6) zůstávají spolehlivým kanálem.

Tichá pojistka. Skupinu den co den spravuje koordinátor, ale každé zařízení, které si k chatu připojí schválený organizátor, se automaticky povýší i na spoluadministrátora — bez jakéhokoli přihlašování, prostě se to stane. Pokud se někdy ztratí databáze vašeho koordinátora bez zálohy (viz operační příručku), vaše vlastní zařízení pořád dokážou přidávat nebo odebírat členy a udržet místnost v chodu, než si zajistíte náhradního koordinátora. Udržování aktuálních záloh koordinátora zůstává skutečným plánem obnovy; tohle je záchranná síť pro případ, že tento plán selže.

7. Během akce

Řešení problémů a časté dotazy

Příloha: sledování pozvánkových kódů, když prodáváte vstupenky jinde (volitelné)

Všechno výše je pro většinu organizátorů celý příběh. Tahle část je jen pro konkrétní případ, kdy prodáváte vstupenky mimo Nostrautiku — přes Eventbrite, vlastní e-shop, nebo v hotovosti u dveří — kde o kupujícím víte jedinou věc: jeho e-mailovou adresu. Každému pošlete jeden pozvánkový odkaz; někteří se připojí hned, jiní se k tomu nikdy nedostanou, a pár dní před akcí chcete připomenout přesně těm, kdo se ještě nezaregistrovali.

Tohle si ujasněte hned na začátku: aplikace se nikdy nedozví ničí e-mailovou adresu a sama nikomu neposílá žádný e-mail. Rozeslání kódů i spárování kódu s konkrétním člověkem je celé vaše vlastní práce ve vašich vlastních nástrojích — hromadná korespondence, tabulka, případně prodejní systém, který už používáte. Aplikace vám umí říct jediné: která čísla kódů už byla použita.

Každý kód má svoje číslo

Každý vygenerovaný pozvánkový kód má u sebe označení — invite-1, invite-2 a tak dál — ať se objeví kdekoli. Tohle číslo je jediné, co kód spojuje s konkrétním člověkem, a víte to jen vy: zapište si ho do sloupce vedle jeho e-mailu ve chvíli, kdy mu kód posíláte, do vlastního souboru.

Číslování se nikdy nevrací zpátky na začátek. Dnes vygenerujete 20 kódů a za týden dalších 10 — nová dávka začne na invite-21, žádný z už rozdaných kódů si číslo nezmění ani se nezopakuje.

Dva exporty pro dvě různé chvíle

Otevřete Exporty pod pozvánkovými kódy v administraci (§3). Záměrně jsou tu dva různé soubory ke stažení, protože odpovídají na dvě různé otázky ve dvou různých chvílích:

Doporučený postup

  1. Vygenerujte kódy a hned potom exportujte Kódy k rozeslání (formát pro tabulkový program, CSV).
  2. Udělejte hromadnou korespondenci proti seznamu kupujících — u každého e-mailu si ve vlastním souboru poznamenejte číslo odpovídajícího kódu.
  3. Blíž k akci — nebo kdykoli později — znovu otevřete Exporty a stáhněte Kdo se už připojil, s vybraným Jen nepoužité kódy.
  4. Spárujte tato čísla zpátky s e-mailovými adresami ve vlastním souboru.
  5. Napište znovu jen téhle kratší skupině, místo abyste psali úplně všem znovu.

Jaký formát zvolit

Soubor pro tabulkový program je výchozí a je to ten, který chcete na hromadnou korespondenci — otevře se přímo v Excelu, Google Sheets nebo v čemkoli, co už používáte. Obyčejný seznam odkazů je tu spíš pro ty, kdo si rozesílání řeší vlastním skriptem.

Jedna upřímná poznámka

„Použito" počítá jen dopředu: jakmile aplikace jednou uvidí kód jako použitý, zůstane tak označený navždy. „Nepoužito" je ale slabší signál, než se zdá — u akce, která skončila už dávno, nebo pokud jste od připojení některých lidí administraci jednoduše neotevřeli, se pár kódů může pořád tvářit jako nepoužitých, přestože se dotyční lidé skutečně připojili. Berte použito jako jisté a nepoužito jako „asi ještě ne — vyplatí se to ověřit, než někomu napíšete znovu". Drobná nepříjemnost pro člověka, který se už připojil, je lepší než žádná připomínka pro toho, kdo se nepřipojil — ale je dobré předem vědět, že se to může stát, než aby vás to zaskočilo.

U dveří

Pozvánkový list (§3) sám o sobě vynechává každý už použitý kód, takže když si ho vytisknete znovu blíž k akci, každý, kdo se mezitím připojil online, na něm už prostě nebude.