W Repository Wiki • PersonalAviation.eu

Guida a LogChain

LogChain & Petalcoins è un sistema sperimentale di logbook per piloti basato su blockchain, con una valuta digitale interna chiamata Petalcoin (PTL).

Indice

  1. Accesso al sistema
  2. Registrazione di un nuovo utente
  3. Login
  4. Home page – Elenco piloti
  5. Registrazione di un nuovo pilota
  6. Gestione voli
  7. Logbook di un pilota
  8. Wallet PTL di un pilota
  9. Block Explorer
  10. Esportazione completa in Markdown
  11. Note importanti

Accesso al sistema

Il sistema è protetto da login obbligatorio.

URL di accesso:
Tramite Petalous

Registrazione di un nuovo utente

Se è il primo accesso o non hai ancora un account:

  1. Vai su: /register_user (oppure clicca il link “Registrati” dalla pagina di login)
  2. Inserisci:
    • Username (scegli un nome unico)
    • Password (minimo 6 caratteri)
    • Ripeti password
  3. Clicca Registrati
  4. Riceverai un messaggio di successo → vai al login

Login

  1. Vai su /login (o verrai reindirizzato automaticamente se provi ad accedere senza essere loggato)
  2. Inserisci username e password che hai scelto
  3. Clicca Accedi
  4. Verrai portato alla home page con l’elenco dei piloti

Home page – Elenco piloti

Pagina principale dopo il login.

Cosa vedi:

  • Form in alto per registrare un nuovo pilota
  • Tabella con tutti i piloti registrati

Ordine visualizzazione:

  • Piloti in volo in cima (evidenziati)
  • Piloti a terra sotto, ordinati per cognome

Azioni per ogni pilota:

  • Decollo (inserisci partenza, matricola, tipo aeromobile, finalità, pilota responsabile)
  • Atterraggio (inserisci arrivo)
  • Logbook (dettagli voli del pilota)
  • Wallet PTL (saldo Petalcoins e storico)

Registrazione di un nuovo pilota

  1. Nella home, riempi il form in alto:
    • Nome
    • Cognome
    • Numero Brevetto
    • Ore pregresse (opzionale, in decimali)
  2. Clicca Registra
  3. Riceverai un messaggio con il wallet generato (es. Pilota registrato! Wallet: abc123def456)
  4. Se hai inserito ore pregresse > 0 → ricevi subito Petalcoins (100 PTL per ora)

Gestione voli

Decollo

  1. Nella riga del pilota desiderato:
    • Inserisci Partenza (es. LIRF)
    • Inserisci Matricola (es. I-ABCD)
    • Seleziona Tipo aeromobile (Tradizionale o UAS)
    • (opzionale) Scrivi Finalità volo (es. addestramento)
    • (opzionale) Scrivi Pilota responsabile (Self o se diverso)
  2. Clicca Decollo
  3. Il pilota passa in stato “In volo dal…”

Atterraggio

  1. Nella riga del pilota in volo:
    • Inserisci Arrivo (es. LIML)
  2. Clicca Atterraggio
  3. Il pilota torna “A terra”
  4. Se il volo è durato almeno 1 minuto → accrediti automatici Petalcoins (100 PTL per ora di volo)

NB: Non è consentito compilare il logbook dopo il volo! Il decollo va segnato alla partenza e l’atterraggio all’arrivo, il sistema calcolerà il tempo di volo: registrare voli “a caso” è una vecchia abitudine da eradicare.

Logbook di un pilota

Clicca Logbook nella riga del pilota.

Cosa vedi:

  • Nome, cognome, wallet
  • Brevetto attuale
  • Ore pregresse (inserite alla registrazione)
  • Ore registrate in blockchain (solo voli con decollo+atterraggio)
  • Ore totali generali (pregresse + blockchain)
  • Tabella voli con:
    • Decollo / Atterraggio (orari)
    • Durata
    • Partenza / Arrivo
    • Aeromobile / Tipo
    • Finalità volo
    • Pilota responsabile

Wallet PTL di un pilota

Clicca Wallet PTL nella riga del pilota.

Cosa vedi:

  • Nome, cognome, wallet
  • Saldo attuale in Petalcoins (PTL)
  • Storico accrediti PTL (data, importo, motivo, ore volo associate)
  • Logbook completo dei voli (stessa tabella del logbook)

Block Explorer

Clicca Block Explorer dalla home.

Cosa vedi:

  • Tabella con tutti i blocchi (dal più recente in alto)
  • Colonne:

    • Blocco

    • Data
    • Hash (abbreviato)
    • Evento (testo leggibile: Decollo da…, Atterraggio a…, Accredito X PTL, ecc.)
    • Petalcoins (importo se reward, altrimenti —)

Esporta Blockchain

Clicca Esporta Blockchain dalla home o dall’explorer.

  • Scarica un file .md con tutti i blocchi in formato Markdown leggibile
  • Include: numero blocco, timestamp, tipo, dati completi in JSON

Note importanti

  • Petalcoins (PTL): Accreditate automaticamente:
    • Alla registrazione
    • Ad ogni atterraggio (se volo ≥ 1 minuto)
  • Blockchain: tutti i dati (voli, brevetti, accrediti PTL) sono immutabili e salvati in blockchain.json
  • Sicurezza: la password utente è solo per accedere al sistema (non è legata ai piloti)
  • Persistenza su Render: su piano Free, blockchain.json e users.db vengono resettati ad ogni deploy o dopo inattività. È normale per test.

Buon uso di LogChain & Petalcoins! ✈️💰

Torna alla Wiki