Roadmap · dalla prima riga alla produzione

La rotta di Ravenly

Tutto quello che manca perché l'app sia pronta per la produzione, raggruppato per ciò che potrai fare e non per ciò che sta nel codice.

Aggiornata il 17 settembre 2026 cd1e09b ramo claude/ravenly-form-builder-sidebar-jos7hr
19/19 schermate, dopo la potatura
92/172 unità di prodotto
36/48 unità di metodo

Come si legge. Un tratto e' chiuso quando puoi fare qualcosa che prima non potevi e lo vedi, non quando il codice esiste. Aprilo e trovi le unita' che mancano.

Prodotto e' quanto manca all'app; metodo e' quanto regge il modo in cui la costruiamo. Sommarli era il motivo per cui la roadmap sembrava infinita.

Che cosa e' cambiato di recente

Riparati fra il 15 e il 17 settembre: il menu a sinistra (tre famiglie su sei cadevano, da due giorni, con tutti i controlli verdi), la creazione di una popolazione da file — CSV, Excel, SPSS, Stata — che non esisteva affatto, il ponte fra cio' che componi e cio' che si somministra, e gli strumenti di Raven, che non venivano mai chiamati. In fondo c'e' un controllo che apre l'app e clicca ogni voce del menu: il difetto peggiore di quella settimana era invisibile a tutti gli altri.

I traguardi, fino alla produzione

M0
Fondamenta chiuso Monorepo, schema del database, banco di conformità.
M1
Parità headless chiuso EDSL parla col server locale come parlerebbe col servizio vero. Gate umano dato il 2 settembre.
M2
Shell desktop chiuso1 coda L'app si installa e trova il suo Python. Resta da far sì che il pacchetto porti l'interfaccia appena costruita, non quella dell'ultima volta.
M3
Raven — l'agente che dialoga e produce in corso Sette tratti di prodotto, di cui quattro chiusi. È dove siamo adesso: i tratti aperti stanno qui sotto.
M4
Validazione con umani atteso Questionari per rispondenti veri, il renderer che li disegna, le esecuzioni programmate, e il tunnel che li rende raggiungibili da fuori. Il server risponde già a quegli indirizzi con una pagina onesta che dice «arriva in M4».
M5
Contorno atteso Widget, macro, notebook, e l'integrazione con Prolific. È l'ultimo, ed è quello la cui portata non è ancora stata decisa.

Prodotto — quanto manca all'app

21 tratti, 102 unità su 184.

Il materiale si ritrova: progetti, conversazioni, archivio 8/9

Ritrovi una conversazione di due settimane fa senza ricordarti dove l'avevi messa.

La finestra regge: guscio, resa, diagnostica 15/16

L'app funziona sulla finestra vera — colonne, icone, diagnostica — non solo sul banco.

  • ui fondamentafatto
  • aria nelle spaziaturefatto
  • interfaccia per iconeverde
  • tre colonne una manigliadisegnoverde
  • maniglie con un nomeverde
  • il piede sta in fondodisegnoda fare
  • il trascinamento arriva alla telaverde
  • dalla colonna si crea un progettoverde
  • interfaccia quattro rossifatto
  • rilievi uxfatto
  • quale sidecar sta girandoverde
  • cors che attraversaverde
  • health attraversaverde
  • interfaccia servitafatto
  • interfaccia nel pacchettofatto
  • pagine pubbliche firmatefatto
Il materiale si cerca: due registri, un indice, e un genere per ognuno 1/6

Da una casella sola cerchi fra tutto quello che hai: questionari, popolazioni, piani, rapporti.

  • un questionario ha un nomeverde
  • un oggetto nasce in un progettoda fare
  • l indice cerca in due registrida fare
  • il costruttore chiede che cosa costruiscida fare
  • il ponte con raven e due gestida fare
  • il genere non e chiuso sul clientda fare
L'app si installa su una macchina pulita e trova il suo sidecar 7/8

Il bundle si installa su una macchina pulita, trova il suo Python e si apre.

  • bundle verdefatto
  • confinifatto
  • destinazioni dichiaratefatto
  • keyringfatto
  • m2 difettifatto
  • pacchetto interfaccia frescarosso
  • python sidecarfatto
  • tauri shellfatto
Il questionario si costruisce a mano, e si vede 4/6

Componi un questionario trascinando le domande su una tela, e ci disegni sopra i salti.

  • il questionario e un graforosso
  • il canvas e una telaverde
  • la tavolozza si capisceverde
  • il questionario si governaverde
  • la tela dice quello che faverde
  • la quota e il blocco servono a qualcosada fare
Il pubblico dello studio si fabbrica dentro l'app 5/12

Porti un file di rispondenti e ottieni una popolazione da guardare, ritagliare e campionare.

Lo stesso questionario gira su materiale mio 0/6

Somministri lo stesso questionario su materiale tuo: una tabella, una cartella di PDF, un Excel.

  • gli scenari si fabbricanoda fare
  • le fonti pesanti si apronoda fare
  • si vede cosa e stato estratto prima di salvareda fare
  • i segnaposto combaciano con i campida fare
  • il tipo dichiarato e il tipo veroda fare
  • uno scenario che porta un file si guardada fare
Cio' che costruisco dentro l'app si somministra 3/6

Il questionario che hai composto sulla tela parte, senza esportarlo e reimportarlo.

  • cio che costruisco si somministraverde
  • il questionario si riapre sulla telaverde
  • la tela avvisa prima di salvareda fare
  • il questionario si rinomina e si buttada fare
  • la tela ha una via di ritornoverde
  • il percorso si prova prima di spendereda fare
Il questionario ramifica, tronca e si mescola come l'ho disegnato 0/6

Screening, salti, sezioni e mescolamenti fanno esattamente quello che hai disegnato.

  • lo screening chiude l intervistada fare
  • le condizioni parlano di numerida fare
  • le regole si governanoda fare
  • la domanda ha il nome che le doda fare
  • sezioni memoria e mescolamento si impostanoda fare
  • la formulazione della domanda si regolada fare
So che cosa riceve l'agente, e lo ricevono tutti allo stesso modo 0/9

Leggi il prompt vero che ogni agente ricevera', prima di spendere e dopo.

  • l anteprima mostra i promptda fare
  • il prompt si rilegge dopoda fare
  • la popolazione si racconta da ogni portada fare
  • le ripetizioni si eseguonoda fare
  • come rispondono si regolada fare
  • il pilota e un campione non i primi nda fare
  • la cache si riusada fare
  • un giro di prova non costa nienteda fare
  • lo scenario entra anche nella via conversazionaleda fare
Uno studio vero si guarda mentre gira, si ferma, e arriva in fondo 5/12

Guardi uno studio mentre gira, «annulla» smette davvero di spendere, e arriva in fondo.

  • lo studio dice a che punto everde
  • il lavoro pagato si salva mano a manoverde
  • uno studio lungo arriva in fondoda fare
  • annullare ferma la spesaverde
  • si sa quali interviste sono falliteverde
  • si rilanciano le interviste falliteda fare
  • la chiave si controlla prima della codada fare
  • il costo si stima davvero e la soglia fermada fare
  • la spesa vera si sommada fare
  • la coda regge e si vededa fare
  • si sa quando e finito e quanto e duratoda fare
  • worker coop localefatto
Dai risultati esce una risposta, non una tabella 2/10

Vedi le distribuzioni, le incroci con un tratto, apri un'intervista e porti via il grafico.

  • ogni domanda ha la sua distribuzioneverde
  • la risposta si incrocia con un trattoda fare
  • i numeri si vedono come graficoda fare
  • la tabella si ordina e si filtraverde
  • la colonna porta il testo della domandada fare
  • un intervista si legge per interoda fare
  • si esporta quello che si sta guardandoda fare
  • excel e il foglio di chi riceveda fare
  • due studi si confrontanoda fare
  • la tabella regge cinquantamila righeda fare
Raven fa il giro intero: sceglie il pubblico, esegue, legge, racconta 4/14

Dici «fai uno studio con la popolazione che ho importato» e Raven lo fa tutto.

  • raven usa davvero i suoi strumentiverde
  • il canale a pezzi connette i suoi strumentiverde
  • raven sceglie una popolazione della libreriadisegnoda fare
  • raven salva in libreria cio che costruisceda fare
  • raven legge i risultati e li citada fare
  • raven ritrova il materialeda fare
  • raven rilegge cio che ho corretto a manoda fare
  • raven monta uno studio completoda fare
  • raven sa che modelli ho e quanto costanoda fare
  • raven va avanti fino al punto di decisioneda fare
  • le competenze sono contenutoda fare
  • raven studio collegatoverde
  • raven sceglie la popolazionedisegnoda fare
  • costruttore sondaggiofatto
Un risultato dice da dove viene, e quanto somiglia al vero 1/8

Un risultato di due mesi fa dice da dove viene, e lo rifai cambiando una cosa sola.

  • un risultato dice da dove vieneda fare
  • lo studio e la popolazione si ricordano a vicendada fare
  • l elenco degli studi dice che cos eranoda fare
  • uno studio si rifa cambiando una cosa solada fare
  • la fedelta si misura contro la verita a terradisegnoda fare
  • una ricerca sta in un progettoda fare
  • cio che non serve piu si toglieda fare
  • banco calibrazionefatto
L'app si apre in un browser, e chi la costruisce la vede 6/11

Apri Ravenly da un indirizzo, senza installare niente — e chi la costruisce vede la stessa istanza.

  • un accesso protegge le chiaviverde
  • il worker si presenta con una credenzialefatto
  • il sidecar serve l interfacciaverde
  • i segreti non stanno in un portachiaviverde
  • il deposito usa una libreria di crittografiada fare
  • l app gira in un containerverde
  • il banco guida l app servitada fare
  • l https e il proxy stanno nel repositoryverde
  • il volume si salva e si rimetteda fare
  • la ci vede l app consegnatada fare
  • la sessione sopravvive al riavvioda fare
L'app sembra un prodotto solo, e si legge senza tradurre 2/6

Passi da una schermata all'altra e non vedi il salto — e quello che leggi è in italiano, corto.

Raven dialoga, e si vede lavorare 13/13

Scrivi a Raven, lo vedi ragionare mentre accade, e lo puoi fermare.

  • raven agentefatto
  • decisione interattivafatto
  • turno che si vede accadereverde
  • turno che sopravvive allo staccoverde
  • fornitore che parla a pezziverde
  • verso che la cli accettaverde
  • ciao che non rispondefatto
  • ciao la misurafatto
  • chiave di chi usaverde
  • raven che si vede pensareverde
  • la soglia che scattaverde
  • l esito si leggeverde
  • azioni che taccionofatto
Gli artefatti si leggono e si ritoccano 9/9

Apri un sondaggio o un rapporto nel pannello, lo leggi per intero e lo correggi a mano.

  • pannello artefattifatto
  • pannello di progettoverde
  • artefatti a schedefatto
  • artifact viewersfatto
  • intestazione artefattofatto
  • salvataggio artefattifatto
  • rapporto a tutta altezzafatto
  • esempi che se ne vannoverde
  • il rapporto si correggeverde
EDSL parla col server locale come parlerebbe con Coop 6/6

Uno script Python usa il server locale come userebbe Coop, senza modificare EDSL.

  • coop config authfatto
  • coop modelsfatto
  • coop object storefatto
  • coop pricesfatto
  • coop remote cachefatto
  • coop remote inferencefatto
Le schermate del menu esistono, e si somigliano 9/9

Ogni voce del menu apre una schermata vera, con dati veri e la stessa forma.

  • il telaio tiene insieme le schermateverde
  • le impostazioni si vedonoverde
  • le esecuzioni si guidanoverde
  • i risultati si leggonoverde
  • la libreria tiene tredici tipiverde
  • il ponte porta alle esecuzioniverde
  • l app non promette cio che non faverde
  • sette posti diventano cinque comandiverde
  • il menu porta dove diceverde
L'app si usa da un telefono, non solo si apre 2/2

Apri Ravenly dal telefono e ci lavori: niente pizzicare per leggere, niente colonne accavallate.

Metodo — quanto regge il modo in cui la costruiamo

3 tratti, 43 unità su 54.

Il banco giudica davvero 9/14

Un rosso del banco vuol dire sempre un difetto vero, e un verde sempre che funziona.

  • m3 oracolo interfacciafatto
  • oracolo a pezzifatto
  • giudice m3 adeguatoverde
  • banco su linuxverde
  • banco che aspettaverde
  • banco che non menteda fare
  • lucchetto macchinafatto
  • isolamento fra testfatto
  • quarta che non esistebloccata
  • rosso che va e vieneda fare
  • controllo avversarioin review
  • oracoli che invecchianoda fare
  • versi nominabilifatto
  • oracolo app installatafatto
I cancelli tengono 18/21

Cio' che il metodo vieta lo impedisce un controllo, non un paragrafo.

  • cancelli in localeverde
  • oracolo cancelli allargatoverde
  • valori grezzi anche da bashverde
  • scenari copertifatto
  • breach giudica il difffatto
  • stati misurabiliverde
  • guardia sui comandifatto
  • guardia anche da bashfatto
  • attese con scadenzaverde
  • audit oracolofatto
  • audit attraverso il tagliofatto
  • oracolo per unitafatto
  • yard glob ownershipfatto
  • guardia che non sparada fare
  • firme dei commitverde
  • il cancello ruff non e rosso per tuttiverde
  • una prova dice non provabile qui invece di rottoverde
  • un cantiere in worktree si fa giudicarerosso
  • finito vuol dire la stessa cosa per ogni cancellofatto
  • un prototipo non si tiene al design systemda fare
  • tre documenti non dicono quando leggerliverde
Il metodo si applica da se' 16/19

Ruoli, review, roadmap e documenti restano veri senza che qualcuno se ne ricordi.

  • corsiefatto
  • corsie comandoverde
  • corsie il proprio giudicefatto
  • yard leaseverde
  • cantieri caldifatto
  • ruoli e reviewverde
  • review a traguardo apertofatto
  • condotta di chi coordinain specifica
  • sanatoria dei confiniverde
  • due ambientiin review
  • sidecar quale copiafatto
  • sidecar quale copia davveroverde
  • roadmap unicada fare
  • roadmap che non mentefatto
  • documenti di stanotteverde
  • docs keeperfatto
  • file di gruppoverde
  • tratto o modificaverde
  • tratto in yardfatto

Decise, e in costruzione

Ognuna e' gia' un'unita' di lavoro con il suo perimetro, non una nota. Il perche' di ognuna sta in docs/adr/.

0027Ravenly si apre in un browser. Apri l'app da un indirizzo e chi la costruisce vede la stessa istanza. Il bundle resta costruibile, ma non e' piu' la strada principale.
La potatura: 26 rotte diventano 19. Approvata per intero. Nessun gesto perso: quello che serviva e' stato rimesso dove si usa.
0025Excel, SPSS/PSPP e Stata si', Parquet no. Costa 127 MB al pacchetto, misurati.
PPTX, PDF e DOCX diventano materiale di stimolo, non popolazioni.
0026Anthropic e OpenAI viaggiano nel pacchetto. Prima nessuno dei due c'era, e lo studio non partiva.

Aspettano una tua decisione

Niente, per la prima volta. Le tre che restavano le hai chiuse il 21 settembre alle 06:23, e stanno qui sotto con le altre. Quando ne nascerà una nuova ricomparirà qui: è questo il posto da guardare per sapere se qualcosa è fermo per colpa tua.

Decise da te il 21 settembre

Stanno qui e non sparite, perché una decisione che non si rilegge torna a essere una domanda.

✓ Ravenly è una browser app. Tauri e l’eseguibile Windows sono un nice to have.

Il rosso del pacchetto Tauri adesso vuol dire «non più il bersaglio», non «rotto». L’oracolo del traguardo M2 si sposta sull’app servita; il bundle resta nel repository e resta costruibile, ma non tiene più in ostaggio un traguardo. Debito 37, chiuso come decisione.

✓ La CI non si riattacca, al momento.

Conseguenza da tenere a mente quando leggi un verde: tools/dev/cancelli.py è l’unico giudice che esista su questo ramo — non lo specchio locale di un altro giudice, l’originale. Chi rompe un cancello non ha una seconda rete sotto. I quattro file di GitHub restano accesi e scollegati: sono il bersaglio a cui si riattaccherà. Debito 62, deciso e ancora aperto.

✓ I tre artboard del telefono sono approvati, e con loro ADR 0031.

Telaio stretto, elenco, conversazione con Raven, tutti a 390×844. E la forma sotto soglia è scelta: ogni colonna diventa un cassetto, e ne resta una — non schede, non una colonna sola con navigazione a piede. Le unità che ripareranno le 29 voci della ricognizione mobile hanno tutto: il bersaglio, la forma, e le due soglie (904 e 624). Niente resta da chiedere: si costruisce.

ADR 0032: «finito» e «integrato» sono due domande.

«È finito?» e «è nel tronco?» adesso hanno una casa sola ciascuna, e ogni cancello dichiara quale delle due sta ponendo. Sblocca l’unità che riunisce gli otto punti di decisione sparsi in sette file, tre dei quali con la stessa costante copiata a mano.

✓ Il rapporto diventa modificabile, ed è la prossima cosa che si costruisce.

Oggi 2 artefatti su 5 si possono modificare dentro l’app, e il REPORT — quello che mandi a un cliente — non è fra quelli. Hai scelto che passi davanti anche alla riparazione mobile. È l’unica delle tre che cambia che cosa puoi fare, non come le cose sono organizzate: sposta il prodotto da «Raven produce, tu guardi» a «Raven produce, tu firmi».

✓ Risultati viene assorbito dentro Esecuzioni. Il menu passa da 6 famiglie a 5.

Uno studio gira, e poi ha dei risultati: adesso si naviga così. Hai scartato la strada che ti avevo consigliato — quella era la più economica, questa è il modello mentale più pulito, e hai pagato la differenza per averlo. ⚠️ La parte che costa è una sola: il riepilogo fra studi diversi perde la propria casa e va ricollocato come scheda di Esecuzioni con ambito «tutte». Se sparisce, la decisione ha tolto una vista invece di spostarla.

✓ Della spesa: prima la somma visibile, la soglia dopo.

Dopo uno studio leggerai quanto è costato. La soglia che ferma aspetta, e non è una mezza misura: oggi è = 1 nel codice, cioè scatta sempre, e un avviso che compare sempre non è più un avviso. Si tarerà quando avrai visto qualche cifra vera.

✓ Aprirai sempre Ravenly da Windows.

Quindi il protocollo «due ambienti» non va in archivio, e a essere scritto male era ADR 0027, corretto lo stesso giorno. ⚠️ Con una misura che cambia cosa va riscritto: sui 764 commit che dichiarano il proprio ambiente, zero vengono da Windows. Le regole «una direzione per volta» e «i diari da un lato solo» difendono da due cloni che scrivono, e il secondo non è mai esistito; quella viva è la terza — il giudizio visivo è tuo.

Debiti noti che toccano il prodotto

Sessantanove voci misurate vivono in docs/ROADMAP.md. Queste sono quelle che si vedono usando l'app.

9Su quali modelli rispondono gli agenti: una dimensione che il prodotto non ha.
23La conversione verso EDSL perde quota, blocchi e regole — una sola delle tre perdite è dichiarata.
24Chi aggiorna Ravenly non ritrova le larghezze che aveva salvato.
29Il banco non entra mai dentro Tauri: un verso verde può convivere con un gesto che non funziona.
30Il Rust si compila per la piattaforma sbagliata, e un #[cfg] errato sparisce in silenzio.
32Un gesto che c'è e non porta da nessuna parte: la promessa non mantenuta.
36«Componi lo studio dagli ingredienti scelti» uccide la finestra con un Out of Memory, e la causa non si sa ancora: il server risponde in mezzo secondo con 1 KB, e in Chromium non succede.
40L'app mostra una «Chiave API» con un bottone Copia su una credenziale che muore al riavvio: copiarla non serve a niente.
45Un nome di modello sbagliato produce «eccezione sconosciuta» invece di «quel modello non esiste», e lo studio sembra rotto quando è solo scritto male.
46Dopo uno studio pagato, quanto sia costato non si legge da nessuna parte: il costo del primo giro vero è stato ricavato dalla cache, che lo conserva per caso.
50Risultati apre da solo lo studio più recente anche se sta ancora girando, e il bottone Esporta ne cava un CSV che sembra completo.