comun/docs/conventie_ux_formulare.md

Convenție UX pentru formulare VFP (preferința lui Marius, valabilă pe toate proiectele ROA*)

Partajat între proiectele ROA* (similar cu PROMPT_cautare_vfp.md, prompt_project_insights_docs.md din acest folder) — pentru că COMUN\ e clonat/sincronizat în fiecare aplicație ROA, e locul corect pentru o convenție de design care nu ține de un singur proiect.

Origine: confirmat de Marius pe frm_autopass.scx (ROAAUTO) după o rundă de regrupare vizuală (2026-07-10) — "imi place designul acesta" pe layout-ul cu rânduri clar separate pe funcție, butoane grupate la margini, fără elemente lipite unele de altele.

Ce înseamnă in practică, pe proprietăți VFP

• Fiecare grup funcțional pe rândul lui — nu înghesui controale fără legătură directă pe același Top. Ex: rândul de perioadă (date + Actualizează) separat de rândul de statistici (Declarabile/Transmise/Blocate), separat de panoul de configurare.
• Spațiere vizibilă între grupuri, strânsă în interiorul unui grup — butoane din aceeași acțiune (ex. Validează dry-run → Transmite → Renunță) la 6-10px unele de altele; gap de 20-30px față de următorul grup funcțional (ex. Selectează tot vs. grupul Validare/Transmitere vs. Actualizează statusuri).
• Butoanele secundare/de configurare aliniate la marginea din dreapta a containerului, nu lipite imediat după textbox-ul pe care îl controlează — altfel nu se disting vizual ca acțiune separată de câmpul de input.
• Acțiunea principală + oprirea ei alăturate — un buton de tip "Renunță/Oprește" trebuie poziționat lângă acțiunea pe care o anulează (ex. Transmite + Renunță), nu împrăștiat în altă parte a rândului.
• Un singur rând de acțiuni cât se poate — dacă mai multe grupuri de butoane încap pe lățimea formei, preferă un singur rând orizontal în loc să adaugi rânduri noi dedesubt; păstrează formele compacte pe verticală.
• Caption-uri scurte, sentence case, nu ALL CAPS — ex. "Transmite" nu "TRANSMITE"; "Dashboard AutoPass" nu "Deschide dashboard AUTOPASS". ALL CAPS/text lung pe un buton citește ca zgomot, nu ca ierarhie.
• Culoare = semnal, nu decor — folosește culoare distinctă doar pentru acțiuni cu semnificație clară (verde = acțiune pozitivă/transmite, roșu = oprire/pericol, albastru = navigare/deschidere link extern); restul butoanelor rămân stilul implicit din _baza.vcx.

Vocabular

Funcțional, compact, aerisit, minimalist, grupat, ușor de înțeles de utilizatori, aer aerisit, modern — asta e reperul calitativ pentru orice formular nou sau refacere de layout, dincolo de regulile mecanice de mai sus, pe orice aplicație ROA*.

Vezi și

• PROMPT_cautare_vfp.md din acest folder — cum se caută/editează cod în binarele VFP text-cache (relevant când aplici aceste reguli prin fluxul .sc2/.vc2 + write-back).
• Capcana de encoding cp1252 la editarea .sc2/.vc2 (corupere diacritice) — documentată în proiectul unde a fost descoperită (ROAAUTO docs/conventie_encoding_cp1252.md); relevantă ori de câte ori editezi text-cache-ul unui formular/librărie pentru a aplica aceste reguli de UX.