Files
comun/docs/conventie_ux_formulare.md
Marius Mutu 889840357a Verificare ANAF la alegerea partenerului
ocautare.prg - miezul functionalitatii:
- anaf_verif_cautare: verdictul ANAF pe randul curent din formularul de cautare
  (label sub grid), la data documentului; discordantele si codurile fiscale invalide
  cu rosu; F4 sau click deschide detaliile.
- ANAF_StarePartener, cu cache pe sesiune, excludere parteneri externi si persoane
  fizice; ANAF_ValidareCod pentru CIF/CNP.
- ANAF_NivelVerificare: cascada RC_ANAF_VERIF_SELECTIE (kill-switch settings.ini >
  optiuni utilizator > optiuni firma > implicit 1), cu cache invalidat la schimbarea
  firmei sau utilizatorului; ANAF_ComutaVerificare pentru punctul de meniu.
- Detalii: alegerea variantei corecte de partener din perechea RO / fara RO, cu
  discriminator "are documente in perioada"; dupa Da sau Nu se inchide cautarea si
  se revine in formular cu partenerul ales (AplicaInlocuirePartenerANAF).
- ANAF_CaData: data documentului poate veni si ca DateTime (tact.dataact).
- Banda proprie sub grid pentru label: formularul creste cu 54, gridul isi pierde
  ancorarea de jos si primeste inaltimea din AjusteazaBanda, legata de Resize si
  Activate - formularul isi reaseaza gridul dupa Show, deci Activate e momentul util.

validare.prg: ANAF_VerificaCuiSingle, wrapper single-CUI peste serviciul ANAF, cu
data verificarii si o singura eroare logata pe sesiune.

cauta_alfa.prg: hook generic - ataseaza poVerifAlegere pe formularul de cautare
inainte de Show si il detaseaza dupa.

Apelanti opt-in (lVerificaANAF): baza.vc2 (lookup-ul generic de partener din
formularele actbaza/actbaza2007 lansate din meniuri), onote_contabile.vc2 (partener
debit/credit), omodificari.vc2 (do_cauta din cele trei clase de modificare, cu data
notei), ofacturare.vc2 (client, furnizor). Casa/banca ramane in afara: acolo partenerul
se alege pentru imperecherea facturilor.

cauta_alfa_forms.vc2: F4 deschide detaliile, iar terminarea cautarii trece prin
VerificaAlegere.

Teste: suita headless pentru fluxul de verificare (utile/Teste/partener_anaf/), cu
mock pentru apelul ANAF si pentru dialoguri.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019H3r66sVojGhgaKq5niu1u
2026-07-27 01:29:41 +03:00

4.3 KiB

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.