roaauto/docs/README.md

docs/ — insight-uri de proiect ROAAUTO

Documentație tehnică concisă, minimalistă, descoperită în timp ce lucrăm la sarcini reale (nu documentație generică, nu ce e deja evident din cod).

Regulă: adaugă sau actualizează o notiță aici ori de câte ori descoperi ceva nou și ne-evident despre structura proiectului (flux ascuns, capcană, convenție, procedură/pachet cheie, tabel relevant) în timpul rezolvării unei sarcini. Nu re-documenta ce oricine ar afla citind codul în 30 de secunde.

Notițele sunt organizate pe fișiere separate, câte un subiect pe fișier (ex. flux-<nume-flux>.md, pachet-<nume-pachet>.md, tabele.md), nu un singur fișier uriaș.

Fișiere

Insight-uri valabile doar pentru ROAAUTO stau aici. Insight-urile valabile pe orice proiect ROA* (convenții, capcane de tooling) stau în COMUN/docs/ (repo separat, partajat) — vezi mai jos.

Specifice ROAAUTO

• vfp_oracle_pack_sesiune.md — capcană: view-urile (AUTO_COMENZI_VALIDATE, AUTO_VORDL_FACTURI) își calculează coloanele după luna de lucru din PACK_SESIUNE; o interogare din sqlplus fără setluna/setan întoarce tăcut alte date decât aplicația
• flux-vizualizare-comenzi.md — lanțul ecranului „Vizualizare comenzi": filtru implicit [1=2] (cursor gol), filtrul real în frm_viz_comenzi.do_cauta; ecranul pereche facturi
• flux-gccondluna.md — gcCondLuna nu e „luna calendaristică", ci luna de lucru plus coada de documente vechi neînchise; cele 6 coloane cerute și capcana de măsurare
• vederi-auto-comenzi.md — lanțul de view-uri Oracle din spatele ecranelor de comenzi/facturi: AUTO_ISTORIC_COMENZI, AUTO_COMENZI_VALIDATE, AUTO_VORDL_FACTURI, garzi și indexuri
• tva-valori-manopera-materiale.md — cu/fără TVA pe valorile din „Vizualizare comenzi” / „Vizualizare facturi” / facturarea devizelor: devizul și coloanele facturate sunt fără TVA, doar valctva e cu TVA

Partajate (COMUN/docs/, valabile pe toate proiectele ROA*)

• cautare_vcx_vct.md — cum se caută cod în binarele .vcx/.scx (conversie text + grep pe cache)
• conventie_encoding_cp1252.md — capcană: editarea .sc2/.vc2 cu encoding greșit corupe ireversibil diacriticele
• conventie_ux_formulare.md — cum îi place lui Marius formatat un formular nou (grupare, spațiere, culoare = semnal)
• conventie_goexecutor_alter_table.md — capcană: ALTER TABLE pe cursorul întors de goExecutor.oExecute() pică; include coloanele noi direct în SELECT