Come dimostrare di aver rilasciato una funzionalità prima di un concorrente
Il post di lancio del tuo concorrente va online un martedì mattina. Screenshot, una pagina prezzi, un video demo — e la funzionalità è tua. L’hai costruita quattordici mesi fa. Hai la cronologia dei commit per dimostrarlo, custodita in un repository GitHub privato.
Quello che non hai è un modo per far credere a chiunque che quella cronologia dei commit non sia stata modificata la settimana scorsa.
Questo divario — tra avere le prove ed essere in grado di dimostrarle — è l’argomento di questo articolo. Non in astratto, ma per le persone specifiche che ne subiscono le conseguenze più pesanti: fondatori, agenzie, freelance e i team di compliance che devono difenderli in seguito.
Il fondatore che aveva bisogno di prove: uno scenario reale
Immagina un fondatore in fase seed che chiameremo Mara. Il suo team ha passato un anno a costruire uno strato di automazione dei flussi di lavoro per una nicchia verticale. Poi un concorrente meglio finanziato ha annunciato un prodotto con lo stesso concetto di base, ha raccolto un Serie A sulla base di questo, e un giornalista ha chiesto a Mara un commento.
La sua posizione nella conversazione dipendeva interamente da una domanda: puoi dimostrare di averlo avuto per primo?
Mara aveva la cronologia Git. Aveva anche:
- Un repository su GitHub, controllato da un’organizzazione le cui impostazioni qualsiasi amministratore può modificare.
- Date dei commit che, in Git, sono solo metadati forniti da chi ha effettuato il commit. Con un force-push, un rebase o una cronologia riscritta, le date cambiano di conseguenza.
- Screenshot, thread Slack e un documento Notion — nessuno dei quali sopravvive a una contestazione determinata in sede legale.
In altre parole, aveva una storia, non prove. Le conversazioni con gli investitori si sono arenate. La narrazione è passata da “siamo stati i primi” a “pensiamo che ci abbiano copiato, ma non possiamo dimostrarlo”. È un problema di credibilità che si amplifica in un problema di valutazione.
La verità scomoda: un log interno è affidabile solo quanto la persona che controlla il server su cui risiede. In una disputa, quella persona sei tu — il che lo rende inutile per la controparte.
La marcatura temporale crittografica risolve questo problema specifico. Non rendendo i tuoi log più belli, ma ancorando un’impronta del tuo codice in un registro pubblico e immutabile che nessuno — incluso il fornitore che l’ha marcato — può riscrivere. Il resto di questo articolo è la versione pratica per i team nella situazione di Mara.
Perché sviluppatori e team di compliance hanno bisogno di prove crittografiche
Le persone a cui viene chiesto “puoi dimostrarlo?” raramente sono ingegneri. È un fondatore in una call di due diligence, un titolare di agenzia in una disputa sui pagamenti o un responsabile compliance che si prepara a un audit IP. Ecco cosa incontra ciascuno di loro.
I log Git interni sono modificabili per progettazione. Git è un sistema distribuito costruito in modo che la cronologia possa essere riscritta. È una funzionalità per lo sviluppo e una responsabilità per le prove. Quando l’avvocato della controparte sostiene che i timestamp del tuo repository sono autoreferenziali, non sta facendo un’affermazione azzardata — sta facendo quella ovvia.
“L’abbiamo sviluppato in modo indipendente” è la difesa predefinita. Un concorrente non ha bisogno di averti copiato per farti del male. Gli basta dire che non l’ha fatto, e senza uno stato dell’arte verificabile, quell’affermazione vale quanto la tua smentita.
I team di compliance hanno bisogno di artefatti a prova di manomissione. Un revisore o un tribunale vuole qualcosa che possa verificare senza fidarsi della tua infrastruttura, dei tuoi dipendenti o del tuo fornitore. Questo significa una prova che si riduce a matematica pubblica — un hash e un’altezza di blocco — piuttosto che a una riga di database.
Il rischio brevetti è asimmetrico. Un’entità non praticante può depositare rivendicazioni ampie su tecnologie che migliaia di team già utilizzano in produzione. Se non puoi mostrare la data in cui l’hai costruita, il costo di difenderti ricade interamente su di te.
Se vuoi le basi concettuali sul perché un hash dimostra l’esistenza e su come lo stato dell’arte invalidi le rivendicazioni, la pagina del concetto e la descrizione del problema le trattano in profondità. Ai fini di questo articolo, il meccanismo conta meno del flusso di lavoro: qualcosa di automatico, continuo e verificabile in modo indipendente.
È esattamente questo divario che colma un servizio di marcatura temporale gestito.
Il tuo playbook: dimostrare lo stato dell’arte con Timestamp GIT
Ecco la checklist completa, in ordine. Nota quanto poco richieda sforzo ingegneristico — è voluto.
Passo 1: installa la GitHub App sul tuo repository
Installa Timestamp GIT dal GitHub Marketplace e seleziona i repository da monitorare. Non c’è nulla da aggiungere al tuo codebase, nessuna dipendenza, nessuna configurazione CI da scrivere e nulla da installare sulle macchine degli sviluppatori. Il tuo team continua a fare commit esattamente come fa oggi.
Permessi, così non ci sono sorprese:
- La modalità standard richiede accesso in sola lettura al repository di origine — il modello di permessi di GitHub non offre un ambito “solo hash del commit” — più accesso in scrittura al repository di destinazione dove finiscono le prove.
- Gli artefatti di prova vengono scritti in un branch dedicato
timestamps, nello stesso repository o in un repository shadow separato.
Passo 2: lascia che l’ancoraggio notturno avvenga automaticamente
Una volta connesso, la pipeline funziona senza di te:
- La GitHub App rileva i nuovi commit tramite webhook.
- Gli hash dei commit vengono accodati in un archivio chiave-valore in memoria per il raggruppamento.
- Un worker cron di mezzanotte raggruppa tutti gli hash in attesa, scrive un manifest
.txtper repository, costruisce un albero di Merkle, genera prove OpenTimestamps rispetto ai calendari OTS pubblici e ancora la radice di Merkle nella blockchain Bitcoin. - I file manifest e le ricevute
.otsvengono inviati al tuo branchtimestamps.
La conferma Bitcoin richiede tipicamente circa tre ore, quindi le prove di una data notte compaiono qualche ora dopo l’ancoraggio del batch. Non devi monitorare nulla.
Passo 3: raccogli le tue ricevute e il badge di verifica
Ogni giorno ancorato ti dà un file di ricevuta .ots immutabile più un badge incorporabile per il tuo README. Il link del badge punta a una vista di verifica pubblica, così chiunque valuti la tua affermazione — un investitore, un avvocato, un cliente — può verificarla senza un account.
I repository pubblici sono coperti dal tier Open Source gratuito; i repository privati funzionano sul piano Pro Agency. Puoi anche recuperare gli URL dei badge e gli snippet markdown a livello di programmazione:
curl -s https://timestampgit.dev/api/badgeLink/your-org/your-repo
Passo 4: produci prove per gli stakeholder
Quando qualcuno chiede davvero una prova, non mettere insieme un file zip di screenshot. Usa gli artefatti creati allo scopo:
- Pagina di stato del repository — longevità delle prove, data di ancoraggio più antica, regolarità giornaliera, dati di blocco e transazione Bitcoin, una heatmap del calendario e CSV di audit scaricabile più certificato PDF.
- Pagina di verifica crittografica — una spiegazione passo passo della catena di Merkle per data, calcolata interamente nel browser. Nessuno vede cosa verifichi.
- Certificato PDF — un documento per data che puoi allegare a un thread legale o di procurement.
# Full audit ledger as CSV
curl -s -o audit.csv https://timestampgit.dev/api/audit/your-org/your-repo
# PDF certificate for a specific anchored date
curl -s -o certificate.pdf https://timestampgit.dev/api/report/your-org/your-repo/2026-11-03
I repository privati aggiungono un HMAC crittografato ai loro URL di stato, così solo i visualizzatori autorizzati possono interrogarli.
Per i team che non possono concedere l’accesso in lettura: modalità Enterprise ZK
Alcune organizzazioni — settori regolamentati, o chiunque abbia l’accesso al repository di origine esso stesso sottoposto ad audit — non possono concedere il permesso di lettura a una terza parte. In quella modalità, una GitHub Action viene eseguita all’interno della tua infrastruttura e invia solo l’hash del commit all’API di Timestamp GIT. Il servizio non ha mai accesso in lettura al repository di origine, e tu concedi solo l’accesso in scrittura al repository di destinazione.
Se devi eseguire l’intero stack da solo, esiste una licenza self-hosted Docker. Una configurazione rapida con Docker Compose è questa:
services:
timestampgit:
image: rue1401/timestampgit:prod
ports:
- "8080:8080"
volumes:
- ./data:/app/data
restart: unless-stopped
valkey:
image: valkey/valkey:8
restart: unless-stopped
docker compose pull
docker compose up -d
docker compose logs -f timestampgit
L’istanza è disponibile su http://localhost:8080 dopo l’avvio, e una procedura guidata ti accompagna nella connessione della tua GitHub App al primo avvio. Una licenza demo a tempo è disponibile dalla pagina della licenza Docker.
Cosa evitare quando si dimostra lo stato dell’arte
Le modalità di fallimento qui sono noiose e costose. Evitale tutte e cinque.
- Non affidarti a log interni, screenshot Slack o cronologia delle revisioni dei documenti. Ognuno di essi è modificabile da qualcuno dalla tua parte, che è esattamente l’obiezione che affronterai.
- Non provare a implementare il protocollo da zero. Assemblare hash, inviare ai server dei calendari e gestire manualmente i file di prova è la strada difficile — soggetta a errori, facile da sbagliare e non qualcosa che vuoi spiegare in una deposizione.
- Non aspettare che inizi la disputa. Lo stato dell’arte è utile solo se precede la rivendicazione. La marcatura temporale inizia il giorno in cui installi la GitHub App e accumula valore ogni giorno; la marcatura retroattiva è impossibile per costruzione.
- Non confondere un repository pubblico con una prova. Rendere visibile il codice dice alle persone cosa hai costruito, non quando l’hai costruito. Visibilità ed esistenza verificabile sono proprietà diverse.
- Non affidarti a un’unica catena di fiducia ininterrotta presso un solo fornitore. Chiedi se la prova può essere verificata senza il fornitore — con Timestamp GIT, la risposta è sì, ed è il punto trattato di seguito.
Come Timestamp GIT si inserisce nel tuo flusso di lavoro di compliance
I revisori di compliance pongono tre domande su qualsiasi pipeline di prove: quali dati lasciano l’ambiente, quale documentazione esiste e cosa succede se il fornitore scompare. Ecco come questa risponde.
Zero-knowledge per architettura. Timestamp GIT non vede, copia o memorizza mai il tuo codice sorgente. Estrae gli hash dei commit, li raggruppa e ancora una radice di Merkle derivata da SHA-256. La tua logica effettiva resta nel tuo repository.
Documentazione su richiesta. Il registro di audit è scaricabile come CSV, e i certificati PDF per data vengono generati per i giorni che devi citare. Gli endpoint di stato espongono i dati di ancoraggio in JSON così puoi inserirli in un registro dei rischi interno:
curl -s https://timestampgit.dev/api/statusLast/your-org/your-repo
curl -s https://timestampgit.dev/api/statusCount/your-org/your-repo
curl -s https://timestampgit.dev/api/statusSummary/your-org/your-repo
Indipendenza dal fornitore. La prova si riduce a SHA-256 e ai dati dei blocchi Bitcoin — nessun formato proprietario, nessun lock-in. Anche se Timestamp GIT smettesse di esistere, le ricevute restano verificabili offline rispetto alla blockchain Bitcoin.
Trasparenza che puoi pubblicare. I badge incorporabili mettono il link di verifica direttamente nel tuo README, così l’affermazione è verificabile da chiunque arrivi sul repository invece di essere asserita in una presentazione privata.
Per i team che confrontano approcci, Brevetto vs Timestamp: il modo più economico per proteggere la proprietà intellettuale del codice sorgente illustra quando un brevetto è lo strumento giusto e quando lo è una prova crittografica. Risolvono problemi diversi, e la maggior parte dei team ha bisogno prima di quello più economico.
FAQ
Un timestamp Bitcoin è ammissibile in tribunale? I timestamp crittografici ancorati nella blockchain Bitcoin sono sempre più riconosciuti come prove a prova di manomissione. Timestamp GIT fornisce prove pronte per il tribunale che possono essere verificate in modo indipendente, rendendole adatte a dispute legali sullo stato dell’arte.
Devo cambiare il mio flusso di lavoro di sviluppo per usare Timestamp GIT? No. Una volta installata la GitHub App, Timestamp GIT marca automaticamente ogni commit ai tuoi repository monitorati ogni notte. Non sono richiesti strumenti CLI o passaggi manuali.
Posso dimostrare che una funzionalità esisteva se il mio repository è privato? Assolutamente sì. Timestamp GIT elabora solo gli hash dei commit, mai il tuo codice sorgente. I repository privati sono supportati, e le prove vengono archiviate in un branch separato o in un repository shadow senza esporre il tuo codice.
E se Timestamp GIT chiudesse? Le tue prove sono ancorate nella blockchain Bitcoin e sono indipendenti dal fornitore. Puoi verificarle offline usando gli strumenti di verifica OpenTimestamps standard, garantendo validità a lungo termine anche se il nostro servizio venisse dismesso.
Questo sostituisce il deposito di un brevetto? No. Un timestamp dimostra che avevi il codice in una certa data; non concede l’esclusività. Ciò che fa è stabilire uno stato dell’arte che può invalidare l’ampia rivendicazione di qualcun altro — e costa una frazione di un deposito.
Dimostralo il giorno in cui lo costruisci, non il giorno in cui te lo chiedono
Il problema di Mara non era che le mancassero le prove. Era che le sue prove richiedevano di fidarsi di lei. L’ancoraggio crittografico elimina questo requisito: un hash del commit, una radice di Merkle, un blocco Bitcoin e una ricevuta che chiunque può verificare.
Il costo di configurazione è un’installazione della GitHub App. Il costo continuo è zero sforzo da parte degli sviluppatori, perché l’ancoraggio notturno funziona che qualcuno si ricordi o meno che esiste.
Se stai rilasciando qualcosa che vorresti difendere — una funzionalità, una libreria, un intero prodotto — avvia il cronometro ora. Installa la GitHub App su un repository oggi, conferma il tuo primo ancoraggio domani e metti il badge nel tuo README. Tra due giorni avrai qualcosa che nessun concorrente può cancellare retroattivamente.
Post correlati
- Brevetto vs Timestamp: il modo più economico per proteggere la proprietà intellettuale del codice sorgente
- Alternative a Timestamp GIT per la marcatura temporale del codice: confronto
- Automatizza la marcatura temporale dei commit Git con una GitHub App