31 lines
1.8 KiB
Markdown
31 lines
1.8 KiB
Markdown
# 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
|