# 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`.

## Clase de controale (confirmat de Marius, 24.07.2026, pe frm_verif_partener_anaf ROACONT)

- **Intotdeauna controale din `_baza.vcx`, nu controale native VFP** — orice grid, label,
  textbox, checkbox etc. dintr-un formular nou se bazeaza pe clasa corespunzatoare din
  `COMUN\clase\_baza.vcx`, nu pe clasa nativa Visual FoxPro. Clasele din `_baza.vcx` au
  fontul default **Arial 10** — nu se suprascrie FontName pe controale (explicit: fara
  Arial Narrow).
- **Butoanele de inchidere/confirmare stau in bara de titlu**, din `cmd_butoane.vcx` —
  modelul Renunt/Termin (clasa de forma `frm_termin_renunt` din `_frm_child.vcx` le aduce
  deja). Nu se dubleaza aceste actiuni cu butoane in corpul formei.
- **Actiunile care au corespondent `but_*` in `cmd_butoane.vcx`** (Nou/Adauga, Modifica,
  Salveaza, Sterge, Verifica etc.) folosesc CU PREDILECTIE clasa dedicata `but_*`
  respectiva — nu se improvizeaza un buton generic pentru o actiune care are deja clasa ei.
- **Doar actiunile FARA corespondent `but_*`** primesc butoane pe clasele `cmd_*` din
  `cmd_butoane.vcx` (ex. `cmd_executa`) — nu clase improvizate si nu CommandButton nativ.

## 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).
- `conventie_encoding_cp1252.md` din acest folder — capcana de corupere a diacriticelor la
  editarea `.sc2`/`.vc2`; relevantă ori de câte ori editezi text-cache-ul unui formular/librărie
  pentru a aplica aceste reguli de UX.