roafacturare/docs/livrare_s5.md

# Dosar de livrare — S5 (scrierea sumelor editate in Oracle)

Bloc #6 / S5, parte din "editare factura emisa". Stare la 10.08.2026. Scop: Marius decide
commit / push / SVN pe baza acestui fisier, fara sa recititeasca cele zece rapoarte de mai jos.

Surse: `docs\progres.md` (sectiunea #6/S5), handoff intermediar (sters) (deciziile 38-41),
`docs\cercetare\rec_s5_scriere_reala.md`, `docs\cercetare\rec_s5_discount_valuta.md`,
`docs\cercetare\rec_s5_teste.md`, `docs\cercetare\rec_s5_grid_articole.md`.

## 1. Ce livreaza S5

Pana acum, editarea unei facturi deja emise (#6/S4) modifica doar ecranul si nota interna —
modificarile facute liniilor de articole (cantitate, pret, discount, articole adaugate sau
sterse) nu ajungeau in baza de date. S5 inchide exact acest pas: la salvare, toate modificarile
se scriu real in Oracle, intr-o singura tranzactie, si totalurile documentului se recalculeaza
din liniile efectiv salvate, nu din liniile vechi.

In plus:
- gridul de articole primeste o coloana noua, "Pret achizitie", editabila doar pe liniile noi
  adaugate (pe liniile existente valoarea veche ramane neatinsa);
- liniile care fac parte dintr-un set de articole devin needitabile individual, cu marcaj vizual
  distinct — totalul unui set se calculeaza din capul lui, nu din componente, deci editarea unei
  componente n-ar fi schimbat tacut totalul;
- cinci validari noi opresc sau avertizeaza la salvare: cantitate invalida, articol lipsa, pret
  lipsa, factura ramasa fara nicio linie activa, si pret de achizitie necompletat pe linie noua.

Scrierea a fost testata cu date reale in Oracle (nu doar simulat), inclusiv doua editari
succesive ale aceleiasi facturi, ca sa se confirme ca o linie stearsa ramane stearsa si la
reeditare.

## 2. Fisiere atinse

| Fisier | Repo | Ce s-a schimbat | Patch |
|---|---|---|---|
| `clase\omodificari.vc2` | COMUN | Coloana `pret_achizitie` in grid, editabilitate per rand (linii de set needitabile, marcaj albastru), 5 validari noi in `inainte_de_do_termin` | diff aplicat (sters) |
| `clase\ofacturare_comun.vc2` | COMUN | Agatarea apelului `ScrieArticoleFacturaEditate` dupa `finalizeaza_modificare_nota` (primul punct de intrare, `do_editare_factura`) | diff aplicat (sters) |
| `clase\comun.vc2` | COMUN | Aceeasi agatare, al doilea punct de intrare (`:2491`) | diff aplicat (sters) |
| `programe\ofacturare_editare.prg` | COMUN | Helper nou `ScrieArticoleFacturaEditate` (marcheaza tot sters / invie ce ramane / insereaza linii noi / apeleaza recalculul Oracle) | diff aplicat (sters) |
| `utile\Teste\editare_factura\test_page3_articole.prg` | COMUN | Asteptari actualizate: `ColumnCount=15`, tip si editabilitate pe coloanele noi | diff aplicat (sters) |
| `utile\Teste\editare_factura\test_s5_validari_articole.prg` (nou) | COMUN | Suita headless: validari + SQL generat de helper, cu mock pe `goExecutor` | diff aplicat (sters) |
| `utile\Teste\editare_factura\test_ui_s5_grid_pret_achizitie.prg` (nou) | COMUN | Suita UI vizibila: coloana noua, needitabilitate pe linii de set, focus pe linie noua | diff aplicat (sters) |
| `utile\Teste\editare_factura\test_s5_scriere_reala.prg` (nou) | COMUN | Test cu scriere reala in Oracle, doua treceri, COMMIT real | diff aplicat (sters) |
| `utile\Teste\editare_factura\test_s5_discount_valuta.prg` (nou) | COMUN | Test parametru discount (NULL vs 0 vs valoare) + documente reale in valuta | diff aplicat (sters) |
| `utile\Teste\editare_factura\test_s5_rollback_real.prg` (nou) | COMUN | Calea de ROLLBACK la esec partial, cu eroare Oracle provocata deliberat | diff aplicat (sters) |
| `utile\Teste\editare_factura\test_s5_al_doilea_intrare.prg` (nou) | COMUN | Al doilea punct de intrare (`comun.vc2:2491`) parcurs real | diff aplicat (sters) |
| `docs\oracle_export.md` | COMUN | Corectie documentatie: `linesize 32767` in loc de 400 (cauza incidentului de export, vezi sectiunea 3) | fara patch dedicat |
| `docs\scripturi-migrare-db.md` | COMUN | Corectie documentatie: `UpdateVersiune` nu primeste extensia `.sql` in argument | fara patch dedicat |
| `versiune_db.txt` | ROAFACTURARE | `2026_08_08_01` -> `2026_08_09_02` | fara patch (fisier text, un rand) |

**Curatare facuta 10.08.2026**: sterse `clase\comun.pre_s5_agatare.bak.vc2`,
`clase\ofacturare_comun.pre_s5_agatare.bak.vc2` (verificate `cmp` **identice cu git HEAD** inainte
de stergere, deci recuperabile) si `utile\Teste\editare_factura\test_nume_coloana_modificat.log`
(reziduu de test, regenerabil).

**Lasat pe disc, decizia lui Marius**: `clase\ofacturare_comun.pre_s4butoane.bak.vc2` — backup din
S4 care **difera** de git HEAD, deci e o stare intermediara nerecuperabila din istoric. Nu l-am
sters tocmai de aceea. Nu e cod de productie si nu e trackuit.

### Write-back binar, dovedit prin reconversie (10.08.2026)

Raport: `docs\verificare_s5_writeback.md`. Fiecare `.vcx` reconvertit in text intr-un cache temporar
si comparat octet cu octet cu `.vc2` din arbore — **nu** pe mtime, care nu e martor
(`txt2vcx.ps1:300` rescrie mtime-ul textului la „cel mai nou binar + 1s").

| Fisier | Octeti | Linii diferite | Cens `> 0x7F` conform reperului |
|---|---|---|---|
| `omodificari.vc2` | 539470 | 0 | da (`2 aa · 2 e3 · 2 fe`, 0x `EF BF BD`) |
| `ofacturare_comun.vc2` | 242984 | 0 | da (`1 aa · 3 ba · 2 ce · 2 e3 · 2 ee · 2 fe`, 0) |
| `comun.vc2` | 330100 | 0 | da (`1 ee`, 0) |

Blocul de agatare confirmat textual, cu `-1` (nu `0`), la `ofacturare_comun.vc2:3828-3830` si
`comun.vc2:2491-2493`.

## 3. Modificari de baza de date

Doua scripturi, **deja aplicate in `MARIUSM_AUTO`**, mutate 10.08.2026 in
`D:\ROA\DATABASE\SCRIPTURI_CLAR\2026\08` si adaugate in SVN (`svn add`, status `A`, **necomise**):

- **`ff_2026_08_09_01_COMUN_PACK_FACTURARE.sql`** — adauga procedura
  `recalculeaza_totaluri_vanzari(V_ID_VANZARE, V_DISCOUNT DEFAULT NULL)` in pachetul
  `PACK_FACTURARE`. `NULL` pastreaza discountul curent al documentului, o valoare explicita
  (inclusiv `0`) il inlocuieste. Pachet `VALID`, 0 erori dupa aplicare.
  - **Incident, rezolvat**: prima aplicare a picat cu `ORA-00920`, cauzat de un export
    `all_source` facut cu `linesize` prea mic, care a rupt o linie prin mijlocul identificatorului
    `PRET_ACHIZITIE`. Scriptul a fost reasamblat de la ultimul script real aplicat pe disc, nu de
    la export; a doua aplicare a reusit curat. `docs\oracle_export.md` corectat ca sa nu se repete.
- **`ff_2026_08_09_02_COMUN_VVANZARI_ARTICOLE.sql`** — adauga coloanele `ID_VANZARE_SET` si
  `PRET_ACHIZITIE` in view-ul `VVANZARI_ARTICOLE`. Aplicat inaintea celuilalt script, altfel
  gridul nu era testabil. View `VALID`, 23 de coloane.

`versiune_db.txt` = **`2026_08_09_02`** (deja actualizat pe disc, vezi sectiunea 2).

## 4. Dovezile de testare

| Suita | Cifra | Ce dovedeste |
|---|---|---|
| `test_s5_validari_articole.prg` (nou, headless) | 35 PASS / 0 FAIL | Cele 5 validari din `inainte_de_do_termin` pe instanta reala; SQL-ul generat de `ScrieArticoleFacturaEditate` (clasificare linii, oprire la primul esec, discount NULL vs valoare) prin mock pe `goExecutor`, fara Oracle |
| `test_ui_s5_grid_pret_achizitie.prg` (nou, formular vizibil) | 14 PASS / 0 FAIL | Grid cu 15 coloane, coloana "Pret achizitie" legata corect, linie de set needitabila cu marcaj albastru, `pret_achizitie` primeste focus doar pe linie noua |
| `test_s5_scriere_reala.prg` (nou, scriere reala in Oracle) | 25 PASS / 0 FAIL | Ordinea din decizia 38 dovedita in tranzactie (linia stearsa e reinviata de reset, apoi corectata de helper); a doua trecere dovedeste ca stergerea ramane definitiva la reeditare; linie noua + `pret_achizitie` scris corect; totaluri recalculate coerente. Verificat independent prin `sqlplus` |
| `test_s5_discount_valuta.prg` (nou, scriere reala + citiri cu ROLLBACK) | 46 PASS / 0 FAIL | `NULL` pastreaza discountul curent, `0` explicit il zeroeaza — dovedit pe 4 apeluri succesive in tranzactie; recalculul e corect si pe un document real in valuta (`id_vanzare=1037`, cu ROLLBACK); lantul complet de salvare cu discount nenul, COMMIT real |
| `test_s5_rollback_real.prg` (nou) | 13 PASS / 0 FAIL | Calea de ROLLBACK la esec partial: contractul helperului prin mock (opreste la prima comanda esuata, `.F.`, zero comenzi in plus) **si** starea reala in Oracle — `ORA-02291` provocat deliberat pe `INSERT`, executie partiala vazuta necomisa in tranzactie, apoi ROLLBACK → document identic, verificat prin `sqlplus`. Cele 2 linii `EROARE` din log sunt exact eroarea provocata intentionat |
| `test_s5_al_doilea_intrare.prg` (nou) | 17 PASS / 0 FAIL | Al doilea punct de intrare (`comun.vc2:2491`, `afisjurcom.do_modifica`) parcurs **real**, nu doar verificat static: `tvanz` se populeaza pe calea asta, blocul nou se executa, lantul comite |
| Regresie (6 suite existente, neregresate) | `test_page3_articole` 14/2 (2 = artefact headless cunoscut) · `test_incarca_vanzare_din_nota` 5/0 · `test_adauga_linie_articol` 20/0 · `test_adauga_linie_valuta` 16/0 · `test_ui_sterge_linie` 8/0 · `test_verdict_act_rul` 26/0 | Nicio functionalitate anterioara (#6/S4) nu s-a stricat |

**Atentie separata, semnalata in `rec_s5_teste.md`**: pentru `test_page3_articole.prg`,
`raport_teste.ps1` (uneltele automate) raporteaza 10/0, nu cifra reala 14/2 — suita scrie o parte
din verdicte intr-un format pe care regexul automat nu-l prinde. Cifra corecta (14/2, numarata
manual din log) e cea folosita peste tot in acest dosar. Nu e o regresie noua.

Nicio contradictie de cifre intre rapoarte pe restul suitelor.

## 5. Ce NU e acoperit

*Doua dintre golurile de mai jos s-au inchis pe 10.08.2026 — vezi
`docs\cercetare\rec_s5_goluri_test.md`. Ce a ramas:*

- **Liniile din seturi de articole** (`id_vanzare_set` nenul) — **neacoperibil pe datele actuale**,
  nu din omisiune: interogare pe `MARIUSM_AUTO`, **zero** documente cu `id_vanzare_set` nenul in
  luna curenta, iar garda de editare cere luna curenta. Nu s-au fabricat date. Tratarea corecta a
  unei astfel de linii de catre helper e acoperita prin mock (`test_s5_validari_articole.prg`).
- **Lantul complet de editare pe documente in valuta** — niciun document `IN_VALUTA=1` din baza nu
  e din luna curenta (cel mai recent, 05.2026), iar garda de editare cere luna curenta. S-a putut
  testa doar recalculul Oracle izolat (cu ROLLBACK), nu fluxul complet de salvare pe un document in
  valuta.
- **Ramura moarta `Isnull(pret)`** (`omodificari.vc2:14340`) — consemnata, nereparata. Verificat
  empiric: `tvd.pret` vine `NOT NULL` din view, orice incercare de a forta `.NULL.` da eroare VFP
  1581. Garda defensiva imposibil de declansat pe fluxul real; inofensiva, lasata neatinsa.

**Wart preexistent, semnalat dar NEATINS de S5** — la o eroare Oracle in acest lant de scriere,
`oproceduri_comune.prg:421-424` afiseaza `Eroare necunoscuta` + SQL brut + `GETCALLSTACK()`.
Functional e corect (mesaj, apoi `.F.`, apoi ROLLBACK), dar textul e nepotrivit pentru utilizator.
Priveste **toata** suita ROA, nu doar editarea de factura, deci nu se repara aici.
*Nota, ca sa nu se reia alarma*: acelasi `AMESSAGEBOX` agata testele headless — e capcana cunoscuta
de dialog nativ, **nu** un defect de productie. Diagnosticul complet in `rec_s5_goluri_test.md`.

## 6. Date de test consumate ireversibil

Pe `id_vanzare = 1049` (factura tip 1, 07.08.2026):

- `cod` realocat succesiv: `1140887` -> `1140896` -> `1140897` -> `1140898` -> `1140900`
  (cel curent, verificat prin `sqlplus` la 10.08.2026).
- `det=1582` a ramas **sters definitiv** in urma testului de scriere reala.
  *Incident, reparat si verificat*: o prima varianta a suitei `test_s5_al_doilea_intrare.prg` a
  **reinviat tacut** linia `1582`, pentru ca apela helperul fara sa incarce `tvd` in prealabil —
  garda no-op pe cursor gol (`ofacturare_editare.prg:476`) a mascat greseala. Corectat pe loc cu
  `UPDATE` + `COMMIT`, iar varianta finala a suitei incarca `tvd` ca `Load()`-ul formularului si
  dovedeste explicit ca `1582` ramane sters dupa salvare. **Verificat independent de orchestrator
  prin `sqlplus`**: `1582` are `STERS = 1`.
- `det=1588` e o linie **noua**, creata de test, cu `id_gestiune=-1000` si `pret_achizitie=77.77`.
- Discountul documentului a trecut prin `12.5`, apoi a fost **restaurat la `0`** — verificat prin
  `sqlplus` dupa test.
- Totalurile documentului: `573.81` (initial) -> `905.02` (dupa scrierea articolelor).

Pe `id_vanzare = 1037` (`cod=1140730`, document in valuta, arhiva 05.2026): doar **citit**, testul
s-a inchis cu ROLLBACK — neatins, verificat prin `sqlplus`.

## 7. Intrarea de changelog — APLICATA 10.08.2026

Adaugata in capul lui `changelog_roafacturare.txt` ca **2.11.15**, tag `:nou:` (completeaza
functionalitatea de editare factura din #6, introdusa in S4). Verificat dupa scriere: CRLF intact
(3876 = 3876 = 3876), octeti `> 0x7F` neschimbati (3, toti preexistenti).

```
<!--
10/08/2026
ROAFACTURARE - 2.11.15

:nou:
  Factura. La editarea unei facturi deja emise, modificarile facute articolelor (cantitate, pret, discount, adaugare sau stergere de linie) se scriu acum si in baza de date, la salvare - anterior ramaneau doar in ecranul de editare. S-a adaugat coloana "Pret achizitie" in grid, editabila pentru articolele nou adaugate pe factura. Liniile care apartin unui set de articole nu se mai pot edita individual - se marcheaza distinct, iar totalul se calculeaza tot din capul setului.
-->
```

## 8. Pasi de livrare — stare la 10.08.2026

| # | Pas | Stare |
|---|---|---|
| 1 | Mutarea scripturilor SQL in `SCRIPTURI_CLAR\2026\08` + `svn add` | **FACUT**, status `A`, necomis |
| 2 | Blocul de changelog `2.11.15` in `changelog_roafacturare.txt` | **FACUT** |
| 3 | Inchiderea golurilor de acoperire din sectiunea 5 | **FACUT** — ROLLBACK 13/0, al doilea punct de intrare 17/0; liniile de set raman neacoperibile (zero date) |
| 4 | Verificarea write-back-ului binar prin reconversie pe cele 3 `.vc2` | **FACUT** — toate trei identice octet cu octet, vezi sectiunea 2 |
| 5 | Curatarea fisierelor netrackuite din COMUN | **FACUT** — 2 `.bak` + 1 log sterse; `pre_s4butoane.bak.vc2` lasat (difera de git HEAD) |
| 6 | **Commit git**, dupa aprobarea lui Marius | **FACUT** — `COMUN` `1c42ae0` (13 fisiere), `ROAFACTURARE` `316b6f7` (2 fisiere), ambele pe `punct6-s4-runda3` |
| 7 | **Verificarea pe ecran de Marius** — coloana "Pret achizitie", marcajul liniilor de set, cele 5 validari | ramane a lui |
| 8 | **Push git si commit SVN** (inclusiv cele doua scripturi `A` din `DATABASE`) | **NEFACUT** — publicare pe server, decizie separata a lui Marius |

### Ce a ramas necomis, deliberat

- **`svn commit`** — nici in `DATABASE` (cele doua scripturi, status `A`), nici in vreun alt repo.
  SVN e sursa de adevar si commit-ul merge direct pe server, deci e publicare, nu pas local.
- **`git push`** — pe niciunul din cele doua repo-uri.
- **`docs\`** din `ROAFACTURARE` — netrackuit dintotdeauna, nu l-am introdus in git acum.
- **`COMUN\clase\ofacturare_comun.pre_s4butoane.bak.vc2`** — vezi sectiunea 2.

### Ce nu s-a rulat inainte de commit

`git_sync.ps1` nu a fost rulat in `ROAFACTURARE` inaintea commit-ului `316b6f7`: acesta atinge doar
`changelog_roafacturare.txt` si `versiune_db.txt`, niciun binar VFP, iar o resincronizare ar fi adus
in commit zgomot din `.??2`-uri nelegate de S5. Daca textele din `ROAFACTURARE` sunt invechite fata
de binare, e stare preexistenta, nu efect al S5.