Sgulatscha da stampa¶

En la chasa da tir hai per il pli dus geners da stampaders: in stampader d'etichettas a la cassa (p.ex. Niimbot B1) ed in stampader da fegls en il biro per cartas da curuna, rangaziuns e la bilantscha da cassa. Latiers po vegnir in stampader da quittanzas per quittanzas da cassa (p.ex. Epson TM-m30III). In navigatur na po cuntanscher directamain nagin dals dus – el avra il pli il dialog da stampa.

La Sgulatscha da stampa schlia quai: In pitschen apparat agent en la rait da la societad (p.ex. in M5Stack Core2) tschertga sez ils stampaders ed als annunzia a l'app. En l'administraziun fixescha ins mo pli tge document che va sin tge stampader. Suenter stampa „Stampar“ directamain (suenter ina curta dumonda: stampader u PDF) sin il dretg apparat.

Paket Societad

La sgulatscha da stampa fa part dal paket Societad. Senza quest paket stampa l'app sur il navigatur; apparats ed attribuziun restan memorisads. Vesair Abunament.

Uschia è quai collià¶

flowchart LR
    subgraph app["Schiess-Auswertungen"]
        direction TB
        doks["Etichettas · Cartas da curuna<br/>Rangaziuns · Bilantscha"] --> weiche{{"Sgulatscha da stampa<br/>Attribuziun"}}
        weiche --> ws[("Cua<br/>per stampader")]
    end

    subgraph haus["Rait da la societad en la chasa da tir"]
        direction TB
        agent["Apparat agent<br/>M5Stack Core2"]
        niimbot["Stampader d'etichettas<br/>Niimbot B1"]
        laser["Stampader da fegls<br/>p.ex. Samsung, HP"]
    end

    agent -- "1 · annunzia ses stampaders" --> ws
    ws -- "2 · prenda las incumbensas" --> agent
    agent -- Bluetooth --> niimbot
    agent -- "WLAN / IPP" --> laser
    agent -- "3 · Quittanza" --> ws

L'apparat agent prenda, l'app na trametta mai. Perquai na dovri nagins ports averts e nagina IP fixa – i funcziuna davos mintga router.
Stampaders chatta el sez: stampaders Niimbot via Bluetooth, stampaders da rait via la rait (AirPrint/IPP). Cun aviar, mintga 10 minutas e cun smatgar in buttun.
Mintga incumbensa vegn quittada. Sch'il stampader è stizzà, sch'el dorma u sch'i manca palpiri, resta l'incumbensa en la cua e vegn, uschespert ch'il stampader è puspè pront.
L'app producescha en il format ch'il stampader chapescha – PDF u PostScript per stampaders da fegls, in maletg finì per etichettas. Drivers na dovri nagins.

Cun box en la chasa da tir¶

Sch'i stat ina box en la chasa da tir, dumonda l'apparat agent omadus: il cloud e la box. La box chatta el da sasez en la rait da la societad (mDNS), in'adressa na sto ins betg endatar. Uschia stampa la cassa sin la box er senza internet.

flowchart LR
    cloud[("Cloud")] -- "Configuraziun<br/>(apparats, clavs, attribuziun)" --> box[("Box")]
    agent["Apparat agent"] -- prenda --> cloud
    agent -- "prenda<br/>(er offline)" --> box
    box -. "la chatta via mDNS" .- agent

Endrizzà vegn en il cloud. La box surpiglia apparats, clavs ed attribuziun cun la sincronisaziun (mintga ura u via Apparat → Sincronisar ussa).

Insaquants dis senza internet

Sch'igl internet manca, pon ins cuntinuar ad endrizzar sin la box:

Novs stampaders annunzia l'apparat d'agent sez a la box.
Ins po crear agens apparats d'agent sin la box (marcads cun «mo sin questa box»); lur clav vala immediatamain.
Ins po endatar sorts da rollas.
L'attribuziun po vegnir remplazzada – ella vala lura mo sin la box («remplazzada sin la box»). Utilisar l'attribuziun dal cloud annullescha quai.

Cur che l'internet è puspè avant maun, unescha la sincronisaziun tut: il medem stampader cumpara mo ina giada, las incumbensas che spetgan restan. Apparats dal cloud na pon betg vegnir midads sin la box – mo en il cloud.

La box stampa sezza¶

La box è sezza in apparat d'agent per stampaders en sia rait – senza apparat supplementar e senza clav da tippar. Suenter il cuppliar s'endrizza ella sezza tar il cloud e cumpara en l'administraziun sco apparat «Box …».

Stampaders A4 (p.ex. Samsung, HP): ella als chatta via AirPrint/IPP e stampa PDF u PostScript.
Stampaders d'etichettas WLAN: Zebra (ZPL) e Brother QL. Ella legia la grondezza da las etichettas or dal stampader.
Stampaders da quittanzas en la rait: Epson TM (p.ex. TM-m30III, TM-T20, TM-T88) via il port 9100. Ella legia model, numer da serie e stadi dal palpiri or dal stampader.
Niimbot (p.ex. B1): cun cabel USB a la box u via Bluetooth, sche la box ha in adapter (p.ex. mini-PC) – model, numer da serie, rulla ed accu legia ella or dal stampader. Senza Bluetooth (RUTC) via in Core2. Il B1 accepta mo ina colliaziun: box u Core2, betg omadus.

Sin la box po ins deactivar quai sut Stampar → Stampaders (Sgulatscha da stampa) cun La box stampa sezza …, p.ex. sch'in Core2 serva tut ils stampaders. Sche la box ed in Core2 chattan il medem stampader, cumpara el duas giadas – ins attribuescha in, stampà vegn mo là.

Brother QL

Il sustegn per Brother QL suonda la descripziun dal protocol, ma n'è anc betg vegnì empruvà vi d'in apparat real.

Endrizzar¶

1. Crear l'apparat agent¶

Administraziun → Stampar → Stampaders (Sgulatscha da stampa), sutvart tar Nov apparat agent endatar in num (p.ex. „Core2 stand“) e Crear. L'app mussa la clav da l'agent e l'adressa dal server – mo ussa, ina giada.

Transferir immediatamain la clav

La clav vegn memorisada mo sco summa da controlla e n'è pli tard betg pli legibla. Sch'ella è ida a perder: tar l'apparat Nova clav – la veglia na vala lura betg pli. Destinaziuns ed attribuziun restan.

2. Endrizzar l'apparat agent (M5Stack Core2)¶

Envidar il Core2. Senza parameters avra el il WLAN PWA-Agent-XXXX.
Colliar cun il telefonin u il laptop; la pagina d'installaziun s'avra per il pli da sasezza (uschiglio http://192.168.4.1).
Endatar: WLAN e pled-clav da la chasa da tir, Server-URL e Agent-Schlüssel dal pass 1. Tar Box im Vereinsnetz laschar la predefiniziun „automatisch finden“.
Speichern & neu starten.

Suenter in pèr secundas stat l'apparat en l'administraziun sco online, sutvart ils stampaders ch'el ha chattà.

2b. Cupplar l'agent PWA (agent autonom)¶

L'agent PWA funcziuna era senza box, p.ex. sin in mini-PC sper il stampader. El na enconuscha betg il cloud da sasez – ins al cuppla cun in link:

Tar l'emprima aviada stampa el in bon d'installaziun (bon, etichetta u A4) cun l'adressa da la WebUI, il PIN ed in code QR. Sin l'apparat mussa pwa-agent pin il PIN; pwa-agent pin neu metta in nov.
Qua giusut tscherner Cupplar in agent PWA. L'app mussa in link da cuppladira cun code (valaivel 15 minutas, mo ina giada).
En la WebUI da l'agent (http://<apparat>:2000/) s'annunziar cun il PIN, sut Agiuntar colliaziun encollar il link – u tscherner «Schiess-Auswertungen» ed endatar mo il code – e Examinar. El mussa tgi che respunda (uniun), lura Colliar.

Lura cumpara el qua sco Agent da stampa … cun ses stampaders. Sch'ina box da la medema uniun è en la rait, la chatta el sez e stampa er senza internet.

Tschertgar stampaders da rait (WebUI, carta Stampaders, cun PIN; a partir da l'agent 0.9.40 – la WebUI è per rumantsch a partir da 0.9.41): Activà tschertga l'agent stampaders en la rait (Bonjour e Niimbot en l'atgna rait /24). Il meglier installar l'agent mo là, nua ch'i dat stampaders: stampaders da rait via in sulet agent (p.ex. il RUTC), stampaders USB e Bluetooth a l'apparat, al qual els èn colliads. Sin quests apparats deactivar la tschertga, uschespert che la quittanza d'installaziun è stampada – uschiglio annunzia mintga agent anc ina giada ils medems stampaders da rait. Deactivà emblida el immediatamain ils stampaders da rait gia annunziads; adressas endatadas a maun valan vinavant.

Separar:

Box u app a l'agent (p.ex. in vegl colliament sut «Apps en la rait»): en la WebUI da l'agent cun il PIN, tar Apps en la rait → Separar.
Colliament cun il cloud da l'agent: en la WebUI sut Colliaziuns → Separar. Las endataziuns «da l’app» administrescha la box sin il medem apparat.
Allontanar l'agent dal tuttafatg: en il cloud qua tar ils agents ✕, lura Propi stizzar? – suenter er separar sin l'apparat, uschiglio s'annunzia el vinavant cun sia veglia clav.

Rollas (apps che stampan directamain via l'agent)¶

Apps che trametten sezzas a l'agent PWA (p.ex. in sistem da cassa) stampan ad ina rolla sco «Bon» u «Küche» empè dad in stampader determinà. Ina rolla è ina successiun: Drucker (stampader), Ersatz (remplazzament), 2. Ersatz (2. remplazzament). L'agent prenda l'emprim stampader ch'è pront e sa il format; sch'in croda ora, midan er las incumbensas che spetgan.

En la WebUI, carta Rollen (rollas): cun il PIN tscherner Rolle, Drucker, Ersatz e 2. Ersatz, lura Speichern (memorisar) – uschia er midar u allontanar. La carta mussa la chadaina da mintga rolla; il stampader che stampa gist porta aktiv.

Per sviluppaders dad apps: POST /v1/auftraege cun { rolle: "Bon", format, daten } empè da ziel; GET /v1/rollen furnescha las rollas.

3. Controllar ils stampaders¶

Mintga stampader annunzià ha in'atgna lingia cun status (pront, betg vis, errur), accu ed etichettas restantas resp. palpiri en il chascham.

Num mussà – p.ex. „Cassa“ u „Biro“ empè dal numer dal model. Cumpara er sin il display da l'apparat agent. Memorisà cun bandunar il champ, senza buttun. Ha la stampanta sezza in num (num da host, p.ex. „Bon-Theke“), mussa l'app quel, uschè ditg ch'i n'è betg definì in num. Sut il num stattan model e numer da serie. Enconuscha in agent in Niimbot en la rait mo sur l'adressa IP, stat enconuschent mo sur l'IP … sperasvi (en l'attribuziun ed en la substituziun «· sur IP …»). Tscherner quel cun numer da seria – l'IP mida cun DHCP.
Stampa da test (stampader d'etichettas), Quittanza da test (stampader da quittanzas) resp. Pagina da test (stampader da fegls, A4) controllescha l'apparat sez – er senza attribuziun.
Cua mussa incumbensas che spetgan, stampadas e betg reussidas cun quintaders ed indicaziuns, pertge che insatge na stampa betg – cun anc ina giada e stizzar (cun dumonda).
Tschertgar stampaders tar l'apparat, sch'in stampader nov vegn latiers.

Nova rolla d'etichettas

Il Niimbot annunzia la sort da sia rolla, betg sia grondezza. Tar ina sort nunenconuschenta dumonda l'administraziun ina giada la ladezza e l'autezza en millimeters (p.ex. rolla 10262260 = 50 × 30 mm). Suenter vegn mintga rolla da questa sort renconuschida.

4. Attribuir¶

Sisum tar Attribuziun tscherna ins per gener da document il stampader:

Gener da document	Stampader	Tge
Etichettas	stampader d'etichettas	etichettas a la cassa, etichettas da remplazzament
Cartas da curuna	stampader da fegls	cartas da curuna (A6)
Diploms	stampader da fegls	diploms (A4) – vid = sco ils documents
Documents	stampader da fegls	rangaziun, bilantscha da cassa, campiunadi, glista da curunas, quint da muniziun, AMM (A4)
Quittanzas da cassa	stampader da quittanzas	quittanza da cassa suenter il pajament a la cassa
Bon da pajament	stampader da quittanzas	bon cun QR suenter la registraziun d’in pajament (Pajament); vid = il stampader da las quittanzas da cassa
Bon da resultat	stampader da quittanzas	resultat cun singuls culps e maletg dals culps (Curunas); vid = il stampader da las quittanzas da cassa
Portal dals resultats: bon / A4	stampader da quittanzas / stampader A4	tar il kiosc dal portal dals resultats; vid = betg stampar al portal (mai il stampader dal biro)

A la tscherna stattan mo stampaders dal gener adattà. „– sco fin ussa –“ munta: nagina sgulatscha, il navigatur stampa sco pli baud. Excepziun Etichettas: Quellas vegnan stampadas mo via la sgulatscha – senza attribuziun annunzia la cassa «Nagin stampader attribuì per «Etichettas».»

Mintga attribuziun ha in buttun Test. El stampa via la medema via sco en funcziun (etichetta da test, carta da test A6, quittanza da test resp. pagina da test A4) e controllescha uschia stampader ed attribuziun. La pagina da test numna stampader, attribuziun e format.

Avis „Format“

Sch'in stampader da fegls na sa ni PDF ni PostScript, trametta l'app PDF cun „il stampader renconuscha sez“. Quai funcziuna tar blers, ma betg tar tut ils models – l'administraziun mussa lura in avis. Cun la pagina da test empruvar immediatamain.

Stampader da remplazzament¶

Sut il stampader da mintga attribuziun stat Remplazzament: «– nagin remplazzament –» u in auter stampader dal medem gener. Sch'il stampader n'è betg pront – el annunzia ina errur (p.ex. nagin palpiri, viertgel avert), el è betg vis u ses apparat agent è offline – ed il remplazzament è pront, van novas incumbensas al remplazzament. Er incumbensas che spetgan anc e n'èn anc betg vegnidas prendidas da l'agent midan (entaifer var 10 secundas); quellas gia prendidas restan – nagut na vegn stampà duas giadas. Quai vala er per las etichettas da la cassa. Cur ch'il stampader è puspè pront, van novas incumbensas puspè ad el.

Uschè ditg ch'il remplazzament stampa, mussa l'attribuziun «stampader n’è betg pront – i stampa remplazzament.»; incumbensas midadas mussan en la cua «(remplazza stampader)».

Il remplazzament vegn endrizzà en il cloud; sin la box vegn el mo mussà («Il stampader da remplazzament vegn endrizzà en il cloud.») e vegn cun la sincronisaziun. Vegn il stampader da remplazzament allontanà, n'ha l'attribuziun simplamain nagin remplazzament pli.

5. Chascha, palpiri, colur, varts¶

Sch'il stampader A4 attribuì sa quai, cumparan sut l'attribuziun champs da tscherna – emplenids cun quai ch'il stampader annunzia sez:

Champ	Exempel
Chascha	Chascha 1, Alimentaziun multipla
Palpiri	Palpiri normal, Cartun
Colur	Colur, Nair e alv
Varts	d’ina vart, da duas varts

Uschia serva in stampader omadus: documents or da la chascha, nair e alv e da duas varts, cartas da curuna or da l'alimentaziun multipla sin cartun. «– il stampader decida –» lascha la tscherna al stampader.

Va ina stampa en ina chascha che vegn emplenida a maun (alimentaziun multipla), mussa l'app immediatamain «Metter palpiri u cartas en …»; il stampader spetga fin che las cartas èn en. In stausch da palpiri u palpiri che manca stat en cleartext en il status dal stampader.

Core2

Il Core2 resguarda chascha e palpiri pir suenter in update dal firmware; fin lura stampa el sco fin ussa.

En funcziun¶

Etichettas van suenter la cumpra a la cassa directamain al stampader d'etichettas attribuì.
Cartas da curuna stampan directamain da la fanestra da curunas.
Quittanzas da cassa: Suenter Incassà en daners bars resp. TWINT → Pajà va ina quittanza al stampader da quittanzas – mo sch'in stampader è attribuì a l'attribuziun „Quittanzas da cassa“. Senza attribuziun na dat i nagina quittanza. Sin la quittanza stattan societad (sch'ins vul cun logo), occurrenza, num, las concurrenzas pajadas cun import, arrundaziun, total e moda da pajament. Sch'il stampader sa bloccha, è il pajament tuttina registrà; la cassa di, sche la quittanza spetga.
Documents: „Stampar“ sin rangaziun, bilantscha da cassa & cumpagnia metta la pagina sin A4 (tabellas largias orizontalas, lingia da titel sin mintga pagina, numers da las paginas) e la trametta al stampader. Suenter cumpara giusut a dretga in avis cun Stampar en il navigatur – sch'ins vul tuttina pli gugent il dialog da stampa.
Senza annunzia (rangaziun publica) stampa adina il navigatur.

Firmware dals apparats d'agent¶

Nova firmware per ils apparats agent (p.ex. il Core2) vegn via il server – l'apparat la prenda sez, sco las incumbensas da stampa. Da sez na vegn nagut actualisà: ina nova versiun vegn pir sin l'apparat, cur che l'administraziun la deliberescha.

Sut Stampar → Stampaders (Sgulatscha da stampa) → Firmware dals apparats d'agent stat per tip d'apparat (p.ex. esp32-core2):

Tscherner la versiun e smatgar Deliberar. Senza fanestra da temp cumenza quai immediatamain; cun fanestra da temp (p.ex. 02:00–05:00) mo en quest temp. Mo tscherner la versiun na basta betg: uschè ditg ch'ella n'è betg deliberada, stat „anc betg deliberà“ ed il buttun ha num p.ex. „Deliberar 0.11.4“.
Sutvart stattan ils apparats da quest tip cun la versiun che funcziuna actualmain e cun il stadi da l'actualisaziun: sin emprova, actualisà u actualisaziun fallida. Sch'igl apparat indica „Bootloader ohne Rückfall – einmal per USB aktualisieren“, al manca anc il nov bootloader – senza el na datti nagin return automatic a la versiun veglia.
In singul apparat po survegnir a dretga in'atgna versiun (p.ex. l'emprim empruvar mo cun in). „– sco tuts –“ al metta puspè tar la deliberaziun per tuts.

In apparat actualisescha mo, sch'el n'ha nagut da stampar, sch'i n'ha naginas quittanzas avertas e sch'el è collià cun il current resp. sch'igl accu ha dapli che 50 %. La nova versiun funcziuna l'emprim sin emprova: Sch'ella na cuntanscha nagin server entaifer 10 minutas, aviescha l'apparat da nov e funcziuna puspè cun la versiun veglia. Empruvar anc ina giada la medema versiun = anc ina giada Deliberar.

Cun box en la chasa da tir

La deliberaziun vegn fatga en il cloud. Ella arriva cun la sincronisaziun sin la box, la datoteca da firmware prenda la box silsuenter sezza. Da lura davent survegnan ils apparats l'actualisaziun er senza internet. La box mussa mo il stadi.

Per il gestiunari

Datotecas da firmware chargia si mo il gestiunari (Master → Firmware), ellas valan per tut las societads. Acceptada vegn mo ina image d'app signada (pwa-agent.bin, signada cun espsecure.py sign_data --version 2 --keyfile <schlüssel> …). L'apparat controllescha sez la signatura e na starta mai ina datoteca estra u betg signada. La clav privata è offline tar il gestiunari, mai sin il server.

Sch'i na stampa betg¶

Indicaziun	Motiv	Remedura
Apparat offline	apparat agent senza current u WLAN	controllar current e WLAN; controllar l'adressa dal server sin l'apparat
Stampader betg vis	stampader stizzà, dorma, ordaifer la purtada u collià cun l'app dal telefonin	envidar il stampader resp. separar l'app dal telefonin – l'incumbensa spetga e vegn lura
Stampader resta betg vis	en reparatura, substituì u davent – suenter trais emprovas dumonda l’apparat el mo pli mintga paucs minutas (fin 30 min)	✕ en la lingia e confermar: l’apparat al emblida, las incumbensas pendentas per el van cun. Sch’el (u ses substitut) returna, al chatta la tschertga – immediat cun Tschertgar stampaders
Stampader errur (p.ex. nagin palpiri, viertgel avert)	messadi dal stampader	eliminar; l'incumbensa cuntinuescha
L'attribuziun mussa «… n’è betg pront – i stampa ….»	il stampader attribuì n'è betg pront, i stampa il remplazzament	metter en urden il stampader – cur ch'el è puspè pront, van novas incumbensas puspè ad el
Stampader da quittanzas „Palpiri bunamain vid“	la rolla va a fin (il status resta „pront“)	preparar ina nova rolla; tar „Nagin palpiri“ spetga la quittanza, fin che la nova rolla è en
La cassa annunzia «Nagin stampader attribuì per «Etichettas».»	a l'attribuziun «Etichettas» n'è attribuì nagin stampader	sut Attribuziun tscherner tar «Etichettas» in stampader d'etichettas
Incumbensa betg reussida	il stampader ha refusà	en la cua anc ina giada; observar l'avis davart il format
L'apparat agent mussa „Schlüssel ungültig“	clav fallida u generada da nov en l'administraziun	generar da nov la clav ed endatar en l'apparat
L'apparat agent mussa „Schlüssel an der Box (noch) unbekannt“	La box n'enconuscha anc betg l'apparat resp. la nova clav – ella surpiglia omadus pir cun la sincronisaziun	Sin la box Apparat → Sincronisar ussa. Fin lura prenda l'apparat vinavant tar il cloud; i na va nagut a perder.
L'apparat agent na chatta nagina box	box ed apparat agent en differentas raits (mDNS na tanscha betg sur in router), u box anc betg colliada	omadus en la medema rait; uschiglio endatar l'adressa da la box a maun sin l'apparat

Suenter mintga midament vid apparats u clavs

Nov apparat agent, Nova clav u attribuziun midada valan en il cloud immediatamain, sin la box pir suenter la proxima sincronisaziun. Tgi che vul cuntinuar a lavurar immediatamain: sin la box Apparat → Sincronisar ussa.