Orgo este registrul de membri al organizației. Conexiunea Orgo este locul din VolunHub unde organizația își spune adresa Orgo, credențialele aplicației și ce are voie să facă VolunHub cu ele. Fiecare organizație (structura de nivel național) are conexiunea ei; centrele locale și unitățile o folosesc pe cea a organizației din care fac parte. O organizație fără conexiune nu are nicio funcție Orgo: nu apar butoane, câmpuri sau legături către Orgo, iar sincronizările nu pornesc.
Conexiunea o gestionează responsabilul IT al organizației, din Aplicații → IT Management → Orgo. Alte persoane nu văd pagina. Toate setările Orgo sunt aici: nimic despre Orgo nu se mai configurează din setările serverului.
Deschide IT Management, alege organizația și apasă Orgo.
Completează adresa Orgo, token-ul API și, dacă organizația permite autentificarea cu Orgo, ID-ul și secretul aplicației. Secretele sunt păstrate criptat și nu mai sunt afișate după salvare; dacă lași un câmp secret gol la o modificare ulterioară, rămâne valoarea veche.
Alege comutatoarele de mai jos și salvează.
Apasă Verifică token-ul API.
Orgo face lucruri diferite, așa că fiecare are comutatorul lui, în secțiunea „Ce face Orgo pentru organizație”. Poți avea, de exemplu, doar autentificarea cu Orgo, fără nicio sincronizare.
Autentificare cu Orgo — butonul „Autentificare cu Orgo” și revenirea din Orgo. Oprit, membrii intră cu parola locală.
Sincronizarea membrilor — importul profilurilor, actualizarea nocturnă, importul listei de membri și reconcilierea apartenențelor. Cât e pornită, invitațiile de membri noi sunt refuzate: membrii organizației se creează într-un singur loc, în Orgo. Importul completează doar câmpurile goale din VolunHub; ce are deja VolunHub nu mai este suprascris (vezi mai jos).
Sincronizarea structurilor — centrele locale, unitățile și consiliile. Cât e pornită, mandatele deschise de Orgo sunt ale Orgo: le modifici prin Orgo, nu doar local.
Insigne — trimiterea insignelor către Orgo și descoperirea celor din Orgo.
Publicarea evenimentelor — publicarea unui eveniment în Orgo de către un organizator, cu propriul cont Orgo.
Scrieri către Orgo — comutatorul general pentru tot ce VolunHub scrie în Orgo. Oprit, VolunHub doar citește din Orgo. Sub el stau zonele de scriere, descrise mai jos.
⚠️ Sincronizarea insignelor pornește oprită
Conexiunea creată automat la instalare pentru Organizația Națională are Insignele oprite. Trimiterea insignelor scrie în Orgo-ul de producție, iar formatul cererilor nu a fost încă încercat pe datele reale. Pornește comutatorul deliberat, împreună cu „Scrieri către Orgo”, și urmărește prima rulare: ce a fost trimis și ce a răspuns Orgo. Dacă ceva nu arată bine, oprește-l la loc.
VolunHub poate corecta datele direct în Orgo, ca să nu mai fie nevoie să intri în Orgo pentru fiecare greșeală. Sub „Scrieri către Orgo” sunt patru comutatoare, toate oprite la început. Fiecare are nevoie și de comutatorul general.
Persoane (nume, contact, date personale) — numele, emailul, telefonul, data nașterii, genul și adresa unui membru, câte un câmp odată, doar când cineva apasă „Actualizează în Orgo”. Datele nu pleacă niciodată singure în Orgo când salvezi ceva în VolunHub.
Apartenențe și roluri — adăugarea, corectarea perioadei și încheierea unei apartenențe la o unitate sau patrulă, a unui mandat în consiliu și a unui rol de lider, din pagina Membri a structurii, din pagina postului și din pagina membrului. Tot aici e „Trimite în Orgo”, care duce în Orgo o apartenență creată doar în VolunHub. Un rol nu se șterge: se încheie, cu data de sfârșit.
Structuri (unități, patrule, centre locale) — crearea, redenumirea, mutarea și închiderea unei unități sau patrule, din tab-ul Organizare, și numele și starea unui Centru Local, din Administrare → Nume și stare în registrul național.
Trimiterea rolurilor Safe from Harm — rolurile de responsabil Safe from Harm, trimise automat în Orgo.
Cât timp o zonă nu a avut nicio scriere reușită, pagina o arată ca „pornit — nicio scriere reușită încă”: nu se știe încă sigur că Orgo acceptă scrierile din zona aceea. Cât timp o zonă e oprită, butoanele care ar scrie în ea nu apar, iar paginile spun „Se modifică în Orgo — scrierea din VolunHub nu este activată”.
⚠️ Prima scriere din fiecare zonă se face cu cineva de față
Orgo nu are un mediu de test: fiecare scriere ajunge pe datele reale ale membrilor. Pornește o zonă deliberat, fă o primă modificare mică și verifică în Orgo și în „Ultimele scrieri” că a ieșit cum trebuia, înainte să o folosească toată lumea.
Scrierile folosesc token-ul API al organizației, dar VolunHub verifică de fiecare dată dreptul persoanei care apasă butonul, exact ca pentru aceeași modificare făcută doar în VolunHub. Nu există drepturi noi, speciale pentru Orgo.
O apartenență o modifică cine gestionează membrii structurii: consiliul Centrului Local, liderul unității pentru propria unitate, un administrator al organizației.
Un mandat îl modifică cine poate ocupa postul respectiv în organigramă.
O unitate sau o patrulă o modifică cine poate organiza structura de deasupra ei.
Numele și starea unui Centru Local le modifică doar Consiliul Național și administratorii platformei.
Datele unei persoane le trimit liderii și consiliul structurilor ei, pentru câmpurile pe care le pot modifica și în VolunHub.
Fiecare membru își poate trimite singur în Orgo emailul, telefonul și adresa, din Profilul meu, cardul „Datele tale în Orgo”. Numele, data nașterii și genul nu le poate trimite el însuși.
Consiliul Național vede listele de membri și datele din Orgo, dar nu le modifică. O corectură la nivel național a apartenențelor unui Centru Local o face un administrator al platformei.
Nu poți schimba Orgo fără să știi. Orice buton care modifică și Orgo are eticheta „— se modifică și în Orgo” și un semn galben Orgo. Un buton fără acest semn schimbă doar VolunHub.
Apeși butonul marcat. Se deschide o fereastră de confirmare care spune că modificarea se trimite în Orgo (membri.scout.ro) și arată valoarea de acum și pe cea nouă.
Confirmi cu „Modifică în VolunHub și în Orgo” sau renunți. Fără confirmare nu se trimite nimic.
VolunHub citește din nou rândul din Orgo, trimite modificarea și aduce înapoi ce a rămas în Orgo. Primești răspunsul Orgo: „Modificat în Orgo” sau „Orgo a refuzat: …”. Dacă Orgo refuză, nimic nu se schimbă nici în VolunHub.
ℹ️ Când cineva a modificat între timp în Orgo
Dacă valoarea din Orgo s-a schimbat de la ultima sincronizare, VolunHub nu trimite nimic: aduce valoarea nouă din Orgo și îți cere să verifici și să încerci din nou. Nu se amestecă două variante.
Fiecare încercare de a scrie în Orgo este notată, reușită sau nu. Cardul „Ultimele scrieri” de pe pagina conexiunii arată ultimele 50: când, cine (sau „sistemul”, pentru trimiterile automate), ce s-a modificat, zona și rezultatul — trimis, refuzat de Orgo, în conflict, eșuat sau încă în așteptare. Pentru un refuz apare și răspunsul Orgo. Scrierile despre o anumită persoană apar și pe pagina membrului, în secțiunea Orgo.
Trimiterile automate (insigne, roluri Safe from Harm) așteaptă la rând și sunt reîncercate dacă Orgo nu răspunde. Modificările făcute de o persoană se trimit pe loc și nu sunt reîncercate: primești răspunsul pe ecran.
Comutatoarele care ating datele reale — sincronizările, insignele, publicarea evenimentelor și toate scrierile — sunt legate de instanța pe care au fost pornite. Când pornești unul, VolunHub notează o amprentă a instalării pe care rulează, cine a pornit și când. Cardul „Instanța pe care rulează Orgo” arată starea.
De ce: o copie a bazei de date — pe staging, pe un laptop sau la o restaurare — ia cu ea și comutatoarele pornite. Fără legare, copia ar scrie în Orgo-ul real și ar copia lista reală de membri. Cu legare, acolo amprenta nu se potrivește, așa că copia nu sincronizează și nu scrie nimic. Comutatoarele apar oprite, cu motivul „configurarea a fost făcută pe altă instanță”. Autentificarea cu Orgo nu e legată și funcționează în continuare, ca oamenii să poată intra.
Butonul „Confirmă din nou pentru această instanță” leagă conexiunea de instanța curentă, dar cu toate comutatoarele legate oprite. Apoi pornești doar ce vrei și salvezi. Așa, un clic pe o copie nu poate redeschide scrierile pe care le avea producția.
⚠️ Și producția se poate opri singură
Dacă instalarea de producție își schimbă cheia secretă sau adresa, amprenta nu se mai potrivește nici acolo: sincronizarea nocturnă și scrierile se opresc până când cineva confirmă din nou și repornește comutatoarele dorite. E intenționat: o instalare care și-a schimbat identitatea întreabă un om înainte să atingă registrul real.
Dacă o sincronizare sau o scriere face ceva greșit, oprește comutatorul respectiv din pagina conexiunii. Operatorul instalării (cine are acces la server) poate opri totul dintr-o singură comandă, fără să repornească aplicația:
manage.py orgo offoprește toate comutatoarele pe toate conexiunile; cu--organizationși--capabilityoprește doar o organizație sau doar o funcție (de exemplu--capability writes).manage.py orgo statusarată, pentru fiecare conexiune, ce e pornit și dacă e legată de instanța curentă.
Oprirea e notată ca făcută de sistem. Trimiterile automate care așteaptă rămân la rând și nu pleacă până când cineva repornește comutatorul.
Verifică token-ul API face o singură cerere către Orgo cu token-ul API și notează rezultatul și momentul. Ea nu poate controla ID-ul și secretul aplicației — acelea se dovedesc doar când cineva se autentifică; pagina scrie „se verifică la prima autentificare” până atunci și notează prima autentificare reușită.
Pentru fiecare comutator, pagina arată dacă rulează efectiv și, dacă nu, de ce: conexiunea e dezactivată, lipsește token-ul, comutatorul e oprit, are nevoie și de „Scrieri către Orgo” sau configurarea a fost făcută pe altă instanță.
Dezactivează oprește Orgo pentru toată organizația, dar nu șterge nimic. Pagina de dezactivare îți arată ce se oprește, pentru fiecare comutator.
Se oprește: autentificarea cu Orgo, sincronizările, trimiterea insignelor, publicarea evenimentelor și toate scrierile. Mandatele deschise de Orgo devin gestionabile local.
Rămâne: credențialele (criptate), conturile membrilor, identificatorii Orgo, apartenențele, mandatele și jurnalul scrierilor. Poți reactiva conexiunea oricând, iar mandatele revin la Orgo exact cum erau.
ℹ️ Membri fără parolă locală
Cine s-a autentificat doar prin Orgo nu are parolă locală și nu va mai putea intra după dezactivare. Pagina îți spune câți sunt și poți apăsa Trimite linkuri de setare a parolei: fiecare membru cu adresă de email primește un link cu care își alege singur o parolă. VolunHub nu setează niciodată o parolă în locul cuiva; cei fără adresă de email nu pot primi linkul și trebuie ajutați separat.
Importul din Orgo nu mai suprascrie datele pe care VolunHub le are deja (nume, data nașterii, email, telefon, adresă, gen): completează doar câmpurile goale. Ce spune Orgo rămâne păstrat și este comparat câmp cu câmp pe pagina membrului, unde o diferență apare cu semnul „Diferă în Orgo” și poate fi rezolvată într-o parte sau în cealaltă. Corecturile făcute în Orgo după primul import nu mai ajung singure în VolunHub; le găsești în lista diferențelor.