# 🎧 RUDE-HZ — Manuale Operativo Ufficiale & Guida alla Piattaforma
**Piattaforma:** https://www.rude-hz.it | **Versione:** 1.0 Production  
**Motto:** *The Harder Side of Sound — Born in WhatsApp, Raised in Techno.*

---

## Indice dei Contenuti
1. **Il Progetto Rude-Hz: Visione, Valori e Navigazione Pubblica**
2. **Guida per Ascoltatori & Artisti (`/my-studio`)**
3. **Guida per la Redazione / Editor (`/admin`)**
4. **Guida per i Curatori Musicali / Curator (`/admin`)**
5. **Guida per l'Amministratore Globale / Super Admin (`/admin`)**

---

## 1. Il Progetto Rude-Hz: Visione, Valori e Navigazione Pubblica

### A. Cos'è Rude-Hz
**Rude-Hz** è una piattaforma indipendente nata per dare struttura, identità e voce alla scena underground **Tekno, Acid, Hard Tekno e Industrial**, superando i limiti delle chat frammentate e degli algoritmi commerciali.  
Il portale unisce in un unico spazio:
* **Musica Indipendente:** Streaming continuo dei master caricati dagli artisti della community, senza pubblicità né logiche commerciali.
* **Cultura & Divulgazione:** Articoli tecnici, storia della musica elettronica, approfondimenti su diritti d'autore/royalty e informazione sulla riduzione del danno.
* **Partecipazione Attiva:** Arene creative e contest di produzione musicale.
* **Sostegno dal Basso:** Un modello autofinanziato dalla community attraverso la sezione **Support**, per coprire i costi reali di server, sviluppo e mantenimento.

### B. Come Funziona il Sito Pubblico
* **Player Audio Persistente (Barra Inferiore):** È sempre attivo durante tutta la navigazione. Al primo clic sulla pagina avvia la rotazione musicale e ti permette di cambiare brano, mettere in pausa, scorrere la traccia o regolare il volume mentre esplori qualsiasi sezione del sito senza interrompere l'ascolto.
* **Multilingua Automatico (`IT` / `EN` / `ES`):** Cliccando sulle bandiere in alto a destra puoi leggere interfaccia e contenuti in Italiano, Inglese o Spagnolo.
* **Sezioni Principali:**
  * **Progetto:** Il manifesto e la storia dell'iniziativa.
  * **Artisti:** L'elenco dei producer attivi, con biografia, tracce e collegamenti diretti.
  * **Playlist:** Le selezioni ufficiali curate dallo staff.
  * **Tracce:** L'archivio completo dei brani approvati in rotazione.
  * **News:** Il magazine editoriale della community.
  * **Support:** La pagina dedicata a chi desidera contribuire alle spese di gestione e sviluppo tramite donazione volontaria (PayPal).

---

## 2. Guida per Ascoltatori & Artisti (`/my-studio`)

### A. Registrazione, Verifica Email e Attivazione
1. Clicca su **Registrati** nella barra superiore (o nella schermata *Accedi*).
2. Inserisci il tuo **Nome d'Arte**, un indirizzo email valido e una password.
3. **Conferma Email:** Riceverai subito un'email da **Rude-Hz** con un pulsante di verifica (*controlla anche la cartella Spam al primo invio*). Clicca sul link per attivare l'account.
4. **Accesso Immediato allo Studio:** Appena confermata l'email, puoi accedere subito alla tua area personale **`/my-studio`**.
5. **Approvazione Pubblica:** Per garantire la qualità musicale del portale, i nuovi profili nascono in modalità *"In Revisione"* (`OFF`). Puoi già compilare tutti i tuoi dati e caricare i tuoi brani; appena lo staff avrà verificato il profilo, diventerai visibile a tutti nella sezione **Artisti**.

### B. Gestione del Profilo Artista (`/my-studio`)
* **Anagrafica & Biografia:** Inserisci la tua descrizione artistica e i tuoi link ufficiali (SoundCloud, Spotify, YouTube, Instagram).
* **Web3 & Supporto Diretto:** Puoi indicare la tua chiave pubblica **Nostr (`npub`)** e il tuo **Lightning Address** per ricevere supporto diretto dagli ascoltatori.
* **Avatar & Immagine di Copertina:** Carica le tue immagini dal dispositivo; il sistema le ottimizzerà automaticamente per garantire caricamenti istantanei anche da rete mobile.

### C. Caricamento Tracce & Partecipazione ai Contest
* **Le Mie Tracce:** Carica i tuoi brani in formato **MP3** (o WAV), specifica titolo, genere musicale e copertina. Finché non vengono approvati dai curatori restano contrassegnati come *In Revisione*.
* **Contest:** Dalla sezione **Contest** della tua area studio puoi consultare le sfide creative aperte, selezionare una delle tue tracce e inviarla accettando la liberatoria prevista dal regolamento.

---

## 3. Guida per la Redazione / Editor (`/admin`)
Gli utenti con ruolo **Editor** accedono al pannello amministrativo con una barra dedicata esclusivamente ai contenuti redazionali: **`DASHBOARD`**, **`CONTEST`**, **`NEWS`**, **`PAGES`**.

### A. Gestione Articoli (`NEWS`)
1. Entra in **News** e clicca su **+ Nuova News**.
2. **Categoria Editoriale:** Se il tuo account è associato a una rubrica specifica, i tuoi articoli verranno pubblicati direttamente all'interno di quella categoria.
3. **Composizione:** Inserisci titolo, sottotitolo, testo completo (scrivilo pure in italiano: il sistema traduce in automatico per gli utenti esteri) e un'immagine di copertina orizzontale.
4. Puoi aggiornare o rimuovere i tuoi articoli in qualsiasi momento tramite i pulsanti **Modifica** ed **Elimina**.

### B. Gestione Pagine Istituzionali (`PAGES`)
* Dalla sezione **Pages** puoi modificare i testi principali delle pagine **Progetto** e **Supporto**, mantenendo sempre aggiornato il manifesto della community e le informazioni per i sostenitori senza dover intervenire sul codice del sito.

### C. Gestione Arene & Contest (`CONTEST`)
* Dalla sezione **Contest** puoi creare nuove sfide musicali, definire il tema, impostare le date di apertura/chiusura e pubblicare il regolamento ufficiale.

---

## 4. Guida per i Curatori Musicali / Curator (`/admin`)
Gli utenti con ruolo **Curator** (A&R) gestiscono il catalogo sonoro e la direzione artistica del portale: **`DASHBOARD`**, **`ARTISTI`**, **`TRACCE`**, **`PLAYLIST`**.

### A. Approvazione e Modifica Artisti (`ARTISTI`)
* **Switch Rapido `ON ⚡ / OFF 💤`:** Nella lista artisti puoi attivare o mettere in pausa un profilo con un solo clic. Quando è su `ON ⚡`, l'artista è immediatamente pubblico.
* **Modifica Profilo (`EDIT`):** Puoi entrare nella scheda di qualsiasi artista per aiutarlo a correggere testi, link o immagini.

### B. Moderazione e Modifica Tracce (`TRACCE`)
* **Approvazione (`ON ⚡`):** Ascolta i nuovi brani caricati dagli artisti e attiva lo switch su `ON ⚡` per mandarli in rotazione pubblica sul player e nell'archivio tracce.
* **Modifica Metadati (`EDIT`):** Se un artista ha sbagliato il titolo del brano, il genere o la copertina, puoi correggerli direttamente cliccando su **`EDIT`**.

### C. Creazione Playlist Ufficiali (`PLAYLIST`)
1. Vai su **Playlist** → **+ Nuova Playlist**.
2. Inserisci titolo, descrizione, copertina e seleziona i brani approvati da inserire nella scaletta.
3. Puoi riordinare o aggiornare le playlist in qualsiasi momento.

---

## 5. Guida per l'Amministratore Globale / Super Admin (`/admin`)
Il **Super Admin** ha accesso completo a tutte le aree operative, statistiche e di sicurezza della piattaforma.

### A. Gestione Utenti, Staff e Permessi (`USERS`)
Dalla voce **Users** nella barra superiore puoi creare, modificare o sospendere qualsiasi account:
* **`super_admin`:** Accesso completo a tutto il sistema.
* **`editor`:** Accesso limitato a *News*, *Contest* e *Pages* (senza creare un profilo artista pubblico).
* **`curator`:** Accesso limitato a *Artisti*, *Tracce* e *Playlist*.
* **`artist`:** Accesso alla propria area personale `/my-studio`.
* **`listener`:** Utente registrato base (senza area artista).

*(Nota sulla sicurezza: eliminando un profilo dalla tabella **Artisti**, vengono rimossi i brani e i file multimediali collegati, mentre l'utenza resta nel sistema come `listener` per mantenere pulito lo storico).*

### B. Analitica, Hardware & Aiuto Rapido (`STATS` & `?`)
* **Monitoraggio Server:** Nella **Dashboard** principale puoi verificare in tempo reale temperatura e carico del server.
* **Statistiche (`STATS`):** Grafici interattivi su visite degli ultimi 30 giorni, tempi di permanenza, dispositivi utilizzati e provenienza del traffico.
* **Aiuto Contestuale (`?`):** In alto a destra nella barra di controllo è sempre presente il pulsante **`?`**, che apre una scheda operativa specifica per la pagina in cui ti trovi, stampabile o salvabile in PDF.
