Manuale Operativo AI
Questa pagina e il punto di ingresso per una AI che deve lavorare in autonomia sui prodotti Smart eCommerce.
Regola principale
Sezione intitolata “Regola principale”Prima di modificare codice, contenuti o configurazioni, l’agente deve identificare il prodotto proprietario della responsabilita. Non deve correggere un problema nel livello sbagliato.
| Se devi modificare | Prodotto proprietario |
|---|---|
| Header, footer, menu, template, opzioni tema, code slots | AI-HTML Theme |
| Token Bootstrap, palette, font, librerie UI/FX, motion runtime | Smart Bootstrap Manager |
| Widget pagina, JSON builder, AI Canvas, blueprint | Smart Builder Site |
| Controlli Customizer e configurazione visuale widget | Smart Customizer Framework |
| Chat AI admin e tool agentici interni | Smart AI Assistant |
| Generazione articoli nell’editor | Smart AI Writer |
| Login personalizzata, OAuth, redirect ruoli | Smart Site Login Personalize |
| Licenze, release premium, update e download firmati | Smart License Manager |
| Shell gestionale Tabler, dashboard e navigazione applicativa | iDash |
Flusso obbligatorio
Sezione intitolata “Flusso obbligatorio”- Leggere la pagina prodotto in questa KB.
- Leggere i documenti locali indicati nella pagina prodotto.
- Capire se la modifica e tema, builder, runtime, API, admin o contenuto.
- Fare una modifica minima nel prodotto proprietario.
- Eseguire build/lint/test disponibili.
- Aggiornare la documentazione se cambia un contratto o una procedura.
- Pubblicare solo dopo verifica.
Confini di autonomia
Sezione intitolata “Confini di autonomia”Una AI puo procedere autonomamente quando:
- opera su file locali del prodotto corretto;
- usa endpoint documentati;
- aggiorna contenuti statici o documentazione;
- esegue build, lint e deploy gia autorizzati;
- non espone credenziali, token o dati personali.
Una AI deve fermarsi quando:
- servono credenziali non disponibili;
- l’azione elimina dati o resetta configurazioni live;
- cambia licenze, pagamenti, download premium o accessi utenti;
- l’endpoint non e documentato e l’effetto non e reversibile;
- la modifica richiede una decisione commerciale.
Verifica minima
Sezione intitolata “Verifica minima”Ogni intervento deve chiudersi con:
- file modificati;
- comando di verifica eseguito;
- risultato del comando;
- URL o schermata verificata se il cambiamento e pubblico;
- note su rischi residui.
Fonti locali canoniche
Sezione intitolata “Fonti locali canoniche”docs/smart-stack/PRODUCT-CATALOG.mdECOSYSTEM-DEVELOPMENT-STATUS.mdTECHNICAL-FILES-INDEX.mdSMART-ADMIN-PANEL-DESIGN-SYSTEM.md