Documentazionealpha 0.7.7
Documentazione
Guide e riferimenti per l'alpha 0.7.7. Ci sono pagine per chi gestisce il server, per chi usa le app ogni giorno e per chi le costruisce.
Tutta la gestione sta nella console del motore, all'indirizzo http://SERVER:8080/console/ (anche /_/, l'indirizzo del pannello di PocketBase, porta lì), dove si entra con il proprio account della rubrica: le pagine di Pyrite (Panoramica, app, Carica app, Persone, Gruppi, Unità, Storico del motore, Backup, Analisi, Strumenti, Lavori pianificati, AI, Archivio, Certificati, Regole di rete, Home del portale e Impostazioni del motore) stanno nella barra a sinistra o nel menu in alto, a scelta di ogni persona, accanto alle pagine di PocketBase del motore. Ci entrano i Proprietari, che vedono tutto, e gli Admin (Admin Persone e Admin App), che vedono solo quello che il loro livello permette. Le pagine di Pyrite e il portale sono in inglese e in italiano: la lingua si sceglie in fondo alla pagina. I nomi delle voci possono ancora cambiare: se una voce non corrisponde, cercala per funzione.
01 /Le pagine
- Guida per l'amministratore
Requisiti, primo avvio, console e livelli, unità, doppia autenticazione, persone e gruppi, accessi, ruoli dentro le app, nuove app e approvazione, regole di rete, firewall di Windows, HTTPS e Let's Encrypt, storico del motore, backup e ripristino, copia dei backup su una cartella di rete, servizio di Windows, avvio senza nessuno collegato e aggiornamento del motore.
- Guida per le persone
Il portale, l'accesso unico, il profilo, la prova di un file Excel, come si esce e cosa fare quando un messaggio blocca l'ingresso.
- Concetti
App, istanza, porta d'ingresso, rubrica, gruppi, ruoli, livello base e strumenti: cosa vogliono dire in questo prodotto.
- La scheda app.json
Tutti i campi della scheda di un'app, compresa la sezione
auth, con l'esempio dell'app «Parts price list». - Standard per gli agenti
Il file da dare all'agente di IA che costruisce un'app: regole, strumenti del motore, lingue, prove e pacchetto zip per «Carica app», con un'app di esempio bilingue. Il testo di riferimento è in inglese, con la traduzione italiana.
- Sicurezza e note operative
Stesso indirizzo per portale e app, firewall, amministrazione centralizzata, la console e i livelli, chiusure di sicurezza delle app e limiti dell'alpha.
- Novità per versione
Le novità dell'alpha 0.7.7, 0.7.6, 0.7.5 e 0.7.4 e, in breve, quelle delle versioni precedenti.
02 /Indirizzi
Al posto di SERVER va l'indirizzo IP o il nome del PC su cui gira il motore.
| Cosa | Indirizzo | Chi entra |
|---|---|---|
| Portale | http://SERVER:8080/ | Tutti. Il login serve per le app riservate. |
| Console del motore | http://SERVER:8080/console/ | Solo i Proprietari e gli Admin, con il loro account della rubrica. |
| Ogni app | http://SERVER:<porta dell'app>/ | Dipende dall'app: con login entra solo chi ha l'accesso, libera per tutta la rete. |
L'elenco delle app con i loro indirizzi è il portale stesso; nella console la pagina di ogni app mostra il suo indirizzo in testa. La porta del motore di solito è la 8080; quella di ogni app è scritta nella sua scheda. Per portale e app usa sempre la stessa forma di indirizzo: o sempre l'IP o sempre il nome. Il motivo è in Sicurezza e note operative.
03 /Convenzioni
I percorsi delle cartelle partono dalla cartella del programma, quella che contiene pyrite.exe. apps\<id> indica la cartella di un'app, dove <id> è il suo identificativo, per esempio apps\parts-pricelist.