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

(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 — 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