Guida utente

Guida utente — Orange Engine Hub

Questa guida descrive le funzioni presenti nel codice. Il plugin e il tema devono essere installati e attivati da un amministratore; prima dell'attivazione in produzione occorrono un backup verificato e un ambiente di prova. La configurazione dello storage privato è descritta in `storage.md`. Senza storage configurato non è possibile caricare pacchetti o ottenere download funzionanti. Il sito non contiene asset, versioni o immagini precompilati.

Ruoli e accesso

Accedi a WordPress e apri **Orange Engine** nel menu. Gli amministratori ricevono le capacità dedicate durante l'attivazione; l'assegnazione a ruoli aggiuntivi richiede uno strumento affidabile di gestione delle capacità. Concedi solo i permessi necessari. Un client automatico non usa la password WordPress: crea un token dedicato in **Orange Engine → Client API**, seleziona gli scope e la scadenza, quindi copia il token quando viene mostrato. Non sarà più visualizzabile. Revocalo dalla stessa schermata quando non serve più.

Asset e versioni

In **Tipi di asset** puoi aggiungere categorie; il catalogo include tipi iniziali per modelli 3D, texture, animazioni e altre risorse. In **Assets** inserisci nome, autore, tipo, licenza e descrizione; seleziona la pubblicazione solo quando il contenuto è pronto. In **Versioni asset** scegli l'asset, la versione SemVer, le eventuali piattaforme compatibili e il file ZIP. Il sistema controlla l'archivio e genera SHA-256. Nella stessa schermata puoi ritirare o ripristinare una versione: il ritiro disattiva il download pubblico ma conserva il pacchetto. La dimensione realmente caricabile dipende anche da PHP e dal proxy; multipart/resume degli upload e importazioni di 5 GB non sono ancora implementati. Gli asset pubblici compaiono in `/assets/`; la scheda mostra le versioni disponibili e i download. Seleziona **Modifica** nell’elenco degli asset per modificare descrizione, requisiti, visibilità, immagine e galleria selezionandole dalla libreria Media. Le stesse operazioni sono disponibili via API: vedi `guida-agente.md`.

Release dell'engine

In **Release engine** inserisci versione, canale, piattaforma, architettura, versione minima del launcher e note, quindi carica lo ZIP. La release appare in `/engine/` e il launcher può consultare la relativa API. Una release senza ZIP è un record informativo senza pulsante di download. Non usare una release di prova come release pubblica effettiva.

Progetti, roadmap, documentazione e news

Usa i menu WordPress **Projects**, **Roadmap** e **Documentation** per creare i contenuti. Il pannello Orange Engine details raccoglie i metadati specifici; per i progetti usa l'immagine in evidenza e gli ID allegato per la galleria. La roadmap usa stati, avanzamento, milestone e versione obiettivo. I tag e le sezioni/versioni della documentazione sono tassonomie modificabili. Un agente con scope `projects:write` può importare pacchetti ZIP versionati da associare ai progetti: i download appaiono nella scheda del progetto pubblicato. Le news usano gli articoli WordPress. Gli archivi pubblici sono `/projects/`, `/roadmap/`, `/docs/` e `/news/`. Le tassonomie vuote e gli archivi senza contenuti non mostrano dati inventati.

Limiti operativi

Il prodotto è ancora in sviluppo: non sono completati tutti i pannelli di gestione, le anteprime, l'importazione multipart, la scansione antivirus, le statistiche e gli strumenti diagnostici richiesti dal progetto. I backup devono includere database WordPress e directory di storage privata. Il download usa URL temporanei: non condividerli come collegamenti permanenti. Per assistenza tecnica consulta `security.md`, `engine-integration.md` e `openapi.yaml`.

Collegare Claude

Puoi aggiungere Orange Engine come connettore MCP personalizzato in Claude usando l’URL dell’hub e il token API. I passaggi e i limiti per i file sono descritti nella guida `claude-mcp.md`.

Gestire gli asset e i download pubblici

Nel menu Orange Engine → Asset trovi gli asset come contenuti WordPress. Apri un asset per modificare titolo, descrizione, autore, categoria, requisiti e immagine in evidenza; le versioni e i relativi pacchetti si gestiscono dalla sezione Versioni. Il ritiro conserva i dati e disattiva la pubblicazione.

In Orange Engine → Impostazioni puoi disattivare i download pubblici degli asset. Le schede restano visibili, ma i visitatori non possono ottenere nuovi link di download dal sito o dalle API. I client autorizzati con assets:download o admin, inclusi engine e agenti, continuano a funzionare. I link temporanei già generati restano validi fino alla scadenza, normalmente cinque minuti. Questa impostazione non riguarda release engine e pacchetti progetto.