Passa al contenuto principale

Assistente IA

Fai domande sul tuo codice in linguaggio naturale.

Panoramica​

L'Assistente IA ArchiCore comprende il tuo codice e può rispondere a domande come:

  • "Come funziona il sistema di autenticazione?"
  • "Cosa si romperebbe se modifico UserService?"
  • "Dove si trova la logica di elaborazione dei pagamenti?"
  • "Spiega il flusso dati per la creazione degli ordini"

Usare l'Assistente​

Interfaccia Web​

  1. Seleziona un progetto
  2. Digita la tua domanda nel pannello chat
  3. Ottieni una risposta con riferimenti al codice

CLI​

Digita semplicemente la tua domanda in modalità interattiva:

> Come funziona l'autenticazione degli utenti?

Il sistema di autenticazione in questo progetto utilizza token JWT.
Ecco come funziona:

1. **Flusso di Login** (src/auth/login.ts)
   - L'utente invia email/password
   - Credenziali validate contro il database
   - Token JWT generato con ID utente

2. **Validazione Token** (src/middleware/auth.ts)
   - authMiddleware() estrae il token dall'header
   - Token verificato usando JWT_SECRET
   - Utente allegato all'oggetto request

3. **Gestione Sessioni** (src/services/session.ts)
   - Sessioni memorizzate in Redis
   - Scadenza predefinita di 7 giorni
   - Supporto refresh token

File chiave:
- src/auth/login.ts:45-78
- src/middleware/auth.ts:12-34
- src/services/session.ts:23-56

API​

curl -X POST https://api.archicore.io/api/v1/projects/:id/ask \
  -H "Authorization: Bearer TUA_API_KEY" \
  -d '{"question": "Come funziona l autenticazione?"}'

Tipi di Domande​

Domande sull'Architettura​

> Qual è l'architettura generale di questo progetto?
> Come sono organizzati i moduli?
> Quali design pattern vengono utilizzati?

Domande sul Flusso del Codice​

> Cosa succede quando un utente effettua un ordine?
> Come fluiscono i dati dall'API al database?
> Traccia il ciclo di vita della richiesta per /api/users

Domande sull'Impatto​

> Cosa si romperebbe se modifico UserService?
> Quali file dipendono dal modulo database?
> Quali test coprono la logica di pagamento?

Domande sulla Posizione​

> Dove si trova la logica di invio email?
> Quale file gestisce la registrazione utenti?
> Trova il middleware di rate limiting

Domande di Spiegazione​

> Spiega cosa fa processOrder()
> Perché questa funzione usa la ricorsione?
> Qual è lo scopo del livello di cache?

Consigli per Risposte Migliori​

Sii Specifico​

❌ "Come funziona?"
✓ "Come funziona il processo di registrazione utenti?"

Fornisci Contesto​

❌ "Perché è lento?"
✓ "Perché la funzione getProducts() in src/api/products.ts potrebbe essere lenta?"

Fai Domande di Follow-up​

> Come funziona l'autenticazione?
[Risposta sui token JWT...]

> Puoi mostrarmi il codice per la validazione del token?
[Mostra codice specifico...]

> Cosa succede se il token scade?
[Spiega il flusso del refresh token...]

Supporto Lingue​

L'assistente risponde nella stessa lingua della tua domanda:

> Come funziona l'autenticazione?

Il sistema di autenticazione utilizza token JWT...

Limitazioni​

L'assistente IA:

  • Conosce solo il codice indicizzato - Esegui prima /index
  • Non può eseguire codice - Analizza solo codice statico
  • Potrebbe avere informazioni obsolete - Re-indicizza dopo le modifiche
  • Si concentra sul tuo progetto - Non discuterà librerie esterne in dettaglio

Privacy​

  • Le domande vengono elaborate da modelli IA
  • Il contesto del tuo codice viene inviato per l'analisi
  • Nessun codice viene memorizzato permanentemente
  • Vedi Informativa sulla Privacy per i dettagli