Documentazione
Tutorial di Agenda Capoeiragem
Guide passo dopo passo per alunni, viaggiatori ed educatori. Impara ogni funzione con il testo esatto che vedrai nell'app.
Generale
Per iniziare
Come creare il tuo account, completare il profilo e unirti alla tua comunità.
Installa l'app o usala come web app
Scaricala da Google Play su Android, oppure apri agendacapoeiragem.com nel tuo browser e aggiungila alla schermata home come web app (PWA). Entrambe le opzioni funzionano allo stesso modo.
Crea il tuo account
Inserisci nome, cognome, soprannome (opzionale), paese (rilevato automaticamente), il tuo ruolo (Praticante o Educatore — solo un altro campo dello stesso modulo), email e password.
Completa l'onboarding
Dopo la registrazione, una procedura guidata ti accompagna passo dopo passo. Se sei alunno: completa il profilo, cerca il tuo gruppo e scegli la tua scuola. Se sei educatore: completa il profilo, scegli se unirti a un gruppo esistente o crearne uno tuo, e concludi creando la tua scuola.
Collega il tuo gruppo
Se hai finito l'onboarding senza unirti a un gruppo, vedrai nella schermata Home la card "Non appartieni ancora a un gruppo" con i pulsanti "Trova gruppo" e "Richiesta guidata" (e "Crea gruppo" se sei educatore).
Generale
Home e scoperta
Come navigare nella schermata principale e trovare rapidamente ciò di cui hai bisogno.
La schermata Home
La scheda "Home" mostra un saluto personalizzato con il tuo nome e la sezione "Prossimi eventi" con gli eventi della tua comunità in ordine cronologico. Un badge rosso sulla scheda "Profilo" indica notifiche in sospeso.
Filtra i prossimi eventi
Nella sezione "Prossimi eventi" troverai dei filtri rapidi: "Tutti", "Oggi", "Questa settimana" e "Questo mese". Toccali per restringere la vista.
Ricerca globale
Tocca la barra di ricerca nella schermata Home per aprire la ricerca globale. Digita un termine qualsiasi e vedrai i risultati organizzati in quattro sezioni: Eventi, Gruppi, Scuole e Utenti.
Card e promemoria in Home
Sopra "Prossimi eventi" possono apparire card contestuali: una tua richiesta in attesa di approvazione, la tua prossima lezione (se ti alleni in una scuola) con la tua serie di presenze, oppure — se sei educatore — un accesso rapido per registrare la presenza di oggi.
Accessi rapidi per educatori
Se gestisci una sola scuola, vedrai due chip fissi sotto i filtri: "Pannello scuola" e "Registra lezione", per accedere direttamente a quelle schermate.
Generale
Gruppi e comunità
Come scoprire i gruppi, unirti a uno ed esplorare la gerarchia della tua comunità.
Cos'è un gruppo e cos'è una scuola (núcleo)?
Un **gruppo** è l'organizzazione di capoeira nel suo insieme (es. Abadá Capoeira, Cordão de Ouro). Una **scuola** (núcleo) è un luogo di allenamento fisico specifico all'interno di quel gruppo — un gruppo può avere molte scuole in città o paesi diversi. Appartieni a un gruppo e ti alleni in una scuola. Gli educatori creano scuole all'interno del loro gruppo.
Esplora i gruppi
La scheda "Gruppi" mostra tutti i gruppi pubblici sulla piattaforma. Usa la barra di ricerca ("Cerca gruppo...") per filtrare per nome, e i menu a discesa "Paese di presenza" e "Stile di capoeira" per restringere la ricerca.
Il profilo di un gruppo
Tocca un gruppo qualsiasi per vedere il suo profilo. È un'unica schermata scorrevole: descrizione, una sezione comprimibile "Sistema di graduazione", una card "Gerarchia" (apre l'albero degli educatori in una schermata separata) e i prossimi eventi del gruppo.
Richiedi di unirti a un gruppo
Il pulsante "Richiedi di unirti al gruppo" appare nel profilo solo se sei educatore (o hai una graduazione da educatore) e non hai ancora un gruppo. La tua richiesta mostrerà il badge "Richiesta in attesa di approvazione".
Visualizza la gerarchia del gruppo
Tocca la card "Gerarchia" nel profilo del gruppo per aprire l'albero completo degli educatori, con ricerca per nome. Tocca un educatore qualsiasi per vedere il suo profilo pubblico.
Visualizza il profilo di un membro
Tocca il nome di un educatore o membro qualsiasi per vedere il suo profilo: nome, soprannome, gruppo, corda attuale e scuole dove insegna o si allena. Anche la cronologia delle graduazioni è visibile pubblicamente.
Generale
Eventi
Come scoprire, filtrare e confermare il tuo interesse per batizados, rodas e altro.
Esplora il calendario degli eventi
La scheda "Eventi" mostra in alto un calendario interattivo e sotto l'elenco eventi. Tocca una data qualsiasi per vedere gli eventi di quel giorno. Puoi alternare tra vista calendario e vista elenco con il pulsante nell'angolo.
Filtra per categoria e altro
Accanto al pulsante di alternanza vista trovi 3 chip rapidi: "Gratis", "Online" e "Questo weekend". Per altre opzioni, tocca "Filtri": categoria (batizado, roda, roda aperta, troca de corda, corso, workshop, seminario, festival, incontro, intensivo, allenamento, o una categoria personalizzata), prezzo, formato, date, gruppo e posizione.
Dettaglio evento
Tocca un evento qualsiasi per vedere la descrizione completa, data e ora, posizione sulla mappa, organizzatori e locandina se presente. Vedrai anche quante persone partecipano ("Partecipo") e quante hanno segnato interesse ("Interessato"), con una fila di avatar di chi partecipa.
Conferma "Partecipo" o "Interessato"
Dal dettaglio dell'evento, tocca "Interessato" per salvarlo nella tua lista, o "Partecipo" per confermare la presenza. Toccare di nuovo lo stesso pulsante rimuove la tua conferma.
Condividi un evento
Usa il pulsante di condivisione nel dettaglio dell'evento per inviarlo via WhatsApp, Instagram o altre app. Vengono condivisi il nome dell'evento, la data e un link diretto.
Generale
Il tuo profilo
Come gestire la tua identità, le notifiche e le impostazioni di accesso.
Come è organizzato il tuo profilo
La scheda "Profilo" è un'unica schermata (senza schede interne): in alto la tua foto, il ruolo e il gruppo; poi un pulsante "Attività"; e più in basso le sezioni in base al tuo ruolo — "Gestione" (educatori, le loro scuole) o "Dove mi alleno" (alunni, presenze e pagamenti).
Modifica il tuo profilo
Tocca l'icona di modifica (matita) sulla tua foto o sul nome. Puoi cambiare foto, nome, cognome, soprannome, una breve bio, paese, data di nascita, genere (obbligatorio) e i link ai tuoi social (Instagram, Facebook, WhatsApp, YouTube, TikTok e sito web). Salva toccando "Salva".
La tua corda
La tua corda attuale appare con il suo colore e nome sotto il tuo nome nel profilo. Toccarla ti porta al sistema di graduazione completo del tuo gruppo (tutti i livelli), non a una cronologia personale delle tue promozioni.
Impostazioni: lingua e tema
Da "Profilo", tocca "Impostazioni". Lì cambi la lingua (spagnolo, portoghese, inglese, francese, tedesco, italiano) e il tema visivo (chiaro o scuro). Le modifiche si applicano immediatamente.
Notifiche push: scegli cosa vuoi ricevere
In "Impostazioni → Notifiche" attiva o disattiva ogni tipo separatamente: promemoria evento, nuovi eventi del tuo gruppo, eventi vicino a te, riepilogo settimanale e novità della tua comunità.
Attività: richieste e prossimi eventi
Tocca il pulsante "Attività" nel tuo profilo per vedere i tuoi prossimi eventi confermati e le tue richieste in sospeso: di gruppo, di scuola, di educatore, di trasferimento scuola e di collaborazione a un evento. Il badge rosso sulla scheda "Profilo" mostra quante non hai letto.
Segnala un problema
Vai su "Profilo" → "Impostazioni" → "Segnala un problema". La tua segnalazione va direttamente al team di sviluppo.
Praticanti
Unirsi a una scuola
Come trovare una scuola, inviare una richiesta e cosa succede dopo.
Trova la tua scuola
Vai alla scheda "Gruppi", cerca il tuo gruppo per nome (o filtra per paese/stile) ed entra nel suo profilo. Da lì puoi raggiungere la scuola dove ti alleni.
Unisciti alla scuola
Nel profilo della scuola, tocca "Unisciti". La tua richiesta resta in sospeso finché l'educatore non la approva.
Attendi l'approvazione
La tua richiesta resta "In sospeso" finché l'educatore non la approva o la rifiuta. Riceverai una notifica quando c'è una risposta.
Accedi alla tua attività
Una volta approvata, la scuola appare nel tuo profilo, nella sezione "Dove mi alleno" — con il tuo stato di pagamento e l'accesso alle tue statistiche di allenamento.
Praticanti
La tua storia personale
Come visualizzare le tue presenze, la tua serie di allenamenti e lo stato dei tuoi pagamenti.
Dove mi alleno
Nel tuo profilo, la sezione "Dove mi alleno" elenca ogni scuola a cui appartieni con un badge di stato pagamento (Pagato, In sospeso, Scaduto, Gratuito...) e, se hai un pagamento in sospeso, un pulsante "Segnala pagamento".
La mia attività
Tocca "Vedi statistiche" su una delle tue scuole per aprire "La mia attività": la tua serie di lezioni consecutive, quante lezioni hai fatto questo mese / negli ultimi 30 giorni / quest'anno, un grafico di frequenza, le tue sessioni recenti e la tua cronologia pagamenti. Puoi condividere le tue statistiche con il pulsante dedicato.
La tua corda
La tua corda attuale appare nel tuo profilo. Toccarla ti porta al sistema di graduazione completo del tuo gruppo — non esiste una cronologia personale separata delle tue promozioni, ma la tua corda attuale è sempre visibile lì.
Eventi confermati
Tocca "Attività" nel tuo profilo per vedere i prossimi eventi a cui hai confermato "Partecipo".
Educatori
Creare il tuo gruppo
Come registrare il tuo gruppo di capoeira sulla piattaforma e configurare le sue informazioni.
Accedi al modulo di creazione
Se sei educatore e non hai ancora un gruppo, vedrai un banner "Crea gruppo" in Home o "Crea nuovo gruppo" nella scheda "Gruppi". Toccalo per aprire il modulo.
Nome e descrizione
Inserisci il nome ufficiale del tuo gruppo e una descrizione. Entrambi sono obbligatori. Il nome apparirà nella directory, sui profili dei membri e sui tuoi eventi.
Stile di capoeira (obbligatorio)
Nel campo "Stile di capoeira *", digita lo stile che praticate (es. Misto, Benguela, Angola, Regional). È testo libero ed è obbligatorio — usato come nome del tuo sistema di graduazione.
Logo del gruppo (opzionale)
Carica il logo dalla tua galleria. Apparirà nel profilo del gruppo, nelle sue scuole e nella card che i tuoi alunni vedono in Home.
Crea il gruppo
Tocca "Crea". Se il nome non è duplicato, il gruppo viene creato immediatamente ed entri direttamente nel suo profilo.
Invita membri
Non esiste un codice di invito. Condividi il nome del tuo gruppo con i tuoi alunni: lo cercheranno nella scheda "Gruppi" e richiederanno di unirsi. Puoi anche aggiungerli direttamente dal pannello della tua scuola.
Educatori
Gestire il tuo gruppo
Come gestire richieste, ruoli di amministrazione e informazioni del gruppo.
Approva o rifiuta le richieste di adesione al gruppo
Le richieste di adesione al gruppo si gestiscono da "Attività" nel tuo profilo, insieme alle altre notifiche. Tocca la richiesta per approvarla o rifiutarla.
Assegna ruoli: admin e co-admin
Dal profilo del gruppo, apri il pannello di amministrazione (visibile solo agli admin e co-admin). Lì puoi attivare o rimuovere il ruolo "Admin" o "Co-admin" per qualsiasi membro, o rimuovere il tuo con "Lascia ruolo admin".
Modifica le informazioni del gruppo
Vai al profilo del gruppo → icona di modifica. Puoi cambiare logo, nome, descrizione e stile di capoeira. Le modifiche si riflettono immediatamente nella directory pubblica.
Educatori
Supervisione educativa
Come assegnare un educatore supervisore per gli alunni della tua scuola.
Cos'è la supervisione educativa
La supervisione educativa è la relazione gerarchica tra educatori dello stesso gruppo. Un educatore più esperto può supervisionare il progresso degli alunni di un altro educatore, particolarmente utile quando si trovano in città o paesi diversi.
Supervisione automatica (stessa scuola)
Se il supervisore e gli alunni condividono la stessa scuola, la supervisione è automatica — vedrai il badge "Stessa scuola" nel profilo dell'alunno.
Supervisione manuale (fuori dalla scuola)
Se non hai una scuola tua, scegli i supervisori manualmente: nella schermata di supervisione, tocca direttamente l'educatore nell'elenco "Supervisori suggeriti" e poi "Salva modifiche". Gli alunni supervisionati così mostreranno il badge "Fuori dalla tua scuola".
Visualizza l'albero di supervisione
Nel profilo del gruppo, tocca la card "Gerarchia" per aprire l'albero completo degli educatori e chi supervisiona chi.
Educatori
Creare la tua scuola
Come creare la tua scuola, posizionarla sulla mappa e configurare gli orari di allenamento.
Accedi al modulo di creazione
Vai su "Profilo" → sezione "Gestione" → pulsante "Crea scuola". Se stai creando il tuo primo gruppo, questo passaggio appare anche nella procedura guidata iniziale.
Compila nome e posizione
Completa "Nome scuola" (es. Scuola Centro), "Posizione" (indirizzo completo), "Paese" e "Città". Tutti sono obbligatori.
Aggiungi orari di allenamento
In "Orari di allenamento", tocca "Aggiungi orario": giorno della settimana, orario di inizio e di fine. È richiesto almeno un orario.
Crea la scuola
Tocca "Crea scuola". Se tutti i campi sono completi, la scuola viene creata e visibile nella directory.
Modifica o elimina la scuola
Per modificare nome, indirizzo o orari, vai al profilo della scuola → icona di modifica. "Elimina scuola" è una cancellazione permanente, disponibile solo per l'educatore responsabile — non esiste un'opzione per nasconderla solo dalla directory.
Configura il sistema di pagamento
In "Modifica scuola" trovi la sezione pagamenti. Attiva "Lezioni gratuite" se non fai pagare una quota mensile. Se la fai pagare, inserisci il prezzo mensile, la valuta e il giorno del mese in cui il pagamento è dovuto.
Educatori
Co-educatori
Come aggiungere co-educatori alla tua scuola e gestire i loro permessi.
Cos'è un co-educatore
Un co-educatore è un educatore dello stesso gruppo che aiuta a gestire la tua scuola: registra lezioni, segna presenze, registra pagamenti e può modificare i dati della scuola. Solo eliminare la scuola o trasferire la responsabilità restano riservati all'educatore responsabile.
Aggiungi un co-educatore
Vai al pannello di amministrazione della tua scuola → scheda "Team" (visibile solo all'educatore responsabile). Scegli dall'elenco degli educatori del gruppo e conferma.
Rimuovi un co-educatore
Nella scheda "Team", tocca il nome del co-educatore e scegli "Rimuovi co-educatore".
Lascia il ruolo di co-educatore
Se sei co-educatore in una scuola e non vuoi più esserlo, vai al profilo pubblico della scuola e tocca "Lascia ruolo".
Trasferisci la responsabilità della scuola
Dalla scheda "Team", l'educatore responsabile può trasferire la responsabilità a un co-educatore attivo. Chi trasferisce diventa co-educatore della scuola.
Educatori
Richieste di adesione alla scuola
Come gestire le richieste di adesione alla tua scuola dal pannello di amministrazione.
Visualizza le richieste in sospeso
Vai al pannello di amministrazione della tua scuola → scheda "Richieste". Vedrai tutte le richieste di adesione in sospeso, con nome, foto e data del richiedente.
Approva o rifiuta una richiesta
Su ogni card, tocca l'icona ✓ per approvare o l'icona ✕ per rifiutare. Il richiedente riceve una notifica con la risposta, e se approvi, appare subito nel tuo elenco alunni.
Educatori
Alunni e gruppi di lezione
Come visualizzare i tuoi alunni e aggiungere membri senza account nell'app.
Il pannello di amministrazione della scuola
Accedi da "Profilo" → sezione "Gestione" → la tua scuola, oppure dal profilo della scuola toccando il pulsante admin. Troverai "Presenze" (aperta di default), "Alunni", "Pagamenti" e "Report".
Visualizza l'elenco alunni
Nella scheda "Alunni" vedrai tutti i membri collegati alla tua scuola con nome, corda attuale e percentuale di presenza mensile.
Aggiungi un alunno senza account (membro fantasma)
Nella scheda "Alunni", tocca l'icona "+" per registrare manualmente un alunno che non usa l'app. Inserisci il suo nome e i dettagli di base.
Gruppi di lezione
I gruppi di lezione (alunni organizzati per orario) si definiscono una sola volta, alla creazione della scuola — non c'è una schermata per aggiungerne di nuovi dopo.
Visualizza il profilo di un singolo alunno
Tocca il nome di un alunno qualsiasi per vedere la sua scheda: corda, percentuale di presenza del mese, cronologia delle presenze e registro pagamenti.
Educatori
Controllo presenze
Come registrare una lezione, segnare presenti e assenti, e rivedere la cronologia.
Registra una lezione
Nel pannello di amministrazione della scuola → scheda "Presenze", tocca "Registra lezione di oggi". Puoi cambiare la data nel modulo per registrare una lezione di un altro giorno — l'app adatta gli orari disponibili in base alla data scelta.
Seleziona orario e gruppo di lezione
Nel modulo della sessione, seleziona l'orario corrispondente. L'app carica automaticamente gli alunni di quel gruppo.
Segna presenti e assenti
Tocca il nome di ogni alunno per alternare tra presente e assente.
Sospendi una lezione
Se la lezione non si è svolta (festività, pioggia, ecc.), attiva "Sospendi lezione" prima di salvare. Viene registrata con il badge "Sospesa" e non conta né nelle presenze né nei pagamenti.
Salva la lezione
Tocca "Salva lezione". L'app mostra una finestra con il conteggio di presenti e assenti — tocca "Conferma" per registrare la sessione.
Rivedi le sessioni precedenti
Nella scheda "Presenze", le sessioni appaiono in ordine cronologico. Tocca una sessione passata qualsiasi per vedere il dettaglio o modificarla.
Educatori
Pagamenti e tesoreria
Come registrare le quote mensili, tracciare chi deve pagare ed esportare report.
La scheda "Pagamenti"
Nel pannello di amministrazione della scuola, vai alla scheda "Pagamenti". Ogni alunno appare con il suo stato del mese: In sospeso, Pagato, Pagato (in ritardo), Scaduto, Gratuito, Segnalato (l'alunno ha indicato di aver pagato) o Duplicato.
Registra il pagamento di un alunno
Tocca il nome dell'alunno nella scheda "Pagamenti" e poi "Registra pagamento". Inserisci l'importo, il mese corrispondente e, se applicabile, uno sconto (importo fisso o percentuale) — utile per le borse di studio.
Verifica un pagamento segnalato da un alunno
Quando un alunno segnala il suo pagamento dal proprio profilo, appare nella tua scheda "Pagamenti" con l'etichetta "Segnalato". Toccalo e modificalo come qualsiasi altro pagamento per cambiarne lo stato in "Pagato".
Vedi chi ha pagamenti in sospeso o scaduti
Nell'elenco della scheda "Pagamenti" vedi a colpo d'occhio lo stato di tutti gli alunni, incluso il giorno di scadenza configurato.
Genera ed esporta il report mensile
Vai alla scheda "Report" del pannello della scuola. Seleziona il formato (CSV o PDF) e tocca "Genera report". Include il riepilogo di pagamenti e presenze del mese.
Educatori
Sistema di graduazione
Come configurare le corde del tuo gruppo e registrare i cambi di livello.
Accedi al sistema di graduazione
Vai al profilo del tuo gruppo → sezione comprimibile "Sistema di graduazione" → "Gestisci sistema completo" (o "Configura sistema ora" se non hai ancora livelli).
Crea un livello di corda
Tocca "Aggiungi livello". Inserisci il nome della corda, seleziona i colori che la compongono e indica se ha punte colorate e quante.
Organizza per categoria
I livelli sono organizzati in sezioni: adulti, giovani, bambini, istruttori in formazione e livelli speciali. Assegna la categoria corretta quando crei o modifichi ogni livello.
Definisci il livello educatore
Puoi indicare a partire da quale corda un alunno è considerato "educatore" nel gruppo — questo determina chi ha accesso alla creazione di scuole e agli strumenti di gestione.
Assegna una graduazione
Dalla schermata del sistema di graduazione, tocca "Assegna graduazione ai membri". Trova l'alunno, seleziona il nuovo livello e la data. La modifica appare subito nel suo profilo.
Visualizza la corda di un alunno
Tocca il nome di un membro qualsiasi del gruppo per vedere la sua corda attuale con il colore.
Educatori
Creare e gestire eventi
Come pubblicare un batizado, una roda o un workshop per la comunità.
Crea un evento
Vai alla scheda "Eventi" e tocca il pulsante "+" flottante.
Compila i dati di base
Inserisci il nome dell'evento, la descrizione e la categoria (batizado, roda, roda aperta, troca de corda, corso, workshop, seminario, festival, incontro, intensivo, allenamento, o una categoria personalizzata).
Data, locandina e documenti
Imposta data di inizio e fine (con opzione di ricorrenza), carica un'immagine di copertina (locandina) e, se devi condividere regole o regolamenti, allega un PDF fino a 10 MB.
Prezzo e programma
Se l'evento ha un costo, inserisci il prezzo e i metodi di pagamento accettati (bonifico, contanti, Mercado Pago, PayPal o altro). Se l'evento ha più attività, aggiungile in "Programma" — ogni blocco con il proprio orario, descrizione e luogo.
Posizione
Se non hai usato il programma con luoghi per blocco, inserisci l'indirizzo dell'evento alla fine del modulo. L'app apre il selettore di mappa per posizionare il marcatore esatto.
Modifica un evento già creato
Vai al dettaglio dell'evento → icona di modifica (disponibile per l'organizzatore e i co-organizzatori). Le modifiche sono visibili immediatamente a tutti.
Gestisci co-organizzatori e ospiti speciali
Dal menu di modifica dell'evento, tocca "Collaboratori". Scegli il ruolo prima di invitare: "Co-organizzatore" (può modificare l'evento) o "Ospite speciale" (mostrato in evidenza, senza diritti di modifica). Cerca per nome e invia l'invito.
Educatori
Report e KPI
Come rivedere le metriche della tua scuola ed esportare dati per analisi esterne.
Barra delle metriche rapide
In alto nel pannello di amministrazione della scuola vedrai una barra con 3 dati: numero di alunni, percentuale media di presenza e alunni pagati sul totale.
Salta a un altro mese dal KPI
Tocca l'etichetta del mese in quella barra per aprire un selettore e saltare direttamente a qualsiasi mese precedente.
La scheda "Report"
Vai al pannello della scuola → scheda "Report". Se hai gruppi di lezione configurati, puoi filtrare l'intero report per un gruppo specifico usando i chip in alto.
Scegli il formato ed esporta
Seleziona "CSV" (per aprire in Excel o Google Sheets) o "PDF" (per condividere o stampare) e tocca "Genera report". Include alunni attivi, sessioni svolte, percentuale di presenza e stato di pagamento per alunno.