Vai al contenuto principale

Costruire con tool IA

La Copera Starter Application ti dà una base funzionante out of the box. Gli assistenti di coding con IA possono accelerare drasticamente quanto velocemente la personalizzi ed estendi — trasformando in ore ciò che potrebbe richiedere giorni, e in minuti ciò che richiederebbe ore.

Il concetto​

Quando lavori con la Starter Application, hai già autenticazione, routing, data fetching e pattern UI in posto. Il tuo compito è adattare questa base al caso d'uso specifico — cambiare quali dati mostri, aggiungere nuove pagine, collegare nuove colonne della Copera Board o cablare nuovi workflow.

I tool IA eccellono esattamente in questo tipo di task. Dagli il contesto giusto e genereranno nuove pagine, componenti e route API che si adattano ai pattern del codebase esistente. La chiave è il contesto: più l'IA capisce della struttura del progetto e del setup della Copera Board, migliore sarà l'output.

Usare Copera AI​

Copera ha un assistente IA integrato che già capisce il workspace, le board e i dati.

Cosa puoi chiederle:

  • "Quali colonne ha la mia board Tickets e quali sono i loro ID?"
  • "Come interrogo le righe della table Orders dove Status è 'Pending'?"
  • "Genera uno snippet Copera SDK che crea una nuova riga nella board Projects con Name e Due Date."

Poiché Copera AI ha accesso diretto alla struttura del workspace, può darti Column ID e nomi table accurati senza che tu debba cercarli manualmente. Usala come prima tappa quando devi capire la struttura dati prima di scrivere codice.

suggerimento

Copia i Column ID e Table ID che Copera AI ti dà direttamente nel file config.ts. Questo rende più facile condividere contesto accurato con altri tool IA in seguito.

Usare Claude, ChatGPT o Gemini​

Gli assistenti IA general-purpose funzionano bene per generare pagine, componenti e logica — purché tu dia loro abbastanza contesto sul progetto all'inizio.

Avviare una conversazione​

Apri una nuova conversazione e fornisci questo contesto all'inizio:

"Sto costruendo un'applicazione custom usando il Copera SDK (@copera.ai/sdk). L'applicazione si collega alle Copera Boards, che fungono da database. Sto partendo dalla Copera Starter Application. La documentazione della piattaforma è su https://university.copera.ai/developer/guides/starter-application/overview"

Questo paragrafo orienta l'IA allo stack. Da qui può generare codice che usa correttamente l'SDK.

Condividere la struttura delle colonne​

Incolla il file config.ts nella conversazione. Questo file mappa i Column ID della Board a nomi leggibili. Con questo contesto, l'IA sa esattamente quali field referenziare in qualsiasi codice che genera.

// Example config.ts excerpt
export const COLUMNS = {
  TICKET_TITLE: 'col_abc123',
  TICKET_STATUS: 'col_def456',
  TICKET_ASSIGNEE: 'col_ghi789',
  TICKET_PRIORITY: 'col_jkl012',
};

Prompt di esempio che funzionano bene​

  1. Aggiungere un nuovo field alla detail view:

    "Aggiungi una colonna 'Priority' alla pagina di dettaglio del ticket. Il Column ID in Copera è col_jkl012. Mostrala come badge colorato: rosso per High, giallo per Medium, verde per Low."

  2. Creare una nuova pagina dashboard:

    "Crea una nuova pagina a /dashboard che mostri i conteggi dei ticket raggruppati per Status. Usa i pattern React Query esistenti del progetto."

  3. Aggiungere un workflow di notifica:

    "Aggiungi una notifica email quando la colonna Status di un ticket cambia in 'Done'. Usa l'integrazione webhook del Copera SDK."

  4. Adattare l'app a un caso d'uso diverso:

    "Converti questa help desk application in un product catalog. Mi servono colonne per Product Name, Price, Description e Image URL. Ecco i Column ID dalla mia Copera board..."

nota

Rivedi sempre il codice generato dall'IA prima di eseguirlo. Verifica che i Column ID corrispondano ai valori reali di config.ts e che le chiamate API seguano i pattern della Starter Application.

Usare IDE potenziati dall'IA (Cursor, Windsurf e altri)​

Gli IDE potenziati dall'IA incorporano l'assistente IA direttamente nell'editor di codice. Possono leggere l'intero codebase per contesto, il che li rende particolarmente efficaci per la Starter Application.

Puntare l'IDE all'architettura​

La Starter Application include un file CLAUDE.md sia in base-application-api/ sia in base-application-web/. Questi file sono scritti appositamente così che gli assistenti IA possano capire:

  • Lo technology stack (framework, librerie, versioni)
  • La struttura delle cartelle e dove appartiene ogni tipo di file
  • Le convenzioni di coding e i pattern di naming
  • Come collegarsi al Copera SDK

Aggiungi il file CLAUDE.md come documento di riferimento nelle impostazioni di contesto dell'IDE. L'IA genererà poi codice che segue i pattern stabiliti anziché inventarne di propri.

Aggiungere documentazione come contesto​

La maggior parte degli IDE IA ti consente di aggiungere URL o documenti come materiale di riferimento. Aggiungi la documentazione developer di Copera:

https://university.copera.ai/developer/guides/starter-application/overview

Questo dà all'IA dell'IDE accesso al riferimento SDK, così può generare chiamate API accurate.

suggerimento

In Cursor, puoi aggiungere URL di documentazione sotto Settings > Features > Docs. Una volta indicizzati, l'IA referenzierà automaticamente metodi e pattern SDK dalla documentazione quando le chiedi di generare codice.

Consigli per i migliori risultati​

Condividi sempre i Column ID. I tool IA non possono indovinare la struttura della Copera Board. Più sei specifico su Column ID e nomi table, più accurato sarà il codice generato.

Costruisci in modo incrementale. Parti da un piccolo cambio — aggiungi un singolo nuovo field, crea una nuova pagina — e testalo prima di andare avanti. È molto più facile fare troubleshooting di un'aggiunta piccola che di una grande.

Referenzia i pattern che esistono già. La Starter Application è intenzionalmente coerente. Quando chiedi a un'IA di generare qualcosa di nuovo, indicale un file esistente che fa qualcosa di simile: "Genera una nuova pagina che segue lo stesso pattern di TicketDetailPage.tsx."

Verifica le chiamate SDK contro la documentazione. Gli assistenti IA possono occasionalmente generare chiamate a metodi SDK che non esistono o usano forme di argomenti obsolete. Controlla rispetto alla documentazione SDK prima di shippare.

Usa Copera AI per le domande sui dati, l'IA esterna per le domande sul codice. Copera AI conosce le board; Claude e ChatGPT sanno scrivere componenti React. Usa ciascuna per ciò che fa meglio.

Prossimi passi​