# COMUN\docs — index

Documentatie comuna tuturor produselor ROA. Cititorul e un agent: fiecare fisier tine **regula +
strictul de context care o face aplicabila + comanda de verificare**. Fara "de ce", fara istoric,
fara studii de caz.

**Se citeste primul: `reguli_lucru.md`** — regulile de livrare + lista de declansatoare ("cand
atingi zona X, citeste fisierul Y"). Restul se deschid doar la declansator.

## Cand citesti fiecare

| Fisier | Cand |
|---|---|
| `reguli_lucru.md` | intotdeauna, la inceput de sesiune |
| `stil_interactiune_cautare.md` | cum interactionezi, cum livrezi si cum cauti (valabil si pentru subagenti) |
| `orchestrare-subagenti.md` | cand delegi, cand verifici ce intoarce un subagent, la predarea contextului |
| `monitorizare-context.md` | instalarea hook-urilor de prag de context si de revizie a docs |
| `masini-dezvoltare-testare.md` | ai nevoie de o masina separata pentru probe UI/rulari lungi care nu trebuie sa blocheze statia principala |
| `fluxul_svn_git.md` | orice commit / `svn update` / `roa_sync` -> skill `roa-git-svn-commit` |
| `scripturi-uzuale.md` | exista deja un script pentru sarcina asta? (roa_sync, curatenie, livrare, diagnostice) |
| **VFP** | |
| `cautare_vcx_vct.md` | cauti cod in `.vcx`/`.scx`/`.frx`/`.mnx` -> skill `roa-vfp-text-edit` |
| `flux-editare-vfp-text.md` | editezi `.vc2`/`.sc2` + write-back; invariantele si `*p:`/`*m:` -> skill `roa-vfp-text-edit` |
| `conventie_encoding_cp1252.md` | fisierul editat are diacritice (cp1250, nu cp1252) -> skill `roa-vfp-text-edit` |
| `inventar-comun.md` | inainte de cod nou: exista deja o functie/clasa comuna? |
| `conventie_ux_formulare.md` | adaugi/rearanjezi controale pe formular |
| `capcana_grid_controlsource.md` | grid needitabil pe formular cu 2+ grid-uri |
| `capcana_grid_preferinte_utilizator.md` | adaugi o coloana intr-un grid deja livrat |
| `conventie_go_recno.md` | `GO` pe un `Recno()` capturat -> skill `roa-vfp-go-recno` |
| `conventie_null_vfp.md` | garzi pe valori NULL din Oracle -> skill `roa-vfp-null-guards` |
| `conventie_goexecutor_alter_table.md` | `ALTER TABLE` pe cursorul de la `oExecute()` |
| **Testare** | |
| `depanare_testare_vfp.md` | rulare headless, depanare bug runtime, capcane VFP -> skill `roa-vfp-headless-test` |
| `testare-ui-vfp.md` | test cu formular real + screenshots (harness UI) -> skill `roa-vfp-headless-test` |
| **Oracle** | |
| `conventie_mediu_oracle.md` | te conectezi la dev/test, alegi schema, rulezi un script de pachet |
| `conexiuni-tunel-ssh-odbc.md` | ajungi la un Oracle de PRODUCTIE prin tunel SSH (Bitvise) + alias TNS + DSN ODBC -> skill `roa-oracle-production-access` |
| `scripturi-migrare-db.md` | modifici schema (tabele/view-uri/pachete); compatibilitate 10.2 -> skill `roa-oracle-migration` |
| `publicare-scripturi-db.md` | publici scripturile catre clienti -> skill `roa-oracle-migration` |
| `oracle_export.md` | reexporti sursa unui pachet PL/SQL -> skill `roa-oracle-migration` |
| `depanare-pack-update.md` | actualizarea ROA nu se finalizeaza la un client -> skill `roa-oracle-diagnostic` |
| `depanare-spatiu-oracle.md` | spatiu plin la un client -> skill `roa-oracle-diagnostic` |
| **Domeniu** | |
| `flux-modificare-stergere-nota-jurnal.md` | modificare/stergere nota; ce face `PACK_CONTAFIN` |
| `tipuri_documente_facturare.md` | `VANZARI.TIP` si seturile de contare `ID_SET` |
| `sold-neexigibil-reportat-jc2007-jv2007.md` | interogari pe sold TVA neexigibil |
| `view-uri-efactura.md` | view-urile `ANAF_VEFACTURA_*` si potrivirea eFacturilor cu registrul de TVA |
| `machete-note-xrequest-explicatii.md` | schimbi ce campuri cere o operatie la introducere (`XREQUEST`/`XITEMS`/`XNOTE`); explicatie, explicatia4, explicatia5 |
| `email-thunderbird.md` | citirea mailurilor de pe conturile romfast |

`onboarding\` — proceduri rulate o singura data per proiect (inrolare in fluxul git-text,
prompturi de configurare) -> skill `roa-onboarding` pentru executie. Nu se citesc in sesiunile de lucru.

`*.pck` — exporturi de referinta ale pachetelor PL/SQL, pentru grep tintit; nu se citesc intregi.
`cercetare\` — note de cercetare pe subiecte incheiate.

## Cand adaugi ceva aici

Doar reutilizabil (80/20): flux ascuns, capcana platita, procedura/tabela cheie. Cateva randuri.
Un subiect are **un singur proprietar** — celelalte fisiere primesc o trimitere de un rand, nu o
copie. Scrie **ASCII**, fara diacritice. Adauga si randul in tabelul de mai sus, plus
declansatorul in `reguli_lucru.md` punctul 7 daca regula se aplica la atingerea unei zone de cod —
fara declansator, regula nu e gasita la timp.