ProactiveProject

← Agenda di Casa

Verifiche e conformità di Agenda di Casa

Prima di pubblicare l'app ho controllato, con l'aiuto dell'IA, cosa c'è dentro: chi ha scritto ogni file, con quale licenza, se ci sono pezzi copiati da altri progetti e se le librerie hanno difetti di sicurezza noti.

Qui trovi i risultati, anche quelli scomodi. Nessuno strumento dà garanzie assolute: questi controlli servono a dichiarare in modo onesto cosa contiene l'app. Non sono una consulenza legale.

Controlli fatti il 31 ottobre 2026 sulla versione 0.8 dell'app e sulla cartella server/, e ripetuti il 4 novembre 2026 sui file cambiati fino alla versione 0.8.1. Il 21 novembre 2026 ho rifatto i controlli sui difetti di sicurezza (vedi sotto).

Il 04/11/2026 sono cambiati solo i numeri di versione: in www/app.js la riga VERSIONE (da 0.8 a 0.8.0) e in prepara-android.py una funzione nuova, versione_android(), che scrive lo stesso numero dentro l'APK (prima dentro l'APK restava scritto "1.0"). Il funzionamento dell'app non è cambiato. Controlli rifatti il 04/11/2026 su prepara-android.py: SCANOSS nessuna somiglianza (1/1 none); ScanCode file letto, 0 errori, nessuna licenza scritta dentro il file (la licenza GPL-3.0-or-later e il titolare ProactiveProject gli vengono da REUSE.toml, che resta conforme).

Versione 0.8.1 (04/11/2026): aggiunte in testa a prepara-android.py le righe SPDX-FileCopyrightText: 2026 ProactiveProject e SPDX-License-Identifier: GPL-3.0-or-later, come negli altri file di codice; cambiato il numero in www/app.js. Controlli sul file: SCANOSS nessuna somiglianza (1/1 none); ScanCode 1 file letto, 0 errori, gpl-3.0-plus, titolare ProactiveProject. Il funzionamento dell'app non è cambiato.

Ricontrollo del 21/11/2026 (versione 0.8.1, codice non cambiato): npm audit rifatto sulle librerie dell'app con le stesse versioni: nessuna voce nuova, sono le stesse della tabella più sotto. npm audit sui plugin di Capacitor, sia alle versioni minime dichiarate in package.json sia alle più recenti compatibili: nessun difetto noto. PocketBase: nessun avviso di sicurezza più recente di quelli già corretti nella 0.39.7 (il server usa la 0.41.1).

In breve

Controllo Strumento Risultato
Autore e licenza di ogni file REUSE 6.3 tutti i file hanno autore e licenza
Pezzi di codice copiati da altri progetti SCANOSS nessuno trovato (4 file su 4)
Testi di licenza e copyright dentro i file ScanCode 4 file su 4 letti, 0 errori
Librerie e caratteri sono quelli dichiarati impronte SHA-256 16 file su 16 identici agli originali
Immagini e icone controllo a mano tutte disegnate apposta per l'app
Difetti di sicurezza noti npm audit + controllo del codice nessuno raggiungibile nell'app
Dati personali nel codice ricerca nel testo nessuno

La licenza dell'app

Ho scelto "versione 3 o successiva" perché alcune librerie usano la licenza Apache 2.0, che è compatibile con la GPL 3 ma non con la GPL 2.

L'elenco preciso, file per file, è in REUSE.toml.

Librerie e caratteri

Le librerie non vengono scaricate quando l'app parte: sono copiate dentro l'app (www/lib/), così l'app funziona anche senza internet. Per ognuna ho scaricato il pacchetto originale e confrontato le impronte SHA-256: i file dell'app sono identici, byte per byte, agli originali. Quindi la versione dichiarata è quella vera e nessuno li ha modificati.

Componente Versione Licenza Note
pdf.js 3.11.174 Apache 2.0
jsQR 1.4.0 Apache 2.0
tesseract.js e tesseract.js-core 5.1.1 Apache 2.0 vedi "Cosa resta da fare"
Dati della lingua italiana (tessdata_best) 4.0.0 Apache 2.0 il pacchetto npm dichiara MIT ma non ha testo di licenza: vale la licenza della fonte, Tesseract OCR
SheetJS (xlsx) 0.18.5 Apache 2.0
jsPDF 4.2.1 MIT contiene pako 2.1.0 (MIT e Zlib); aggiornato dalla 2.5.1 dopo questi controlli
JSZip 3.10.1 MIT (a scelta MIT o GPL 3) contiene pako (MIT)
Capacitor e plugin ufficiali 8 MIT
Capacitor Biometric Auth 10 MIT
Atkinson Hyperlegible 5.0.22 (Fontsource) SIL OFL 1.1
Bricolage Grotesque 5.2.4 (Fontsource) SIL OFL 1.1
JetBrains Mono 5.1.0 (Fontsource) SIL OFL 1.1

Tutte queste licenze sono libere e compatibili con la GPL 3. I testi completi sono in www/lib/licenze/ e www/fonts/, e l'elenco leggibile dentro l'app è in www/LICENZE.txt.

Una nota onesta. Dentro jsPDF c'è un piccolo pezzo di codice di un altro autore (un lettore di colori, di Stoyan Stefanov) con una licenza informale: "Use it if you like it" ("usalo se ti piace"). Non è una licenza standard, ma è un permesso esplicito e senza condizioni, ed è distribuito da anni dentro jsPDF con licenza MIT. Lo segnalo per trasparenza.

Pezzi copiati da altri progetti (snippet)

Con SCANOSS ho confrontato i file scritti per l'app (app.js, prepara-android.py, il Dockerfile e la migrazione del server) con un grande archivio di codice pubblicato. A SCANOSS vengono mandate solo le "impronte" dei file, non il codice.

Risultato: nessuna somiglianza con codice di altri progetti.

Non ho controllato con SCANOSS le librerie (sono di altri autori per definizione, e le ho controllate con le impronte) né i file HTML e CSS.

Difetti di sicurezza noti

Ho usato npm audit sulle stesse versioni delle librerie dell'app e dei plugin Capacitor. npm audit elenca tutti i difetti noti di un pacchetto e di tutto quello che si porta dietro, anche le parti che nell'app non arrivano. Per questo ho controllato ogni voce: arriva nell'app? L'app usa la parte difettosa? Ho cercato nel codice tutti i punti in cui l'app usa quella libreria, non solo quelli protetti.

Voce Arriva nell'app? Conclusione
Capacitor CLI → rimraf, glob, minimatch No: è lo strumento di compilazione sul computer non presente (il 21/11/2026 npm audit non li segnala più)
pdf.js → canvas, node-pre-gyp, tar (il 31/10 anche glob, minimatch, rimraf) No: servono a pdf.js solo quando gira su Node, non nel telefono non presente
pdf.js 3.11.174: un PDF fatto apposta può eseguire codice (GHSA-wgrm-67xf-hhpq) Sì mitigato: l'app apre i PDF in 2 punti di app.js e in tutti e 2 c'è isEvalSupported: false, che blocca il difetto
SheetJS 0.18.5: due difetti nella lettura di file Excel (GHSA-4r6h-8v6p-xvw6, GHSA-5pgg-2g8v-p4x9) Sì non raggiungibile: l'app usa solo XLSX.write (esportazione) e non legge mai file Excel
jsPDF 2.5.1: 12 difetti, alcuni critici Sì (fino alla versione 0.7) non raggiungibili: l'app usava solo new jsPDF, addImage con un JPEG appena creato dal browser e output("blob"). Aggiornato comunque alla 4.2.1, che non ha difetti noti
jsPDF → DOMPurify (19 difetti) No: jsPDF lo usa solo per la funzione html(), che l'app non usa, e DOMPurify non è dentro l'app non presente
Plugin Capacitor che finiscono nell'app (core, app, filesystem, notifiche, share, impronta) Sì nessun difetto noto
Server: PocketBase 0.41.1 Sì (sul tuo server) nessun difetto aperto: gli ultimi avvisi sono stati corretti nelle versioni 0.37.4 e 0.39.7
Server: Alpine Linux Sì (sul tuo server) aggiornato a 3.24, supportata fino a giugno 2028

Cosa resta da fare

Se trovi un errore in questo documento o un problema nell'app, scrivimi a ProactiveProject@proton.me: mi aiuti a migliorarla per tutti.

Come rifare i controlli

Servono un computer con Linux (io ho usato Ubuntu), il codice completo del repository e una connessione a internet. I comandi vanno lanciati nella cartella principale del repository.

1. Autore e licenza di ogni file (REUSE)

sudo apt install reuse
reuse lint

Deve finire con Congratulations!.

2. Pezzi copiati da altri progetti (SCANOSS)

pipx install scanoss
mkdir -p ~/controllo-snippet && cp www/app.js prepara-android.py server/Dockerfile server/pb_migrations/*.js ~/controllo-snippet/
scanoss-py scan ~/controllo-snippet -o ~/snippet.json && grep -o '"id": "[a-z]*"' ~/snippet.json | sort | uniq -c

Va bene se compaiono solo righe "id": "none".

3. Licenze e copyright dentro i file (ScanCode)

pipx install uv && uv tool install --python 3.13 --with "pluggy==1.6.0" scancode-toolkit-mini
scancode -cl --json-pp ~/scancode.json ~/controllo-snippet

Con pluggy 1.7.0 ScanCode si ferma con l'errore did not find any 'pre_scan' hooks: per questo il comando fissa la versione 1.6.0.

4. Le librerie sono quelle originali

sha256sum www/lib/*.js www/lib/tesseract/*.js www/lib/lang/ita.traineddata www/fonts/*.woff2

Confronta i risultati con i file dei pacchetti originali, alle versioni scritte nella tabella sopra (npm pack NOME@VERSIONE scarica il pacchetto senza installarlo).

5. Difetti di sicurezza noti

mkdir -p ~/controllo-librerie && cd ~/controllo-librerie
npm init -y > /dev/null
npm install --package-lock-only --ignore-scripts jspdf@4.2.1 jsqr@1.4.0 jszip@3.10.1 pdfjs-dist@3.11.174 xlsx@0.18.5 tesseract.js@5.1.1 tesseract.js-core@5.1.1
npm audit

Non lanciare npm audit fix: le librerie dell'app sono copiate a mano in www/lib/. Per ogni voce controlla se arriva nell'app e se l'app usa la parte difettosa (es. grep -n "getDocument" www/app.js).