# AKS Knowledge Base Chat

Web component per la chat AI integrata in Aksilia Suite. Permette agli utenti di interagire con la Knowledge Base, documenti normativi, manuali Suite, GenDoc e trascrizioni riunioni.

## Stack tecnologico

- **TypeScript**
- **Svelte 5** (framework)
- **Vite 5** (build tool)
- **Paraglide JS** (i18n — italiano e inglese)

## Avvio in sviluppo

```bash
# Requisiti: Node.js 20+
npm install
npm run dev
```

Il server di sviluppo si avvia su `http://localhost:5173`. La pagina di sandbox è `src/routes/+page.svelte`.

Per connettersi ai backend locali, usare `env-id="aks_svi"` nel componente (vedi [docs/development.md](docs/development.md)).

## Comandi principali

| Comando | Descrizione |
|---|---|
| `npm run dev` | Avvia il server di sviluppo |
| `npm run build` | Compila la libreria in `CDN/` |
| `npm run check` | Type-check Svelte/TypeScript |
| `npm run check:watch` | Type-check in modalità watch |
| `npm run cdn` | Build + bump versione + pubblica su npm (`@latest`) |
| `npm run cdn:dev` | Aggiunge il tag `dev` alla versione corrente (Quality) |
| `npm run cdn:stable` | Aggiunge il tag `stable` alla versione corrente (Produzione) |

## Pubblicazione

```bash
npm run cdn          # Pubblica come @latest
npm run cdn:dev      # Promuove a Quality
npm run cdn:stable   # Promuove a Produzione
```

Vedi [docs/deployment.md](docs/deployment.md) per la procedura completa.

## Dipendenze

- **AKS Knowledge Base Back** — backend principale (orchestrator, KB, Forge, GenDoc, Transcription)

## Documentazione

- [Panoramica](docs/index.md)
- [Installazione e integrazione](docs/installation.md)
- [Configurazione](docs/configuration.md)
- [Architettura](docs/architecture.md)
- [Sviluppo](docs/development.md)
- [Testing](docs/testing.md)
- [Deploy](docs/deployment.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Servizi esterni](docs/integration.md)