Files
comun/docs/reguli_lucru.md
Marius Mutu ccb8fd2cc6 Verificare ANAF: perioada de TVA spune ce reprezinta; optiunea intreaba inainte sa modifice
SufixPerioadaTVA lipea intervalul direct dupa verdict ("Neplatitor TVA
05/07/2002 - 18/04/2012"), ceea ce se citea ca perioada in care partenerul NU a
fost platitor - exact pe dos. Eticheta spune acum ce reprezinta: "inregistrat TVA
<de la> - <pana la>", respectiv "cod TVA anulat din <data>". Detaliile F4 arata
perioada si in ramurile "Nu exista partener cu CUI ..." si "Nu s-a putut citi
lista de parteneri", unde lipsea - adica tocmai in cazul in care utilizatorul
n-avea de unde sa afle ce inseamna datele din banda de stare.

ANAF_ComutaVerificare afisa un mesaj informativ si apoi cerea neconditionat
valoarea noua, propunand valoarea curenta. Cand verificarea era oprita local din
settings.ini, valoarea propusa era 0, iar un Enter reflex o salva ca optiune de
utilizator - ceea ce transforma tacut o oprire locala in oprire pe orice
calculator. Mesajul intreaba acum Da/Nu si propune 9 (oprire locala) in loc de 0.

reguli_lucru.md pct. 2: istoricul modificarilor sta doar in antetul fisierului,
la fel in .prg si in package-urile/procedurile PL/SQL Oracle; in corpul codului
doar comentarii functionale, niciodata data/autor/"am modificat".

Adaugat docs/sold-neexigibil-reportat-jc2007-jv2007.md: jc2007/jv2007 tin o linie
per factura PER PERIOADA (soldul neexigibil se reporteaza lunar), deci orice
interogare pe sold se filtreaza pe an/luna.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DhJwsrFFe1ZNAAtS8Twuti
2026-07-28 15:12:13 +03:00

4.5 KiB

Reguli de lucru agent (comune proiectelor ROA VFP)

  1. Modificari de cod: livreaza FISIER de diff docs\diff_runda<N>_<subiect>.patch (git diff --no-index <baseline.bak> <editat>), nu diff in terminal. Write-back in binar (txt2vcx) si commit DOAR dupa aprobarea patch-ului de catre utilizator. Patch-urile sunt intermediare de review: NU se comit NICIODATA in git (sunt in .gitignore ca docs/diff_runda*.patch); raman doar local, pe disc. Curatenie: dupa commit se sterg patch-urile de review si backup-urile de lucru (*.pre_runda*.bak).
  2. Comentarii in cod: istoricul modificarilor sta DOAR in ANTETUL fisierului, niciodata inline. Se aplica la fel in .prg si in package-urile/procedurile PL/SQL Oracle. In corpul codului sunt permise numai comentarii FUNCTIONALE (ce face codul si de ce, acolo unde nu se vede din cod) - niciodata "am adaugat / am modificat / am sters", data sau autor. In ANTET se tine o singura intrare CUMULATIVA per functionalitate, scurta si compacta, in stilul existent (*!* DD.MM.YYYY / *!* autor / *!* ce face, 1-2 fraze): la revenirea pe aceeasi lucrare se rescrie intrarea, nu se adauga alta. Autorul e persoana care semneaza livrarea (ex. marius.mutu) - niciodata "claude" sau alt nume de agent. Se descrie doar comportamentul final, fara referinte la revizii, runde, patch-uri sau la corectii facute pe parcurs. La rezolvari de erori NU se adauga comentarii deloc. Explicatiile merg in docs/ sau in mesajul de commit, nu in cod. Changelog (changelog_<aplicatie>.txt): text minimal, pe limba utilizatorului, nu tehnic, o fraza scurta per intrare. Cat timp lucrarea nu a ajuns la utilizatori (fara deploy), erorile introduse si corectate in interiorul ei NU se pomenesc - intrarea descrie functionalitatea asa cum ajunge la utilizator, :nou:/:modificare:; :eroare: ramane doar pentru erori care au fost in productie.
  3. Modificari minime: doar ce s-a cerut; fara refactorizari sau curatenie din oficiu.
  4. Testare headless (fara IDE): vfp9.exe -A -T "<script.prg>" <param> din PowerShell. Mediu, sabloane, capcane si metoda de depanare: depanare_testare_vfp.md.
  5. Editare .vcx/.scx pe text (cache, cp1252 byte-safe, fidelity-check): flux-editare-vfp-text.md. Cautare in binare: cautare_vcx_vct.md. Versiunile .??2 sunt instantanee si pot fi mai vechi decat binarul - verifica mtime-ul inainte de a trage concluzii din ele; continutul real al proiectului se citeste din .PJX.
  6. Misiuni lungi (teste, investigatii, sarcini inlantuite): NU un singur subagent cu context acumulat — orchestrator + subagenti proaspeti per sarcina (max ~200-250k tokens/subagent), handoff compact pe disc: orchestrare-subagenti.md.
  7. Conventii obligatorii, de citit cand atingi zona respectiva:
    • editezi orice fisier cu octeti cp1252 - .vc2/.sc2, dar si .prg (ex. programe\ocautare.prg, unde s-urile cu virgula din masina/si contul/transa sunt octetul 0xBA) -> conventie_encoding_cp1252.md. Orice write cu un tool care nu scrie cp1252 nativ (Edit/Write) corupe caracterele >= 0x80 din TOT fisierul (0xBA -> EF BF BD), chiar daca schimbi o singura linie, si o face din nou la FIECARE scriere. Deci: editezi tot ce ai de editat, si abia DUPA ultima scriere verifici byte-level si repari o singura data; daca mai editezi dupa reparare, se strica iar. Verificare: perl -ne 'print "$.\n" if /[\x80-\xFF]/' <fisier>; reparare (aici pentru 0xBA): perl -e 'binmode(STDIN);binmode(STDOUT);local $/;$_=<STDIN>;s/\xEF\xBF\xBD/\xBA/g;print' < f > f.tmp. ATENTIE: EF BF BD nu spune ce caracter s-a pierdut - toate diacriticele devin la fel. Ia octetul corect per pozitie din svn cat <fisier> (SVN are versiunea necorupta) si abia apoi inlocuieste; o inlocuire oarba cu 0xBA strica a/t cu caciula (0xE3, 0xFE) din alte fisiere;
    • adaugi/rearanjezi controale pe formulare sau coloane in grid -> conventie_ux_formulare.md;
    • scrii cod cu GO pe un Recno() capturat sau primit ca parametru -> conventie_go_recno.md;
    • ALTER TABLE pe cursorul intors de goExecutor.oExecute() -> conventie_goexecutor_alter_table.md;
    • testare UI / prin MCP -> testare-ui-vfp.md, testare-vfp-mcp.md;
    • export date din Oracle -> oracle_export.md;
    • modifici schema Oracle (tabele/view-uri/pachete) -> scripturi-migrare-db.md (unde stau scripturile de migrare si modelele pentru scripturi noi).