# 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

(niciunul încă — primele insight-uri de proiect au fost, până acum, toate transversale și au
migrat în `COMUN/docs/`)

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