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
- Codice, icone e file del server: GNU GPL versione 3 o successiva (
GPL-3.0-or-later). Testo completo inLICENSES/e dentro l'app inwww/LICENSE. - Testi e documenti (questo file, i LEGGIMI,
LICENZE.txt): Creative Commons BY-SA 4.0. - File di configurazione senza contenuto creativo (
package-lock.json,capacitor.config.json,.gitignore,REUSE.toml): CC0 1.0. - Titolare del copyright: ProactiveProject.
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.
Copyright e immagini
- ScanCode ha letto gli stessi file, senza errori. Ha trovato due cose, già corrette: l'intestazione di
app.jsindicava come autori "gli autori di Agenda di Casa" (frase vaga: ora c'è ProactiveProject), e la frase "versione 3 o successiva" scritta in italiano veniva letta come "solo versione 3". Ora i file hanno anche le righe standardSPDX-License-Identifier: GPL-3.0-or-later. - Icone, splash e icona delle notifiche: disegnate apposta per l'app, con forme semplici, senza librerie di icone. Il logo di prova di Capacitor è stato sostituito ovunque.
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
- pdf.js: passare a una versione recente. Il difetto è già bloccato, ma dalla versione 4 pdf.js esiste solo in un formato diverso (moduli ES), quindi serve un lavoro a parte.
- SheetJS: le versioni nuove si scaricano solo dal sito di SheetJS, non da npm. Da valutare.
- tesseract.js-core: il pacchetto dichiara solo Apache 2.0, ma il motore Tesseract al suo interno usa probabilmente anche la libreria Leptonica, che ha una sua licenza libera (simile alla BSD). Da verificare e, se confermato, aggiungere il suo testo in
www/lib/licenze/. - Server: far girare PocketBase con un utente normale invece che come amministratore (root), e togliere
curleunzipdalla scatola finita. Da provare con attenzione ai permessi dei volumi di Coolify. - ScanCode: segnalare al progetto il problema con pluggy 1.7.0 (vedi sotto).
package.json: i campilicense("ISC") eversion("1.0.0") sono quelli che npm scrive da solo quando crea il file, e non sono quelli veri. La licenza dell'app è GPL-3.0-or-later (vedi sopra eREUSE.toml) e la versione è quella scritta inwww/app.js. Da correggere con la prossima versione.
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).