VZCards

VZCards

App iOS per la gestione delle tessere fedeltà, con widget Home Screen, app Apple Watch e complicazione, completamente offline e rispettosa della privacy.

Funzionalità principali

📄

Gestione tessere

Aggiunta, modifica ed eliminazione di tessere fedeltà con nome negozio, numero e colore personalizzato.

📷

Scansione barcode

Scanner integrato con fotocamera che riconosce automaticamente il tipo di codice (EAN-13, EAN-8, QR Code, Code 128, PDF417, Aztec, Data Matrix, ecc.).

Conferma scansione

Al rilevamento del codice la fotocamera si ferma e mostra il valore letto: puoi confermare con «Usa questo codice» oppure riscansionare in caso di lettura errata o accidentale.

🖼

Scansione da galleria

Importa il codice a barre direttamente da una foto nella galleria del dispositivo, senza necessità di scansionare la tessera fisica.

Generazione barcode

Rendering nativo dei codici EAN-13/EAN-8 pixel per pixel, con fallback CIFilter per gli altri formati.

Validazione intelligente

Controllo del formato, check digit EAN e rilevamento duplicati.

💰

Credito prepagato

Gestione carte a scalare usa e getta con saldo iniziale, registrazione spese e cronologia transazioni con saldo progressivo.

🔄

Carte ricaricabili

Gestione carte con ricariche successive: registra ogni ricarica e ogni spesa, con saldo aggiornato in tempo reale e storico completo.

💲

Simbolo valuta personalizzabile

Per ogni carta prepagata puoi scegliere il simbolo di valuta (predefinito €): viene mostrato in lista, nel dettaglio, nella cronologia transazioni e in tutti gli avvisi.

Gestione esaurimento credito

Se l'importo supera il saldo, l'app propone tre opzioni: Ricarica carta per le ricaricabili, Nuova carta con compilazione automatica per le usa e getta (con trasferimento del residuo e rimozione della vecchia), oppure Annulla.

🔁

Esportazione e importazione

Backup delle carte in formato .vzc condivisibile via AirDrop, WhatsApp, email e qualsiasi altra app. Compatibile con la versione Android per il trasferimento cross-platform.

🖼

Foto tessera

Possibilità di allegare una foto con ritaglio interattivo in formato carta di credito (ISO 7810).

🔍

Ricerca rapida

Filtro in tempo reale per nome o numero tessera.

Luminosità automatica

Lo schermo va al massimo quando si mostra una tessera alla cassa.

Alto contrasto barcode

Modalità per migliorare la leggibilità dai lettori ottici.

Vista lista o griglia

Scegli dalle Impostazioni se mostrare le tessere in lista compatta oppure in griglia con anteprime colorate.

Schermata Impostazioni

Tema chiaro/scuro/automatico, lingua dell'app indipendente dal sistema, vista tessere, opzioni di scansione, sincronizzazione Watch e gestione import/export, tutto in un unico pannello.

🌙

Tema e lingua

Modalità chiara, scura o automatica e selezione della lingua tra Italiano, English, Français, Español e Deutsch, indipendentemente dalle impostazioni del dispositivo.

🔗

Deep link

URL vzcards:// per aprire l'app, una carta specifica o la lista completa da widget, complicazione e Shortcut.

Ecosistema

VZCards non vive solo nell'app: porta le tue tessere sulla schermata Home dell'iPhone e al polso con Apple Watch.

📱

Widget Home Screen

Widget per iOS in formato piccolo e medio che mostra la carta preferita con barcode pronto da scansionare, nome del negozio e numero. Il colore della tessera diventa lo sfondo del widget per riconoscerla subito.

👉

Tap configurabile sul widget

Tieni premuto il widget e scegli se al tocco aprire direttamente la carta preferita oppure l'intera lista carte: due flussi diversi, uno per chi vuole pagare al volo, uno per chi sceglie all'occorrenza.

Carta preferita

Marca con una stella la carta che usi più spesso: viene esposta dal widget e dalla complicazione tramite App Group, restando sempre allineata anche dopo modifiche o ricariche.

App Apple Watch

App nativa watchOS con elenco delle tessere e dettaglio con QR Code renderizzato in bianco/nero ad alto contrasto per i lettori ottici. Per le carte prepagate viene mostrato anche il saldo residuo con il simbolo di valuta scelto.

🔁

Sincronizzazione automatica Watch

Le tessere vengono trasferite all'orologio tramite WatchConnectivity con coalescing delle modifiche e deduplica del payload. In Impostazioni puoi consultare lo stato e forzare un nuovo invio con «Sincronizza ora».

Complicazione Apple Watch

Complicazione disponibile in formato circolare, rettangolare e inline: aggiungila al quadrante per aprire VZCards con un solo tocco.

💾

Esportazione selettiva

Dal pannello Impostazioni puoi selezionare le singole tessere da esportare in formato .vzc e condividerle via AirDrop, email o messaggi. Le carte prepagate e ricaricabili sono escluse per motivi di sicurezza.

🛡

Robustezza dati

In caso di archivio danneggiato l'app si auto-ripristina e avvisa l'utente, garantendo che VZCards si apra sempre. Schema versionato per migrazioni future senza perdita di dati.

Caratteristiche tecniche

Stack UI

SwiftUI + SwiftData

Architettura

MVVM

Scanner

AVFoundation

Generazione codici

CoreImage + Rendering nativo EAN

Persistenza

100% locale, zero rete

Lingua in-app

AppStorage + Environment Locale

Widget

WidgetKit + AppIntents

Apple Watch

watchOS app + complicazione

Sincronizzazione

WatchConnectivity + App Group

Deep linking

vzcards://list, /card/{id}, /open

Lingue supportate

Italiano

English

Français

Español

Deutsch

Privacy e sicurezza

🔒

Privacy assoluta

I dati restano solo sul dispositivo dell'utente.

🚫

Zero tracking

Nessun dato viene raccolto o condiviso.

👤

Nessuna registrazione

L'app funziona subito, senza creare un account.

🔌

Funziona offline

Non serve connessione internet.

Torna a VZCards Privacy Supporto