Documentație tehnică

Această pagină adună partea tehnică a platformei Arhondaric — software gratuit pentru mănăstirile ortodoxe — și se adresează celui căruia i se cere o părere înainte ca mănăstirea să primească acest program pentru arhondaric: un informatician al eparhiei, un voluntar priceput sau un părinte care vrea să arate cuiva ce anume primește. Aici scriem pe ce tehnologii este construită platforma, de ce are nevoie ca să funcționeze, unde stau datele pelerinilor, cum se face asistența și ce rămâne mănăstirii dacă într-o zi renunță la ea. Nimic din cele scrise mai jos nu cere pricepere tehnică din partea părinților — instalarea o facem noi —, ci sunt lămuriri pentru cine vrea să înțeleagă temeiul.

Pe ce tehnologii este construită platforma

Arhondaric este o platformă web pentru gestionarea cazării pelerinilor: nu se instalează pe calculator, ci se deschide în browser. Partea care lucrează pe server este scrisă în PHP, iar datele sunt ținute într-o bază de date MariaDB (sau MySQL). PHP este limbajul folosit și de Wikipedia, și de multe alte site-uri mari, iar MariaDB este o bază de date binecunoscută; sunt tehnologii deschise, mature și bine încercate, nu unelte rare pe care nimeni nu le mai știe peste câțiva ani.

Interfața pe care o văd părinții este făcută cu Bootstrap 5, jQuery și DataTables. Aceleași pagini se folosesc deopotrivă de pe calculator, de pe tabletă și de pe telefon. Paginile publice ale mănăstirii se scriu într-un editor vizual (Summernote), biletele de cazare în PDF cu cod QR se fac cu TCPDF, iar înștiințările pe email pleacă prin PHPMailer, pe SMTP.

  • Limbaj: PHP 8.2
  • Bază de date: MariaDB sau MySQL
  • Interfață: Bootstrap 5, jQuery, DataTables
  • Editor pentru paginile publice: Summernote
  • Bilete PDF cu cod QR: TCPDF
  • Înștiințări pe email: PHPMailer, prin SMTP
  • Docker
  • Limba platformei: română

Ce îi trebuie ca să funcționeze

Două lucruri sunt de trebuință din partea mănăstirii: un server pe internet, pe care se așază platforma, și o adresă de email de pe care pleacă înștiințările către pelerini. Dacă mănăstirea nu are un server, vă îndrumăm noi cum poate fi obținut. Altceva nu este nevoie.

De partea părinților nu se instalează nimic. Un browser obișnuit este de ajuns, pe calculator, pe tabletă sau pe telefon; părintele arhondar poate aproba o cerere de cazare de oriunde se află, fără să descarce vreo aplicație.

Cât despre cheltuială: software-ul este 0 lei, fără taxe, fără abonament, și nu se solicită donații de la mănăstiri. Rămâne doar găzduirea pe server, o cheltuială mică ce rămâne în grija mănăstirii; totuși, în limita resurselor pe care le avem, încercăm să o oferim și pe aceasta fără plată sfintelor mănăstiri ce nu o pot susține.

  • Un server pe internet, pentru care vă îndrumăm dacă nu aveți unul
  • O adresă de email pentru trimiterea înștiințărilor, prin SMTP
  • Un browser obișnuit, pe calculator, tabletă sau telefon
  • Nicio instalare și nicio descărcare de partea celor care o folosesc

Ce înseamnă că platforma se așază pe serverul mănăstirii

Platforma nu este un serviciu la care mănăstirea se abonează. Ea se așază pe serverul mănăstirii și de acolo lucrează: acolo stau datele, acolo stă și codul.

Instalarea efectivă durează câteva ore și nu revine mănăstirii — o facem noi. După aceea așezăm în sistem clădirile și camerele mănăstirii, orarul cazărilor și orarul meselor, și pornim sau oprim modulele după rânduiala obștii: dacă nu este de trebuință modulul de transport sau cel de evenimente, poate rămâne oprit.

La urmă îl învățăm pe părintele rânduit cum să o folosească, fie online, fie venind la fața locului dacă este nevoie. Instalarea și instruirea sunt fără plată.

Unde stau datele pelerinilor și cui aparțin

Datele aparțin în totalitate mănăstirii. Ele se află pe serverul propriu și nu sunt trimise nicăieri. Nimeni altcineva — nici cel ce a făcut platforma — nu are acces la ele.

Înăuntru, accesul este rânduit pe roluri: administrator, organizator, părinte arhondar, fiecare cu drepturi pe modulele care îl privesc. Organizatorul unei tabere vede doar evenimentul lui, nu și celelalte cazări. Autentificarea este securizată, iar observațiile pe care părintele arhondar le scrie în opisul pelerinilor rămân confidențiale.

Cererile care vin din afară, de pe formularul public, trec prin confirmarea adresei de email și printr-o apărare împotriva cererilor automate, trimise de roboți, ca să nu se umple evidența cu cereri întâmplătoare.

Despre cod și despre ce se întâmplă peste ani

Tehnologiile pe care este clădită platforma sunt deschise și bine cunoscute, ceea ce înseamnă că oricine cu cunoștințe tehnice de bază o poate înțelege și întreține.

Trebuie însă spus limpede: nu există un depozit public de cod și nu există documentație de cod publicată pe internet. Cine caută un link de unde să descarce codul nu îl va găsi, fiindcă nu există. Codul platformei rămâne pe serverul mănăstirii. Orice altă întrebare despre cod se discută la cerere, cu mănăstirea.

De aici vine și liniștea pentru anii ce vin: codul rămâne al mănăstirii, pe serverul propriu. Chiar dacă cel ce o întreține acum nu ar mai putea continua, platforma funcționează în continuare, iar cineva cu pricepere tehnică o poate prelua.

Asistență și repararea problemelor

Rămânem la dispoziția mănăstirii și după instalare. Dacă ne semnalați o problemă, o reparăm. Dacă aveți nevoie de o funcționalitate nouă și ea ar putea folosi și altor mănăstiri, o adăugăm fără plată.

Nu se cere nimic în schimb. Ne puteți scrie sau suna oricând; adresa de email pentru legătură este contact@biq.ro.

Dacă mănăstirea renunță la platformă

Se poate renunța oricând. Datele aparțin mănăstirii și pot fi exportate; dacă platforma nu mai este de folos, serverul poate fi oprit și lucrurile se opresc acolo.

Nu există contracte, nu există penalități și mănăstirea nu este legată de nimic. Ceea ce s-a strâns în evidența pelerinilor rămâne al ei.

Întrebări frecvente

Pe ce tehnologii este construită platforma?

Partea de server este scrisă în PHP 8.2, cu bază de date MariaDB sau MySQL. Interfața folosește Bootstrap 5, jQuery și DataTables, paginile publice se scriu cu editorul Summernote, biletele PDF cu cod QR se generează cu TCPDF, iar înștiințările pe email pleacă prin PHPMailer, pe SMTP. Se folosește și Docker. Sunt tehnologii deschise, mature și bine cunoscute — PHP este folosit și de Wikipedia, și de multe alte site-uri mari.

De ce anume are nevoie mănăstirea ca platforma să funcționeze?

De un server pe internet și de o adresă de email de pe care să plece înștiințările către pelerini. Atât. Instalarea nu revine mănăstirii: o facem noi, durează câteva ore, iar dacă nu aveți server vă îndrumăm cum poate fi obținut. Părinții care o folosesc au nevoie doar de un browser, pe calculator, tabletă sau telefon.

Există un depozit public de cod sau o documentație de cod publicată?

Nu. Nu există un depozit public și nu există documentație de cod publicată pe internet. Tehnologiile folosite sunt însă deschise și bine cunoscute, iar codul platformei se află pe serverul mănăstirii, așa încât oricine cu pricepere tehnică o poate întreține sau prelua. Orice altă întrebare despre cod se discută la cerere.