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