Ghid de utilizare

Ce face aplicația

• Gestionează profilul tău autentificat.
• Creează și întreține contracte.
• Gestionează proprietarii contractelor.
• Leagă proprietăți de contracte.
• Încarcă și gestionează documentele justificative.

Înainte să începi

Ai nevoie de următoarele înainte să folosești aplicația:

• Acces la URL-ul aplicației.
• Un cont Microsoft Entra valid și autorizat pentru aplicație.
• Datele asociației necesare pentru a crea contracte, proprietari, proprietăți și documente.

Comportament important la prima utilizare

În timpul autentificării, înainte ca sesiunea cookie a frontend-ului să fie finalizată, frontend-ul rulează un flux de provisionare:

1. Verifică dacă utilizatorul tău există deja în backend.
2. Dacă nu există, îl creează.
3. Îmbogățește principalul autentificat cu detaliile backend ale utilizatorului folosite de sesiunea frontend.

Dacă provisionarea eșuează, autentificarea este respinsă, iar fluxul protejat rămâne indisponibil până la rezolvarea problemei.

Pasul 1: deschide aplicația

Deschide pagina principală.

Din meniul din stânga poți accesa:

• Acasă
• Contracte
• Confidențialitate
• Tutorial
• Termeni
• Drepturi GDPR

Bara de sus îți permite să:

• Schimbi limba.
• Schimbi tema.
• Te autentifici sau te deconectezi.

Pasul 2: autentifică-te

Selectează Autentificare din bara de sus.

Aplicația te redirecționează către fluxul de autentificare Microsoft și apoi te aduce înapoi în aplicație.

Pasul 3: deschide Contracte

Accesează pagina Contracte.

Pagina încarcă două lucruri:

• Catalogul canonic de proprietăți folosit pentru a rezolva proprietăți valide.
• Contractele tale curente.

Fiecare contract este afișat ca un card expandabil cu stare de validare.

• Validat: contractul este complet și marcat ca validat.
• În așteptarea verificării: datele necesare există, dar contractul nu este încă validat.
• Incomplet: lipsesc proprietari, proprietăți sau documente obligatorii.

Pasul 4: creează un contract

Folosește formularul de creare contract din partea de jos a paginii Contracte.

Trebuie să furnizezi:

• Numărul contractului.
• Data contractului.

După salvare, contractul apare în listă.

Pasul 5: gestionează proprietarii contractului

În interiorul unui card de contract, extinde secțiunea Proprietari.

• Adaugă un proprietar.
• Editează un proprietar existent.
• Șterge un proprietar.

Comportamentul formularului de proprietar:

• Proprietarul poate fi persoană fizică sau companie.
• Un proprietar poate fi marcat ca persoană de contact.
• Formularul poate reutiliza datele utilizatorului autentificat, acolo unde este permis.
• Erorile de validare sunt afișate direct sub câmpurile afectate.

Pasul 6: gestionează proprietățile contractului

În același card de contract, extinde secțiunea Proprietăți.

Formularul de proprietate este bazat pe lookup. Nu introduci identificatori liberi de proprietate.

1. Selectează tipul proprietății.
2. Selectează faza.
3. Selectează clădirea sau etajul, în funcție de tipul proprietății.
4. Selectează numărul.

Ce se întâmplă după selecție:

• Aplicația filtrează lista canonică de proprietăți.
• Rezolvă proprietatea corespunzătoare.
• Completează câmpuri informative doar pentru citire, cum ar fi textul de afișare, identificatorul CF, cota și suprafața utilă.

Dacă o combinație este invalidă, formularul afișează eroarea sub câmpul care a cauzat-o.

Pentru apartamente, formularul captează și numărul de camere. Poți:

• Adăuga o proprietate.
• Edita o proprietate.
• Șterge o proprietate.

Pasul 7: încarcă documentele necesare

Extinde secțiunea Documente din interiorul unui contract.

Pagina generează sloturi de documente dinamic, în funcție de contractul curent:

• Un slot pentru documentul CVC la nivel de contract.
• Un slot de buletin pentru fiecare proprietar.
• Un slot de împuternicire pentru fiecare proprietar.
• Un slot de extras CF pentru fiecare proprietate.

Obligatoriu versus opțional:

1. CVC și buletinul sunt tratate ca obligatorii.
2. Împuternicirea și CF sunt tratate ca opționale.

Pentru a încărca un document:

• Alege fișierul în slotul relevant.
• Selectează Salvare.
• După încărcare, slotul documentului devine link de descărcare și acțiune de ștergere.

Constrângerile actuale pentru încărcare: dimensiune maximă 50 MB, formatele permise includ PDF și mai multe tipuri de imagini, iar backend-ul respinge combinațiile neacceptate de extensie și MIME type.

Pasul 8: descarcă sau șterge documente

Dacă un document există deja într-un slot, poți:

• Selecta numele lui pentru descărcare.
• Folosi pictograma de ștergere pentru a-l elimina.

Aplicația folosește dialoguri de confirmare înainte de acțiuni destructive precum ștergerea contractelor, proprietarilor, proprietăților sau documentelor.

Pasul 9: editează înregistrările existente

Fiecare contract, proprietar și proprietate are o acțiune de editare.

Când editezi:

• Formularul de editare se deschide inline.
• Salvarea reîmprospătează lista de contracte.
• Anularea închide editorul inline fără să aplice modificări.

Pasul 10: înțelege starea de completare

Dacă un contract rămâne incomplet, verifică mai întâi aceste zone:

• Există cel puțin un proprietar.
• Există cel puțin o proprietate.
• Toate documentele obligatorii sunt încărcate.
• Selecția proprietății se rezolvă către o proprietate canonică validă.

Probleme frecvente

Deconectare

Folosește meniul utilizatorului din bara de sus și alege Deconectare.

Secvență recomandată de utilizare

Pentru cel mai fluid flux, folosește această ordine:

1. Autentifică-te.
2. Creează contractul.
3. Adaugă proprietari.
4. Adaugă proprietăți.
5. Încarcă documentele obligatorii.
6. Revizuiește starea de validare.

Această ordine corespunde modului în care aplicația determină dacă un contract este incomplet, în așteptarea verificării sau validat.