roafacturare/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this is

ROAFACTURARE is a Visual FoxPro 9 desktop invoicing application, one product in the ROA business-software suite built by ROA Romfast SRL. Thick client: VFP source (.prg, .scx, .vcx, .mnx, .frx) compiled to roafacturare.exe, talking to an Oracle backend. No web front-end, no package-manager-based build.

This directory (D:\ROA\ROAFACTURARE) is one working copy inside the larger D:\ROA tree that holds the sibling ROA products (ROACONT, ROAGEST, ROAIMOB, ROAACNPRO, ...) plus the suite-wide shared library D:\ROA\COMUNROA.

Version control

Primarily an SVN working copy (^/ROAFACTURARE/Trunk, repository root http://svnroa:3001/svn/ROA) — use svn status, svn diff, svn commit for the day-to-day legacy workflow. A git mirror runs in parallel (gitea.romfast.ro:romfast/roafacturare.git), synced manually from SVN; SVN stays the source of truth.

Git tracks the FoxBin2Prg text versions of the VFP binaries (.vc2/.sc2/.fr2/.mn2/.lb2/.pj2), generated in-tree next to each binary — not the binaries themselves. Refresh them with git_sync.ps1 at the start of every session and before any git commit:

powershell -ExecutionPolicy Bypass -File D:\ROA\UTIL\foxbin2prg\git_sync.ps1 -ProjectRoot D:\ROA\ROAFACTURARE

Then search the .??2 files in-tree with Grep, citing file:line. Write-back text->binary via txt2vcx.ps1 is supported only for .vc2/.sc2; .frx/.mnx/.lbx/.pjx/.dbc/.dbf are editable only in the VFP IDE. See D:\ROA\UTIL\foxbin2prg\CLAUDE.md and COMUN\docs\flux-editare-vfp-text.md.

COMUN/ is excluded from this repo's git — it is shared by every ROA product and versioned by its own git repo, gitea.romfast.ro:romfast/comun.git. Run git commands for COMUN/ from inside that directory, and treat any change there as cross-project.

Building / running

No CLI build tool. Compiled from inside the VFP 9 IDE: open roafacturare.PJX, then Project > Build / Rebuild. Entry point is Programe/roafacturare.prg (PARAMETERS tparam — a connection string passed by the ROA "Start" launcher); it sets the VFP environment (SET PATH, SET CLASSLIB, SET PROCEDURE ... ADDITIVE), so new shared .prg/.vcx files must be registered there to be reachable app-wide. Always edit the source file, never its compiled sibling (.FXP/.SCT/.VCT/.MPR). No automated tests.

Directory layout

Programe/ top-level business-logic modules · Clase/ .vcx class libraries · Ferestre/ and Formulare/ .scx forms · Meniuri/ menus · Rapoarte/ .frx reports · Locale/ DBF-based i18n · COMUN/ this project's copy of the shared assets (clase, ferestre, programe, rapoarte, utile) · Utile/, Include/, Grafice/, Ajutor/, Mesaje/ support assets. versiune_db.txt is a manually bumped YYYY_MM_DD_NN marker for the last applied DB migration.

Changelog convention

changelog_roafacturare.txt is a flat file of HTML-comment blocks, newest first:

<!--
DD/MM/YYYY
ROAFACTURARE - X.Y.Z

:modificare:
  <what changed>
-->

Tags: :nou: (new feature), :modificare: (change), :eroare: (bug fix), :adaugare: (addition). Bump MAJOR.MINOR.PATCH per entry (current series 2.11.x). In-code change comments follow *!* DD.MM.YYYY + author + short description directly above the changed code.

Localization

Romanian is the built-in default. Keep new user-facing strings and code comments in Romanian to match the existing codebase unless told otherwise.

Reguli de lucru si testare

Inainte de orice modificare de cod sau testare, citeste COMUN\docs\reguli_lucru.md. Nu e optional si nu e doar context: contine regulile de livrare (diff ca fisier + aprobare inainte de write-back), comentariile (max o linie), modificarile minime, harnessul de testare headless si — la punctul 7 — lista de conventii obligatorii per zona atinsa (encoding cp1252 la editarea .vc2/.sc2, UX formulare/griduri, GO pe Recno(), goExecutor + ALTER TABLE, testare UI, export Oracle). Fisierul e index: urmeaza linkurile relevante pentru sarcina curenta. Depanare detaliata: COMUN\docs\depanare_testare_vfp.md.

Mod de lucru: delegare catre subagenti + review inainte de commit

• Orchestrare pe misiuni lungi: niciodata un singur subagent care acumuleaza context pe multe sarcini inlantuite — sesiunea principala orchestreaza subagenti proaspeti per sarcina (max ~200-250k tokens per subagent, apoi handoff + agent nou), cu handoff compact pe disc: COMUN\docs\orchestrare-subagenti.md.
• Delegare: modificarile de cod de volum/rutina (aplicarea unei propuneri aprobate din docs/, editari pe versiunile text .??2 + write-back, actualizari de documentatie, rulari de teste) se delega catre subagenti Sonnet care lucreaza in background (Agent tool cu model: sonnet), iar sesiunea principala doar orchestreaza si verifica rezultatele.
• Fara commit fara review: nu da commit (git sau svn) din proprie initiativa pe modificari de cod — diff-ul se livreaza intai ca fisier in docs/, iar commit-ul vine dupa aprobare.