> ## Documentation Index
> Fetch the complete documentation index at: https://docs.switchbord.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sviluppo

> Come estendere il monorepo in sicurezza.

## 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

Ogni slice di funzionalità dovrebbe includere:

* 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

Il repo dovrebbe adattarsi allo stile operativo di `gb-travio-webhooks`:

* 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

Vedi [Coerenza del repo](/it/operations/repo-fit) per le convenzioni a livello di repo riprese da `gb-travio-webhooks`.

## Nota sull'implementazione attuale

Il repo dispone già sia di un livello di repository tipizzato basato su mock, sia del contratto schema/env di Supabase.

Per i contributori, l'assunzione sicura oggi è:

* 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

```bash theme={null}
pnpm lint
pnpm typecheck
pnpm test
pnpm build
```

Usa esecuzioni mirate per package per restringere rapidamente i fallimenti:

```bash theme={null}
pnpm --filter api test
pnpm --filter worker test
pnpm --filter control-plane test
pnpm --filter @repo/database typecheck
```

## Leggi anche

* [Flusso di contribuzione](/it/contributing/workflow)
* [Etichetta per issue e PR](/it/contributing/issue-pr-etiquette)
* [Processo di release](/it/contributing/release-process)