Documentatie tehnica ROAGEST
Notite concise despre structura interna a proiectului (fluxuri, pachete, tabele), descoperite in timp ce se lucreaza la sarcini concrete. Completeaza CLAUDE.md — nu il inlocuieste si nu duplica ce e deja evident din cod.
Index
- CLAUDE.md — modul de lucru Claude ↔ Marius (propuneri de cod pentru VFP IDE, acces Oracle direct).
- flux-achizitie-import.md — lantul achizitie import: gestiuni.vcx → achizitie_import → import_nota → import_nir → PACK_CONTAFIN; capcane (ptva bruta vs proc_tva, import_nota_original mort, 4427/401).
- flux-editare-vfp-text.md — editare directa pe cache-ul text (.vc2/.sc2) cu write-back prin txt2vcx.ps1, in loc de VFP IDE; limite (.mnx/.frx read-only, COMUN cu aprobare, staleness dupa sesiuni IDE).
- propuneri_achizitie_import.md — temporar: modificarile propuse (cu cod) pentru sesizarea achizitie import; se sterge dupa implementare.
local/— notite neversionate (credentiale Oracle etc., in .gitignore).
Vezi si COMUN\docs\oracle_export.md (export surse PL/SQL, PACK_CONTAFIN.pck).
Cand actualizezi
Adauga sau corecteaza o notita aici ori de cate ori descoperi ceva nou si ne-evident despre structura proiectului in timpul rezolvarii unei sarcini (un flux ascuns, o capcana, o conventie, un pachet sau tabel cheie). Nu documenta ce oricine ar afla citind codul in 30 de secunde — scopul e sa scurtezi investigatii viitoare similare, nu sa duplici codul.
Organizeaza notitele in fisiere separate pe subiect (nu un singur fisier uriaș), ex: flux-<nume-flux>.md, pachet-<nume-pachet>.md, tabele.md.