Sviluppo

​

Standard del repo

• mantieni il codice completamente tipizzato
• aggiungi storie Storybook per qualsiasi superficie UI personalizzata
• documenta le modifiche di runtime nella documentazione
• mantieni i feature flag additivi
• preferisci un comportamento operativo prevedibile rispetto a teatrini di abstrazione

​

Standard della pull request

• modifiche tipizzate ad applicazioni e package
• test per il comportamento modificato
• documentazione aggiornata in apps/docs e docs/*.md dove rilevante
• note esplicite di rollout, replay o rollback per le modifiche operative
• note di revisione adversarial quando la funzionalità tocca correttezza o confini di sicurezza

​

Coerenza del repository

• scopo del repository diretto ed esplicito
• CI e processo di release leggibili
• comportamento a runtime con poca “magia”
• contratti interni documentati
• runbook e note di revisione conservati nel repo

​

Nota sull’implementazione attuale

• la maggior parte dell’iterazione su UI e API avviene ancora sul percorso basato su mock
• il comportamento basato su Supabase dovrebbe essere documentato esplicitamente quando una superficie è effettivamente collegata
• i contratti di app e API dovrebbero rimanere stabili mentre l’implementazione dello storage cambia sotto di essi

​

Comandi ad alto valore

pnpm lint
pnpm typecheck
pnpm test
pnpm build

pnpm --filter api test
pnpm --filter worker test
pnpm --filter control-plane test
pnpm --filter @repo/database typecheck

​

Leggi anche

• Flusso di contribuzione
• Etichetta per issue e PR
• Processo di release